ComposioHQ/Xero-Automation

Xero Automation

Xeroの会計処理を自動化します。請求書、連絡先、支払い、銀行取引、勘定科目の管理など、中小企業の簿記業務を効率化します。

ツールキットドキュメント: composio.dev/toolkits/xero

---

セットアップ

このスキルを使用するには、https://rube.app/mcp に接続された Rube MCPサーバー が必要です。

ツールを実行する前に、xero ツールキットのアクティブな接続が存在することを確認してください。アクティブな接続がない場合は、RUBE_MANAGE_CONNECTIONS を介して接続を開始してください。

マルチテナント: 複数のXero組織を管理している場合は、最初に XERO_GET_CONNECTIONS を呼び出してアクティブなテナントを一覧表示し、後続の呼び出しで正しい tenant_id を取得してください。

---

コアワークフロー

1. 請求書の一覧表示とフィルタリング

ステータス、連絡先、日付範囲、ページネーションによるフィルタリングで請求書を取得します。

ツール: XERO_LIST_INVOICES

主要パラメータ:

• Statuses -- カンマ区切りのステータスフィルター: "DRAFT"、"SUBMITTED"、"AUTHORISED"、"PAID"
• ContactIDs -- フィルタリングする連絡先ID（カンマ区切り）
• InvoiceIDs -- フィルタリングする請求書ID（カンマ区切り）
• where -- OData形式のフィルター（例: "Status==\"AUTHORISED\" AND Total>100"）
• order -- ソート式（例: "Date DESC"、"InvoiceNumber ASC"）
• page -- ページネーション用のページ番号
• If-Modified-Since -- UTCタイムスタンプ。この日時以降に変更された請求書のみを返します。
• tenant_id -- Xero組織ID（省略時は最初のテナントを使用）

例:

Tool: XERO_LIST_INVOICES
Arguments:
  Statuses: "AUTHORISED,PAID"
  order: "Date DESC"
  page: 1

---

2. 連絡先の管理

請求書や取引で使用する連絡先を取得および検索します。

ツール: XERO_GET_CONTACTS

主要パラメータ:

• searchTerm -- 名前、FirstName、LastName、Email、ContactNumber に対する大文字小文字を区別しない検索
• ContactID -- 単一の連絡先をIDで取得
• where -- ODataフィルター（例: "ContactStatus==\"ACTIVE\""）
• page、pageSize -- ページネーション制御
• order -- ソート（例: "UpdatedDateUTC DESC"）
• includeArchived -- true でアーカイブ済みの連絡先を含める
• summaryOnly -- true で軽量なレスポンス

例:

Tool: XERO_GET_CONTACTS
Arguments:
  searchTerm: "acme"
  page: 1
  pageSize: 25

注意: 取引量の多いアカウントでは、一部の where フィルター（例: IsCustomer、IsSupplier）がXeroによって拒否される場合があります。その場合は searchTerm またはページネーションにフォールバックしてください。

---

3. 支払いの作成

支払いレコードを作成して、請求書を銀行口座にリンクします。

ツール: XERO_CREATE_PAYMENT

主要パラメータ:

• InvoiceID（必須） -- 支払い対象のXero請求書ID
• AccountID（必須） -- 支払い元の銀行口座ID
• Amount（必須） -- 支払い金額（数値）
• Date -- 支払日（YYYY-MM-DD 形式）
• Reference -- 支払いの参照または説明
• CurrencyRate -- 外貨支払いの為替レート

例:

Tool: XERO_CREATE_PAYMENT
Arguments:
  InvoiceID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  AccountID: "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  Amount: 1500.00
  Date: "2026-02-11"
  Reference: "Payment for INV-0042"

---

4. 銀行取引の作成

支出（送金）または入金（受取）の銀行取引を記録します。

ツール: XERO_CREATE_BANK_TRANSACTION

主要パラメータ:

