---
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`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/reports/date-range`
- Auth: HTTP bearer

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, debe ser una URL http o https que apunte a un host público

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. Debe ser http o https y apuntar a un host público

## 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.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)