Purchase Orders
List Purchase Orders (DataTable)
Paginated purchase orders list using the DataTable trait. Supports full-text search, filters, sorting, and archival state.
Create Purchase Order
Create a new purchase order with optional line items.
Bulk Delete
Bulk delete purchase orders by IDs or by filter criteria.
List Purchase Orders (Vue3 List)
Paginated purchase order list for the Vue 3 datatable. Uses Spatie QueryBuilder with advanced grouped filter support.
Export Purchase Orders
Export purchase orders as XLSX or CSV. Supports summary (one row per PO) and line_items (one row per line item with PO fields repeated) modes.
List Purchase Orders (DataTable)
Paginated purchase orders list using the DataTable trait. Supports full-text search, filters, sorting, and archival state.
Create Purchase Order
Create a new purchase order with optional line items.
Bulk Delete
Bulk delete purchase orders by IDs or by filter criteria.
List Purchase Orders (Vue3 List)
Paginated purchase order list for the Vue 3 datatable. Uses Spatie QueryBuilder with advanced grouped filter support.
Export Purchase Orders
Export purchase orders as XLSX or CSV. Supports summary (one row per PO) and line_items (one row per line item with PO fields repeated) modes.
Get CSV Column Registry
Returns the master registry of supported PO email CSV columns and the tenant-wide default selection. Used by the per-supplier CSV column picker, the supplier preferences panel, and the PO settings page.
Get Purchase Order
Get a single purchase order with all relations loaded: lines, products, inventory, shipments, receipts, invoices, bills, notes, financial lines, Amazon inbound data, and more.
Update Purchase Order
Update an existing purchase order. All fields are optional (sometimes).
Delete Purchase Order
Delete a single purchase order. Fails if the PO has received inventory that has been used in FIFO layers.
Get Purchase Order
Get a single purchase order with all relations loaded: lines, products, inventory, shipments, receipts, invoices, bills, notes, financial lines, Amazon inbound data, and more.
Update Purchase Order
Update an existing purchase order. All fields are optional (sometimes).
Delete Purchase Order
Delete a single purchase order. Fails if the PO has received inventory that has been used in FIFO layers.
Bulk Approve
Bulk approve purchase orders by IDs or filters.
Bulk Submit
Bulk submit (send to supplier) purchase orders.
Bulk Archive
Bulk archive purchase orders.
Bulk Unarchive
Bulk unarchive purchase orders.
Check Deletable
Check whether each purchase order can be deleted. Returns a list with deletable flag and reason if not.
Bulk Approve
Bulk approve purchase orders by IDs or filters.
Bulk Submit
Bulk submit (send to supplier) purchase orders.
Bulk Archive
Bulk archive purchase orders.
Bulk Unarchive
Bulk unarchive purchase orders.
Check Deletable
Check whether each purchase order can be deleted. Returns a list with deletable flag and reason if not.
Submit PO to Supplier
Submit (send) a draft purchase order to the supplier. Triggers PO sent notification.
Close Purchase Order
Manually close an open purchase order.
Reopen Purchase Order
Reopen a closed purchase order.
Duplicate Purchase Order
Duplicate a purchase order (creates a new draft with the same lines).
Cover Backorders
Sync inventory allocation coverages for all lines in this purchase order.
Generate Accounting Transaction
Generate (or regenerate) the accounting transaction for a purchase order.
Create Receiving Discrepancy
Create an accounting transaction for the receiving discrepancy on this purchase order.
Submit PO to Supplier
Submit (send) a draft purchase order to the supplier. Triggers PO sent notification.
Close Purchase Order
Manually close an open purchase order.
Reopen Purchase Order
Reopen a closed purchase order.
Duplicate Purchase Order
Duplicate a purchase order (creates a new draft with the same lines).
Cover Backorders
Sync inventory allocation coverages for all lines in this purchase order.
Generate Accounting Transaction
Generate (or regenerate) the accounting transaction for a purchase order.
Create Receiving Discrepancy
Create an accounting transaction for the receiving discrepancy on this purchase order.
Get PO Lines (DataTable)
Get purchase order lines via DataTable. Includes full product info, inventory, supplier products, allocations, receipts, and invoice lines.
Get PO Lines for Invoice
Get purchase order lines optimised for invoice creation. Returns only essential invoice-relevant fields with minimal N+1 overhead.
Get PO Lines for Receiving
Lean endpoint for the Receive drawer. Returns only the 8 fields the UI consumes (id, sku, name, barcode, img_url, quantity, received) — no COGS, no allocations, no inventory snapshots, no resource transformation.
Get PO Lines for Shipment Picker
Lines for the Create Shipment / Add to Existing Shipment pickers on the PO Shipments tab.
Get PO Line Items (Lightweight)
Lightweight line items for the expandable row in the datatable. Returns id, product SKU, barcode, product_name, quantity, received_quantity, amount, discount_rate, and line_total.
Import Lines from CSV
Import purchase order line items from a CSV file. CSV must have a 'sku' column. Optional columns: quantity, unit_cost, description, discount_rate, tax_rate_id, pricing_tier, barcode.
Download Lines Import Template
Download an XLSX import template for PO line items with headers (sku, quantity, unit_cost) and sample data.
Apply Discount Rate to Lines
Apply a discount rate to all lines of a purchase order.
Apply Pricing Tier to Lines
Apply a supplier pricing tier to all (or specified) lines of a purchase order.
Apply Tax Rate to Lines
Apply a tax rate to all lines of a purchase order.
Clear Tax Rate from Lines
Clear tax rates from all lines of a purchase order.
Get PO Lines (DataTable)
Get purchase order lines via DataTable. Includes full product info, inventory, supplier products, allocations, receipts, and invoice lines.
Get PO Lines for Invoice
Get purchase order lines optimised for invoice creation. Returns only essential invoice-relevant fields with minimal N+1 overhead.
Get PO Line Items (Lightweight)
Lightweight line items for the expandable row in the datatable. Only returns id, product SKU/name, quantity, received_quantity, amount, and discount_rate.
Import Lines from CSV
Import purchase order line items from a CSV file. CSV must have a 'sku' column. Optional columns: quantity, unit_cost, description, discount_rate, tax_rate_id, pricing_tier, barcode.
Download Lines Import Template
Download an XLSX import template for PO line items with headers (sku, quantity, unit_cost) and sample data.
Apply Discount Rate to Lines
Apply a discount rate to all lines of a purchase order.
Apply Pricing Tier to Lines
Apply a supplier pricing tier to all (or specified) lines of a purchase order.
Apply Tax Rate to Lines
Apply a tax rate to all lines of a purchase order.
Clear Tax Rate from Lines
Clear tax rates from all lines of a purchase order.
Update PO Line
Update a single purchase order line. Designed for the PO grid's inline-edit interactions (tax rate, quantity, unit cost, discount, description, FOC toggle, nominal code).
Short-Close PO Line
Short-close a PO line at a smaller `closed_quantity` than originally ordered. Records an audit event (PurchaseOrderLineShortCloseEvent) and mutates the line's `quantity` to the new effective ordered amount. The line's own `save()` propagates the change into demand-planning coverages.
Undo Short-Close
Reverse a prior short-close event, restoring the PO line's original ordered quantity.
Get PO Lines for Shipment Picker
Lines for the Create Shipment / Add to Existing Shipment pickers on the PO Shipments tab.
Get PO Lines for Receiving
Lean endpoint for the Receive drawer. Returns only the 8 fields the UI consumes (id, sku, name, barcode, img_url, quantity, received) — no COGS, no allocations, no inventory snapshots, no resource transformation.
Get PO Receipts
Get all shipment receipts for a purchase order.
Get Single PO Receipt
Get a single receipt for a purchase order.
Get Dropship Shipments
Get dropship fulfillment shipments for a dropship purchase order. Returns empty array for non-dropship POs.
Mark as Shipped (FBA/AWD)
Mark an FBA or AWD purchase order as shipped. Processes through Amazon inbound management (creates pending inbound record).
Update Shipment Details (FBA)
Update shipment details (shipped date and tracking number) for an already-shipped FBA purchase order.
Get PO Receipts
Get all shipment receipts for a purchase order.
Get Single PO Receipt
Get a single receipt for a purchase order.
Get Dropship Shipments
Get dropship fulfillment shipments for a dropship purchase order. Returns empty array for non-dropship POs.
Mark as Shipped (FBA/AWD)
Mark an FBA or AWD purchase order as shipped. Processes through Amazon inbound management (creates pending inbound record).
Update Shipment Details (FBA)
Update shipment details (shipped date and tracking number) for an already-shipped FBA purchase order.
Get Notes
Get paginated notes for a purchase order (most recent first).
Add Note
Add a note to a purchase order.
Toggle Note Pin
Toggle the pinned state of a note on a purchase order.
Delete Note
Delete a note from a purchase order.
Get Notes
Get paginated notes for a purchase order (most recent first).
Add Note
Add a note to a purchase order.
Toggle Note Pin
Toggle the pinned state of a note on a purchase order.
Delete Note
Delete a note from a purchase order.
Activity Log
Get paginated activity log for a purchase order. Covers events on the PO, its lines, and invoices.
Inventory Movements
Get paginated inventory movements for a purchase order (via receipt lines).
FIFO Layers
Get paginated FIFO inventory layers created from receiving this purchase order.
Activity Log
Get paginated activity log for a purchase order. Covers events on the PO, its lines, and invoices.
Inventory Movements
Get paginated inventory movements for a purchase order (via receipt lines).
FIFO Layers
Get paginated FIFO inventory layers created from receiving this purchase order.
List PO Invoices
Get paginated purchase invoices for a specific purchase order.
Preview Invoice
Generate an invoice PDF preview and return the URL path.
Create Bill
Create a landed cost bill linked to this purchase order.
Get Bill
Get a single bill linked to this purchase order. Returns 404 if the bill does not belong to this PO.
Update Bill
Update a bill linked to this purchase order. Returns 404 if the bill does not belong to this PO.
List PO Invoices
Get paginated purchase invoices for a specific purchase order.
Preview Invoice
Generate an invoice PDF preview and return the URL path.
Create Bill
Create a landed cost bill linked to this purchase order.
Get Bill
Get a single bill linked to this purchase order. Returns 404 if the bill does not belong to this PO.
Update Bill
Update a bill linked to this purchase order. Returns 404 if the bill does not belong to this PO.
Download Import Template
Download an XLSX import template with headers, sample data, field guide, and reference data.
Preview Import
Preview a purchase order import file before executing. Returns a grouped preview of what would be imported.
Validate Import
Validate mapped import rows and return a grouped preview with errors. No side effects — safe to call repeatedly.
Execute Import
Execute the purchase order import — create purchase orders from validated data.
Download Import Template
Download an XLSX import template with headers, sample data, field guide, and reference data.
Preview Import
Preview a purchase order import file before executing. Returns a grouped preview of what would be imported.
Validate Import
Validate mapped import rows and return a grouped preview with errors. No side effects — safe to call repeatedly.
Execute Import
Execute the purchase order import — create purchase orders from validated data.
Build PO (Forecast)
Build a suggested purchase order based on sales history or other forecast types.
Export Builder Results
Build a suggested purchase order and export the result as a CSV file.
Build PO (Forecast)
Build a suggested purchase order based on sales history or other forecast types.
Export Builder Results
Build a suggested purchase order and export the result as a CSV file.
Send ASN
Send an Advanced Shipment Notice (ASN) for this purchase order to the 3PL warehouse.
Dropship (Ship Fulfillment)
Create a dropship fulfillment for a dropship purchase order (ship directly to customer).
Send ASN
Send an Advanced Shipment Notice (ASN) for this purchase order to the 3PL warehouse.
Dropship (Ship Fulfillment)
Create a dropship fulfillment for a dropship purchase order (ship directly to customer).