PurchaseOrder

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

type PurchaseOrder {
  approvedBy: Party
  approvedById: ID
  attachments: [File!]
  brand: Brand!
  brandId: ID!
  cancelable: Boolean!
  closedAt: ISO8601DateTime
  confirmedDate: ISO8601DateTime
  contact: SupplySupplierContact
  contactId: ID
  costAllocationStatus: POCostAllocationStatusEnum
  countLines: Int
  countUnits: BigDecimal
  createdAt: ISO8601DateTime!
  createdBy: Party!
  createdById: ID!
  currentMilestone: POMilestone
  deleteable: Boolean!
  deletedAt: ISO8601DateTime
  deliveredDate: ISO8601DateTime
  expectedCompleteDate: ISO8601DateTime
  expectedDate: ISO8601DateTime
  financialStatus: POFinancialStatusEnum
  id: ID!
  incoterms: SupplyIncoterms
  issueDate: ISO8601DateTime
  milestoneName: POMilestoneEnum
  milestones: [POMilestone!]!
  nextMilestone: POMilestone
  paymentDueDate: ISO8601DateTime
  paymentTerms: String
  poItems: [POItem!]!
  poNumber: String!
  prodCompleteDate: ISO8601DateTime
  shipDate: ISO8601DateTime
  specialInstructions: String
  statusName: POStatusEnum
  supplier: SupplySupplier
  supplierId: ID
  totalExpectedDays: Int
  totalPayments: MonetaryValue
  totalProductCost: MonetaryValue
  updatedAt: ISO8601DateTime!
}

Fields

PurchaseOrder.approvedBy ● Party object

Party who approved this purchase order

PurchaseOrder.approvedById ● ID scalar

ID of the party who approved this purchase order

PurchaseOrder.attachments ● [File!] list object

Attachments associated with this purchase order

PurchaseOrder.brand ● Brand! non-null object

Brand associated with this purchase order

PurchaseOrder.brandId ● ID! non-null scalar

PurchaseOrder.cancelable ● Boolean! non-null scalar

Indicates if the purchase order can be canceled

PurchaseOrder.closedAt ● ISO8601DateTime scalar

Date when the purchase order was closed

PurchaseOrder.confirmedDate ● ISO8601DateTime scalar

Date when the purchase order was confirmed

PurchaseOrder.contact ● SupplySupplierContact object

Contact person at the supplier

PurchaseOrder.contactId ● ID scalar

PurchaseOrder.costAllocationStatus ● POCostAllocationStatusEnum enum

Cost allocation status of the purchase order

PurchaseOrder.countLines ● Int scalar

Number of line items in this purchase order

PurchaseOrder.countUnits ● BigDecimal scalar

Total number of units across all line items

PurchaseOrder.createdAt ● ISO8601DateTime! non-null scalar

Creation timestamp

PurchaseOrder.createdBy ● Party! non-null object

Party who created this purchase order

PurchaseOrder.createdById ● ID! non-null scalar

ID of the party who created this purchase order

PurchaseOrder.currentMilestone ● POMilestone object

Current milestone in the purchase order workflow

PurchaseOrder.deleteable ● Boolean! non-null scalar

Indicates if the purchase order can be deleted

PurchaseOrder.deletedAt ● ISO8601DateTime scalar

Soft deletion timestamp

PurchaseOrder.deliveredDate ● ISO8601DateTime scalar

Date when the order was delivered

PurchaseOrder.expectedCompleteDate ● ISO8601DateTime scalar

Expected completion date

PurchaseOrder.expectedDate ● ISO8601DateTime scalar

Expected delivery date

PurchaseOrder.financialStatus ● POFinancialStatusEnum enum

Financial status of the purchase order

PurchaseOrder.id ● ID! non-null scalar

Unique identifier for the purchase order

PurchaseOrder.incoterms ● SupplyIncoterms object

International Commercial Terms (Incoterms) for this purchase order

PurchaseOrder.issueDate ● ISO8601DateTime scalar

Date when the purchase order was issued

PurchaseOrder.milestoneName ● POMilestoneEnum enum

Current milestone name in the purchase order workflow

PurchaseOrder.milestones ● [POMilestone!]! non-null object

Milestones associated with this purchase order

PurchaseOrder.nextMilestone ● POMilestone object

Next milestone in the purchase order workflow

PurchaseOrder.paymentDueDate ● ISO8601DateTime scalar

Date when payment is due

PurchaseOrder.paymentTerms ● String scalar

Payment terms for this purchase order

PurchaseOrder.poItems ● [POItem!]! non-null object

Purchase order line items

PurchaseOrder.poNumber ● String! non-null scalar

Purchase order number

PurchaseOrder.prodCompleteDate ● ISO8601DateTime scalar

Production completion date

PurchaseOrder.shipDate ● ISO8601DateTime scalar

Date when the order was shipped

PurchaseOrder.specialInstructions ● String scalar

Special instructions or notes for this purchase order

PurchaseOrder.statusName ● POStatusEnum enum

Current status name of the purchase order

PurchaseOrder.supplier ● SupplySupplier object

Supplier associated with this purchase order

PurchaseOrder.supplierId ● ID scalar

PurchaseOrder.totalExpectedDays ● Int scalar

Total expected days from issue to expected completion date

PurchaseOrder.totalPayments ● MonetaryValue object

PurchaseOrder.totalProductCost ● MonetaryValue object

PurchaseOrder.updatedAt ● ISO8601DateTime! non-null scalar

Last update timestamp

Returned By

supplyCreatePurchaseOrder mutation ● supplyPurchaseOrder query ● supplyUpdatePurchaseOrder mutation

Member Of

PONote object ● PurchaseOrderConnection object ● PurchaseOrderEdge object ● SupplyShipment object