Auto Insurance Integration Manual
Developer guidance for integrating DecisioQ Auto Insurance decisions with claims, underwriting, repair, fraud, mobility, compliance, analytics, and customer service platforms.The Auto Insurance sector in the DecisioQ Decision Catalog is identified by AUTO-INS. It supports decision support for claims, underwriting, repair approvals, risk scoring, compliance, analytics, and customer service operations across automotive insurance workflows.
DecisioQ integrations should load sector, category, decision, Decision Preparation Model, and scenario metadata from the Decision Catalog. Do not hard-code legacy template names or old decision payload structures.
Recommended first deployment: start with a high-volume advisory workflow such as claim intake prioritization, adjuster assignment, rental extension approval, or coverage validation. Compare DecisioQ recommendations against existing claim handling decisions before automating downstream actions.
Auto Insurance client applications should use the same discovery flow as the Business Decision Studio:
- Load
GET /decisioncatalogthrough the approved server-side Decision Catalog gateway. - Populate Sector from
catalog.sectors[]and selectAUTO-INSfor Auto Insurance. - Populate Category from
selectedSector.categories[]. Example categories include Claims Intake & Triage, Coverage & Liability, Customer Mobility, Compliance & Regulatory, and Analytics & Reporting. - Populate Decision from
selectedCategory.decisions[]when available, or call/decisioncatalog/sectors/{sectorCode}/categories/{categoryCode}/decisions. - Display Decision Name only in the dropdown while keeping
decisionIdas the option value. - 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.
| Use Case | Primary Users | Typical Inputs |
|---|---|---|
| Claim intake and triage | Claims operations, adjusters, service teams | Claim severity, coverage confidence, customer impact, SLA urgency, complexity, fraud risk. |
| Adjuster and appraisal assignment | Claims managers, appraisal coordinators | Workload, expertise, location, claim severity, vehicle type, response deadline. |
| Coverage and liability review | Adjusters, coverage specialists, legal reviewers | Policy status, deductible terms, loss facts, evidence quality, liability indicators, injury exposure. |
| Rental and mobility approval | Claims teams, mobility teams, partner repair networks | Coverage entitlement, repair duration, replacement need, cost exposure, customer impact. |
| Compliance and regulatory prioritization | Compliance teams, claims leadership | Filing deadlines, complaint severity, jurisdiction, exposure, exception risk, audit history. |
| Analytics and portfolio prioritization | Analytics leaders, product managers, operations executives | Business value, data readiness, adoption effort, operational risk, monitoring value. |
| Special investigation triage | SIU, claims quality, fraud analysts | Anomaly signals, prior history, evidence quality, financial exposure, repair pattern, policy timing. |
Auto Insurance integrations should map operational claim, policy, customer, vehicle, repair, and service data into decision-specific Business Data. The selected decision detail defines which criteria are required and how each value should be measured.
| Business Data Source | Common Use | Integration Notes |
|---|---|---|
| Claim, policy, vehicle, customer, or repair order ID | optionId and audit correlation. | Keep stable IDs. Business users may edit option IDs in demos, but production systems should preserve source-system identifiers. |
| Policy coverage and deductible terms | Coverage validation, rental approval, liability and reserve decisions. | Use normalized values and ensure policy effective dates match the loss date. |
| Claim severity and estimated loss | Intake prioritization, reserve review, appraisal routing. | Keep amount units consistent and avoid mixing estimated and approved amounts. |
| Evidence, police report, witness, and liability indicators | Liability position and coverage exception review. | Distinguish missing evidence from evidence that is negative or conflicting. |
| Repair duration and rental need | Rental approval, extension, and mobility decisions. | Use current repair estimate dates and update the decision if repair status changes materially. |
| Adjuster capacity, skill, territory, and workload | Assignment and routing decisions. | Refresh capacity data before execution to avoid stale workload recommendations. |
| Customer impact and SLA urgency | Priority and service escalation decisions. | Separate business urgency from customer sentiment when the decision model expects distinct criteria. |
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.
- Trusted backend obtains a JWT token from
identity.vinquery.com. - Application loads catalog and decision detail metadata.
- User or system prepares Business Data for candidate claims, policies, repair cases, or operational actions.
- Call
POST /api/v1/validateto validate and prepare the decision input before execution. - Call
POST /api/v1/decideto return the authoritative Decision Result. - Display the recommendation, ranked alternatives, warnings, assumptions, and Explanation of Decision Result.
- 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 selected Auto Insurance decision. The example below shows the integration style rather than a guaranteed schema for every decision.
{
"decisionId": "AUTO-INS-011",
"decisionPreparationModelId": "AUTO-INS-PROFILE-STANDARD",
"scenarioId": "AUTO-INS-SCENARIO-CLAIMS-TRIAGE",
"businessData": {
"candidates": [
{
"optionId": "CLAIM-78421",
"name": "2019 Honda Civic rear-end collision",
"values": {
"claimSeverityScore": 82,
"coverageConfidenceScore": 94,
"customerImpactScore": 76,
"slaUrgencyScore": 88,
"fraudRiskScore": 18,
"estimatedLossAmount": 7400
}
},
{
"optionId": "CLAIM-78433",
"name": "2022 Ford F-150 hail damage",
"values": {
"claimSeverityScore": 61,
"coverageConfidenceScore": 89,
"customerImpactScore": 58,
"slaUrgencyScore": 64,
"fraudRiskScore": 12,
"estimatedLossAmount": 5200
}
}
]
},
"requestContext": {
"correlationId": "claims-workbench-20260717-001"
}
}
This pattern belongs in a trusted backend, not directly in browser JavaScript.
async function executeAutoInsuranceDecision(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();
}
| UI Element | Recommended Display | Why It Matters |
|---|---|---|
| Choose a Decision | Sector, Category, Decision, Profile, and Scenario selectors populated from catalog metadata. | Users see business names while integrators retain stable IDs. |
| Selection Overview | Sector, category, and decision overviews in one collapsible panel. | Claims and operations users understand the decision before entering data. |
| Guided Data Collection | Criterion label, field, data type indicator, summary, and expandable "More about this criterion". | Improves claim data quality and reduces inconsistent intake. |
| Candidate Cases | Two fields per row where practical, editable option ID, and visible units or data type indicators. | Claims teams can compare cases quickly without feeling like they are using an API tool. |
| Decision Result | Recommendation, ranking, confidence, and key drivers. | Users need the answer and the reason. |
| Outcome Follow-up | Accepted, Rejected, or Overridden; selected option and override reason when applicable. | Connects the recommendation to the action actually taken. |
| Realized Value | Outcome status plus a consistently defined financial or operational metric. | Measures adoption and business value without changing deterministic scoring. |
| Explanation | Business-friendly explanation without AI provider branding. | Supports trust while keeping the UI provider-neutral. |
| Diagnostics | Collapsed technical panel for status, timings, warnings, and errors. | Useful for integrators without distracting business users. |
- 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.
- 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, claim ID, policy ID, decision ID, profile ID, scenario ID, selected option, score, and explanation for audit.
- Retain the successful decision response
requestIdwith the host business transaction, then callPOST /api/v1/decision-outcomeswhen the action and realized result are known. - Require an
overrideReasonfor overridden recommendations; never infer acceptance merely because a result was displayed. - Monitor
GET /api/v1/decision-outcomes/summaryfor acceptance rate, override rate, and realized-value aggregates. Treat outcome feedback as reporting evidence, not automatic model training. - Redact claim notes, customer identifiers, policy details, medical details, and payment data 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 claims workflows remain usable when DecisioQ is unavailable.
- Review Decision Preparation Models and scenario assumptions with claims, compliance, and product owners when policy rules or regulatory requirements change.
| Symptom | Likely Cause | Fix |
|---|---|---|
| Category list is empty. | The catalog response does not include categories for the selected sector, or the client is reading an old category layer. | Use selectedSector.categories[] from /decisioncatalog. |
| Decision dropdown shows IDs only. | The client did not load decision detail or category decision names. | Display Decision Name as the label and keep decision ID as the option value. |
| Criterion guidance is missing. | Decision detail lacks criterion overview metadata or the page is not rendering it. | Read criterion overview from /decisioncatalog/decisions/{decisionId} and show available summaries. |
| Secure session could not be refreshed. | Token proxy or identity service configuration failed. | Check server-side identity configuration and proxy logs; do not request tokens directly from browser JavaScript. |
| Decision execution failed. | Decision API unavailable, invalid Business Data, authorization failure, or account verification issue. | Check response envelope, HTTP status, correlation ID, Decision API health, and server logs. |
| Unexpected recommendation. | Scale, units, direction, or values do not match catalog criterion guidance. | Compare Business Data fields against criterion overview and validation metadata. |
| Recommendation conflicts with policy rules. | The selected scenario or Decision Preparation Model may not match the product, jurisdiction, or claim type. | Review scenario assumptions and profile metadata before execution. |
