Quick Start
- Sign up — company name, slug, LEI.
- On the dashboard, click + New Battery Model → wizard with 7 clusters × 95 attributes.
- Fill the wizard and submit (status: draft).
- Back on the dashboard click Activate on the model row.
- Once active: + Publish Passport (single sample) or 📦 Bulk Item Import (Excel/CSV).
- Passport URL format:
https://battery-id.com/p/<slug>/01/<GTIN>/21/<serial>
Access Tiers (prEN 18239)
EU 2023/1542 Article 77(2) defines 4 access tiers — we implement them as:
| Tier | Who | Data |
|---|---|---|
| public | Everyone (no auth) | Annex XIII point 1 — model, performance, carbon |
| consumer | End-user | + own item usage data (point 4 — Phase 2) |
| legitimate_interest | Refurbisher, recycler, repairer | + point 2 (composition, dismantling) |
| authority | Notified Body, MSA, EC | + point 3 test reports |
Mock auth for now (X-Auth-Tier header). Phase 2 will integrate Keycloak/eIDAS High LoA.
95 Data Attributes (DIN DKE SPEC 99100)
Catalog v1.1 covers EU 2023/1542 Annex XIII point 1+2+3 + Annex VI Part A in full. See /catalog/clusters/....
QR Carrier (prEN 18220)
GS1 Digital Link URL format: https://battery-id.com/p/<slug>/01/<GTIN-14>/21/<serial>. Encoded as QR. Generate A4 label sheets via POST /battery-batches/{id}/label-sheet.
Audit & Versioning
Every PATCH creates a new passport_version snapshot. Time-travel via GET /dpps/byProductIdAndDate/.... All writes audited (GET /audit-log).
API
Swagger UI. Auth: X-Tenant-Id header. Rate limit 120/min.
FAQ
Self-hosting, schema upgrades, regulatory timeline — see TR docs or contact support.