cadrumo.application.modelo.settlement_casilla module

Which casilla settles a modelo revision, read from the registry.

A declaration’s settled result is the number an operator scans a list for, and naming it is a filing-grade claim: showing the wrong casilla as “the result” misreports what the taxpayer owes. So the answer comes from the registry’s own semantic_role declaration and from nowhere else – never from a casilla number, a position, or a label that reads like a total.

Coverage is deliberately narrow and will stay that way until each modelo’s settlement chain is modelled. SETTLEMENT_SEMANTIC_ROLES holds the grounded terminal-liquidación roles, Modelo 100 today; modelo 303’s casillas carry positional roles such as dr303_23 that name no meaning, so this resolver returns nothing for them rather than guessing. A caller must render that absence as “not available”, not as a blank or a zero.

SETTLEMENT_SEMANTIC_ROLES: Final

Terminal-liquidación semantic_role values, per settlement-bearing modelo.

Grounded in the #39 settlement-completeness audit: Modelo 100 cuota resultante de la autoliquidación (casilla 0595, the liability before pagos a cuenta) and resultado de la declaración (0670).

Modelo 100 today. Extend as further modelos’ settlement chains are modelled – and only from the official record design for that modelo, because the whole point of reading a declared role is that nobody has to infer which cell is the result. A modelo absent here yields no settlement casilla, which is a safe false negative: the surface says it does not know rather than naming a cell on no authority.

DECLARATION_RESULT_SEMANTIC_ROLES: Final

The roles that name a declaration’s FINAL result – a strict subset of the above.

Both settlement roles are terminal-liquidación cells, and both must be computed before filing, which is why the advisory watches the whole set. Only one of them is the number an operator means by “the result”: Modelo 100 declares irpf_cuota_resultante_autoliquidacion (casilla 0595) for the liability BEFORE pagos a cuenta, and irpf_resultado_declaracion (0670) for what the declaration actually settles.

Reading the registry is what surfaced this. A first version of this resolver matched the full settlement set and would have raised ambiguity on M100 – the only modelo it covers – because that revision legitimately declares both.

exception AmbiguousDeclarationResultError(message=None, *, context=None, translated_message=None)

Bases: CadrumoError

A revision declares more than one final-result casilla.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• translated_message (str | None)

Return type:

None

code

class SettlementCasillaV1(*args, **kwargs)

Bases: Protocol

The casilla surface declaration_result_casilla_id() reads.

property id: CasillaId

property semantic_role: str | None

class SettlementRevisionV1(*args, **kwargs)

Bases: Protocol

The revision surface declaration_result_casilla_id() reads.

Structural rather than the whole ModeloRevision because the reader consumes only an id and the casillas’ roles. A revision declaring two result casillas is the defect this function refuses, and the shipped registry cannot express it, so the refusal is exercised through a value carrying just this surface.

property id: str

property casillas: Sequence[SettlementCasillaV1]

declaration_result_casilla_id(revision)

Return the casilla holding this revision’s final result, or nothing.

Returns None for a revision whose casillas declare no result role. That is the ordinary case today – most modelos are not yet modelled to this depth – and it is deliberately indistinguishable from “the registry has not said”, because it IS that. A caller renders the absence as unknown, never as a blank or a zero.

Raises:

AmbiguousDeclarationResultError – Two or more casillas claim the result role. A declaration with two results has none, and picking the first would publish one of them as the answer on no grounds; the registry declaration is wrong and must be fixed rather than resolved here.

Return type:

TypeAliasType | None

Parameters:

revision (SettlementRevisionV1)