Ordine d'acquisto (Purchase order)

Rappresenta un ordine d'acquisto verso fornitore: numero, stato, date ordine e consegna attesa, fornitore (vendorId), eventuale riferimento offerta fornitore (vendorReference), magazzino di destinazione (shipToWarehouseId), righe con quantità ordinata e ricevuta, prezzi, aliquote, totali e condizioni di pagamento. È il payload tipico per flussi di approvvigionamento, MRP e ricezione merce in ERP.

Esempio JSON completo

{
  "id": "po_3Bc6De9Fg2Hi5",
  "channel": "demoipaas",
  "createdAt": "2026-01-09T09:00:00+00:00",
  "updatedAt": "2026-01-11T11:45:00+00:00",
  "number": "PO-2026-0045",
  "status": "approved",
  "orderDate": "2026-01-09",
  "expectedReceiptDate": "2026-02-05",
  "vendorId": "vend_SUPPLIER_XYZ",
  "vendorReference": "QT-77881",
  "currency": "EUR",
  "shipToWarehouseId": "wh_MIL01",
  "lineItems": [
    {
      "position": 10,
      "itemId": "itm_RAW_STEEL_COIL",
      "description": "Bobina acciaio 2t",
      "quantityOrdered": 5,
      "quantityReceived": 0,
      "unitPrice": 820,
      "taxRate": 22,
      "lineTotal": 4100
    }
  ],
  "subtotal": 4100,
  "taxTotal": 902,
  "grandTotal": 5002,
  "paymentTerms": "Net 45",
  "notes": null
}

Note

• quantityReceived si aggiorna con le ricezioni merce; in creazione è spesso zero.
• status (es. bozza, approvato, chiuso) va mappato sul ciclo di vita dell’ERP collegato.
• Indirizzi di spedizione multipli possono richiedere campi aggiuntivi oltre a shipToWarehouseId a seconda del connettore.