• Type（必須） -- "SPEND"（支出）または "RECEIVE"（入金）
• ContactID（必須） -- Xero連絡先ID
• BankAccountCode（必須） -- 勘定科目一覧の銀行口座コード
• LineItems（必須） -- 明細項目の配列。各項目は以下を含む:
  • Description（必須） -- 明細の説明
  • UnitAmount（必須） -- 単価
  • AccountCode（必須） -- 分類用の勘定科目コード
  • Quantity -- 数量（デフォルトは1）
  • TaxType -- 税タイプ: "OUTPUT"、"INPUT"、"NONE"
• Date -- 取引日（YYYY-MM-DD 形式）
• Reference -- 取引参照
• Status -- "AUTHORISED" または "DELETED"
• CurrencyCode -- 例: "USD"、"EUR"

例:

Tool: XERO_CREATE_BANK_TRANSACTION
Arguments:
  Type: "SPEND"
  ContactID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  BankAccountCode: "090"
  LineItems: [
    {
      "Description": "Office supplies",
      "UnitAmount": 75.00,
      "AccountCode": "429",
      "Quantity": 1,
      "TaxType": "INPUT"
    }
  ]
  Date: "2026-02-11"
  Reference: "Feb office supplies"

---

5. 支払いと銀行取引の一覧表示

既存の支払いと銀行取引の履歴を確認します。

ツール:

• XERO_LIST_PAYMENTS -- 請求書と銀行取引をリンクする支払いレコードを一覧表示
• XERO_LIST_BANK_TRANSACTIONS -- 支出/入金の銀行取引を一覧表示

共通パラメータ:

• where -- ODataフィルター（例: "Status==\"AUTHORISED\""）
• order -- ソート式（例: "Date DESC"）
• page -- ページネーション用のページ番号
• If-Modified-Since -- タイムスタンプ以降の増分更新
• tenant_id -- 組織ID

---

6. 勘定科目一覧と接続の表示

ツール:

• XERO_LIST_ACCOUNTS -- 取引を分類するためのすべての勘定科目コードを取得
• XERO_GET_CONNECTIONS -- アクティブなXeroテナント接続を一覧表示
• XERO_LIST_ATTACHMENTS -- エンティティ（請求書、連絡先など）の添付ファイルを一覧表示

---

既知の落とし穴

落とし穴	詳細
マルチテナントルーティング	tenant_id を省略すると、最初に接続されたテナントが使用されます。複数の組織を管理する場合は、必ず XERO_GET_CONNECTIONS で正しいテナントを確認してください。
大量データでのフィルター拒否	大規模なアカウントでは、IsCustomer/IsSupplier などの一部の where フィルターが拒否される場合があります。searchTerm とページネーションにフォールバックしてください。
ODataフィルター構文	ODataフィルターでは二重等号（==）を使用してください（例: Status==\"AUTHORISED\"）。単一の = はエラーを引き起こします。
ページネーション必須	ほとんどの一覧表示エンドポイントは結果をページ分割します。追加ページがあるかどうかを常に確認し、完了するまで取得を続けてください。
日付形式	すべての日付は YYYY-MM-DD 形式である必要があります。If-Modified-Since のタイムスタンプは完全なISO 8601 UTC日時である必要があります。
銀行口座コード	銀行取引の BankAccountCode は、勘定科目一覧の有効なコードと一致する必要があります。XERO_LIST_ACCOUNTS を使用して有効なコードを確認してください。

---

クイックリファレンス

ツールスラッグ	説明
XERO_LIST_INVOICES	フィルタリングとページネーションで請求書を一覧表示
XERO_GET_CONTACTS	連絡先を取得および検索
XERO_CREATE_PAYMENT	請求書を銀行口座にリンクする支払いを作成
XERO_CREATE_BANK_TRANSACTION	支出または入金の銀行取引を記録
XERO_LIST_PAYMENTS	支払いレコードを一覧表示
XERO_LIST_BANK_TRANSACTIONS	銀行取引を一覧表示
XERO_LIST_ACCOUNTS	勘定科目一覧を取得
XERO_GET_CONNECTIONS	アクティブなXeroテナント接続を一覧表示
XERO_LIST_ATTACHMENTS	エンティティの添付ファイルを一覧表示

---

Powered by Composio