upsertPurchaseOrder
Topics: Commerce
Create or update a purchase order. Requires purchaseOrder:write permission.
Examples
Create Commerce Purchase Order
mutation CreateCommercePurchaseOrder($input: UpsertPurchaseOrderInput!) {
upsertPurchaseOrder(input: $input) {
purchaseOrder { id poNumber status totalAmount currency }
errors { path message }
}
}Variables
{
"input": {
"poNumber": "PO-2042",
"supplierId": "sup_01h455vb4pex5vsknk084sn02q",
"orderDate": "2026-10-21T09:00:00.000Z",
"totalAmount": 500,
"currency": "EUR"
}
}Exact field SDL
"""
Create or update a purchase order. Requires purchaseOrder:write permission.
"""
upsertPurchaseOrder(
"""Purchase order data"""
input: UpsertPurchaseOrderInput!
): UpsertPurchaseOrderPayload! @topic(names: ["commerce"]) @topic_example(names: ["commerce.create-purchase-order"])Declared on Mutation. Access is checked by the platform for each operation.