cadrumo.application.aggregation.withholding_source module¶

Calc-mesh source resolver for the per-perceptor-clave withholding store.

Reads the dedicated PercepcionObservationRepository for the modelo’s annual window and materialises the Modelo 190 “número total de percepciones” box with the DISTINCT (perceptor, clave, subclave) count (the percepcion_count withholding fact) — replacing the wrong sum-of-quarterly-M111-perceptor-counts relations. The pull and calculate surfaces read this ONE store (aeat-calculation-aggregation).

Lives in its own module (rather than modelo_bindings.py) so the percepciones source is isolated from the contended retenciones/ledger mesh surface; it is enrolled in merge_source_resolutions exactly like the other source resolvers. It reads the withholding bindings declared on the snapshot’s ModeloRevision and returns its result as a CalculationSourceResolution.

Empty-store behaviour materialises an explicit ZERO count AND surfaces a non-blocking advisory (NOT a hard refusal) — a legitimate nil-percepciones filer must still be able to calculate, and the bound casilla requires its fact (no-silent-under-declaration: the zero is loud, not silent).

class WithholdingSourceResolver(*, ports)[source]¶

Bases: object

Source mesh resolver for the dedicated per-perceptor-clave withholding store.

Materialises the Modelo 190 “número total de percepciones” box with the DISTINCT (perceptor_tax_id, clave, subclave) count (the percepcion_count fact) over the persisted withholding detail — the percepciones counterpart of RetencionesAggregationSourceResolver (which counts distinct perceptores for M180/M193). The pull and calculate surfaces read this one store (one-aggregation-path).

Parameters:: ports (PercepcionObservationPorts)

resolver_id: ClassVar[str]¶

owned_sources: ClassVar[tuple[BindingSourceKind, ...]]¶

resolve(context)[source]¶

Resolve withholding totals from the bucket-scoped observation store.

Return type:: CalculationSourceResolution
Parameters:: context (CalculationSourceContext)