aeat.application.live._filed_data_capture module

Filed-declaration capture services for live AEAT workflows.

The listing helpers read AEAT declaration-register rows without downloading artefacts. The capture helpers download the selected filed-declaration artefacts through the authenticated Sede adapter, persist encrypted FiledDeclaracionObservation payloads and artefacts, promote extracted casillas into registry-grounded calculation observations, and attempt to stamp matching current ModeloRecord filings with live ExternalEvidence.

Source capture resolves a ValidatedRegistryAuthority before asking the Sede adapter which prior declarations a target filing needs, so cross-period inputs remain registry-authored rather than adapter-inferred. The module never creates a remote submission or mutates AEAT state; filing-record stamping is local evidence enrollment against an existing current record.

See also

aeat.application.live._session.active_verified_session()

Enforces the read-only live gate before the register walker is opened.

aeat.application.live._filed_observation_persistence.persist_latest_filed_calculation_observations()

Persists the latest captured filed observations as calculation-history evidence.

aeat.application.live._filed_observation_persistence.enroll_filed_justificante_evidence()

Persists matching justificante metadata and stamps current filing records when the receipt matches.

filed_data_capture_failure_row(*, modelo, year, error, declaration=None)

Map one failed capture into a FiledDataCaptureFailureRow.

Return type:

FiledDataCaptureFailureRow

Parameters:

• modelo (str)

• year (int)

• error (BaseException)

• declaration (Declaracion | None)

async list_filed_data(*, modelo, year_from, year_to)

List declarations via AEAT and return a FiledDataListingReport.

Return type:

FiledDataListingReport

Parameters:

• modelo (str)

• year_from (int)

• year_to (int)

async list_filed_data_bulk(*, year_from, year_to, modelos=None)

List filed declarations across modelos with one authenticated register session.

Return type:

BulkFiledDataListingReport

Returns:

A BulkFiledDataListingReport of the per-modelo rows and failures.

Parameters:

• year_from (int)

• year_to (int)

• modelos (tuple[str, ...] | None)

async capture_filed_data(*, modelo, year, output_root, period=None, expediente_id=None, limit=None)

Capture filed-declaration artefacts and return a FiledDataCaptureReport.

The report accounts for persisted observation manifests, encrypted artefact references, saved justificante CSVs, stamped aeat.domain.modelos.ModeloRecord ids, conflicts, and calculation observation keys produced from the captured AEAT rows.

Return type:

FiledDataCaptureReport

Parameters:

• modelo (str)

• year (int)

• output_root (Path)

• period (Period | None)

• expediente_id (str | None)

• limit (int | None)

async capture_filed_data_bulk(*, year_from, year_to, output_root, modelos=None, limit=None)

Capture filed declarations across a year range and return a BulkFiledDataCaptureReport.

Unsupported modelo/year pairs are recorded as failures before live contact. Supported pairs share one authenticated register session and then follow the same persistence, justificante enrolment, and calculation-observation path as capture_filed_data().

Return type:

BulkFiledDataCaptureReport

Parameters:

• year_from (int)

• year_to (int)

• output_root (Path)

• modelos (tuple[str, ...] | None)

• limit (int | None)

async capture_source_filed_data(*, modelo, year, period, output_root, registry_root=None, source_root=None)

Capture source observations and return a SourceFiledDataCaptureReport.

Return type:

SourceFiledDataCaptureReport

Parameters:

• modelo (str)

• year (int)

• period (Period)

• output_root (Path)

• registry_root (Path | None)

• source_root (Path | None)

capture_report_path(path, *, output_root)

Return a stable report path relative to the configured output root when possible.

Return type:

str

Parameters:

• path (Path)

• output_root (Path)