references/cpq-salesforce-fields.json

{
  "$description": "Static fallback catalog of Zuora CPQ and Zuora Billing Salesforce object fields. Used by CPQ build/validate skills and lint-cpq-apex.js / lint-cpq-hooks-events.js when live SFDX describe is unavailable. Customer-specific custom fields outside zqu__/Zuora__ namespaces are not listed.",
  "$source": "references/cpq-patterns.md — Required Fields for renewQuote, Field Mapping Template, SOQL Query Requirements (snapshot 2026-Q1).",
  "$usage": {
    "lookup": "objects.<ObjectApiName>.fields[]",
    "requiredFor": "objects.<ObjectApiName>.requiredFor.<flow> — fields that must appear in SOQL SELECT before calling the flow API",
    "commonMistakes": "$common_mistakes — known hallucinated field names mapped to corrections",
    "linterRules": {
      "EAPEX050": "literal type incompatible with catalog field type",
      "EAPEX052": "known hallucinated field name ($common_mistakes)",
      "WAPEX050": "zqu__/Zuora__ field not in catalog",
      "WAPEX051": "renewQuote flow missing required SELECT fields",
      "WJS080": "Quote Studio patch/getQuoteField references unknown zqu__ field"
    }
  },
  "$common_mistakes": {
    "Zuora_ZuoraId__c": "Use Zuora__Zuora_Id__c",
    "Zuora_ZuoraID__c": "Use Zuora__Zuora_Id__c",
    "Zuora__ZuoraId__c": "Use Zuora__Zuora_Id__c",
    "zqu__BillingAccount__c": "Deprecated — use zqu__ZuoraAccountId__c",
    "zqu__SubscriptionId__c": "Use zqu__ExistSubscriptionID__c with the Zuora subscription Id, not the Salesforce record Id",
    "Quote__c": "Use zqu__Quote__c (managed package namespace prefix)"
  },
  "objects": {
    "zqu__Quote__c": {
      "fields": [
        { "name": "Id", "type": "id" },
        { "name": "Name", "type": "string" },
        { "name": "zqu__Account__c", "type": "reference" },
        { "name": "zqu__Opportunity__c", "type": "reference" },
        { "name": "zqu__Currency__c", "type": "picklist" },
        { "name": "zqu__ExistSubscriptionID__c", "type": "string" },
        { "name": "zqu__SubscriptionType__c", "type": "picklist" },
        { "name": "zqu__BillingEntity__c", "type": "reference" },
        { "name": "zqu__IsMSQ__c", "type": "boolean" },
        { "name": "zqu__SubscriptionTermEndDate__c", "type": "date" },
        { "name": "zqu__Amendment_Name__c", "type": "string" },
        { "name": "zqu__AmendmentName__c", "type": "string" },
        { "name": "zqu__RenewalTerm__c", "type": "decimal" },
        { "name": "zqu__StartDate__c", "type": "date" },
        { "name": "zqu__Status__c", "type": "picklist" },
        { "name": "zqu__Primary__c", "type": "boolean" },
        { "name": "zqu__ZuoraAccountId__c", "type": "string" },
        { "name": "zqu__InitialTerm__c", "type": "decimal" },
        { "name": "zqu__Hidden_Subscription_Name__c", "type": "string" },
        { "name": "zqu__SubscriptionVersion__c", "type": "decimal" },
        { "name": "zqu__SubscriptionTermStartDate__c", "type": "date" },
        { "name": "zqu__RenewalSubscriptionTermStartDate__c", "type": "date" },
        { "name": "zqu__Subscription_Term_Type__c", "type": "picklist" },
        { "name": "zqu__InitialTermPeriodType__c", "type": "picklist" },
        { "name": "zqu__RenewalSetting__c", "type": "picklist" },
        { "name": "zqu__BillToContact__c", "type": "string" },
        { "name": "zqu__SoldToContact__c", "type": "string" },
        { "name": "zqu__InvoiceOwnerId__c", "type": "string" },
        { "name": "zqu__BillingEntity__r.zqu__EntityID__c", "type": "string" }
      ],
      "requiredFor": {
        "renewQuote": [
          "Id",
          "zqu__Currency__c",
          "zqu__ExistSubscriptionID__c",
          "zqu__SubscriptionType__c",
          "zqu__BillingEntity__r.zqu__EntityID__c",
          "zqu__IsMSQ__c",
          "zqu__SubscriptionTermEndDate__c",
          "zqu__Amendment_Name__c",
          "zqu__AmendmentName__c",
          "zqu__RenewalTerm__c"
        ]
      }
    },
    "Zuora__Subscription__c": {
      "fields": [
        { "name": "Id", "type": "id" },
        { "name": "Name", "type": "string" },
        { "name": "Zuora__Zuora_Id__c", "type": "string" },
        { "name": "Zuora__RenewalTerm__c", "type": "decimal" },
        { "name": "Zuora__InitialTerm__c", "type": "string" },
        { "name": "Zuora__SubscriptionEndDate__c", "type": "date" },
        { "name": "Zuora__TermEndDate__c", "type": "date" },
        { "name": "Zuora__TermSettingType__c", "type": "picklist" },
        { "name": "Zuora__InitialTermPeriodType__c", "type": "picklist" },
        { "name": "Zuora__RenewalTermPeriodType__c", "type": "picklist" },
        { "name": "Zuora__Version__c", "type": "decimal" },
        { "name": "Zuora__NextRenewalDate__c", "type": "date" },
        { "name": "Zuora__CustomerAccount__c", "type": "reference" },
        { "name": "Zuora__InvoiceOwner__c", "type": "reference" },
        { "name": "Zuora__CustomerAccount__r.Zuora__Currency__c", "type": "picklist" },
        { "name": "Zuora__CustomerAccount__r.Zuora__Zuora_Id__c", "type": "string" },
        { "name": "Zuora__CustomerAccount__r.Zuora__AccountNumber__c", "type": "string" },
        { "name": "Zuora__CustomerAccount__r.Zuora__BillToContact__c", "type": "reference" },
        { "name": "Zuora__CustomerAccount__r.Zuora__SoldToContact__c", "type": "reference" },
        { "name": "Zuora__InvoiceOwner__r.Zuora__Zuora_Id__c", "type": "string" }
      ]
    },
    "Zuora__CustomerAccount__c": {
      "fields": [
        { "name": "Id", "type": "id" },
        { "name": "Zuora__Zuora_Id__c", "type": "string" },
        { "name": "Zuora__Currency__c", "type": "picklist" },
        { "name": "Zuora__AccountNumber__c", "type": "string" },
        { "name": "Zuora__BillToContact__c", "type": "reference" },
        { "name": "Zuora__SoldToContact__c", "type": "reference" },
        { "name": "Zuora__BillToContact__r.Zuora__External_Id__c", "type": "string" },
        { "name": "Zuora__SoldToContact__r.Zuora__External_Id__c", "type": "string" }
      ]
    },
    "zqu__QuoteAmendment__c": {
      "fields": [
        { "name": "Id", "type": "id" },
        { "name": "zqu__Quote__c", "type": "reference" },
        { "name": "zqu__Type__c", "type": "picklist" }
      ]
    }
  }
}