---
title: "Endpoint para generar un reporte por rango de fechas"
method: POST
path: "/reports/date-range"
tags: ["Reportes"]
---

# Endpoint para generar un reporte por rango de fechas

`POST /reports/date-range`

Dispara la generación asíncrona de un reporte de documentos electrónicos para un rango de fechas. El reporte se ejecuta en una tarea en segundo plano. Use el endpoint GET /reports/{requestId} para consultar el estado y obtener las URLs de descarga cuando esté listo.

Restricciones:
- El rango máximo permitido es de 92 días
- La fecha de inicio debe ser anterior a la fecha de fin
- Si se envía callbackUrl, se valida que sea alcanzable

Retención:
- Los archivos del reporte y su registro se eliminan automáticamente después de 60 días. Si necesita el mismo reporte después de este periodo, deberá generar uno nuevo

## Request body

- object
  - `startDate` string, date, required — Fecha de inicio del rango del reporte. Formato YYYY-MM-DD
  - `endDate` string, date, required — Fecha de fin del rango del reporte. Formato YYYY-MM-DD. El rango máximo permitido es de 92 días
  - `docType` 'invoice' | 'credit-note' | 'debit-note' | 'equivalent-document-pos' | 'support-document', required — Tipo de documento electrónico para el reporte
  - `callbackUrl` string, uri — URL opcional de webhook para notificación cuando el reporte esté listo. Se valida que sea alcanzable al momento de la solicitud

## Response `202`

El reporte ha sido aceptado y se está generando de forma asíncrona

- object
  - `requestId` string, uuid — Identificador único para consultar el estado del reporte
  - `status` 'RUNNING' — Estado inicial del reporte

## Other responses

- `400` — Objeto que representa una respuesta de error por validaciones
- `401` — No se pudo obtener el usuario autenticado del token
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)