Skip to main content

supplyPurchaseOrder

Retrieves a single purchase order by its ID from the supply chain management system.

Authentication & Permissions​

Requires the supply:read_pos permission to execute this query. Access is restricted to purchase orders belonging to brands the authenticated user has access to.

Common Errors​

  • **Not Found Error**: Purchase order with the specified ID does not exist
  • **Permission Error**: Missing required supply:read_pos permission
  • **Access Error**: User does not have access to the brand associated with the purchase order
supplyPurchaseOrder(
  poId: ID!
): PurchaseOrder

Arguments​

supplyPurchaseOrder.poId ● ID! non-null scalar​

ID of the Purchase Order

Type​

PurchaseOrder object​

Represents a purchase order in the supply chain module.

Purchase orders are formal documents sent to suppliers to request materials, products, or services. They contain details about quantities, prices, delivery dates, and terms of the purchase agreement.

Core Information​

  • **PO Number**: Unique identifier for the purchase order
  • **Status Management**: Tracks financial status and cost allocation status
  • **Dates**: Issue date, expected dates, delivery dates, and payment due dates
  • **Terms**: Payment terms, Incoterms, and special instructions

Relationships​

Each purchase order is associated with a supplier, created by a party, and can be approved by another party. It contains multiple line items (POItems).

Status Tracking​

  • **Financial Status**: Tracks payment status (unpaid, partially paid, paid)
  • **Cost Allocation Status**: Tracks if costs are complete or incomplete
  • **Milestones**: Current milestone and status name for workflow tracking