Skip to main content

Bulk Send Purchase Order ASNs

POST 

/api/purchase-orders/asn/bulk

Send the ASN for several purchase orders in the background. Each goes to its destination's warehouse system (a ShipHero purchase order) or is emailed as a spreadsheet. POs already in their warehouse system with no changes are skipped; POs with products the warehouse system doesn't have are held.

Required scope: purchase-orders:write

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

Body

  • ids (array of integers, 1–500, required unless apply_to_all is true): the purchase order ids.
  • apply_to_all (boolean, optional): true sends every purchase order matching filters (object, optional; omitted = every purchase order) instead of ids. filters is ignored unless apply_to_all is true, and apply_to_all: false (or filters alone) still requires ids.

Returns tracked_job_log_id for the background job (named Send ASNs to {destination}). When it completes, its results hold outcomes (counts of sent, linked, updated, emailed, held, skipped, failed) and one entry per purchase order with its outcome and message.

Requires permission: purchase_orders.update

Authentication: Requires Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type