Struct Price 

pub struct Price {
    pub net: CurrencyAmount,
    pub tax_rate: Decimal,
}

A net price plus a percentage tax rate (e.g. VAT 20%).

All amounts share a single Currency; operations return MoneyError::CurrencyMismatch if currencies diverge.

Mirrors ecom_core::Money::percentage_of — tax = net * rate / 100 — but surfaces the rate explicitly for invoicing.

use billing_kit::{Price, Currency};
use rust_decimal_macros::dec;
let p = Price::new(dec!(100), Currency::GBP, dec!(20)).unwrap();
assert_eq!(p.tax_amount().amount, dec!(20));
assert_eq!(p.gross().amount, dec!(120));

Fields

net: CurrencyAmount

Net (pre-tax) amount.

tax_rate: Decimal

Tax rate as percentage (0-100).

Implementations

impl Price

pub fn new( net_amount: impl Into<Decimal>, currency: Currency, tax_rate: Decimal, ) -> Result<Self, PriceError>

Create a new Price.

Errors

Returns PriceError::InvalidTaxRate if tax_rate is not in 0..=100.

pub fn tax_amount(&self) -> CurrencyAmount

Tax amount = net * tax_rate / 100.

pub fn gross(&self) -> CurrencyAmount

Gross amount = net + tax.

pub fn discount_of_gross(&self, percent: Decimal) -> CurrencyAmount

Discount amount at percent% of gross (0-100).

pub fn gross_minus_discount(&self, percent: Decimal) -> CurrencyAmount

Apply a promo discount to gross, returning the discounted gross.

Clamps percent to 0..=100 and never returns a negative amount.

Trait Implementations

impl Clone for Price

fn clone(&self) -> Price

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Price

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

Formats the value using the given formatter.

impl Eq for Price

impl PartialEq for Price

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Price