Supplier orders

Use supplier order operations when a merchant integration needs to create purchasing workflows, update line items, or mirror supplier order states.

Available operations

• List and filter supplier orders with supplierOrders.
• Create a supplier order with createSupplierOrder.
• Add, update, and remove line items with addSupplierOrderLineItem, updateSupplierOrderLineItem, and removeSupplierOrderLineItem.
• Update the expected delivery date with updateSupplierOrderExpectedDeliveryDate.
• Move the order through purchasing states with markSupplierOrderAsConfirmed, markSupplierOrderAsOrdered, or cancelSupplierOrder.
• Update the payment state with markSupplierOrderAsPaid, markSupplierOrderAsPartiallyPaid, or markSupplierOrderAsUnpaid.
• Delete a supplier order with deleteSupplierOrder.

Example: create a supplier order

mutation CreateSupplierOrder($input: CreateSupplierOrderInput!) {
  createSupplierOrder(input: $input) {
    id
    number
    state
    paymentState
  }
}

The input references product-supplier configurations, not raw products. Use Product-supplier configurations to find or create those assignments first.

Required scopes

Use supplier_orders:read for reads and supplier_orders:write for mutations.