Preventivo (Quote)

Rappresenta un preventivo / offerta commerciale: numero documento, stato, validità, totali (imponibile, imposte, sconti, totale), valuta, collegamenti a opportunità, contatto e account, righe con prodotto, quantità, prezzi, aliquota e totale riga, note libere. È il payload tipico per flussi che generano o aggiornano offerte tra CPQ, ERP e CRM.

Esempio JSON completo

{
  "id": "quo_5Yz8Ab1Cd4Ef7",
  "channel": "demoipaas",
  "createdAt": "2026-01-20T12:00:00+00:00",
  "updatedAt": "2026-01-27T09:30:00+00:00",
  "number": "Q-2026-0042",
  "status": "sent",
  "validUntil": "2026-02-28",
  "currency": "EUR",
  "subtotal": 9500,
  "taxTotal": 2090,
  "discountTotal": 500,
  "grandTotal": 11090,
  "opportunityId": "opp_3Xy8Za1Bc4De7",
  "contactId": "cnt_1Mn4Op7Qr0St3",
  "accountId": "acc_2Hj5Kl8Mn1Op4",
  "lineItems": [
    {
      "position": 1,
      "productId": "prd_ent_std",
      "description": "Abbonamento annuale standard",
      "quantity": 12,
      "unitPrice": 500,
      "taxRate": 22,
      "lineTotal": 6000
    },
    {
      "position": 2,
      "productId": "prd_addon_api",
      "description": "Add-on API premium",
      "quantity": 1,
      "unitPrice": 3500,
      "taxRate": 22,
      "lineTotal": 3500
    }
  ],
  "notes": "IVA al 22%; pagamento anticipato 30%"
}

Note

• I totali di testata devono essere coerenti con le righe e le regole fiscali del sistema di destinazione; alcuni connettori ricalcolano taxTotal e grandTotal lato server.
• number può essere assegnato dalla sorgente o generato dal CRM in creazione: evitare duplicati se la destinazione impone univocità.
• status (es. bozza, inviato, accettato) va allineato al vocabolario del connettore di uscita.