← API reference
CANONICAL TYPE REFERENCE

PurchaseOrderState

A purchase order sent to a supplier

Unique identifier

poNumberString!

Purchase order number

Associated supplier ID

Delivery address ID

Current status

Order date (ISO8601)

Expected delivery date (ISO8601)

Date goods were received (ISO8601)

Subtotal before tax

taxAmountFloat!

Tax amount

Total amount including tax

Currency code

Associated job ID

notesString

Notes visible to supplier

Internal notes

User who created this PO

User who approved this PO

Approval timestamp (ISO8601)

createdAtString!

Creation timestamp (ISO8601)

updatedAtString!

Last update timestamp (ISO8601)

Supplier for this purchase order. Requires supplier:read permission.

Line items. Requires purchaseOrder:read permission.

User who created this PO. Requires user:read permission.

Document attachments. Requires file:list permission.

View exact SDL
"""A purchase order sent to a supplier"""
type PurchaseOrderState {
  """Unique identifier"""
  id: PurchaseOrderID!
  """Purchase order number"""
  poNumber: String!
  """Associated supplier ID"""
  supplierId: SupplierID!
  """Delivery address ID"""
  deliveryAddressId: AddressID
  """Current status"""
  status: PurchaseOrderStatus!
  """Order date (ISO8601)"""
  orderDate: ISO8601!
  """Expected delivery date (ISO8601)"""
  expectedDeliveryDate: ISO8601
  """Date goods were received (ISO8601)"""
  receivedAt: ISO8601
  """Subtotal before tax"""
  subtotalAmount: Float!
  """Tax amount"""
  taxAmount: Float!
  """Total amount including tax"""
  totalAmount: Float!
  """Currency code"""
  currency: CurrencyISO!
  """Associated job ID"""
  jobId: JobID
  """Notes visible to supplier"""
  notes: String
  """Internal notes"""
  internalNotes: String
  """User who created this PO"""
  createdByUserId: UserID
  """User who approved this PO"""
  approvedByUserId: UserID
  """Approval timestamp (ISO8601)"""
  approvedAt: ISO8601
  """Creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
  """Supplier for this purchase order. Requires supplier:read permission."""
  supplier: SupplierState
  """Line items. Requires purchaseOrder:read permission."""
  purchaseOrderLines: [PurchaseOrderLineState!]!
  """User who created this PO. Requires user:read permission."""
  createdByUser: UserState
  """Document attachments. Requires file:list permission."""
  attachments: [PurchaseOrderFileAttachment!]!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.