grid-billing 0.11.0

Role-neutral grid invoice calculation: NNE/KA/MMM/MSB (PIDs 31001/31002/31005/31006/31009/31011) — used by netzbilanzd (NB) and invoicd (LF selbstausstellen). §14a ToU HT/NT. Zero I/O, no float money.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! Role-neutral **German grid settlement calculation** engine.
//!
//! Covers all DSO/TSO-side INVOIC documents:
//! - **NNE** (Netznutzungsentgelt) — PIDs 31001, 31005, 31006, 31011
//! - **MMM** (Mehr-/Mindermengensaldo) — PID 31002
//! - **MSB** (Messstellenbetrieb) — PID 31009
//!
//! ## Calculation flow
//!
//! ```text
//! Input → validation → Settlement Engine → GridSettlement → into_rechnung() (service layer)
//! ```
//!
//! [`GridSettlement`] is the canonical output. The service layer (`netzbilanzd`,
//! `invoicd`) converts it to BO4E `Rechnung`. This keeps `grid-billing`
//! publishable to crates.io without pulling in the internal `rubo4e` crate.
//!
//! ## Explainability
//!
//! Every [`InvoicePosition`] carries a [`CalculationTrace`] with:
//! - input values (quantity, unit price)
//! - gross intermediate result before rounding
//! - applicable [`LegalReference`]s (e.g. `StromNEV §17`, `KAV §2`)
//! - the [`TariffSource`] justifying each rate
//!
//! ## No float money
//!
//! All amounts use `rust_decimal::Decimal` and the `billing::EuroAmount` newtype.
//!
//! ## Example
//!
//! ```rust,no_run
//! use grid_billing::{NneInput, calculate_nne_invoice};
//! use rust_decimal::Decimal;
//! use time::macros::date;
//!
//! fn d(s: &str) -> Decimal { Decimal::from_str_exact(s).unwrap() }
//!
//! let result = calculate_nne_invoice(&NneInput {
//!     malo_id: "51238696780".into(),
//!     nb_mp_id: "9900357000004".into(),
//!     lf_mp_id: "9900012345678".into(),
//!     rechnungsnummer: "NNE-2025-001".into(),
//!     period_from: date!(2025-01-01),
//!     period_to:   date!(2025-01-31),
//!     invoice_date: date!(2025-02-15),
//!     due_date: date!(2025-03-15),
//!     arbeitsmenge_kwh: d("1500"),
//!     arbeitspreis_ct_per_kwh: d("3.5"),
//!     arbeitsmenge_ht_kwh: None,
//!     arbeitspreis_ht_ct_per_kwh: None,
//!     arbeitsmenge_nt_kwh: None,
//!     arbeitspreis_nt_ct_per_kwh: None,
//!     spitzenleistung_kw: None,
//!     leistungspreis_eur_per_kw: None,
//!     ka_satz_ct_per_kwh: Some(d("0.11")),
//!     tariff_sheet_id: Some("Preisblatt-NNE-2025-Q1".into()),
//!     sparte: grid_billing::Sparte::Strom,
//!     ka_klasse: Some(grid_billing::KaKlasse::TarifkundeLow),
//! }).expect("valid billing input");
//!
//! // Every position explains itself:
//! for pos in &result.positions {
//!     println!("{}: {}", pos.text, pos.trace.explanation);
//! }
//!
//! // Legal references used:
//! for r in result.all_legal_refs() {
//!     println!("  → {r}");
//! }
//! ```
#![deny(unsafe_code)]
#![warn(missing_docs)]

pub mod billing;
pub mod error;
pub mod types;

pub use billing::{
    calculate_mmm_invoice, calculate_msb_invoice, calculate_nne_invoice, calculate_reversal,
};
pub use error::BillingError;
pub use types::{
    // Domain types for explainability + audit
    CalculationTrace,
    // Backward-compatible alias for GridSettlement — same type, kept for call-site stability
    GridInvoice,
    // Core settlement output
    GridSettlement,
    InvoicePosition,
    KaKlasse,
    LegalReference,
    // Input types
    MmmInput,
    MsbInput,
    NneInput,
    QuantityUnit,
    SettlementStatus,
    SettlementType,
    SettlementWarning,
    Sparte,
    TariffSource,
    ValidationResult,
    WarningSeverity,
    // Validation functions
    validate_mmm_input,
    validate_msb_input,
    validate_nne_input,
};