Sign in

v1

latestOpenAPI 3.0.0MIT2026-07-26875496.2 KB
Reportes

Endpoint para generar un reporte por rango de fechas

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
post/reports/date-range

Request body

startDatestring date required

Fecha de inicio del rango del reporte. Formato YYYY-MM-DD

endDatestring 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

callbackUrlstring uri

URL opcional de webhook para notificación cuando el reporte esté listo. Se valida que sea alcanzable al momento de la solicitud

Example request

{
  "startDate": "2025-01-01",
  "endDate": "2025-03-31"
}

Response

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

requestIdstring uuid

Identificador único para consultar el estado del reporte

status'RUNNING'

Estado inicial del reporte