Skip to main content

supplyLinkPurchaseOrder

Records that a purchase order is the document a downstream system already holds under a given number, without writing anything to that system.

Authentication Requirements​

Requires the supply:record_external_identity permission for the company.

Business Rules​

  • The purchase order and the integration must both belong to the authenticated company
  • A downstream document backs one purchase order, and a purchase order carries one document per integration

Behavior​

Claims the link only. The purchase order becomes linked exactly as though it had been pushed, so a later push updates that document rather than creating a second one.

supplyLinkPurchaseOrder(
  input: SupplyLinkPurchaseOrderInput!
): PurchaseOrder

Arguments​

supplyLinkPurchaseOrder.input ● SupplyLinkPurchaseOrderInput! non-null input common​

Parameters for SupplyLinkPurchaseOrder

Type​

PurchaseOrder object purchase-orders​

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