pending, overdue o ya delivered.
Por qué existen los plazos
La generación de informes responde cómo y qué. Los plazos responden cuándo y si se cumplió. Sin una capa de rastreo, un equipo puede producir informes perfectos y aun así perder una ventana de presentación. Nada en el propio motor de generación de informes sabe que un informe vencía. Los plazos resuelven un problema de cumplimiento de entrega. Convierten las obligaciones de generación de informes recurrentes en compromisos rastreados y con fecha, de modo que nada se pierda en silencio:
- Obligaciones regulatorias de generación de informes: muchas presentaciones deben llegar a un regulador en un calendario fijo. Un plazo registra esa obligación, su recurrencia y su estado de entrega, de modo que una presentación perdida o tardía es visible antes de convertirse en un incidente de cumplimiento.
- SLA internos: los informes de negocio recurrentes suelen llevar compromisos internos (“finanzas recibe el paquete de cierre mensual antes del día 5”). Los plazos hacen esos compromisos explícitos y medibles.
- Registros de auditoría para la entrega: cada plazo registra
deliveredAty avanza porpending→overdue→delivered. Deja un historial auditable de cuándo se cumplió cada obligación, no solo que existe un informe.
Quién usa los plazos
Los plazos son una herramienta de negocio y cumplimiento que se agrega sobre el motor de generación de informes. Los usuarios típicos incluyen:
- Una fintech que entrega informes regulatorios a BACEN en calendarios mensuales o anuales fijos. Usa plazos para rastrear y cumplir cada ventana de presentación.
- Un equipo de tesorería o finanzas que rastrea entregas mensuales recurrentes de informes, usando el calendario y la vista de estado para confirmar que cada salida rutinaria salió a tiempo.
- Un oficial de cumplimiento que monitorea obligaciones vencidas en toda la organización, filtrando por el estado
overduepara detectar cualquier riesgo antes de que escale.
Cómo encajan los plazos en el workflow de Reporter
Los plazos envuelven los informes y las fuentes de datos para agregar una capa de estado de entrega sobre el motor de generación de informes. Las fuentes de datos proveen los datos, las plantillas definen la salida y el ciclo de vida de la generación de informes produce el archivo. Un plazo está por encima de todo eso. De forma opcional, se vincula a la plantilla que cumple la obligación, vigila la fecha de vencimiento y expone un único estado. El estado le indica al negocio si la obligación se cumplió. Los plazos son no intrusivos. Nunca activan, generan ni envían un informe. Observan y registran. Sigues generando informes mediante el ciclo de vida normal, y el plazo registra el estado de entrega.
Qué rastrea un plazo
Cada plazo captura la fecha de vencimiento de una obligación de informe, además de los metadatos que tu equipo necesita para administrarla:
Reporter también mantiene campos de solo lectura en cada plazo:
id, status (pending, overdue o delivered), deliveredAt, templateName, createdAt y updatedAt.
Incluye un encabezado
Authorization: Bearer <token> en cada solicitud de plazo si tu entorno habilita Access Manager.Crear un plazo
Crea un plazo con el endpoint Crear un plazo (
POST /v1/deadlines).
Los campos requeridos son name, type, frequency, dueDate y color. Los demás campos son opcionales. Configura templateId para vincular el plazo a la plantilla que lo cumple, y notifyDaysBefore para controlar cuándo empiezan los recordatorios.
201 Created con el plazo completo, incluidos su id generado y un status inicial.
Listar plazos
Recupera plazos con el endpoint Recuperar plazos (
GET /v1/deadlines). El endpoint pagina los resultados, y puedes filtrarlos por estado.
Por ejemplo, para listar los plazos vencidos, diez por página:
items, además de page, limit y total para la paginación.
Actualizar un plazo
Actualiza un plazo existente con el endpoint Actualizar un plazo (
PATCH /v1/deadlines/{id}). El endpoint cambia solo los campos que están en el cuerpo de la solicitud, así que puedes enviar un payload parcial. Por ejemplo, para posponer una fecha de vencimiento o desactivar un plazo:
200 OK con el plazo actualizado.
Eliminar un plazo
Elimina un plazo que ya no necesitas rastrear con el endpoint Eliminar un plazo (
DELETE /v1/deadlines/{id}). Una solicitud exitosa devuelve 204 No Content.
Marcar un plazo como entregado
Después de presentar o enviar el informe detrás de un plazo, márcalo como entregado. Usa el endpoint Entregar un plazo (
PATCH /v1/deadlines/{id}/deliver). Mueve el status del plazo a delivered y registra deliveredAt.
delivered es un booleano, el mismo endpoint también puede revertir la acción. Envía "delivered": false para reabrir un plazo que marcaste como entregado por error. Una solicitud exitosa devuelve 200 OK con el plazo actualizado.
Entregar un plazo solo rastrea la obligación. Registra que la obligación se cumplió. No genera ni envía el informe subyacente. Genera el informe mediante el ciclo de vida de la generación de informes y luego marca el plazo como entregado para mantener tu rastreador preciso.
Cómo encajan los plazos en el workflow
Una obligación típica avanza por estos estados:
1
Crea el plazo
Registra la obligación con su fecha de vencimiento, su frecuencia y una plantilla opcional.
2
Rastrea su estado
Se muestra como
pending hasta la fecha de vencimiento, y luego como overdue si no entregas el informe a tiempo.3
Genera el informe
Produce el informe mediante el ciclo de vida de la generación de informes normal, usando la plantilla vinculada.
4
Márcalo como entregado
Llama al endpoint de entrega para establecer
status en delivered y registrar deliveredAt.Próximos pasos
Primeros pasos con Reporter
Recorre el ciclo de vida de generación de informes que rastrean los plazos.
Usar Reporter
Construye las plantillas que cumplen tus plazos.
Plantillas de BACEN
Plantillas listas para usar en la generación de informes regulatorios brasileños.
API de plazos
Referencia completa de solicitud y respuesta para cada endpoint de plazos.