Sales order

Represents a sales order: commercial commitment to a customer with number, status, order and requested ship dates, customer, optional customer PO (customerPurchaseOrder), fulfillment warehouse (warehouseId), lines with ordered/shipped quantities, prices, discounts, tax, and totals. Core payload for order-to-cash flows into ERP, WMS, and downstream documents (delivery note, invoice).

Full JSON example

{
  "id": "so_8Km2Np5Qr8St1",
  "channel": "demoipaas",
  "createdAt": "2026-01-08T07:30:00+00:00",
  "updatedAt": "2026-01-22T15:10:00+00:00",
  "number": "SO-2026-0118",
  "status": "confirmed",
  "orderDate": "2026-01-08",
  "requestedShipDate": "2026-01-25",
  "customerId": "cust_4Fx7Gy0Hz3Ja6",
  "customerPurchaseOrder": "PO-ACME-8842",
  "currency": "EUR",
  "warehouseId": "wh_MIL01",
  "lineItems": [
    {
      "position": 10,
      "itemId": "itm_WIDGET_A",
      "description": "Widget mod. A — conf. 24 pz",
      "quantityOrdered": 48,
      "quantityShipped": 0,
      "unitPrice": 12.5,
      "discountPercent": 0,
      "taxRate": 22,
      "lineTotal": 600
    },
    {
      "position": 20,
      "itemId": "itm_SERVICE_SETUP",
      "description": "Setup on-site",
      "quantityOrdered": 1,
      "quantityShipped": 0,
      "unitPrice": 350,
      "discountPercent": 10,
      "taxRate": 22,
      "lineTotal": 315
    }
  ],
  "subtotal": 915,
  "taxTotal": 201.3,
  "grandTotal": 1116.3,
  "notes": "Consegna solo giorni feriali"
}

Remarkable notes

• quantityShipped updates when delivery notes are posted; it is often zero when the order is first created.
• Confirm whether the destination ERP expects tax-inclusive or exclusive pricing and how line vs header rounding is handled.
• Sample ids (id, customerId, itemId) are illustrative—align with the connected system’s master data.