cadrumo.domain.modelos.calculation_revision_m303_handoff module

Typed Modelo 303 annual handoff and filing-instance evidence.

class M303RegimenSimplificadoAnnualSummaryHandoff(**data)

Bases: BaseModel

One frozen, source-identified cross-model handoff.

The handoff is calculated before its enclosing target revision has an id. Its digest and unsigned identity payload therefore deliberately exclude target_calculation_revision_id; persistence derives the target revision id from the unsigned payload and then stamps that id on this immutable envelope. No relation, observation replay, or manual binding override can substitute for this exact source calculation contract.

Parameters:

data (Any)

source_bucket_id: BucketId

source_modelo: str

source_work_unit_id: WorkUnitId

source_calculation_revision_id: CalculationRevisionId

source_registry_revision_id: RevisionId

source_filing_year: FilingYear

source_period: Period

source_result_digest: ContentDigest

source_evidence_references: tuple[FilingEvidenceReference, ...]

target_bucket_id: BucketId

target_modelo: str

target_work_unit_id: WorkUnitId

target_registry_revision_id: RevisionId

target_filing_year: FilingYear

target_period: Period

values: Mapping[CasillaId, Decimal]

target_calculation_revision_id: CalculationRevisionId | None

digest: ContentDigest

property source_registry_snapshot_ref: RegistrySnapshotRef

Canonical source registry coordinate carried by the distributed fields.

property target_registry_snapshot_ref: RegistrySnapshotRef

Canonical target registry coordinate carried by the distributed fields.

classmethod assembled(*, source_bucket_id, source_modelo, source_work_unit_id, source_calculation_revision_id, source_registry_revision_id, source_filing_year, source_period_code, source_result_digest, source_evidence_references, target_bucket_id, target_modelo, target_work_unit_id, target_registry_revision_id, target_filing_year, target_period_code, values)

Build an unsigned handoff with its content digest.

This is the only pre-persistence constructor. Revision-selected relation metadata supplies model and period coordinates; this carrier retains only generic identity and evidence mechanics.

Return type:

Self

Parameters:

• source_bucket_id (Annotated[str, StringConstraints(strip_whitespace=True, to_upper=None, to_lower=None, strict=None, min_length=1, max_length=128, pattern=None, ascii_only=None)])

• source_modelo (str)

• source_work_unit_id (WorkUnitId)

• source_calculation_revision_id (CalculationRevisionId)

• source_registry_revision_id (RevisionId)

• source_filing_year (int)

• source_period_code (str)

• source_result_digest (ContentDigest)

• source_evidence_references (tuple[FilingEvidenceReference, ...])

• target_bucket_id (Annotated[str, StringConstraints(strip_whitespace=True, to_upper=None, to_lower=None, strict=None, min_length=1, max_length=128, pattern=None, ascii_only=None)])

• target_modelo (str)

• target_work_unit_id (WorkUnitId)

• target_registry_revision_id (RevisionId)

• target_filing_year (int)

• target_period_code (str)

• values (Mapping[CasillaId, Decimal])

stamped_for_target_calculation_revision(target_calculation_revision_id)

Return this unsigned carrier stamped for its containing revision.

Return type:

Self

Parameters:

target_calculation_revision_id (CalculationRevisionId)

unsigned_identity_payload()

Return the canonical, target-id-free payload used in revision identity.

Return type:

dict[str, object]

class M303RegimenSimplificadoFilingEvidence(**data)

Bases: BaseModel

Taxpayer rows bound to the exact annual Orden and record-design snapshot.

Parameters:

data (Any)

scope_decision: M303RegimenSimplificadoScopeDecision

rows: RegimenSimplificadoFilingRows

regimen_snapshot: M303RegimenSimplificadoSnapshot

dana_eligibility: M303DANAEligibilityEvidence | None

calculation_result: M303RegimenSimplificadoCalculationResult

class M303FilingInstanceEvidence(**data)

Bases: BaseModel

Complete operator-selected facts bound to one Modelo 303 revision.

Parameters:

data (Any)

period: Period

joint_return_elected: bool

annual_volume_nonzero: bool

insolvency: M303InsolvencyFilingFact | None

exonerado_390: M303Exonerado390FilingEvidence

regimen_simplificado: M303RegimenSimplificadoFilingEvidence

class FilingInstanceEvidence(**data)

Bases: BaseModel

Closed filing-instance evidence envelope persisted on a revision.

Parameters:

data (Any)

m303: M303FilingInstanceEvidence