Bu makale İngilizce olarak mevcuttur.
On this pageRegulation
The regulatory terms behind the API’s field names and rules, and the API’s own vocabulary. Regulatory terms link to their full definitions.
Regulation
| Term | Meaning here |
|---|---|
| Battery passport | The electronic record of one physical battery required by Regulation (EU) 2023/1542. In the API: a passport, one per battery item. |
| Article 77 | The article that creates the passport. 77(1): one per individual battery. 77(7): a repurposed or remanufactured battery gets a new passport linked to the old. 77(8): the passport ceases when the battery is recycled. |
| Annex XIII | The list of passport content, in four points. Point 1 public information; Point 2 information for persons with a legitimate interest and authorities; Point 3 authority-only information such as test-report results; Point 4 battery-specific data, including dynamic data such as state of health. |
| Access tier | Who may see a data point, following Annex XIII: PUBLIC (Point 1), LEGITIMATE_INTEREST (Points 2 and 4) and AUTHORITY (Point 3). Enforced on the server; the public resolver serves PUBLIC only. |
| Legitimate interest | The standing of repairers, remanufacturers, second-life operators and recyclers to access more than the public tier. |
| Unique identifier | The string that identifies one physical battery (ISO/IEC 15459). In the API: uniqueIdentifier, C- + 11 characters. Never changes. |
| UPI (unique product identifier) | The identifier a passport is registered under in the EU DPP Registry (Impl. Reg. (EU) 2026/1778 Art. 8). The Registry requires a URL starting with https://, at most 50 characters, that resolves to the hosted passport — the reason identifiers are kept short. |
| Data carrier | The QR code (ISO/IEC 18004) on the battery that encodes the resolver URL. In the API: GET /passports/{id}/qr.svg. |
| Economic operator | The organisation responsible for the battery and its passport — your organisation. In the API: responsibleOrgId. |
| Placing on the market | Making a battery available on the EU market for the first time. In the API: placedOnMarketAt; Point 4(a) values are measured at this moment. |
| State of health | The battery’s condition relative to new. EV: state of certified energy. LMT: remaining capacity, power capability, round-trip efficiency. In the API: SOH_READING events. |
| Repurposing | A battery gets a second life for a different purpose. In the API: PATCH /passports/{id}/status with REPURPOSED, which forks a linked passport. |
| Declaration of conformity | The EU Declaration of Conformity, a required document (Annex XIII 1(r)). In the API: a document of type "EU Declaration of Conformity". |
| Notified body / market surveillance authority | The authorities with access to Point 3 data. |
| Battery categories | EV, LMT and industrial batteries above 2 kWh need a passport. In the API: category. |
API
| Term | Meaning |
|---|---|
| Model | A battery design: the data every battery of the design shares. |
| Battery item | One physical battery. Creating one creates its passport. |
| Draft / published | A new passport is a draft: private and not billed. Publishing makes it public and counts it as issued. |
| Publish gate | The server-side check before publishing: a place of manufacture, and a model complete for its category. |
| Ceased | A recycled battery’s passport. The resolver answers 410 Gone. |
| Fork | The new, linked passport created on repurpose, re-use or remanufacture. |
| Event | One append-only record of dynamic data. |
| Live / test key | A live key stores writes; a test key dry-runs them. Details. |
| Dry run | A write validated in full and not stored. |
| Idempotency key | A header that makes a retried write return its first response. Details. |
| Cursor | The opaque pointer to the next page of a list. Details. |
| Webhook | A signed HTTPS POST we send when something changes. Details. |