Skip to main content

Set Channel Accounting Owner

PUT 

/api/ledger/settings/channel-sync/:integrationInstance/owner

Sets who books one sales channel in the accounting system. Use it when another app (for example A2X, Link My Books, Synder, or a bookkeeper) already books part of the channel, so SKU.io must not send the same documents.

Required scope: accounting:write

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

Authentication: Requires Bearer token with the Manage accounting settings permission.

Body:

  • owner (string, required): sku (SKU.io books the channel), external_revenue (another app books revenue, refunds and payout/settlement documents; SKU.io keeps sending COGS and inventory journals) or external_all (another app books everything for the channel).
  • app_name (string, optional, max 60): the other app's name, used only as a label ("Booked by A2X"). Ignored when owner is sku.
  • send_from_today (boolean, optional): when documents come back to SKU.io — the channel returns to sku, or external_all narrows to external_revenue (COGS and returns come back). Documents the other app booked that are dated before today then stay unsent automatically (they can still be pushed one at a time), so SKU.io does not send a period twice. A save that keeps the same owner (e.g. only renaming the app) changes nothing.

Documents the other app books are never sent by SKU.io — not automatically and not with Sync Now. Documents already in the accounting system are never changed or removed. The channel's unsynced documents are re-evaluated in the background.

Returns the channel's refreshed explanation (same shape as Get Channel Sync Explanation). 404 when the channel does not exist; 422 for an invalid owner, an app name over 60 characters, or an instance that is not a sales channel.

Request​

Responses​

OK

Response Headers
    Content-Type