Skip to main content

Get ShipHero Purchase Order

GET 

/api/shiphero/integration-instances/:integration_instance/purchase-orders/:purchaseOrder

Get one ShipHero purchase order SKU.io created, held back or linked, with everything about it: the SKU.io source (source: purchase order or warehouse transfer, its supplier and warehouse, or deleted: true when the order is gone), the ShipHero vendor and the SKU.io supplier it is mapped to, the ShipHero warehouse it went to and the SKU.io warehouse it was sent for, the 3PL customer account it was filed under, the header as sent (tracking_number, po_date, po_date_source, notes, backup_emailed_at), and the hold or last error.

Required scope: integrations:read

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

lines: one per ShipHero SKU — the quantity SKU.io sent, shiphero_quantity (from the last full read of the PO from ShipHero; null before one), received, rejected and sell-ahead, the SKU.io order lines it combines, and flags: quantity_differs (ShipHero's quantity isn't what was sent), over_received, no_product (no SKU.io product) and not_in_shiphero (ShipHero no longer has the line). remote_only_lines lists SKUs ShipHero has on the PO that SKU.io never sent; mismatch_count counts flagged lines.

related: the other ShipHero purchase orders of the same SKU.io order (primary, supplementary -A, revisions -R2, replaced). receipts: the SKU.io receipts posted from this PO's ShipHero receiving, newest first. json_object: the purchase order as last read from ShipHero.

shiphero_url is the outside link set by asn.portal_po_url_template, and null when the connection doesn't link outside SKU.io (the default).

Returns 404 when the purchase order belongs to another connection.

Requires permission: integrations.show

Authentication: Requires Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type