📄️ Get Purchase Orders
Returns a paginated list of Purchase Orders with optional filtering and sorting capabilities.
📄️ Get Purchase Order
Returns a single Purchase Order with all related data including line items with committed quantities. This eliminates the need for separate GET /{id}/products endpoint as line items are included in the response.
📄️ Get Purchase Order by Serial Number
Looks up the most recent committed V2 receipt item for a serial number and returns the associated purchase order ID.
📄️ Create Purchase Order
Creates a new Purchase Order with line items and shipping address. Supports both ticket-based and standalone line items. Returns the full created purchase order object including address details.
📄️ Update Purchase Order
Updates an existing Purchase Order. Only provided (non-null) fields are updated. Automatically updates ModifiedBy and ModifiedDate audit fields.
📄️ Approve Purchase Order
Approves a purchase order. Sets ApprovedBy and ApprovedDate fields and transitions status to 'Open'. Records status history for the transition.
📄️ Complete Purchase Order
Completes a purchase order. Sets CompletedBy and CompletedDate fields, auto-approves if not already approved, and transitions status to 'Completed'. Records status history for the transition.
📄️ Void Purchase Order
Voids a purchase order. Validates that no committed receipts exist, clears any staged (uncommitted) receipts, and transitions status to 'Void'. Records status history for the transition and notifies Inventory Management API.
📄️ Get Line Items
Returns all line items for the specified purchase order.
📄️ Add Line Item
Adds a new line item to an existing purchase order. Supports both ticket-based and standalone line items.
📄️ Update Line Item
Updates an existing line item's quantity, cost, or provider.
📄️ Bulk Update Line Items
Updates multiple line items in a single operation. More efficient than individual update calls.
📄️ Remove Line Item
Removes a line item from a purchase order. Cannot remove line items with committed receipt items.
📄️ Get Purchase Order Receipts
Returns all receipts (staged and committed) for a purchase order.
📄️ Stage Receipt
Creates a staged receipt. Serial number conflicts are validated and returned in the response. CRITICAL: Does NOT check InventoryManagementGeneration - all POs are eligible.
📄️ Commit Receipt
Commits a staged receipt, marking all items as committed and updating inventory.
📄️ Delete Staged Receipt
Deletes a staged (uncommitted) receipt. Cannot delete committed receipts.
📄️ Get Status History
Returns all status transitions for a purchase order, ordered by date descending (most recent first).
📄️ Get Purchase Order Statuses
Returns a list of all available Purchase Order Statuses.
📄️ Get Shipping Methods
Returns a list of Shipping Methods. Use the 'active' parameter to filter for active methods only.
📄️ Get Shipping Method
Returns a specific Shipping Method by its unique identifier. Returns 404 if not found.
📄️ Create Shipping Method
Creates one or more Shipping Methods. New Shipping Methods will be Active by default.
📄️ Update Shipping Method
Updates an existing Shipping Method. Returns 404 if not found.
📄️ Delete Shipping Method
Permanently removes a Shipping Method if it is not in use by any purchase orders. Returns detailed response about the operation result.
📄️ Get Ticket Parts Labor Summary
Returns ordered quantities, received (committed) quantities, and purchase order IDs for the specified ticket parts labor IDs. Excludes voided purchase orders.