billing
POST /v1/accounting/xero/sync
Push outstanding invoices to Xero now.
認証
ベアラー トークンとして API キーを送信します。キーには billing.invoice.manage 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X POST https://api.zinndigital.com/v1/accounting/xero/sync \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
Runs a batch immediately instead of waiting for the hourly sweep. Idempotent: every invoice carries a deterministic reference and the engine searches Xero for it before creating anything, so pressing this twice cannot produce two invoices in the customer's books. 409 means the connection needs reconnecting. Nothing is lost in that state — outstanding invoices stay queued and are sent on reconnect. Requires billing.invoice.manage.
返信
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
pushed | integer | はい | — |
failed | integer | はい | — |
remaining | integer | はい | Still outstanding after this batch. ⛔ Reported so a client never infers "finished" from a short batch — some rows may have failed rather than completed. |
connection | XeroConnection | いいえ | An organization's link to its own Xero. ⛔ needs_reconnect is a distinct state from not_connected on purpose — see getMyXeroConnection. |
このエンドポイントが返すエラー
401 · 403 · 404 · 409 · 429