Períodos y cadencia de cobro

Dos preguntas distintas determinan cuándo se cobra un contrato:

1. ¿Cada cuánto? → el intervalo, que es propiedad de cada cargo.
2. ¿A partir de qué fecha? → el ancla, que es propiedad del contrato.

Separar ambas es lo que permite que un mismo contrato tenga plataforma mensual y una licencia anual sin que los períodos se desalineen.

Intervalos

Cada cargo declara su intervalo de facturación:

Intervalo	Frecuencia
ONE_TIME	Una sola vez, sin recurrencia
WEEKLY	Semanal
MONTHLY	Mensual
QUARTERLY	Trimestral
SEMIANNUAL	Semestral
YEARLY	Anual

El ancla del contrato

El ancla se declara como tres campos explícitos: día, mes y año.

Campo	Rango	Qué determina
day	1–31	El día del mes en que corta el ciclo. Sin valor, corta el día 1
month	1–12	El mes de referencia para cadencias mayores a un mes
year	año	El año de referencia desde el cual se proyecta el ciclo anclado

Día 31 no se desplaza

Un ancla en el día 31 se ajusta al último día real de cada mes: 31 de enero → 28 (o 29) de febrero → 31 de marzo. No arrastra el corte hacia el 28 en los meses siguientes. Un contrato anclado a fin de mes sigue anclado a fin de mes todo el año.

§

Mes y año van juntos, o no van

month y year se declaran ambos o ninguno.

• Ambos declarados → ciclo anclado: el ciclo queda fijado a una fecha negociada (año, mes, día), que debe ser una fecha real del calendario. Si month está declarado, day también es obligatorio.
• Ninguno declarado → ciclo calendario: alineado al calendario natural (enero/abril/julio/octubre para trimestral, enero para anual), con day como corte opcional.

Ejemplo

Trimestral anclado vs. trimestral calendario

Configuración	Períodos que produce
QUARTERLY, sin month	Ene–Mar · Abr–Jun · Jul–Sep · Oct–Dic
QUARTERLY, month = 2, day = 15, year = 2026	15 Feb–14 May · 15 May–14 Ago · 15 Ago–14 Nov · …

El segundo caso es un contrato que se negoció el 15 de febrero y cuyo cliente espera que el ciclo respete esa fecha, no el calendario fiscal.

Un ancla por contrato

El ancla es una sola por contrato. Lo que varía por cargo es el intervalo, no la fecha de corte.

!

No configures un ancla distinta por cargo

Aunque un cargo pueda llevar su propia configuración de ancla, la identidad de período efectiva se resuelve desde el ancla por defecto del contrato. Dos cargos del mismo contrato con el mismo intervalo siempre comparten los mismos límites de período. Si necesitas fechas de corte realmente distintas, eso es un segundo contrato, no un segundo ancla.

Identidad de período

Intervalo y ancla juntos forman la identidad de período de un cargo. Dos cargos con la misma identidad producen exactamente los mismos límites de período, y por eso pueden agruparse en un mismo cálculo y en una misma factura.

Esa identidad se deriva de la configuración, no del momento en que corre el proceso: un ciclo de facturación se puede volver a correr mañana, la próxima semana o durante una auditoría, y produce el mismo período.

Anticipado y vencido dentro del mismo período

El intervalo define la ventana; pay_in_advance define en qué extremo de esa ventana se cobra el cargo. Un contrato mensual normal cobra la plataforma al abrir el período y el consumo al cerrarlo, y ambos importes terminan en la misma factura.

Cambiar la cadencia

La cadencia de un período ya cerrado no se modifica. Un cambio de intervalo o de ancla es un cambio de condiciones futuras, y se registra como un amendment con fecha de vigencia. Ver Contratos y fases.

SiguienteContratos y fasesCómo cambian las condiciones en el tiempo sin reescribir el pasado.RelacionadoCargos y pricingQué se cobra en cada período que define la cadencia.RelacionadoCobros, prefacturas y facturasQué ocurre cuando el período cierra.