Opportunità (Opportunity)

Rappresenta un’opportunità di vendita: trattativa con importo stimato, fase (stage), probabilità di chiusura, data prevista (expectedCloseDate), collegamenti opzionali a lead e account, proprietario (ownerId) e righe commerciali (lineItems) con SKU, quantità e sconti. Si usa nei flussi che sincronizzano pipeline, forecast o ordini commerciali tra ERP e CRM.

Esempio JSON completo

{
  "id": "opp_3Xy8Za1Bc4De7",
  "channel": "demoipaas",
  "createdAt": "2026-01-15T11:30:00+00:00",
  "updatedAt": "2026-02-01T16:45:00+00:00",
  "name": "Licenza enterprise — Acme SpA",
  "stage": "proposal",
  "probability": 60,
  "amount": 45000,
  "currency": "EUR",
  "expectedCloseDate": "2026-03-31",
  "leadId": "lead_7aBc2DeF9Gh0",
  "accountId": "acc_2Hj5Kl8Mn1Op4",
  "ownerId": "usr_4Km9NpQr2St5",
  "lostReason": null,
  "tags": ["renewal-risk"],
  "lineItems": [
    {
      "sku": "ENT-LICENSE-100",
      "description": "Licenza piattaforma 100 utenti",
      "quantity": 1,
      "unitPrice": 35000,
      "discountPercent": 5
    },
    {
      "sku": "SVC-IMPL",
      "description": "Servizio implementazione",
      "quantity": 1,
      "unitPrice": 10000,
      "discountPercent": 0
    }
  ]
}

Note

• amount può essere derivato dalle righe o impostato a livello opportunità a seconda del connettore; allineare la logica di calcolo alla destinazione.
• stage e probability devono essere mappati sulle fasi del CRM di destinazione per evitare stati non riconosciuti.
• lostReason è valorizzato quando l’opportunità è persa; può essere omesso o null nelle fasi aperte.