Enum AgencyCode 

#[non_exhaustive]
pub enum AgencyCode {
    Bdew,
    Gs1,
    Entso,
    Dvgw,
}

EDIFACT DE 3055 — code list responsible agency for market participant identification.

Used in NAD segments (C082 component 2) and IDE segments to indicate which body issued the party identifier code. Choosing the wrong agency code produces non-conformant EDIFACT that receiving parties may reject.

In the German energy market (BDEW MaKo / EDI@Energy) the dominant code is AgencyCode::Bdew ("293"). Nearly all supplier, DSO, and MSB codes are issued and administered by BDEW and carry this agency qualifier — even when the 13-digit number is also a valid GS1 GLN (BDEW is a GS1 member prefix holder).

Wire format

The agency code appears as the third component of the NAD C082 composite:

NAD+MS+{party_id}::{agency_code}'

The middle component (code list id, C082/1154) is always empty in EDI@Energy.

Example

use edi_energy::AgencyCode;

assert_eq!(AgencyCode::Bdew.as_str(), "293");
assert_eq!(AgencyCode::Gs1.as_str(),  "9");
assert_eq!(AgencyCode::Entso.as_str(), "305");

// Parse from a raw NAD segment agency string.
assert_eq!(AgencyCode::parse("293"), Some(AgencyCode::Bdew));
assert_eq!(AgencyCode::parse("999"), None);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Bdew

"293" — BDEW (Bundesverband der Energie- und Wasserwirtschaft).

Used for all BDEW-issued market participant codes in the German electricity and gas markets. This is the correct agency code for suppliers (LFN), distribution system operators (NB/VNB), metering point operators (MSB), and balance responsible parties (BKV/BRK) registered in the BDEW Marktteilnehmerverzeichnis.

NAD wire form

NAD+MS+9900123456789::293'

Gs1

"9" — GS1 (formerly EAN International).

Used when a 13-digit GLN is issued directly under GS1’s global prefix scheme rather than through BDEW. Rare in German MaKo practice — most operators use AgencyCode::Bdew even for GS1-compatible numbers.

Entso

"305" — ECOD (ENTSO-E Coding Scheme / European network operator).

Used for 16-character EIC (Energy Identification Codes) issued by ENTSO-E. Required for transmission grid operators (ÜNB/TSO), balance zones (Regelzonen), and cross-border market participants.

NAD wire form

NAD+MS+10XDE-EON-NETZ--I::305'

Dvgw

"332" — DVGW (Deutscher Verein des Gas- und Wasserfaches).

Occasionally used for gas-sector participants registered in the DVGW system before the BDEW merger. Modern gas market messages prefer AgencyCode::Bdew; this variant is kept for parsing legacy messages.

Implementations

impl AgencyCode

pub const DEFAULT: Self = Self::Bdew

Default agency code for new outbound EDI@Energy messages.

293 (BDEW) is the correct default for all standard German market participants. Change to AgencyCode::Entso only for TSO/ÜNB parties that carry an EIC code.

pub fn as_str(self) -> &'static str

Return the wire-format string for the DE 3055 component.

pub fn parse(s: &str) -> Option<Self>

Parse a DE 3055 agency code string.

Returns None for unrecognised codes; callers may fall back to treating the raw string as an opaque pass-through.

Trait Implementations

impl Clone for AgencyCode

fn clone(&self) -> AgencyCode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for AgencyCode

impl Debug for AgencyCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AgencyCode

fn default() -> Self

Returns the “default value” for a type.

impl Display for AgencyCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for AgencyCode

impl Hash for AgencyCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AgencyCode

fn eq(&self, other: &AgencyCode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AgencyCode