Skip to main content

Import Purchase Orders

POST 
/api/purchase-orders/import

Execute the purchase order import — create purchase orders from validated data.

Required scope: purchase-orders:write

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

Authentication: Requires Bearer token.

Returns 201 Created on success, 422 on failure.

Purchase order fields:

  • purchase_order_date (required, date)
  • supplier_id (required, exists:suppliers)
  • destination_warehouse_id (required, exists:warehouses)
  • purchase_order_number (optional)
  • currency_id (optional), currency_code (optional)
  • order_status (optional, in:draft,open)
  • estimated_delivery_date, supplier_notes, tracking_number, tags (all optional)
  • payment_term_id, shipping_method_id, incoterm_id, store_id (all optional)

Line fields:

  • quantity (required, numeric, min:1)
  • amount (required, numeric, min:0)
  • product_id, description, discount, tax_rate, nominal_code_id, estimated_delivery_date (all optional)

Requires permission: purchase_orders.import

Request​

Responses​

Created

Response Headers
    Content-Type