Chapter 3 · Using the app

Materials, BOM & composition

How to declare chemistry, parts lists, hazardous substances, recycled metal content, and how the app helps you stay aligned with Annex IV and fleet compliance checks.

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)

  1. Open Models in the sidebar and select your product family.
  2. Go to Bill of materials (or follow the link from a passport’s Materials tab).
  3. Enter the declared pack mass in kilograms.
  4. 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 %
  5. 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.

  1. Open the passport from Registry.
  2. Select the Materials tab → Edit materials.
  3. For each substance, enter a name, optional CAS number, and details including concentration (for example 0.15% w/w).
  4. 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).

  1. Model → CircularityRecycled content (or the passport shortcut that opens the same form).
  2. Enter percentages for each metal (pre- and post-consumer where applicable).
  3. Review progress on the Dashboard recycled-content panel.
  4. 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