Enum InvoiceField 

pub enum InvoiceField {
    InvoiceNumber(String),
    InvoiceDate(String),
    DueDate(String),
    TotalAmount(f64),
    TaxAmount(f64),
    NetAmount(f64),
    VatNumber(String),
    SupplierName(String),
    CustomerName(String),
    Currency(String),
    ArticleNumber(String),
    LineItemDescription(String),
    LineItemQuantity(f64),
    LineItemUnitPrice(f64),
}

Extracted invoice field with strongly-typed data

Each variant represents a different type of information that can be extracted from an invoice. Fields are matched using language-specific patterns and converted to appropriate types (String for text, f64 for amounts).

Type Conversion

• String fields: Invoice numbers, dates, names (preserved as-is)
• Amount fields: Parsed with language-aware decimal handling
  • European format: 1.234,56 → 1234.56
  • US/UK format: 1,234.56 → 1234.56
• Quantity fields: Parsed as floating-point numbers

Examples

use oxidize_pdf::text::invoice::InvoiceField;

let invoice_number = InvoiceField::InvoiceNumber("INV-2025-001".to_string());
let total = InvoiceField::TotalAmount(1234.56);

assert_eq!(invoice_number.name(), "Invoice Number");
assert_eq!(total.name(), "Total Amount");

Variants

InvoiceNumber(String)

Invoice number (e.g., “INV-2025-001”, “Factura Nº: 2025-001”)

Typically appears near the top of the invoice. Format varies by country and company, but usually includes alphanumeric identifiers.

InvoiceDate(String)

Invoice date as extracted from document

Format varies by language:

• Spanish/Italian: DD/MM/YYYY
• German: DD.MM.YYYY
• English: DD/MM/YYYY or MM/DD/YYYY

Note: Stored as string, not parsed to Date type (MVP)

DueDate(String)

Due date for payment

Same format considerations as InvoiceDate.

TotalAmount(f64)

Total amount including all taxes (in currency units)

Also known as: “Total”, “Grand Total”, “Gesamtbetrag”, “Totale”

TaxAmount(f64)

Tax amount (VAT/IVA/MwSt/IVA in currency units)

Represents the total tax charged. May include breakdown of different tax rates (e.g., 21% VAT, 10% reduced rate).

NetAmount(f64)

Net amount before tax (in currency units)

Also known as: “Subtotal”, “Net Amount”, “Base Imponible”, “Nettobetrag”, “Imponibile”

VatNumber(String)

VAT/Tax identification number

Format varies by country:

• Spain: CIF (A12345678)
• UK: VAT Number (GB123456789)
• Germany: USt-IdNr. (DE123456789)
• Italy: Partita IVA (IT12345678901)

SupplierName(String)

Supplier/Vendor name (company issuing the invoice)

CustomerName(String)

Customer/Client name (company receiving the invoice)

Currency(String)

Currency code (ISO 4217)

Examples: “EUR”, “GBP”, “USD”, “CHF”

ArticleNumber(String)

Article/Product number for line items

SKU, part number, or product code.

LineItemDescription(String)

Line item description/name

Textual description of product or service.

LineItemQuantity(f64)

Line item quantity (units ordered/delivered)

LineItemUnitPrice(f64)

Line item unit price (price per unit, before tax)

Implementations

impl InvoiceField

pub fn name(&self) -> &'static str

Get a human-readable name for this field type

Trait Implementations

impl Clone for InvoiceField

fn clone(&self) -> InvoiceField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvoiceField

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

Formats the value using the given formatter.

impl PartialEq for InvoiceField

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for InvoiceField