Ship an approved intercompany or FBA transfer (deducts source, posts GL)
Ships a transfer that has cleared its prior state. Branch behavior:
intercompany: requires statusapproved. Validates stock, deducts source inventory, posts the ship GL (DR in-transit / CR inventory plus Due From / Due To for intercompany), advances toin_transit.fba_inbound: requires statusworkingorsubmitted. Same inventory deduction + ship GL, advances toshipped.internal: NOT allowed via this endpoint; internal transfers ship as part of submit. Returns 400.
Optional carrier and tracking_number body fields update the
existing header values (COALESCE semantics; passing null keeps the
prior value). AUDIT-089 fires transfer.shipped to both entities.
Requires inventory:write scope. Idempotent via Idempotency-Key.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Response
Shipped transfer (hydrated; GL JE id populated)

