Struct TaxCode 

pub struct TaxCode {
    pub id: String,
    pub code: String,
    pub description: String,
    pub tax_type: TaxType,
    pub rate: Decimal,
    pub jurisdiction_id: String,
    pub effective_date: NaiveDate,
    pub expiry_date: Option<NaiveDate>,
    pub is_reverse_charge: bool,
    pub is_exempt: bool,
}

A tax code defining a rate for a specific tax type and jurisdiction.

Fields

id: String

Unique tax code identifier

code: String

Short mnemonic (e.g., “VAT-STD-20”, “WHT-SVC-15”)

description: String

Human-readable description

tax_type: TaxType

Category of tax

rate: Decimal

Tax rate as a decimal fraction (e.g., 0.20 for 20%)

jurisdiction_id: String

Jurisdiction this code applies to

effective_date: NaiveDate

Date from which the code is effective (inclusive)

expiry_date: Option<NaiveDate>

Date after which the code is no longer effective (exclusive)

is_reverse_charge: bool

Whether the reverse-charge mechanism applies

is_exempt: bool

Whether transactions under this code are tax-exempt

Implementations

impl TaxCode

pub fn new( id: impl Into<String>, code: impl Into<String>, description: impl Into<String>, tax_type: TaxType, rate: Decimal, jurisdiction_id: impl Into<String>, effective_date: NaiveDate, ) -> Self

Creates a new tax code.

pub fn with_expiry_date(self, expiry: NaiveDate) -> Self

Sets the expiry date.

pub fn with_reverse_charge(self, reverse_charge: bool) -> Self

Sets the reverse-charge flag.

pub fn with_exempt(self, exempt: bool) -> Self

Sets the exempt flag.

pub fn tax_amount(&self, taxable_amount: Decimal) -> Decimal

Computes the tax amount for a given taxable base.

Returns taxable_amount * rate, rounded to 2 decimal places. Exempt codes always return zero.

pub fn is_active(&self, date: NaiveDate) -> bool

Returns true if the tax code is active on the given date.

A code is active when effective_date <= date and either no expiry is set or date < expiry_date.

Trait Implementations

impl Clone for TaxCode

fn clone(&self) -> TaxCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaxCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaxCode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaxCode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToNodeProperties for TaxCode

fn node_type_name(&self) -> &'static str

Entity type name (snake_case), e.g. "uncertain_tax_position".

fn node_type_code(&self) -> u16

Numeric entity type code for registry, e.g. 416.

fn to_node_properties(&self) -> HashMap<String, GraphPropertyValue>

Convert all fields to a property map with camelCase keys.