{
  "title": "Salesforce Sales Cloud Opportunity Structure",
  "description": "Structural documentation for the Salesforce Opportunity sObject — the core deal tracking record.",
  "resource": "Opportunity",
  "baseUri": "https://{instance}.salesforce.com/services/data/v59.0/sobjects/Opportunity",
  "fields": [
    {
      "name": "Id",
      "type": "string",
      "required": true,
      "description": "Unique Salesforce record ID",
      "example": "006xx000003GYkJAAW"
    },
    {
      "name": "Name",
      "type": "string",
      "required": true,
      "description": "Name of the opportunity/deal",
      "example": "Acme Corp - Enterprise License Renewal 2024"
    },
    {
      "name": "AccountId",
      "type": "string",
      "required": false,
      "description": "Salesforce ID of the associated Account",
      "example": "001xx000003GYkJAAW"
    },
    {
      "name": "Amount",
      "type": "number",
      "required": false,
      "description": "Opportunity value in the default currency",
      "example": 125000
    },
    {
      "name": "CloseDate",
      "type": "date",
      "required": true,
      "description": "Expected or actual close date (ISO 8601)",
      "example": "2024-12-31"
    },
    {
      "name": "StageName",
      "type": "string",
      "required": true,
      "description": "Current stage in the sales pipeline",
      "example": "Proposal/Price Quote"
    },
    {
      "name": "Probability",
      "type": "number",
      "required": false,
      "description": "Likelihood of closing (0-100%)",
      "example": 75
    },
    {
      "name": "Type",
      "type": "string",
      "required": false,
      "description": "Type of opportunity",
      "example": "New Business"
    },
    {
      "name": "LeadSource",
      "type": "string",
      "required": false,
      "description": "Origin of the opportunity",
      "example": "Web"
    },
    {
      "name": "ForecastCategoryName",
      "type": "string",
      "required": false,
      "description": "Forecast category for pipeline reporting",
      "example": "Commit"
    },
    {
      "name": "OwnerId",
      "type": "string",
      "required": false,
      "description": "Salesforce ID of the opportunity owner",
      "example": "005xx000001gN1aAAE"
    },
    {
      "name": "IsClosed",
      "type": "boolean",
      "required": false,
      "description": "Whether the opportunity is in a closed stage",
      "example": false
    },
    {
      "name": "IsWon",
      "type": "boolean",
      "required": false,
      "description": "Whether the opportunity was won",
      "example": false
    },
    {
      "name": "CreatedDate",
      "type": "datetime",
      "required": false,
      "description": "ISO 8601 creation timestamp",
      "example": "2024-03-01T09:00:00.000Z"
    }
  ],
  "pipelineStages": [
    "Prospecting",
    "Qualification",
    "Needs Analysis",
    "Value Proposition",
    "Id. Decision Makers",
    "Perception Analysis",
    "Proposal/Price Quote",
    "Negotiation/Review",
    "Closed Won",
    "Closed Lost"
  ]
}