cadrumo.application.modelo.registry_discovery module

Application Modelo registry discovery queries.

CLI discovery commands call this module instead of constructing the eager legacy query service or reading the registry authority directly. Each query leases one indexed operation and returns the domain query report unchanged.

The *_for_scope helpers accept a concrete Period and pass its filing year plus bare registry token into the query service, so revision selection stays inside the authority-backed registry layer.

declared_modelo_period_tokens(modelo, *, operation)

Return every period token declared by any revision of one modelo.

Return type:

tuple[str, ...]

Parameters:

• modelo (str | None)

• operation (PinnedAuthorityOperation)

registry_modelo_codes(*, operation)

Return registry-backed modelo codes in authority order.

Return type:

tuple[str, ...]

Parameters:

operation (PinnedAuthorityOperation)

registry_support_matrix(*, operation)

Return the registry-wide per-modelo support/capability matrix.

Every ModeloEntry is derived directly from the loaded registry authority (calc-grade, manifest, export formats, extractor, declared casilla renames, declared deprecation decisions, and declared AEAT-portal cross-references) — never hand-maintained.

Return type:

ModeloSupportMatrixReport

Parameters:

operation (PinnedAuthorityOperation)

registry_list_modelos(*, year=None, domain=None, operation)

Return the registry modelo list report, optionally filtered by tax family.

Return type:

ModeloListReport

Parameters:

• year (int | None)

• domain (TaxDomain | None)

• operation (PinnedAuthorityOperation)

registry_describe_modelo(modelo, *, period=None, as_of=None, operation)

Return the registry modelo description report.

Return type:

ModeloDescribeReport

Parameters:

• modelo (str)

• period (str | None)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_describe_modelo_for_scope(modelo, *, period, as_of=None, operation)

Return the registry modelo description report for an exact Period.

Return type:

ModeloDescribeReport

Parameters:

• modelo (str)

• period (Period)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_describe_modelo_for_registry_scope(modelo, *, filing_year, period, as_of=None, operation)

Return a modelo description for an explicit filing-year registry scope.

Return type:

ModeloDescribeReport

Parameters:

• modelo (str)

• filing_year (int)

• period (str)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_casillas(modelo, *, period=None, as_of=None, input_kind=None, required=None, form_number=None, operation)

Return the registry casilla report.

Return type:

ModeloCasillasReport

Parameters:

• modelo (str)

• period (str | None)

• as_of (date | None)

• input_kind (InputKind | None)

• required (bool | None)

• form_number (str | None)

• operation (PinnedAuthorityOperation)

registry_casillas_for_scope(modelo, *, period, as_of=None, input_kind=None, required=None, form_number=None, operation)

Return the registry casilla report for an exact Period.

Return type:

ModeloCasillasReport

Parameters:

• modelo (str)

• period (Period)

• as_of (date | None)

• input_kind (InputKind | None)

• required (bool | None)

• form_number (str | None)

• operation (PinnedAuthorityOperation)

registry_casillas_for_registry_scope(modelo, *, filing_year, period, as_of=None, input_kind=None, required=None, form_number=None, operation)

Return casillas for an explicit filing-year registry scope.

Return type:

ModeloCasillasReport

Parameters:

• modelo (str)

• filing_year (int)

• period (str)

• as_of (date | None)

• input_kind (InputKind | None)

• required (bool | None)

• form_number (str | None)

• operation (PinnedAuthorityOperation)

registry_casilla(modelo, casilla, *, period=None, as_of=None, operation)

Return the single-casilla semantic detail report.

Return type:

ModeloCasillaDetailReport

Parameters:

• modelo (str)

• casilla (str)

• period (str | None)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_casilla_for_registry_scope(modelo, casilla, *, filing_year, period, as_of=None, operation)

Return one casilla detail for an explicit filing-year registry scope.

Return type:

ModeloCasillaDetailReport

Parameters:

• modelo (str)

• casilla (str)

• filing_year (int)

• period (str)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_bindings(modelo, *, period=None, as_of=None, operation)

Return the registry bindings report for a modelo and optional period.

Return type:

ModeloBindingsReport

Parameters:

• modelo (str)

• period (str | None)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_bindings_for_year(modelo, *, filing_year, as_of=None, operation)

Return the registry bindings report for a filing year.

Return type:

ModeloBindingsReport

Parameters:

• modelo (str)

• filing_year (int)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_bindings_for_scope(modelo, *, period, as_of=None, operation)

Return the registry bindings report for an exact Period.

Return type:

ModeloBindingsReport

Parameters:

• modelo (str)

• period (Period)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_formulas(modelo, *, period=None, as_of=None, operation)

Return the registry formulas report.

Return type:

ModeloFormulasReport

Parameters:

• modelo (str)

• period (str | None)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_formulas_for_scope(modelo, *, period, as_of=None, operation)

Return the registry formulas report for an exact Period.

Return type:

ModeloFormulasReport

Parameters:

• modelo (str)

• period (Period)

• as_of (date | None)

• operation (PinnedAuthorityOperation)

registry_formulas_for_registry_scope(modelo, *, filing_year, period, as_of=None, operation)

Return formulas for an explicit filing-year registry scope.

Return type:

ModeloFormulasReport

Parameters:

• modelo (str)

• filing_year (int)

• period (str)

• as_of (date | None)

• operation (PinnedAuthorityOperation)