aeat.application.invoices package

Application invoice orchestration and calculation-source surface.

This package is the public application boundary for invoice catalogue import, linking, review, reconciliation, and source-mesh projection. Callers outside the subpackage must import only from this module so private underscore-prefixed implementation modules can evolve freely.

The calculation-facing export is InvoiceCatalogueSourceResolver. It projects both rich domain.invoices.InvoiceCatalogue entries and slim application.ledger.BusinessOperationInvoice records into application.aggregation.CalculationSourceResolution values for the core.BindingSourceKind.COLLECTIBLE_INVOICE and core.BindingSourceKind.PAYABLE_INVOICE source kinds. The helper invoice_direction_to_source_kind() is the single direction-to-settlement mapping shared with the operator aeat app ledger invoice surface.

Key exports:

• find_invoice(), find_unmatched() — read paths against the invoice catalogue.

• link_invoice_transaction_repositories() — persisted bidirectional invoice/transaction linking.

• LinkInconsistency — audit result for cross-side link integrity.

• InvoiceCatalogueSourceResolver — the live calculate-path resolver for invoice-source bindings and Modelo 349 detail rows.

domain.invoices.link_transaction(), domain.invoices.suggest_reconciliations(), and domain.invoices.verify_link_consistency() are NOT re-exported here; domain.invoices is their sole canonical source (import-centralization ADR ruling 5).

See also

domain.invoices

Rich invoice catalogue, line arithmetic, payment state, and reconciliation/link authority adapted by this application facade.

application.ledger

Slim payable/collectible invoice CRUD and ledger transaction evidence links that converge with invoice catalogue data at source resolution.

domain.transactions

Transaction catalogue whose ids are linked from invoices and reported as calculation source provenance.

application.aggregation

Source-mesh envelope receiving invoice binding values, diagnostics, detail rows, and provenance.

domain.calculations.registry

Pure binding declarations and invoice observation contracts consumed by modelo calculation.

Submodules

• aeat.application.invoices._bulk_import module
  • BulkInvoiceImportRow
    • BulkInvoiceImportRow.counterparty_nif
    • BulkInvoiceImportRow.counterparty_name
    • BulkInvoiceImportRow.invoice_number
    • BulkInvoiceImportRow.invoice_date
    • BulkInvoiceImportRow.taxable_base
    • BulkInvoiceImportRow.iva_rate
    • BulkInvoiceImportRow.currency
    • BulkInvoiceImportRow.country_code
    • BulkInvoiceImportRow.notes
  • BulkInvoiceImportRowFailure
    • BulkInvoiceImportRowFailure.row_number
    • BulkInvoiceImportRowFailure.field
    • BulkInvoiceImportRowFailure.reason
  • BulkInvoiceImportResult
    • BulkInvoiceImportResult.rows
    • BulkInvoiceImportResult.created
    • BulkInvoiceImportResult.skipped_duplicate
    • BulkInvoiceImportResult.refused
    • BulkInvoiceImportResult.created_invoice_ids
  • read_bulk_invoice_import_rows()
  • import_invoices_from_rows()
• aeat.application.invoices._creation module
  • numeric_iva_rate_slots()
  • CatalogueInvoiceCreateResult
    • CatalogueInvoiceCreateResult.invoice
    • CatalogueInvoiceCreateResult.catalogue
  • build_catalogue_invoice()
  • create_catalogue_invoice()
• aeat.application.invoices._importing module
  • InvoiceRowPayload
    • InvoiceRowPayload.invoice_id
    • InvoiceRowPayload.bucket_id
    • InvoiceRowPayload.kind
    • InvoiceRowPayload.currency
    • InvoiceRowPayload.invoice_number
    • InvoiceRowPayload.issued_at
    • InvoiceRowPayload.counterparty_name
    • InvoiceRowPayload.counterparty_tax_id
    • InvoiceRowPayload.counterparty_country
    • InvoiceRowPayload.payment_status
    • InvoiceRowPayload.lines
    • InvoiceRowPayload.base_total
    • InvoiceRowPayload.iva_total
    • InvoiceRowPayload.grand_total
    • InvoiceRowPayload.linked_transaction_ids
    • InvoiceRowPayload.notes
    • InvoiceRowPayload.iva_category
    • InvoiceRowPayload.operation_type
    • InvoiceRowPayload.oss_ioss_regime
    • InvoiceRowPayload.oss_transaction_kind
    • InvoiceRowPayload.retention_rate
    • InvoiceRowPayload.retention_amount
    • InvoiceRowPayload.payment_id
  • InvoiceImportResult
    • InvoiceImportResult.rows
    • InvoiceImportResult.imported
    • InvoiceImportResult.skipped
    • InvoiceImportResult.dry_run
    • InvoiceImportResult.catalogue
  • parse_invoice_payload()
  • merge_invoice_import()
  • import_invoices_from_path()
