aeat.domain.justificante package

Public facade for AEAT justificante receipt metadata.

Callers outside domain.justificante must import receipt-domain types from this module. The facade re-exports the strict Justificante record, JustificanteParserBackend parser contract, and the PdfModeloImportError / JustificanteError hierarchy used by PDF filing-import flows. The encrypted AUDIT store lives in the persistence adapter as JustificanteRepository.

This package is scoped to the AEAT justificante de presentación receipt: CSV, modelo, period, presentation timestamp, taxpayer id, totals, source path, and source hash. A justificante is official submission evidence, but it is not a filing copy and it does not carry per-casilla values. Application import paths may compose a Justificante into a draft scaffold, a local domain.submission.ModeloPresentado audit baseline, or a domain.modelos.ExternalEvidence reference, but casilla-complete declaración, borrador, and predeclaración parsing belongs to their own inbound adapter surfaces.

The PDF parsing pipeline lives in adapters.inbound.justificante; this module intentionally does not re-export parser entry points. Live CSV verification lives in adapters.outbound.aeat.verify, because Playwright/browser automation belongs in the outbound adapter layer, not the domain.

See also

application.filing.import_filing_from_justificante()

Application import path that composes receipt metadata into local draft and submission-audit records without treating it as casilla authority.

application.live

Read-only live-capture surface that can persist and verify justificante evidence against existing filing records.

application.live.register_capture_as_filing_evidence()

Live-capture path that parses a persisted receipt snapshot into Justificante metadata before stamping matching local filing evidence.

application.modelo.import_external_filing_evidence()

Modelo work-unit import path that requires matching JustificanteRepository metadata for receipt-bound evidence kinds.

domain.submission

Local-only domain.submission.ModeloPresentado audit trail populated by imported or historical receipt evidence.

domain.modelos.ExternalEvidence

Work-unit filing-record evidence reference that may point at a persisted justificante without embedding receipt bytes in the model record.

adapters.inbound.justificante

PDF parser implementation kept outside the domain facade.

Submodules