Skip to main content

Create Purchase Order

POST 
/api/purchase-orders

Create a new purchase order with optional line items.

Authentication: Requires Bearer token.

Required fields:

  • purchase_order_date (date)
  • supplier_id OR supplier_name
  • currency_id OR currency_code

Optional fields:

  • purchase_order_number: custom PO number (auto-generated if omitted)
  • approval_status: pending (default) or approved
  • order_status: draft (only allowed value; omit for open)
  • shipment_id: required when destination_warehouse is Amazon FBA
  • forecasting_products[]: alternative to purchase_order_lines for forecasting integration

Line item fields:

  • product_id OR sku (required if not a cost line)
  • quantity (required, min:0)
  • amount (required, min:0) — unit cost
  • description, discount, tax_rate_id, estimated_delivery_date, nominal_code_id, is_free_of_charge, free_of_charge_reason, linked_backorders all optional

Request​

Responses​

Successful response