Skip to main content

List Shopify Partner Orders

GET 

/api/shopify/:integrationInstance/partner-orders

List the Shopify orders a partner ships, one row per record-only drop-ship purchase order at a partner location's supplier warehouse, newest first. Each row carries the sales order, the Shopify order, the partner (supplier, drop-ship warehouse and Shopify location), the items with cost and sold price, the purchase order, its bills, and where its cost stands.

Required scope: integrations:read

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

Only partner locations mapped to a supplier warehouse are included (see Apply Shopify Partner Location Mappings).

cost_status (the first that applies):

  • cost_missing: a purchase order line has no cost.
  • variance: its Collective debit was matched but differs from the purchase order cost plus shipping.
  • debit_matched: its Collective debit was matched and billed.
  • paid: billed and the bill is paid.
  • billed: billed, not paid.
  • not_billed: shipped more than 7 days ago and not billed.
  • shipped: shipped recently, not billed yet.
  • po_recorded: recorded, not shipped yet.

Totals: po_total is the purchase order cost (quantity x unit cost, less discount); sold_total is what the customer paid for the same lines. collective is set for Shopify Collective orders: the supplier's name, its order number and the shipping it charged; otherwise null. shopify_order and partner.location are null when they cannot be resolved.

Pagination: 10 per page by default; standard paginated response.

Authentication: Requires Bearer token (integrations:read).

Request​

Responses​

OK

Response Headers
    Content-Type