> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Gestión de plazos > Haz seguimiento de los informes regulatorios y de negocio con los plazos de Reporter: crea obligaciones recurrentes, monitorea su estado y márcalas listas. 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](/es/reporter/reporter-quick-start#the-reporting-lifecycle) 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: | Campo | Descripción | | ------------------ | ----------------------------------------------------------------------------------------- | | `name` | Nombre legible del plazo (por ejemplo, *Informe Regulatorio Mensual*). | | `description` | Descripción opcional más larga de la obligación. | | `type` | Clasificación del plazo, como `regulatory` o `custom`. | | `frequency` | Con qué frecuencia se repite el plazo, como `monthly` o `annual`. | | `dueDate` | Cuándo vence el informe, en formato RFC 3339. | | `color` | Color hexadecimal usado para identificar visualmente el plazo en los dashboards. | | `notifyDaysBefore` | Número de días antes de la fecha de vencimiento en que comienzan las notificaciones. | | `monthsOfYear` | Meses (1–12) en los que se aplica el plazo. | | `templateId` | UUID opcional de la [plantilla](/es/reporter/using-reporter) usada para cumplir el plazo. | | `active` | Si 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 ` cuando [Access Manager](/es/platform/access-manager/access-manager) esté habilitado en tu entorno. ## Creación de un plazo *** Crea un plazo con el endpoint [Create a Deadline](/es/reference/reporter/create-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. ```json theme={null} { "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](/es/reference/reporter/create-deadline) ## Listado de plazos *** Recupera los plazos con el endpoint [Retrieve Deadlines](/es/reference/reporter/retrieve-deadlines) (`GET /v1/deadlines`). Los resultados están paginados y se pueden filtrar por estado. | Parámetro de consulta | Descripción | Predeterminado | | --------------------- | ---------------------------------------------- | -------------- | | `status` | Filtra por `pending`, `overdue` o `delivered`. | — | | `limit` | Número de registros por página (entero ≥ 1). | `10` | | `page` | Nú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](/es/reference/reporter/retrieve-deadlines) ## Actualización de un plazo *** Actualiza un plazo existente con el endpoint [Update a Deadline](/es/reference/reporter/update-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: ```json theme={null} { "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](/es/reference/reporter/update-deadline) ## Eliminación de un plazo *** Elimina un plazo que ya no necesitas rastrear con el endpoint [Delete a Deadline](/es/reference/reporter/delete-deadline) (`DELETE /v1/deadlines/{id}`). Una solicitud exitosa devuelve `204 No Content`. Referencia de la API: [Delete a Deadline](/es/reference/reporter/delete-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](/es/reference/reporter/deliver-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`. ```json theme={null} { "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](/es/reporter/reporter-quick-start) y luego marca el plazo como entregado para mantener tu rastreador preciso. Referencia de la API: [Deliver a Deadline](/es/reference/reporter/deliver-deadline) ## Cómo encajan los plazos en el flujo de trabajo *** Una obligación típica pasa por estos estados: Registra la obligación con su fecha de vencimiento, frecuencia y plantilla opcional. Se muestra como `pending` hasta la fecha de vencimiento, y luego como `overdue` si el informe no se ha entregado a tiempo. Produce el informe a través del [ciclo de vida de informes](/es/reporter/reporter-quick-start) normal, usando la plantilla vinculada. Llama al endpoint de entrega para establecer el `status` en `delivered` y registrar `deliveredAt`. ## Próximos pasos *** Recorre el ciclo de vida de informes que los plazos rastrean. Construye las plantillas que cumplen tus plazos. Plantillas listas para usar para informes regulatorios brasileños. Referencia completa de solicitud y respuesta para cada endpoint de plazo.