Opportunity

Represents a sales opportunity: a deal with an estimated amount, pipeline stage (stage), win probability, expected close date, optional links to a lead and account, owner (ownerId), and commercial lines (lineItems) with SKU, quantity, and discounts. Used in flows that sync pipeline, forecasting, or commercial orders between ERP and CRM.

Full JSON example

{
  "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
    }
  ]
}

Remarkable notes

• amount may be rolled up from lines or set at opportunity level depending on the connector; align calculation logic with the destination.
• stage and probability should map to the destination CRM stages to avoid unknown states.
• lostReason is populated when the opportunity is lost; it may be omitted or null while open.