Enum PriceAdjustment 

pub enum PriceAdjustment {
    Tax {
        name: String,
        percentage: Decimal,
    },
    Discount {
        name: String,
        percentage: Decimal,
    },
    Fixed {
        name: String,
        amount: Decimal,
        currency: Currency,
    },
}

Represents additional price modifications such as tax, discount, or fixed fees.

This enum is used to define adjustments that can be applied to a PricingDetail. These adjustments are later converted and applied using a CurrencyConverter, resulting in one or more AppliedAdjustment entries with actual values.

Variants

• Tax: Represents a tax to be applied as a percentage of the current sell price. Useful for applying VAT, Tax, or sales tax.

  • name: A human-readable label (e.g., "Tax 11%")
  • percentage: The tax rate as a percentage (e.g., 11.0 for 11%)

• Discount: Represents a discount applied as a percentage of the current sell price. Useful for promotions or campaigns.

  • name: A human-readable label (e.g., "Promo New Year")
  • percentage: The discount rate as a percentage (e.g., 5.0 for 5%)

• Fixed: Represents a fixed fee adjustment, such as a service or admin fee. This amount can be in a different currency and will be converted accordingly.

  Use sell_currency as the default currency for fixed amount adjustments. Caller is responsible for providing the correct currency context.

  • name: A human-readable label (e.g., "Admin Fee")
  • amount: The raw fixed amount before conversion
  • currency: The original currency of the fixed amount

Example

use rust_decimal_macros::dec;
use pricing_kit::{Currency, PriceAdjustment};
let discount = PriceAdjustment::Discount {
    name: "Year End Promo".into(),
    percentage: dec!(5.0),
};

let tax = PriceAdjustment::Tax {
    name: "Tax 11%".into(),
    percentage: dec!(11.0),
};

let fixed_fee = PriceAdjustment::Fixed {
    name: "Admin Fee".into(),
    amount: dec!(2.0),
    currency: Currency::new("USD", "US Dollar"),
};

Adjustments are intended to be applied in order using PricingDetail::apply_adjustments().

Variants

Tax

Fields

name: String

percentage: Decimal

Discount

Fields

name: String

percentage: Decimal

Fixed

Fields

name: String

amount: Decimal

currency: Currency

Trait Implementations

impl Clone for PriceAdjustment

fn clone(&self) -> PriceAdjustment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PriceAdjustment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PriceAdjustment

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PriceAdjustment

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

where __S: Serializer,

Serialize this value into the given Serde serializer.