The Used Car Dealership sector in the DecisioQ Decision Catalog is identified by AUTO-UCD. It currently covers 100 decision types across acquisition, appraisal, inventory, pricing, reconditioning, certification, warranty, compliance, digital retailing, F&I, customer sales, retention, market intelligence, and operational performance.

DecisioQ integrations should load sector, category, decision, Decision Preparation Model, and scenario metadata from the Decision Catalog. Do not hard-code old template names, static decision lists, or legacy request models.

Recommended first deployment: start with a workflow where managers already compare tradeoffs, such as acquisition bid guidance, reconditioning approval, pricing action, online lead response, CPO eligibility, finance exception, warranty package recommendation, or aging inventory disposition.

Used car dealership client applications should use the same discovery flow as the Business Decision Studio:

1. Load GET /decisioncatalog through the approved server-side Decision Catalog gateway.
2. Populate Sector from catalog.sectors[] and select AUTO-UCD for Used Car Dealership.
3. Populate Category from selectedSector.categories[]. Example categories include Certification & Warranty, Compliance & Risk, Customer Sales, Digital Retailing, Finance & Insurance, Inventory Analytics, Market Intelligence, Operational Performance, and Reconditioning.
4. Populate Decision from selectedCategory.decisions[] when available, or call /decisioncatalog/sectors/{sectorCode}/categories/{categoryCode}/decisions.
5. Display Decision Name only in the dropdown while keeping decisionId as the option value.
6. Load full decision detail from /decisioncatalog/decisions/{decisionId} before rendering Guided Data Collection.

Decision detail is the source of truth for criterion names, data guidance, scale, direction, profile options, scenarios, and overview metadata.

For regional deployments, keep DecisioQ technical identifiers stable and localize only user-facing labels and guidance. Unless the selected endpoint and decision schema explicitly support unit-qualified input, convert mileage, distance, pressure, temperature, mass, volume, speed, fuel consumption, and other measurements to the required canonical units before submission. Do not infer units or currency from locale.

Used car dealership integrations should map DMS, CRM, appraisal, inventory, reconditioning, pricing, F&I, vehicle history, merchandising, and customer data into decision-specific Business Data. The selected decision detail defines which criteria are required and how each value should be measured.

Do not invent criterion IDs. Use the canonical criteria returned by /decisioncatalog/decisions/{decisionId}, including criterion overview metadata, unit, direction, scale, and data guidance.

Production integrations should keep credentials and bearer tokens on trusted servers or server-side gateways. Browser pages should use same-origin proxy handlers or their own backend service.

1. Trusted backend obtains a JWT token from identity.vinquery.com.
2. Application loads catalog and decision detail metadata.
3. User or system prepares Business Data for candidate vehicles, bids, recon actions, price actions, leads, finance paths, warranty outcomes, or growth initiatives.
4. Call POST /api/v1/validate to validate and prepare the decision input before execution.
5. Call POST /api/v1/decide to return the authoritative Decision Result.
6. Display the recommendation, ranked alternatives, warnings, assumptions, and Explanation of Decision Result.
7. Keep execution trace and diagnostics available to integrators, but collapsed or hidden by default for business users.

Use /api/v1/decide for both Prepared Criteria Mode and business-data integrations that submit a businessData object. New public onboarding should prefer Preview Decision and Execute Decision terminology.

The exact fields depend on the Decision Preparation Model published for the selected decision. Treat this as an integration pattern, not as a guaranteed schema for every dealership decision.

{
  "decisionId": "AUTO-UCD-001",
  "decisionPreparationModelId": "AUTO-UCD-PROFILE-STANDARD",
  "scenarioId": "AUTO-UCD-SCENARIO-ACQUISITION-REVIEW",
  "businessData": {
    "candidates": [
      {
        "optionId": "VIN-1HGCV1F3XNA104912",
        "name": "2022 Honda Accord EX trade appraisal",
        "values": {
          "marketDemandScore": 86,
          "conditionScore": 82,
          "reconditioningCost": 1450,
          "grossPotentialScore": 78,
          "inventoryFitScore": 91,
          "agingRiskScore": 28
        }
      },
      {
        "optionId": "VIN-5NMS3DAJ4NH303881",
        "name": "2022 Hyundai Santa Fe auction purchase",
        "values": {
          "marketDemandScore": 79,
          "conditionScore": 76,
          "reconditioningCost": 2100,
          "grossPotentialScore": 84,
          "inventoryFitScore": 74,
          "agingRiskScore": 42
        }
      }
    ]
  },
  "requestContext": {
    "correlationId": "used-car-acquisition-20260717-001"
  }
}

This pattern belongs in a trusted backend, not directly in browser JavaScript.

async function executeUsedCarDealershipDecision(decisionInput, jwtToken) {
  const response = await fetch(`${process.env.DECISIOQ_BASE_URL}/api/v1/decide`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${jwtToken}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(decisionInput)
  });

  if (!response.ok) {
    throw new Error(`DecisioQ execution failed: ${response.status} ${await response.text()}`);
  }

  return await response.json();
}

• Store identity credentials, Decision API base URL, and proxy configuration in trusted server configuration or a secret manager.
• Do not expose bearer tokens or integration credentials in browser code, appraisal tools, or public digital retail experiences.
• Use catalog metadata rather than hard-coded categories, decisions, criteria, profiles, or scenarios.
• Validate Business Data before execution and show user-friendly validation messages.
• Persist correlation ID, VIN, stock number, appraisal ID, deal ID, lead ID, repair order ID, decision ID, profile ID, scenario ID, selected option, score, and explanation for audit.
• Retain the successful decision response requestId with the host business transaction, then call POST /api/v1/decision-outcomes when the action and realized result are known.
• Require an overrideReason for overridden recommendations; never infer acceptance merely because a result was displayed.
• Monitor GET /api/v1/decision-outcomes/summary for acceptance rate, override rate, and realized-value aggregates. Treat outcome feedback as reporting evidence, not automatic model training.
• Redact customer identifiers, credit-sensitive fields, lender details, vehicle-history details, margin data, and sensitive recon notes in logs and diagnostics.
• Monitor catalog load failures, token refresh failures, API latency, validation failures, account verification failures, and unusual exclusion rates.
• Define fallback behavior so appraisal, inventory, CRM, reconditioning, sales desk, and F&I workflows remain usable when DecisioQ is unavailable.
• Review Decision Preparation Models and scenario assumptions with used car, inventory, recon, compliance, and finance owners when market or policy conditions change.