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
Delete multiple Shopify products from the local database (does not delete in Shopify).
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
Exports all purchase orders as a CSV file.
Get Purchase Order
Get a single QBO purchase order by ID.
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 multiple RMAs. Returns success and failed counts.
Bulk Submit
Bulk submit (send to supplier) purchase orders.
Bulk Archive
Archive multiple Shopify products by their IDs.
Bulk Unarchive
Bulk unarchive multiple stock takes.
Check Deletable
Check which nominal codes can be deleted. A code cannot be deleted if it is linked to sales order lines or used in nominal code mapping settings.
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
Generates (or regenerates) the accounting transaction for this bill. Uses the bill's nominal codes and totals to create journal entries.
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 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 stock take lines from a previously uploaded CSV file. The CSV must have columns: sku or id (product identifier), and optionally qty_counted, snapshot_inventory, unit_cost.
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 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
Returns paginated notes for a supplier product, most recent first.
Add Note
Adds a note to a sales credit.
Toggle Note Pin
Toggle the pinned state of a note on a purchase order.
Delete Note
Deletes a note.
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
Generates a PDF invoice preview for the sales credit and returns the URL to the generated file.
Create Bill
Creates a standalone bill. Note: This endpoint is currently not used in practice — bills are typically created via purchase order or warehouse transfer nested routes.
Get Bill
Returns a bill with its vendor, lines, allocations, and related purchase order / warehouse transfer data.
Update Bill
Updates an existing bill's header data and allocations.
Download Import Template
Download the CSV import template for COGS bulk import. Headers: layer_id, cogs.
Preview Import
Previews an import file for financial alerts before committing. Returns a summary of what will be imported and any errors.
Validate Import
Validate mapped import data and return a preview. No data is created — safe to call repeatedly for client-side validation before executing the actual import.
Execute Import
Execute the product import — creates products from the validated data. Should be called after validate.
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).