aeat.application.invoices._linking module¶

Application service for explicit invoice-to-transaction linking.

link_invoice_transaction_repositories() loads both the InvoiceCatalogue via InvoiceCatalogueRepository and the TransactionCatalogue via TransactionCatalogueRepository, applies the bidirectional link, and persists both updated catalogues.

class InvoiceTransactionLinkResult(**data)[source]¶

Bases: BaseModel

Result of a persisted bidirectional invoice link command.

Parameters:

invoice_id (str)
transaction_id (str)
invoice (Invoice)
invoices (InvoiceCatalogue)
transactions (TransactionCatalogue)

invoice_id: str¶

transaction_id: str¶

invoice: Invoice¶

invoices: InvoiceCatalogue¶

transactions: TransactionCatalogue¶

link_invoice_transaction_catalogues(invoices, transactions, *, invoice_id, transaction_id)[source]¶

Link one invoice to one transaction, returning the updated catalogues.

Returns an InvoiceTransactionLinkResult where the invoice and transaction cite each other.

Parameters:

invoices (InvoiceCatalogue) – The InvoiceCatalogue to update with the new link.
transactions (TransactionCatalogue) – The TransactionCatalogue to update with the new link.
invoice_id (str) – Identifier of the invoice to link.
transaction_id (str) – Identifier of the transaction to link; resolved to its canonical form against transactions before linking.

Return type:

InvoiceTransactionLinkResult

link_invoice_transaction_repositories(*, bucket_id, invoice_id, transaction_id, invoice_repository=None, transaction_repository=None)[source]¶

Persist a bidirectional invoice link through the backend repositories.

Returns an InvoiceTransactionLinkResult with the updated invoice and transaction catalogues after the link is written.

Return type:

InvoiceTransactionLinkResult

Parameters:

bucket_id (str)
invoice_id (str)
transaction_id (str)
invoice_repository (InvoiceCatalogueRepositoryProtocol | None)
transaction_repository (TransactionCatalogueRepositoryProtocol | None)