Struct GridSettlement 

pub struct GridSettlement {

    pub pid: u32,
    pub settlement_type: SettlementType,
    pub status: SettlementStatus,
    pub rechnungsnummer: String,
    pub correction_of: Option<String>,
    pub invoice_date: Date,
    pub due_date: Date,
    pub period_from: Date,
    pub period_to: Date,
    pub nb_mp_id: String,
    pub counterparty_mp_id: String,
    pub positions: Vec<InvoicePosition>,
    pub total_eur: Decimal,
    pub warnings: Vec<SettlementWarning>,
}

Result of a grid settlement calculation — pure domain type, no BO4E coupling.

This is the canonical output of all calculation functions in grid-billing. The service layer (netzbilanzd, invoicd) converts it to rubo4e::current::Rechnung via a local into_rechnung() adapter.

Explainability

Every settlement carries a full CalculationTrace per position, applied LegalReferences, and the TariffSource for each rate. The warnings field surfaces any non-blocking validation issues.

Immutable correction chain

When correcting a prior settlement, set status = SettlementStatus::Correction and populate correction_of with the original settlement’s rechnungsnummer. The original settlement is never mutated.

PID override

pid defaults to SettlementType::default_pid(). Override after construction:

• 31005 for Gas NNE (NneStrom → NneGas)
• 31006 for selbstausstellt NNE
• 31011 for GeLi Gas AWH Sperrprozesse

Fields

pid: u32

BDEW Prüfidentifikator — caller may override after construction.

settlement_type: SettlementType

Settlement type.

status: SettlementStatus

Lifecycle status.

rechnungsnummer: String

Unique invoice reference number.

correction_of: Option<String>

If this is a correction, the rechnungsnummer of the original settlement.

invoice_date: Date

Invoice issue date.

due_date: Date

Payment due date (Zahlungsziel, §271 BGB).

period_from: Date

Start of billing period (inclusive).

period_to: Date

End of billing period (inclusive).

nb_mp_id: String

Sender MP-ID — Netzbetreiber (or MSB for PID 31009).

counterparty_mp_id: String

Recipient MP-ID — Lieferant (NNE/MMM), MSB (PID 31009), or MGV (GaBi Gas).

Maps to rechnungsempfaenger in the BO4E Rechnung built by the service layer. Previously omitted, causing service-layer code to pass recipient IDs separately.

positions: Vec<InvoicePosition>

Ordered billing positions (each with full calculation trace).

total_eur: Decimal

Net total in EUR, rounded to 2 decimal places.

warnings: Vec<SettlementWarning>

Non-blocking validation warnings.

Empty when the settlement is clean. The service layer should review Warning and Error severity items before dispatch.

Implementations

impl GridSettlement

pub fn positions_count(&self) -> usize

Number of billing positions.

pub fn is_clean(&self) -> bool

true when the settlement has no warnings at Warning or Error severity.

pub fn all_legal_refs(&self) -> Vec<String>

All legal references cited across all positions (deduplicated by citation string).

pub fn recomputed_total(&self) -> Decimal

Net total as computed from positions (re-summed for verification).

Should equal total_eur. A mismatch indicates a calculation bug.

Trait Implementations

impl Clone for GridSettlement

fn clone(&self) -> GridSettlement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GridSettlement

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

Formats the value using the given formatter.