# Electric vehicle data contract Date2026-10-21. State: CONTRACT_FROZEN / RUNTIME_PENDING. Owns B-BR-EV-01–07/10–12/16–22 and BUC-EV-01–12 at the contract level. [Shapes](https://github.com/AlexandreZanata/Abastevo/blob/e4a67580fc368a59bc1c0f1e0466fc011313f330/contracts/openapi/ev-support-planned.json), [numeric policy](https://github.com/AlexandreZanata/Abastevo/blob/e4a67580fc368a59bc1c0f1e0466fc011313f330/contracts/ev/numeric-policy-v1.json), [shape examples](https://github.com/AlexandreZanata/Abastevo/blob/e4a67580fc368a59bc1c0f1e0466fc011313f330/contracts/testdata/ev/support-v1.json) and [shared exact examples](https://github.com/AlexandreZanata/Abastevo/blob/e4a67580fc368a59bc1c0f1e0466fc011313f330/contracts/testdata/ev/exact-v1.csv) are staged; there are no live routes, SQL/Room migrations or newly granted capabilities. ## Identity, vehicle capability and legacy evolution EnergyVehicle holds one stable vehicle ID, propulsion, explicitly supported/ unsupported/unknown external charging, optional tank/fuel/battery/source specs, connector support and independent AC/DC limits. ICE, BEV, PHEV, HEV, MHEV, range extender, other and unknown are distinct. BEV needs no liquid tank/fuel; PHEV may carry both energy systems and occupies one registration slot. HEV/MHEV cannot be presented as externally chargeable from their names. Unknown source propulsion retains its source label without coercion to ICE/BEV. Gross and usable battery Wh stay optional and separate; no guessed default or zero for unknown. Contradictory assertions remain source-qualified; the chosen effective private specification requires correction rather than silently choosing one. Do not infer actual charging speed, safe adapters, session duration, battery degradation or vehicle-compatible connectors solely from an advertised station W. Exact model/market/year/trim/edition/reference basis is optional. PBE_LAB, manufacturer assertion, manual estimate and measured values are different methods. Equivalent km/L is not real liquid use. No inferred manufacturer connector/battery spec is supplied by an unrelated PBE energy-efficiency row. Legacy vehicle UUIDs/fields keep their historical meanings. GASOLINE_PREMIUM is the persisted Android additive legacy, normalized to GASOLINE_ADDITIVED for the existing Go wire; GASOLINE_PREMIUM_GRADE remains separate. A legacy provenance field in the staged example does not authorize changing old history or inventing electricity as a FuelProduct. Old Room tank Double stays legacy-only; new energy/ money values use the exact contract. Actual migrations belong to EE-10/19 and MEX-07/08, including existing-data upgrade/rollback/reopen acceptance. Wire version1 is explicit. Unknown source connector codes can normalize to UNKNOWN with their bounded source code; unknown top-level schema/unsupported methods produce an explained unsupported state and retain accepted local data. Never map an unfamiliar token to a known connector/fuel or fabricate compatibility. ## Public place, equipment and evidence boundaries PublicLocation, EVSE and Connector have separate stable internal IDs and parent references, each with source-scoped external ID/revision and rights/attribution reference. No CNPJ/name/coordinate-only identity merge; co-located Directory station links are optional and separately proven. Child equipment/connector counts and simultaneous capacity are independent nullable facts. Missing child identity is not permission to create a fictitious counted EVSE. PublicLocation requires PUBLIC_VERIFIED publication eligibility. Access/hours, price and availability may still be unknown/restricted. Coordinates refer only to eligible public infrastructure; missing coordinates remain null. Private/home addresses, contacts/comments/contributor positions and raw photos are absent. Source qualification, an open-data flag or a community suggestion cannot itself supply that public eligibility or a license over private metadata. SourceAssertion binds source/external ID/revision, rights record, license, attribution/change notice and observation clock. Only admitted field/provider rights permit later API/offline packs. OCM export/API share lineage; repeated snapshots/votes do not establish independent evidence. EE-01 samples are not source admission; PBE rights are still pending. EE-03–09/18 own those gates. Operational status has a separate source and expiration. Static catalog or dated community report can only support UNKNOWN current operational status. An actual AVAILABLE/OCCUPIED/FAULT/OUT_OF_SERVICE claim needs licensed operator basis and real observation/expiry; the adapter must also verify observed<=now