cadrumo.domain.calculations.registry.runtime_catalogues module

Canonical typed runtime tables published with the registry authority.

class PublishedIvaCitation(**data)[source]

Bases: RegistryModel

One dated legal citation embedded in an IVA operative rule.

Parameters:

data (Any)

legal_reference: str
quoted_text: str
grounding: Literal['verified', 'unresolved']
unresolved_reason: str
retrieval_date: date
valid_from: date
valid_to: date
class PublishedIvaRegulation(**data)[source]

Bases: RegistryModel

One typed IVA category regulation and its legal grounding.

Parameters:
category: str
requires_reverse_charge: bool
requires_supplier_iva_id: bool
manual_references: tuple[str, ...]
citations: tuple[PublishedIvaCitation, ...]
notes: str
legal_basis_exempt: bool
class PublishedIvaPlaceOfSupplyRule(**data)[source]

Bases: RegistryModel

One dated place-of-supply rule published for runtime selection.

Parameters:

  • rule_id (str)

  • supply_nature (str | None)

  • legal_references (tuple[str, ...])

  • establishing_reference (str)

  • notes (str)

  • legal_basis_exempt (bool)

  • valid_from (date | None)

  • valid_to (date | None)

rule_id: str
supply_nature: str | None
legal_references: tuple[str, ...]
establishing_reference: str
notes: str
legal_basis_exempt: bool
valid_from: date | None
valid_to: date | None
class PublishedRecargoBand(**data)[source]

Bases: RegistryModel

One contiguous late-filing surcharge band.

Parameters:

  • id (str)

  • min_completed_months (int)

  • max_completed_months (int | None)

  • surcharge_pct (Decimal)

  • interest_applies (bool)

  • legal_ref (str)

id: str
min_completed_months: int
max_completed_months: int | None
surcharge_pct: Decimal
interest_applies: bool
legal_ref: str
class CountryVocabularyRecord(**data)[source]

Bases: RegistryModel

One canonical country code and its accepted printed names.

Parameters:
code: str
alpha3: str
names: tuple[str, ...]
notes: str
class SpanishPostalTerritory(**data)[source]

Bases: RegistryModel

One Spanish postal-prefix classification for IVA territory.

Parameters:
postal_prefixes: tuple[str, ...]
scope: str
name: str
legal_refs: tuple[str, ...]
notes: str
class TerritoryCarveOut(**data)[source]

Bases: RegistryModel

One special territory’s explicit IVA disposition.

Parameters:

  • code (str)

  • name (str)

  • assimilated_to (str | None)

  • scope (str | None)

  • establishes_nothing (bool)

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

  • notes (str)

code: str
name: str
assimilated_to: str | None
scope: str | None
establishes_nothing: bool
legal_refs: tuple[str, ...]
notes: str
class ApoderamientoScopeRecord(**data)[source]

Bases: RegistryModel

One published authorization scope and its modelo coverage.

Parameters:
code: str
name_es: str
name_en: str
name_ca: str
name_hu: str
modelo_codes: tuple[str, ...]
class RuntimeRegistryCatalogues(**data)[source]

Bases: RegistryModel

Every former raw runtime table, reconstructed without TOML access.

Parameters:
iva_regulations: Annotated[Mapping[str, PublishedIvaRegulation], FROZEN_MAPPING]
iva_place_of_supply: Annotated[Mapping[str, PublishedIvaPlaceOfSupplyRule], FROZEN_MAPPING]
countries: Annotated[Mapping[str, CountryVocabularyRecord], FROZEN_MAPPING]
spanish_postal_territories: Annotated[Mapping[str, SpanishPostalTerritory], FROZEN_MAPPING]
territory_carve_outs: Annotated[Mapping[str, TerritoryCarveOut], FROZEN_MAPPING]
recargo_bands: Annotated[Mapping[str, PublishedRecargoBand], FROZEN_MAPPING]
apoderamientos_version: str
apoderamientos_scopes: Annotated[Mapping[str, ApoderamientoScopeRecord], FROZEN_MAPPING]
require_complete()[source]

Refuse an authority publication missing any former runtime table.

Return type:

Self