• aeat.application.invoices._lifecycle module
  • CatalogueInvoiceRemoveResult
    • CatalogueInvoiceRemoveResult.invoice
    • CatalogueInvoiceRemoveResult.catalogue
  • resolve_catalogue_invoice()
  • resolve_catalogue_invoice_from_repository()
  • remove_catalogue_invoice()
• aeat.application.invoices._linking module
  • InvoiceTransactionLinkResult
    • InvoiceTransactionLinkResult.invoice_id
    • InvoiceTransactionLinkResult.transaction_id
    • InvoiceTransactionLinkResult.invoice
    • InvoiceTransactionLinkResult.invoices
    • InvoiceTransactionLinkResult.transactions
  • link_invoice_transaction_catalogues()
  • link_invoice_transaction_repositories()
• aeat.application.invoices._projection module
  • InvoiceReviewProjection
    • InvoiceReviewProjection.id
    • InvoiceReviewProjection.kind
    • InvoiceReviewProjection.issued_at
    • InvoiceReviewProjection.base
    • InvoiceReviewProjection.iva
    • InvoiceReviewProjection.status
    • InvoiceReviewProjection.payment
    • InvoiceReviewProjection.payment_id
    • InvoiceReviewProjection.review
  • InvoiceMatchRow
    • InvoiceMatchRow.invoice
    • InvoiceMatchRow.payment
  • InvoiceMatchProjection
    • InvoiceMatchProjection.period
    • InvoiceMatchProjection.matched
    • InvoiceMatchProjection.unmatched
  • project_invoice_reviews()
  • project_invoice_review()
  • invoice_display_amounts()
  • invoice_review_status()
  • apply_manual_invoice_match()
  • project_invoice_payment_matches()
• aeat.application.invoices._queries module
  • InvoiceListRow
    • InvoiceListRow.invoice_id
    • InvoiceListRow.kind
    • InvoiceListRow.issued_at
    • InvoiceListRow.counterparty_name
    • InvoiceListRow.grand_total
    • InvoiceListRow.currency
    • InvoiceListRow.payment_status
  • list_invoice_rows()
  • list_invoice_repository_rows()
  • get_invoice_from_repository()
  • list_unmatched_invoice_rows()
  • list_unmatched_invoice_repository_rows()
  • verify_invoice_repository_links()
• aeat.application.invoices._reconciliation module
  • ReconciliationSkippedSuggestion
    • ReconciliationSkippedSuggestion.invoice_id
    • ReconciliationSkippedSuggestion.transaction_id
    • ReconciliationSkippedSuggestion.reason
  • InvoiceReconciliationResult
    • InvoiceReconciliationResult.suggestions
    • InvoiceReconciliationResult.applied
    • InvoiceReconciliationResult.skipped
    • InvoiceReconciliationResult.invoices
    • InvoiceReconciliationResult.transactions
  • reconcile_invoice_catalogues()
  • reconcile_invoice_repositories()
• aeat.application.invoices._source_resolver module
  • invoice_direction_to_source_kind()
  • InvoiceCatalogueSourceResolver
    • InvoiceCatalogueSourceResolver.resolver_id
    • InvoiceCatalogueSourceResolver.owned_sources
    • InvoiceCatalogueSourceResolver.resolve()
• aeat.application.invoices._wizard module
  • InvoiceWizardFieldError
    • InvoiceWizardFieldError.field
    • InvoiceWizardFieldError.reason
  • InvoiceWizardResult
    • InvoiceWizardResult.invoice
    • InvoiceWizardResult.already_existed
  • create_invoice_via_wizard()