Skip to main content

List Purchase Orders for a Provider Bill Supplier

GET 

/api/accounting/provider-bills/review/purchase-orders

The purchase orders a goods supplier's provider bill can become a purchase invoice on: the supplier's received, not-yet-invoiced purchase orders. The wizard loads these when a person matches a contact to a supplier, and for the per-bill purchase order picker.

Required scope: purchase-orders:read

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

Query:

  • supplier_id (required, integer) - the SKU.io supplier.
  • connection_id (optional, integer).

Each row: id, number, total (the order's total), invoice_total (what a purchase invoice on it would total now: received and not yet invoiced, at the order's prices, with tax unless the prices include it), open_charges (the order's charges not billed yet: id, description, total), currency. At commit the purchase invoice takes the open charges the provider bill's total includes (the set that comes closest to it), then books the provider's total: any remaining difference goes on a "Difference from Xero" / "Difference from QuickBooks" line.

Returns 422 without a valid supplier_id.

Authentication: Requires Bearer token. Scope: purchase-orders (read/write). The user must hold the Review provider bills permission (bills.review_provider).

Request​

Responses​

OK

Response Headers
    Content-Type