Enum PricingNoteCode 

#[non_exhaustive]
pub enum PricingNoteCode {
    NoPriceComponent,
    PeriodSpansPriceChange,
    PeriodsOutOfOrder,
    TotalClamped,
    NegativeTax,
    UnattributedTax,
}

Available on crate feature tariffs only.

What a PricingNote is about, without reading the English.

An invoice-reconciliation pipeline has to be able to count these — how many CDRs this month span a price change? — and grepping a sentence is not a way to do that.

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.

NoPriceComponent

A dimension was consumed that no Tariff Element prices.

Not an error: “there will be no costs for that Tariff Dimension”. But a session that charged 40 kWh for nothing is worth looking at.

PeriodSpansPriceChange

A Charging Period outlasted the Price Component that priced it.

A CPO SHALL at least start (and add) a ChargingPeriod every moment/event that has relevance for the total costs of a CDR. … When an energy changes in price after 17:00, the CPO has to start a new Charging Period at 17:00.

So this is a defect in the CDR, not in the tariff: the period should have been split. Its quantities cannot be apportioned after the fact — nothing in the data says how much of the energy fell either side of the boundary — so the period is priced at the rate that applied when it began, and this note says that happened. See PricingEngine.

PeriodsOutOfOrder

The Charging Periods are not in chronological order.

Nothing in the property tables says they must be, but everything built on them assumes it: step_size is defined in terms of “the last relevant PriceComponent”, and a period’s duration is only knowable as the gap to the next one. Out of order, both are wrong.

The session is still priced — the quantities are all there — but any restriction that depends on elapsed time is evaluated against a timeline that does not exist.

TotalClamped

A min_price or max_price moved the total, and the tax lines were moved with it.

NegativeTax

The tax the tariff describes came out negative.

No tariff can mean that: a VAT percentage below zero is a malformed PriceComponent, which Validate reports. The engine does not require validated input, so rather than publish a session that costs less with tax than without, it holds the inclusive total at the exclusive one and says why.

UnattributedTax

Tax was owed that no rate in the session accounts for.

Raised when a min_price.after_taxes lifts the inclusive total of a session whose price components named no VAT at all. The amount is real; the rate is not knowable.

Implementations

impl PricingNoteCode

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

A short, stable, machine-readable slug.

Trait Implementations

impl Clone for PricingNoteCode

fn clone(&self) -> PricingNoteCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PricingNoteCode

impl Debug for PricingNoteCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PricingNoteCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PricingNoteCode

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

Formats the value using the given formatter.

impl Eq for PricingNoteCode

impl Hash for PricingNoteCode

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 PricingNoteCode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PricingNoteCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PricingNoteCode