app.parsers.schemas module

class app.parsers.schemas.ColumnMapping(date: int | None = None, value_date: int | None = None, description: int | None = None, reference: int | None = None, amount: int | None = None, debit: int | None = None, credit: int | None = None, balance: int | None = None, currency: int | None = None, transaction_type: int | None = None)

Bases: object

Maps logical field names to actual CSV column indices.

amount: int | None = None

balance: int | None = None

credit: int | None = None

currency: int | None = None

date: int | None = None

debit: int | None = None

description: int | None = None

reference: int | None = None

transaction_type: int | None = None

value_date: int | None = None

class app.parsers.schemas.ParsedBankStatement(bank_name: str | None, account_number: str | None, account_holder: str | None, currency: str | None, statement_from: ~datetime.date | None, statement_to: ~datetime.date | None, opening_balance: ~decimal.Decimal | None, closing_balance: ~decimal.Decimal | None, transactions: list[~app.parsers.schemas.ParsedTransaction], detected_encoding: str, detected_delimiter: str, detected_format: str, raw_headers: dict, column_mapping: ~app.parsers.schemas.ColumnMapping, total_rows_parsed: int, total_rows_skipped: int, parser_version: str = 'csv-parser-v1.0.0', warnings: list[dict] = <factory>)

Bases: object

Final result from the full CSV parsing pipeline.

account_holder: str | None

account_number: str | None

bank_name: str | None

closing_balance: Decimal | None

column_mapping: ColumnMapping

currency: str | None

detected_delimiter: str

detected_encoding: str

detected_format: str

opening_balance: Decimal | None

parser_version: str = 'csv-parser-v1.0.0'

raw_headers: dict

statement_from: date | None

statement_to: date | None

total_rows_parsed: int

total_rows_skipped: int

transactions: list[ParsedTransaction]

warnings: list[dict]

class app.parsers.schemas.ParsedInvoice(invoice_number: str | None = None, invoice_date: datetime.date | None = None, due_date: datetime.date | None = None, currency: str | None = None, subtotal: decimal.Decimal | None = None, tax_amount: decimal.Decimal | None = None, discount_amount: decimal.Decimal | None = None, total_amount: decimal.Decimal | None = None, raw_vendor_name: str | None = None, raw_date_text: str | None = None, raw_total_text: str | None = None, confidence: decimal.Decimal = Decimal('1.000'), notes: str | None = None, line_items: list[app.parsers.schemas.ParsedInvoiceLineItem] = <factory>, warnings: list[str] = <factory>, parser_version: str = 'pdf-parser-v1.0.0')

Bases: object

confidence: Decimal = Decimal('1.000')

currency: str | None = None

discount_amount: Decimal | None = None

due_date: date | None = None

invoice_date: date | None = None

invoice_number: str | None = None

line_items: list[ParsedInvoiceLineItem]

notes: str | None = None

parser_version: str = 'pdf-parser-v1.0.0'

raw_date_text: str | None = None

raw_total_text: str | None = None

raw_vendor_name: str | None = None

subtotal: Decimal | None = None

tax_amount: Decimal | None = None

total_amount: Decimal | None = None

warnings: list[str]

class app.parsers.schemas.ParsedInvoiceLineItem(line_number: int, description: str | None = None, quantity: decimal.Decimal | None = None, unit_price: decimal.Decimal | None = None, line_total: decimal.Decimal | None = None, tax_rate: decimal.Decimal | None = None, tax_amount: decimal.Decimal | None = None, sku: str | None = None, unit_of_measure: str | None = None)

Bases: object

description: str | None = None

line_number: int

line_total: Decimal | None = None

quantity: Decimal | None = None

sku: str | None = None

tax_amount: Decimal | None = None

tax_rate: Decimal | None = None

unit_of_measure: str | None = None

unit_price: Decimal | None = None

class app.parsers.schemas.ParsedTransaction(row_index: int, transaction_date: date, value_date: date | None, description: str | None, raw_description: str | None, reference_number: str | None, transaction_type: TransactionType, amount: Decimal, direction: str, balance_after: Decimal | None, currency: str | None, parse_warnings: list[str] = <factory>)

Bases: object

One fully-parsed transaction row.

amount: Decimal

balance_after: Decimal | None

currency: str | None

description: str | None

direction: str

parse_warnings: list[str]

raw_description: str | None

reference_number: str | None

row_index: int

transaction_date: date

transaction_type: TransactionType

value_date: date | None