aeat.domain.calculations.registry._filed_state module

Filed-state comparison for registry calculation outputs.

class RegistryFiledStateDrift(**data)[source]

Bases: BaseModel

One casilla whose local calculation does not match filed AEAT state.

formula_id, legal_refs, and source_refs carry the regulatory grounding for the casilla from the typed calculation observation.

Parameters:

  • casilla_id (CasillaId)

  • local_value (Decimal)

  • filed_value (Decimal)

  • delta (Decimal)

  • formula_id (FormulaId | None)

  • legal_refs (tuple[LegalRefId, ...])

  • source_refs (tuple[SourceRefId, ...])

casilla_id: CasillaId
local_value: Decimal
filed_value: Decimal
delta: Decimal
formula_id: FormulaId | None
legal_refs: tuple[LegalRefId, ...]
source_refs: tuple[SourceRefId, ...]
class RegistryFiledStateComparison(**data)[source]

Bases: BaseModel

Verdict for one local calculation versus one normalized filed observation.

Parameters:

  • modelo (ModeloId)

  • revision (str)

  • filing_period (Period | None)

  • filing_year (int)

  • period (str)

  • status (Literal['satisfied', 'failed'])

  • compared_casilla_ids (tuple[CasillaId, ...])

  • missing_local_casilla_ids (tuple[CasillaId, ...])

  • missing_filed_casilla_ids (tuple[CasillaId, ...])

  • drifts (tuple[RegistryFiledStateDrift, ...])

modelo: ModeloId
revision: str
filing_period: Period | None
filing_year: int
period: str
status: Literal['satisfied', 'failed']
compared_casilla_ids: tuple[CasillaId, ...]
missing_local_casilla_ids: tuple[CasillaId, ...]
missing_filed_casilla_ids: tuple[CasillaId, ...]
drifts: tuple[RegistryFiledStateDrift, ...]
compare_calculation_to_filed_observation(calculation, observation, *, required_casilla_ids)[source]

Compare local registry calculation values against filed AEAT casillas.

Each RegistryFiledStateDrift in the returned comparison carries formula_id, legal_refs, and source_refs from the typed CasillaObservation envelope, so the regulatory grounding for every drifted casilla is preserved in the comparison result and propagates to CLI / audit surfaces.

Return type:

RegistryFiledStateComparison

Returns:

A RegistryFiledStateComparison summarising all casilla-level drift.

Parameters: