# BDEW Codelist & EBD Cluster Data
Machine-readable lookup tables used by the condition evaluator. Two upstream sources:
- BDEW [Codeliste der Artikelnummern und Artikel-ID v5.6 (Fehlerkorrektur 2025-09-30)](https://bdew-mako.de/pdf/Codeliste_Artikelnummern%20und%20Artikel-ID_5_6_Fehlerkorrektur_20250930.pdf) (via BNetzA *"Änderungsmanagement"*) for the Artikel-ID tables.
- Hochfrequenz [mako_prozesse](https://github.com/Hochfrequenz/mako_prozesse) for the per-EBD answer-code cluster map (parsed from BDEW EBD PDFs).
## Files
- `artikel_id_codelist.json` — chapter 3 (Gruppenartikel-ID / Artikel-ID). Loaded at runtime via `ArtikelIdCodelist::embedded()` in `crates/automapper-validation/src/eval/codelist.rs`. Used by conditions `[73]` and `[284]`.
- `artikelnummer_codelist.json` — chapter 2 (5-digit Artikelnummern, INVOIC/residual MMM usage). **Not yet wired into the evaluator**; committed in anticipation of future conditions that reference chapter-2 codes (MMM workflows). Loader is not yet implemented.
- `verwendungszwecke.json` — chapter 2 of the BDEW Codeliste der Verwendungszwecke (version 1.0 with the corrections of 29.06.2026, valid from FV2610): per code (V01…V33) its locations (MaLo, Tranche, NeLo), the market roles it may be sent to (NB, LF, ÜNB), and what its Erläuterung asks of the OBIS of the same PIA (Messart D, Lieferrichtung via Messgröße C). Loaded by `src/eval/verwendungszwecke.rs`; used by UTILMD Strom FV2610 `[185]`–`[187]`, `[274]`–`[276]`, `[353]`, `[354]`, `[381]`–`[383]`, `[422]`–`[424]`, and by the sample generator for PIA+5 Verwendungszweck codes.
- `konfigurationen_produkte.json` — the product codes of every chapter of the BDEW Codeliste der Konfigurationen, editions 1.3c (FV2504–FV2604) and 1.4 (FV2610), keyed by chapter number as the document numbers its headings (`2.1.1`, `4.6.1`, `7`). Loaded by `src/eval/konfigurationen.rs` (`products`, `chapters_named`, `codes_named_by`); used by the sample generator for every PIA Produkt-Code whose condition names a chapter (QUOTES `[74]`: "… der Codeliste der Konfigurationen im Kapitel 4.6.1 …"). Chapter 4.5 lists no product in either edition. Not yet read by the validator, whose chapter conditions are external. Extracted by `scripts/extract_konfigurationen_produkte.py`.
- `konfigurationen_abrechnungsdaten.json` / `konfigurationen_anmeldung.json` — the rows of chapter 6.2 (ORDERS 17133) and 6.1 (UTILMD Anmeldungen 55001, 55077, 55014, 55600, 55601, 55608) of the Codeliste der Konfigurationen, 1.3c and 1.4: per product its Produkteigenschaften (CAV+ZH9), its Wertedetail (CAV+ZV4) with format conditions and, where it is needed only beside one Produkteigenschaft, `variants` (Tranchengröße), the Prüfidentifikatoren that may order it and (6.1) its maximum repetitions per Produktpaket. Loaded by `src/eval/abrechnungsdaten.rs` (`AbrechnungsdatenProdukte::embedded` / `anmeldung`, `chapter6_product`); 6.2 drives ORDERS `[158]`–`[162]`/`[180]`, both drive the sample generator's CAV+ZH9/ZV4. Extracted by `scripts/extract_konfigurationen_abrechnungsdaten.py` (`--chapter 6.1` for the second).
- `obis_medien.json` — the OBIS-Kennzahlen and Medien the BDEW Codeliste der OBIS-Kennzahlen und Medien (2.5c, file id 11919) ties to MSCONS Prüfidentifikatoren (column "Nutzungseinschränkung in der MSCONS / Prüfidentifikator", condition `[501]`): 13013 `7-b:9.98.0`, 13020 `AUA`, … Loaded by `src/eval/obis_medien.rs`; used by the sample generator for MSCONS PIA+5 `Z02` (OBIS-ähnliche Kennzahl) and `Z08` (Medium). Extracted by `scripts/extract_obis_medien.py`.
- `ebd_cluster_map.json` — per-EBD (`E_0624`, `E_0047`, ...) map `{ code → cluster }` where cluster ∈ {`Zustimmung`, `Ablehnung`, `Ablehnung auf Kopfebene`, `Ablehnung auf Positionsebene`, `Ablehnung auf Summenebene`, `Korrekturliste wegen Ablehnung`, `Änderung der Daten`, `Abweisung`, ...}. Loaded via `EbdClusterLookup::embedded()` in `src/eval/ebd_cluster.rs`. Used by conditions `[359]` / `[360]` / `[366]` / `[368]` (UTILMD_Strom), `[17]` / `[18]` (ORDRSP), `[61]` (UTILTS), and `[14]` / `[15]` / `[16]` / `[517]` / `[518]` (REMADV). Each caller reads the answer code and EBD id from its segment-specific layout (STS/C556 or AJT) and classifies via the lookup. Extracted by `scripts/extract_ebd_clusters.py`, which reads the dedicated `if_yes_cluster` / `if_no_cluster` keys (preferred, introduced upstream after [mako_prozesse#5](https://github.com/Hochfrequenz/mako_prozesse/issues/5)) and falls back to the legacy `Cluster:` prefix in `if_*_hint`.
## Updating
**Artikel-ID codelist:** when BDEW publishes a new PDF, re-extract both JSON files manually (the Rust extraction CLI is deferred — see `docs/plans/2026-04-23-ahb-codelist-and-per-instance-plan.md` Task A8). Spot-check against known entries before committing; bump `version` and `source_published` in both file headers.
**Codeliste der Konfigurationen / OBIS-Kennzahlen und Medien:** download the Word "informatorische Lesefassung" the same way (titles "Codeliste der Konfigurationen …", "Codeliste der OBIS-Kennzahlen und Medien …"), then run `scripts/extract_konfigurationen_produkte.py OUT 1.3c=<docx> 1.4=<docx>`, `scripts/extract_konfigurationen_abrechnungsdaten.py OUT 1.3c=<docx> 1.4=<docx> [--chapter 6.1]` or `scripts/extract_obis_medien.py OUT <docx> --version <v> --file-id <id>`.
**Codeliste der Verwendungszwecke:** list the documents (`GET https://www.bdew-mako.de/api/documents`, titles "Codeliste der Verwendungszwecke …"), download the Word "informatorische Lesefassung" (`GET https://www.bdew-mako.de/api/downloadFile/<fileId>`), then:
```bash
scripts/extract_verwendungszwecke.py crates/automapper-validation/data/verwendungszwecke.json \
"<version>=<downloaded .docx>" --file-id <fileId>
```
**EBD cluster map:** `git pull` the mako_prozesse repo, then:
```bash
scripts/extract_ebd_clusters.py /path/to/mako_prozesse \
crates/automapper-validation/data/ebd_cluster_map.json \
--commit "$(git -C /path/to/mako_prozesse rev-parse HEAD)"
```
Spot-check `ebds["E_0624"]` (and any EBDs referenced by newly-added STS conditions) against the upstream YAML before committing.