What you enter once vs per battery
To avoid retyping the same datasheet on every serial number, the app splits work between your product family (battery model) and each passport (physical unit).
| Information | Where to edit | Applies to |
|---|---|---|
| Battery chemistry (NMC, LFP, NCA, …) | Model → Materials | All passports of that model |
| Cathode & anode description | Model → Materials | All passports |
| Critical raw materials summary | Model → Materials | All passports |
| Bill of materials (parts list) | Model → Bill of materials | All passports |
| Recycled content % (Co, Li, Ni, Pb) | Model → Circularity → Recycled content | All passports |
| Hazardous substances (with concentration) | Passport → Materials tab → Edit | This serial unit only |
On a passport’s Materials tab you can still open the model editor from the banner (“Edit on model”) when a field is shared across the whole product family.
Battery chemistry
Choose a standard chemistry type from the dropdown (for example NMC, LFP, NCA). Add free-text cathode and anode descriptions if your datasheet names specific grades or coatings.
Tip: Complete model materials before bulk-importing passports so new units inherit the right data.
Bill of materials (BOM)
- Open Models in the sidebar and select your product family.
- Go to Bill of materials (or follow the link from a passport’s Materials tab).
- Enter the declared pack mass in kilograms.
- Add one row per part or sub-assembly. For each row you can set:
- Level — pack, module, cell, component, or material
- Parent row — optional, to show what sits inside what
- Name — part or material label
- Material code — short code used to match supply-chain data (see below)
- Mass (kg) and optional mass %
- Save. The list shows whether masses add up to the declared pack mass.
Mass balance messages
- Within 0.5% tolerance — summed line masses match declared pack mass (good for compliance).
- Mismatch warning — totals differ by more than 0.5%; check missing rows or wrong kg values.
- Incomplete data — you declared pack mass but left line masses empty; fill in kg on each row you want counted.
Large packs (50+ lines) are supported. You do not need a separate “part numbers” text field in circularity anymore — the structured BOM is what compliance checks use.
Hazardous substances & SVHC alerts
Substances of concern are recorded per passport because concentrations can differ by batch or unit.
- Open the passport from Registry.
- Select the Materials tab → Edit materials.
- For each substance, enter a name, optional CAS number, and details including concentration (for example 0.15% w/w).
- Save. Return to the Materials tab to review the list and any alerts.
If a substance is on the EU SVHC candidate list and you declare more than 0.1% weight-by-weight, the app shows a clear warning (on the edit form and on the tab). This helps you meet REACH disclosure expectations before placing batteries on the market.
Fleet Compliance also checks that every on-market passport has hazardous data recorded.
Recycled content & 2031 targets
Post-consumer and pre-consumer recycled shares for cobalt, lithium, nickel, and lead are entered on the model (shared by all units of that family).
- Model → Circularity → Recycled content (or the passport shortcut that opens the same form).
- Enter percentages for each metal (pre- and post-consumer where applicable).
- Review progress on the Dashboard recycled-content panel.
- Use Compliance to see gaps: undeclared values, or declared values below provisional 2031 minimums (for example cobalt 16%, lithium/nickel 6%, lead 85% post-consumer).
Fixing a gap on the model automatically improves every passport linked to that product family.
Linking BOM to your supply chain
When the same material code appears in both your BOM and your Supply chain graph, the passport Materials tab shows them as matched.
- Matched codes — BOM and supply chain both reference the code (traceability looks consistent).
- BOM codes without supply-chain link — add or import the supplier edge under Supply chain, or fix the code spelling.
- Supply-chain edges without BOM — optional cleanup; may be upstream materials not in the pack BOM.
Due diligence declarations remain under model Due diligence and the supply-chain workspace.
Before market placement — quick checklist
- Model BOM saved with sensible mass balance
- Model recycled content % entered where required for your chemistry
- Each on-market passport has hazardous substances filled in
- Compliance screen shows no open gaps for BOM, hazardous, or recycled obligations
- Supply-chain material codes aligned where you rely on traceability attestations
These checks mirror the manufacturer golden path (WF-01 through WF-07). See Core workflows & law for the full sequence.
Screen reference
| Task | Where in the app |
|---|---|
| Edit shared chemistry & materials | Models → select model → Materials (or passport banner “Edit on model”) |
| Edit BOM | Models → Bill of materials |
| Edit hazardous substances for one unit | Registry → passport → Materials → Edit materials |
| Edit recycled metal % | Models → Circularity → Recycled content |
| Review warnings & linkage | Registry → passport → Materials tab |
| Fleet-wide gaps | Compliance · Dashboard |