dvgw-edi

DVGW EDIFACT format parser for the German gas transport and balancing market

Implements parsing of DVGW-governed EDIFACT formats used in GaBi Gas 2.1 (BNetzA BK7-24-01-008). The crate is the DVGW counterpart to edi-energy, which covers BDEW EDI@Energy (UTILMD, MSCONS, INVOIC, APERAK, …).

Supported formats

FK = Fehlerkorrektur — editorial correction only; no structural change.

Quick start

use dvgw_edi::{DvgwPlatform, AnyDvgwMessage, DvgwMessage};

let platform = DvgwPlatform::default();
let msg = platform.parse(edi_bytes)?;

if let AnyDvgwMessage::Nomint(nomint) = msg {
    // nomination_ref from BGM document number — use to correlate the NOMRES
    println!("nomination ref:  {:?}", nomint.nomination_ref);
    println!("sender EIC:      {:?}", nomint.sender_eic());
    for qty in &nomint.quantities {
        println!("  {} {} {}", qty.location_code, qty.quantity,
                 qty.unit.as_deref().unwrap_or("?"));
    }
}

// For ALOCAT — always use quantity_decimal() for gas billing precision
if let AnyDvgwMessage::Alocat(alocat) = msg {
    for qty in &alocat.quantities {
        // Decimal arithmetic per DVGW G 685 §7 (≥ 3 dp required)
        if let Some(kwh) = qty.quantity_decimal() {
            println!("  {} kWh_Hs (Decimal)", kwh);
        }
    }
}

Message routing

DVGW messages carry no BGM Prüfidentifikator. Routing uses the combination of message type and the direction qualifier extracted from the NAD+MS/MR role codes.

Use AnyDvgwMessage::detect_pid(role_qualifier) to obtain the synthetic PID for registration with the mako-engine PID router:

// After parsing — BKV → FNB nomination
let pid = msg.detect_pid(Some("Z01")); // → Some(90011)

Synthetic PID table (range 90000–90999)

The range 90000–90999 is reserved exclusively for DVGW synthetic PIDs and will never collide with BDEW PIDs (10000–99999, documented in PID 3.3 / PID 4.0).

NOMINT/NOMRES correlation

1. BKV sends NOMINT — nomination_ref holds the BGM document number.
2. FNB/MGV responds with NOMRES — nomination_ref holds the RFF+Z13 value that back-references the originating NOMINT.

Match nomres.nomination_ref == nomint.nomination_ref to correlate the response to the outbound nomination workflow.

DELORD/DELRES correlation

1. BKV sends DELORD — order_ref holds the BGM document number.
2. FNB responds with DELRES — order_ref holds the RFF+Z13 value that back-references the originating DELORD.

Match delres.order_ref == delord.order_ref to correlate the delivery response to the outbound delivery order workflow.

delres.status carries the overall disposition (Accepted, Modified, or Rejected). Per-location detail is in delres.lines.

Feature flags

Quantities are Decimal, never f64. DVGW G 685 §7 settles gas energy to at least three decimal places, and binary floating point cannot represent those decimal fractions exactly, so quantity_decimal() is the only accessor offered.

Market roles

Acknowledgements (CONTRL / APERAK)

dvgw-edi does not reimplement CONTRL or APERAK. These are handled by the edi-energy crate and shared across all message families. See "Ergänzungsblatt zur APERAK und CONTRL für die Nutzung in GaBi Prozessen" on edi-energy.de.

Relationship to other crates

Regulatory basis

DVGW AHBs and MIGs are published by DVGW S&C: https://www.dvgw-sc.de/leistungen/it-dienstleistungen/datenaustausch-gas