Saltar al contenido principal
Un plazo es la capa de seguimiento de Reporter para las entregas de informes. Mientras que las plantillas definen cómo se ve un informe y la generación de informes produce la salida, un plazo registra cuándo vence un informe y si ha sido entregado. Cada plazo representa una obligación de entrega — normalmente una presentación regulatoria o un informe de negocio recurrente — y puede, opcionalmente, estar vinculado a la plantilla utilizada para cumplirlo. Los plazos no generan informes por sí mismos. Se ubican junto al ciclo de vida de informes como un rastreador operativo, para que los equipos vean de un vistazo qué está pending (pendiente), overdue (vencido) o ya delivered (entregado).

​
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 seguimiento, un equipo puede producir informes perfectos y aun así perder una ventana de presentación, porque nada en el propio motor de informes sabe que un informe estaba por vencer. Los plazos resuelven un problema de cumplimiento de entregas. Convierten las obligaciones de informes recurrentes en compromisos rastreados y fechados, para que nada pase desapercibido:
  • Obligaciones regulatorias de informes — muchas presentaciones deben llegar a un regulador en un cronograma fijo. Un plazo registra esa obligación, su recurrencia y su estado de entrega, para que una presentación perdida o tardía sea visible antes de convertirse en un incidente de cumplimiento.
  • SLA internos — los informes de negocio recurrentes a menudo conllevan compromisos internos (“finanzas recibe el paquete de cierre mensual antes del día 5”). Los plazos hacen que esos compromisos sean explícitos y medibles.
  • Pistas de auditoría para la entrega — como cada plazo registra deliveredAt y recorre pending → overdue → delivered, deja un historial auditable de cuándo se satisfizo cada obligación, no solo de que un informe existe.

​
Quién usa los plazos

Los plazos son una herramienta de negocio y cumplimiento superpuesta al motor de informes. Los usuarios típicos incluyen:
  • Una fintech que entrega informes regulatorios al BACEN en cronogramas mensuales o anuales fijos, usando los plazos para garantizar que cada ventana de presentación se rastree y se cumpla.
  • Un equipo de tesorería o finanzas que hace seguimiento de las entregas de informes mensuales recurrentes, usando el calendario y la vista de estado para confirmar que cada salida rutinaria se envió a tiempo.
  • Un responsable de cumplimiento que monitorea las obligaciones vencidas en toda la organización, filtrando por el estado overdue para detectar cualquier cosa en riesgo antes de que escale.
Para estos equipos, el valor no está en producir el informe — ese es el trabajo del motor de informes — sino en conocer el panorama de obligaciones: qué se aproxima, qué está atrasado y qué está hecho.

​
Cómo encajan los plazos en el flujo de trabajo de Reporter

Los plazos envuelven los informes y las fuentes de datos para añadir una capa de estado de entrega sobre el motor de informes. Las Fuentes de Datos proporcionan los datos, las Plantillas definen la salida y el ciclo de vida de informes produce el archivo. Un plazo se ubica por encima de todo eso: vincula (opcionalmente) la plantilla que cumple la obligación, observa la fecha de vencimiento y expone un único estado que le dice al negocio si la obligación se ha cumplido. En la práctica, esto significa que los plazos son no intrusivos. Nunca activan, generan ni envían un informe — observan y registran. Sigues generando informes a través del ciclo de vida normal; el plazo es simplemente el rastreador que convierte esa actividad en un estado de entrega claro en el que el resto de la organización puede confiar.

​
Qué rastrea un plazo

Cada plazo captura la fecha de vencimiento de una obligación de informe más los metadatos que tu equipo necesita para gestionarla:
CampoDescripción
nameNombre legible del plazo (por ejemplo, Informe Regulatorio Mensual).
descriptionDescripción opcional más larga de la obligación.
typeClasificación del plazo, como regulatory o custom.
frequencyCon qué frecuencia se repite el plazo, como monthly o annual.
dueDateCuándo vence el informe, en formato RFC 3339.
colorColor hexadecimal usado para identificar visualmente el plazo en los dashboards.
notifyDaysBeforeNúmero de días antes de la fecha de vencimiento en que comienzan las notificaciones.
monthsOfYearMeses (1–12) en los que se aplica el plazo.
templateIdUUID opcional de la plantilla usada para cumplir el plazo.
activeSi el plazo está actualmente activo.
Reporter también mantiene campos de solo lectura en cada plazo — id, status (pending, overdue o delivered), deliveredAt, templateName, createdAt y updatedAt.
Todos los endpoints de plazo requieren el encabezado X-Organization-id. Incluye un encabezado Authorization: Bearer <token> cuando Access Manager esté habilitado en tu entorno.

