Enum EngineError 

pub enum EngineError {
    ValidationBlocked {
        warnings: Vec<BillingWarning>,
    },
    PriceOutOfRange {
        field: String,
        value: Decimal,
    },
    InvalidPeriod {
        from: Date,
        to: Date,
    },
    AllocationMismatch {
        fractions: usize,
        contexts: usize,
    },
    AllocationWeightsInvalid {
        sum: Decimal,
    },
    NutzungsplanSharesInvalid {
        sum: Decimal,
    },
    Unrepresentable {
        field: String,
        value: String,
    },
    ReconciliationFailed {
        reason: String,
    },
    Arithmetic(BillingError),
}

Errors returned by BillingEngine::bill and the invoice assembly functions.

Variants

ValidationBlocked

One or more providers raised Error-severity regulatory warnings during validation — the run must not produce an invoice.

Carries all warnings collected up to and including the blocking provider, so the caller sees every violation at once. The blocking ones are those with WarningSeverity::Error.

Fields

warnings: Vec<BillingWarning>

All warnings collected before the run was aborted.

PriceOutOfRange

A tariff price could not be represented in the monetary type.

Raised when a configured ct/kWh price exceeds the Amount range — in practice always a corrupt tariff, never a real price.

Fields

field: String

The tariff field holding the offending value (e.g. "arbeitspreis_ht_ct_per_kwh").

value: Decimal

The value that could not be represented.

InvalidPeriod

A billing period whose end precedes its start.

Unreachable through BillingPeriod::new — this is what the constructor returns, making the invalid pair unrepresentable everywhere downstream.

Fields

from: Date

The requested first day.

to: Date

The requested last day, before from.

AllocationMismatch

Invoice::allocate_proportionally was called with mismatched shapes.

Fields

fractions: usize

Number of allocation fractions supplied.

contexts: usize

Number of recipient contexts supplied.

AllocationWeightsInvalid

Invoice::allocate_proportionally was given weights it cannot normalise.

A negative weight is not an allocation share, and weights summing to zero name no recipient at all. Both are caller mistakes rather than arithmetic failures, so they are refused before the split runs.

Fields

sum: Decimal

The sum of the supplied weights.

NutzungsplanSharesInvalid

A §42b EEG Nutzungsplan whose shares do not describe an allocation.

The plan’s fractions are caller-supplied and must partition the plant’s generation exactly once — a plan entered as percentages allocates a hundred times the generation, and one summing short leaves kWh unallocated. Refused before the split rather than distributed.

Fields

sum: Decimal

The sum of the supplied shares.

Unrepresentable

A value the EN 16931 semantic model cannot represent.

A rendered e-invoice is a legally binding document: a line amount saturated to 0.00, or a BT-2 Ausstellungsdatum taken from a fallback constant, states as fact something § 14 Abs. 4 UStG requires the document to get right. Both are refused rather than emitted.

Fields

field: String

The business term that could not be represented (e.g. "BT-131").

value: String

The value that could not be represented.

ReconciliationFailed

EN 16931 reconciliation (BG-22/BG-23, BR-CO-10..16) failed.

The breakdown and the totals of an e-invoice are derived, and a derivation that fails leaves the document carrying whichever totals the builder happened to hold — a document that states amounts nothing computed. Refused rather than emitted.

Fields

reason: String

What the reconciler reported.

Arithmetic(BillingError)

An arithmetic or document error from the billing core — monetary overflow, invalid schedule, tax-layer failure.

Implementations

impl EngineError

pub const fn code(&self) -> &'static str

Stable machine-readable code for structured error responses.

pub fn blocking_warnings(&self) -> &[BillingWarning]

The Error-severity warnings that blocked the run, when this is a ValidationBlocked.

Trait Implementations

impl Clone for EngineError

fn clone(&self) -> EngineError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EngineError

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

Formats the value using the given formatter.

impl Display for EngineError

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

Formats the value using the given formatter.

impl Error for EngineError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BillingError> for EngineError

fn from(source: BillingError) -> Self

Converts to this type from the input type.