aeat.adapters.inbound.financial.providers package

Bank-statement provider contract and concrete file-ingest implementations.

Defines the financial-statement provider contract and the concrete per-format parsers behind aeat app ledger import. Detection picks the right provider for a file; each provider parses a bank statement into domain.transactions.RawTransaction records plus an explicit domain.transactions.TransactionDirection. The provider layer parses rows only; application ledger import owns active-bucket routing, transaction persistence, currency normalization, and bucket events.

Concrete providers also declare corpus provenance through CorpusVerificationSource. PDF providers use BankStatementParseError structured attributes for missing, malformed, ambiguous, and coverage failures so callers do not need to parse messages.

Major declarations:

• FinancialProvider — the provider abstract base class.

• CorpusVerificationSource and ProviderValidation — the provider corpus and pre-ingest validation contracts.

• ParsedLedgerRow — one parsed raw transaction paired with its authoritative flow direction.

• CsvProvider, OfxProvider, XlsxProvider, and PdfN26Provider — the concrete per-format parsers.

• detect_provider() and provider_for_extension() — resolve the provider for a given source.

• FinancialProviderError and its subclasses (BankStatementParseError, UnsupportedFinancialSourceError, InvalidFinancialSourceError, FinancialValidationError) — the failure taxonomy.

See also

• adapters.inbound.financial for the parent financial-import facade.

• application.ledger for the operator-facing import service that calls these providers and persists ledger transactions.

• domain.transactions for the raw transaction records produced by successful parsing.

Submodules

• aeat.adapters.inbound.financial.providers._base module
  • Provider corpus discipline
  • CorpusVerificationSource
  • FinancialProviderError
    • FinancialProviderError.code
  • FinancialProviderConfigError
    • FinancialProviderConfigError.code
  • UnsupportedFinancialSourceError
    • UnsupportedFinancialSourceError.code
  • InvalidFinancialSourceError
    • InvalidFinancialSourceError.code
  • FinancialValidationError
    • FinancialValidationError.code
  • BankStatementParseError
    • BankStatementParseError.code
  • ProviderValidation
    • ProviderValidation.is_valid
    • ProviderValidation.warnings
    • ProviderValidation.detected_encoding
    • ProviderValidation.detected_dialect
  • FinancialProvider
    • FinancialProvider.name
    • FinancialProvider.supported_extensions
    • FinancialProvider.source_format
    • FinancialProvider.verification_source
    • FinancialProvider.provisional_pending_specimen
    • FinancialProvider.can_handle()
    • FinancialProvider.ingest()
    • FinancialProvider.validate_source()
  • describe_dialect()
  • normalize_header()
  • coerce_cell_text()
  • parse_date_value()
  • parse_amount_value()
  • synthesize_transaction_id()
  • ParsedLedgerRow
    • ParsedLedgerRow.raw
    • ParsedLedgerRow.direction
  • direction_from_signed_amount()
  • build_raw_transaction()
  • default_currency()
• aeat.adapters.inbound.financial.providers._constants module
  • CSV_EXTENSIONS
• aeat.adapters.inbound.financial.providers._csv module
  • CsvColumnMap
    • CsvColumnMap.booked_date
    • CsvColumnMap.value_date
    • CsvColumnMap.amount
    • CsvColumnMap.direction
    • CsvColumnMap.currency
    • CsvColumnMap.description
    • CsvColumnMap.counterparty
    • CsvColumnMap.external_id
  • CsvBankLayout
    • CsvBankLayout.bank_name
    • CsvBankLayout.columns
    • CsvBankLayout.day_first_dates
    • CsvBankLayout.decimal_separator
  • CSV_LAYOUTS
  • ParsedTabularTransactionRow
    • ParsedTabularTransactionRow.provider_transaction_id
    • ParsedTabularTransactionRow.booked_date
    • ParsedTabularTransactionRow.value_date
    • ParsedTabularTransactionRow.amount
    • ParsedTabularTransactionRow.direction
    • ParsedTabularTransactionRow.currency
    • ParsedTabularTransactionRow.description
    • ParsedTabularTransactionRow.counterparty
  • CsvProvider
    • CsvProvider.name
    • CsvProvider.supported_extensions
    • CsvProvider.source_format
    • CsvProvider.verification_source
    • CsvProvider.provisional_pending_specimen
    • CsvProvider.validate_source()
    • CsvProvider.ingest()
• aeat.adapters.inbound.financial.providers._detection module
  • provider_for_extension()
  • detect_provider()
• aeat.adapters.inbound.financial.providers._ofx module
  • OfxProvider
    • OfxProvider.name
    • OfxProvider.supported_extensions
    • OfxProvider.source_format
    • OfxProvider.verification_source
    • OfxProvider.provisional_pending_specimen
    • OfxProvider.validate_source()
    • OfxProvider.ingest()
• aeat.adapters.inbound.financial.providers._pdf_n26 module
  • PdfN26Provider
    • PdfN26Provider.name
    • PdfN26Provider.supported_extensions
    • PdfN26Provider.source_format
    • PdfN26Provider.verification_source
    • PdfN26Provider.provisional_pending_specimen
    • PdfN26Provider.validate_source()
    • PdfN26Provider.ingest()
• aeat.adapters.inbound.financial.providers._xlsx module
  • XlsxProvider
    • XlsxProvider.name
    • XlsxProvider.supported_extensions
    • XlsxProvider.source_format
    • XlsxProvider.verification_source
    • XlsxProvider.provisional_pending_specimen
    • XlsxProvider.validate_source()
    • XlsxProvider.ingest()