​
Creación de un plazo

Crea un plazo con el endpoint Create a Deadline (POST /v1/deadlines). Los campos obligatorios son name, type, frequency, dueDate y color. Los campos restantes son opcionales — define templateId para vincular el plazo a la plantilla que lo cumple, y notifyDaysBefore para controlar cuándo comienzan los recordatorios. 
{
  "name": "Monthly Regulatory Report",
  "description": "Monthly regulatory compliance report",
  "type": "regulatory",
  "frequency": "monthly",
  "dueDate": "2026-03-31T23:59:59Z",
  "color": "#FF5733",
  "notifyDaysBefore": 5,
  "monthsOfYear": [1, 6],
  "templateId": "00000000-0000-0000-0000-000000000000",
  "active": true
}
Una solicitud exitosa devuelve 201 Created con el plazo completo, incluyendo su id generado y un status inicial.
Referencia de la API: Create a Deadline

​
Listado de plazos

Recupera los plazos con el endpoint Retrieve Deadlines (GET /v1/deadlines). Los resultados están paginados y se pueden filtrar por estado.
Parámetro de consultaDescripciónPredeterminado
statusFiltra por pending, overdue o delivered.—
limitNúmero de registros por página (entero ≥ 1).10
pageNúmero de página a devolver (entero ≥ 1).1
Por ejemplo, para listar plazos vencidos, diez por página: 
GET /v1/deadlines?status=overdue&limit=10&page=1
La respuesta contiene un array items más page, limit y total para la paginación.
Referencia de la API: Retrieve Deadlines

​
Actualización de un plazo

Actualiza un plazo existente con el endpoint Update a Deadline (PATCH /v1/deadlines/{id}). Solo se modifican los campos incluidos en el cuerpo de la solicitud, por lo que puedes enviar un payload parcial — por ejemplo, para posponer una fecha de vencimiento o desactivar un plazo: 
{
  "dueDate": "2026-06-30T23:59:59Z",
  "notifyDaysBefore": 10,
  "active": false
}
Una solicitud exitosa devuelve 200 OK con el plazo actualizado.
Referencia de la API: Update a Deadline

​
Eliminación de un plazo

Elimina un plazo que ya no necesitas rastrear con el endpoint Delete a Deadline (DELETE /v1/deadlines/{id}). Una solicitud exitosa devuelve 204 No Content.
Referencia de la API: Delete a Deadline

​
Marcar un plazo como entregado

Cuando el informe detrás de un plazo se haya presentado o enviado, marca el plazo como entregado con el endpoint Deliver a Deadline (PATCH /v1/deadlines/{id}/deliver). Esta es la acción que cierra el ciclo en el flujo de seguimiento: mueve el status del plazo a delivered y marca deliveredAt. 
{
  "delivered": true
}
Como delivered es un booleano, el mismo endpoint también puede revertir la acción — envía "delivered": false para reabrir un plazo que se marcó como entregado por error. Una solicitud exitosa devuelve 200 OK con el plazo actualizado.
Entregar un plazo es solo una acción de seguimiento. Registra que la obligación se cumplió — no genera ni envía el informe subyacente. Genera el informe a través del ciclo de vida de informes y luego marca el plazo como entregado para mantener tu rastreador preciso.
Referencia de la API: Deliver a Deadline

​
Cómo encajan los plazos en el flujo de trabajo

Una obligación típica pasa por estos estados:
1

Crea el plazo

Registra la obligación con su fecha de vencimiento, frecuencia y plantilla opcional.
2

Haz seguimiento de su estado

Se muestra como pending hasta la fecha de vencimiento, y luego como overdue si el informe no se ha entregado a tiempo.
3

Genera el informe

Produce el informe a través del ciclo de vida de informes normal, usando la plantilla vinculada.
4

Márcalo como entregado

Llama al endpoint de entrega para establecer el status en delivered y registrar deliveredAt.

​
Próximos pasos

Primeros pasos con Reporter

Recorre el ciclo de vida de informes que los plazos rastrean.

Uso de Reporter

Construye las plantillas que cumplen tus plazos.

Plantillas BACEN

Plantillas listas para usar para informes regulatorios brasileños.

API de Plazos

Referencia completa de solicitud y respuesta para cada endpoint de plazo.