ACP FoundationAutomotive Commerce Protocolacpspec.org · Apache 2.0 · v1.0.0

Automotive Commerce Protocol

The open successor to ADF-XML — built for real-world automotive commerce.

A JSON-native protocol modeling the full transaction lifecycle, from first conversation through negotiation, financing, delivery, and post-sale events.

Open Specification
Apache 2.0 Licensed
ADF-XML Compatible
Vendor-Neutral Governance
Idempotent & Replay-Safe

From ADF-XML to ACP — how automotive commerce data evolves into a structured, lifecycle-aware protocol.

ADF-XML was built for forms.
ACP is built for commerce.

ADF-XML served the industry for two decades. ACP extends that foundation with the data structures modern automotive commerce requires.

ADF-XML 1.0

  • No transaction state modeling
  • No event lifecycle
  • No structured error handling
  • No conversation support
  • No intent or behavioral signals
  • No deal progression or offer history
  • XML-only transport
  • 8–15 data points per lead

ACP 1.0

  • Full transaction lifecycle with 8 stages
  • Typed event stream with payloads
  • Structured errors, idempotency, replay protection
  • Full conversation transcript with roles
  • 12 standard intent types with confidence scores
  • Offer history with revision tracking
  • JSON-native with deterministic ADF conversion
  • 100–200+ data points per envelope

Eight top-level objects

Every ACP envelope is a self-contained commerce document with a defined structure.

acp
Protocol version, envelope ID (idempotency key), generation timestamp, optional parent reference for deltas.
Required
source
Originating platform, agent type, channel, session, device, UTM attribution.
Required
dealership
Receiving dealership identity, CRM provider, DMS provider, timezone.
Required
lead
Customer contact, vehicle interests, budget, trade-in, detected intents, optional scoring.
Required
transaction
Commerce state: lifecycle stage, offer history, finance terms, appointment, delivery confirmation.
Required
conversation
Full transcript with message roles, timestamps, handoff state, sentiment, topics.
Required
events
Chronological behavioral event stream. 18 standard types plus vendor extensions.
Required
ai_analysis
Purchase probability, recommended actions, objections, engagement level. Explicitly optional.
Optional

Transaction stage model

Eight stages model the full deal lifecycle. Stage progression is non-linear and represents snapshot state at time of transmission.

inquiry
qualified
negotiation
finance
appointment
sold
delivered
|
closed_lost

Receivers MUST NOT assume linear progression. Stages may be skipped, repeated, or reversed. The closed_lost stage is terminal — a new transaction should be created if the customer re-engages.

Snapshots and deltas

ACP envelopes are full state snapshots by default. Event-only delta envelopes are supported for real-time streaming.

Transmission flow
Snapshot
Delta
Delta
Delta
Final Snapshot

Delta envelopes contain only acp + events and reference a parent via parent_envelope_id. The JSON Schema enforces this: if parent_envelope_id is present, no other top-level objects are permitted.

Full Snapshot DEFAULT
{
  "acp": {
    "version": "1.0.0",
    "protocol": "acp",
    "envelope_id": "acp_1739456200_x8k2"
  },
  "source": { ... },
  "dealership": { ... },
  "lead": {
    "id": "lead_1739456200",
    "status": "qualified",
    "score": 82
  },
  "transaction": {
    "id": "txn_1739456200_m4k8",
    "stage": "negotiation",
    "offer_history": [ ... ]
  },
  "conversation": { ... },
  "events": [ ... ],
  "ai_analysis": { ... }
}
Delta Envelope STREAMING
{
  "acp": {
    "version": "1.0.0",
    "protocol": "acp",
    "envelope_id": "acp_1739456338_d01",
    "parent_envelope_id": "acp_1739456200_x8k2"
  },
  "events": [
    {
      "type": "intent_detected",
      "timestamp": "2025-02-13T15:32:18Z",
      "data": {
        "type": "TEST_DRIVE",
        "confidence": 0.97
      }
    }
  ]
}

Three-phase migration from ADF-XML

ACP is designed for incremental adoption. Existing ADF-XML workflows continue to function throughout the migration.

Phase 1
Dual Output
Generate ACP envelopes alongside ADF-XML. CRM continues consuming ADF-XML. ACP envelopes stored for validation and analysis.
Phase 2
ACP Primary
CRM switches to ACP as primary format. ADF-XML continues as fallback for downstream systems. CRM leverages intents, scoring, and transaction state.
Phase 3
ACP Only
ADF-XML output deprecated. Deterministic converter retained for emergency backward compatibility. Full ACP envelope is the sole exchange format.

Active implementations

ACP is in active production use. The following platforms produce or consume ACP envelopes.

Producer
AutomotiveAI
AI sales agent platform generating ACP envelopes from live customer conversations across chat, voice, and SMS channels.
Production
Consumer
DriveVex CRM
Native ACP ingestion with full envelope storage, intent-based routing, transaction state mapping, and ADF-XML fallback generation.
Production
Open
Your Platform
Implement ACP and be listed as an early adopter. CRM, DMS, and agent platform integrations welcome.
Apply

Vendor-neutral, community-governed

ACP evolves through a public RFC process with multi-stakeholder advisory board governance.

RFC Process

All specification changes go through a formal Request for Comments process with a 30-day public comment period. Anyone can submit proposals via the public issue tracker.

Advisory Board

5–9 members representing agent platforms, CRM vendors, DMS providers, and independent contributors. Rotating chair. No single vendor controls the protocol.

Breaking Changes

Changes to required fields or envelope structure require two-thirds supermajority approval and 12-month deprecation notice. Migration guides published before every major release.

Open Participation

The specification, schema, and all tooling are Apache 2.0 licensed. Two Advisory Board seats are permanently reserved for independent community contributors.

Read the full Governance document →