La factura de cada mes
no debería ser una tarea de cada mes.

Qué va a hacer

Una recurrencia es una plantilla con un calendario. Se define una vez —cliente, líneas, moneda, condición de venta— y el sistema genera el comprobante en cada período, con la numeración consecutiva de su caja y la respuesta de Hacienda que corresponda.

• Frecuencias diaria, semanal, mensual y anual.
• Zona horaria explícita. Una recurrencia mensual «el día 1» tiene que ejecutarse el día 1 en Costa Rica, no en el huso de un servidor.
• Próxima ejecución visible, para que nunca haya que adivinar si ya corrió.
• Pausa, reanudación y cancelación, porque un cliente se va de vacaciones o deja de ser cliente, y eso no debería obligar a borrar la plantilla.
• Historial de ejecuciones, incluidas las que fallaron y por qué.

Lo que más trabajo da, y no se ve

La parte difícil de la facturación recurrente no es el calendario: es que no emita dos veces. Un reintento después de un error de red, dos servidores despertando a la misma hora, o alguien presionando «ejecutar ahora» mientras el calendario ya corría, son tres caminos distintos hacia el mismo problema — y en facturación electrónica ese problema gasta un consecutivo, que es un número que no se puede devolver.

El diseño parte de ahí: la identidad de una ejecución es la recurrencia más el período, así que dos intentos del mismo período producen un solo documento. No es una optimización; es la condición para que la función pueda existir. El criterio de cierre de esta funcionalidad es precisamente una prueba de extremo a extremo que lo demuestre.

Antes de cada corrida se verifica todo

Una recurrencia que se definió en marzo puede encontrarse en noviembre con que la llave criptográfica venció, el cupo del plan se agotó, la caja se desactivó o el producto cambió de código CABYS. Emitir en esas condiciones produce un rechazo de Hacienda o, peor, un comprobante equivocado. Antes de cada ejecución se comprueban empresa, plan y cupo, caja, llave, actividad económica, producto, CABYS, receptor y tipo de cambio.

Si algo falta, la ejecución queda en un estado visible con el motivo —no en silencio— y la recurrencia sigue viva para el período siguiente.

Generar no es cobrar

Son dos cosas distintas y Yatta las va a mantener separadas. «Generar la factura recurrente» significa emitir el comprobante electrónico que corresponde. «Cobrar automáticamente» significa mover dinero de una tarjeta. Mezclarlas obliga a quien solo quiere lo primero a aceptar lo segundo, y son decisiones de negocio diferentes.

Dónde va a estar

En la web y en la aplicación. Crear y administrar recurrencias desde la web no va a depender de tener el teléfono a mano: administrar un calendario de cobros es trabajo de escritorio, aunque emitir una factura suelta no lo sea.