Skip to main content

Get Bill Sync Settings

GET 

/api/accounting/bill-sync

Get how expense bills sync to a Xero or QuickBooks connection: the expense bill mode, the start date, whether landed cost bills sync, the period lock date and the list of connections.

Required scope: accounting:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Without any Xero or QuickBooks connection the response still returns 200 with connection: null, connections: [] and the sku_only mode.

Response fields:

  • connection - the connection these settings belong to (id, name, provider xero/qbo, provider_label, is_active).
  • connections - every Xero / QuickBooks connection on the tenant.
  • mode - the expense bill mode in effect (see below).
  • mode_is_default - true when no mode was ever chosen and the connection is inheriting one.
  • start_date - only bills dated on or after this date are sent (Y-m-d, or null for no limit).
  • landed_cost_enabled - whether landed cost bills sync to this connection.
  • lock_date - the later of the SKU.io period lock and the provider's lock date, or null.
  • billcom - whether a BILL connection exists and whether BILL syncs bills to accounting itself.

Modes:

  • send - SKU.io sends its expense bills to the provider.
  • provider_owned - the provider owns expense bills; keep entering them there and bring them into SKU.io with the provider bill review endpoints. SKU.io does not send them.
  • sku_only - expense bills stay in SKU.io and are never sent.

Authentication: Requires Bearer token. Scope: accounting (read/write). The user must hold the Manage bill sync permission (accounting.bill_sync).

Request​

Responses​

OK

Response Headers
    Content-Type