Documentación API Descargar LDFs De Documentos

1. Información General

Propiedad Valor
Nombre GetDocumentsLDF
Versión 1
Última actualización 2026/06/03
Responsable / Equipo GoldTeam

Consulta LDF por días parametrizado por grupo de descarga.

Esta API permite realizar la consulta de los LDF de un contrato por tipo (Emisión, Recepción y Nómina) dentro de un rango de fechas de máximo 7 días.

2. Base URL

Ambiente URL
Producción https://apimng-pro.facture.co
Beta https://apimng-beta.facture.co

3. Autenticación

Tipo: JWT (vía API Management)

Authorization: Bearer {token}

4. Estructura General

POST /Documents/GetDocumentsLDF
Elemento Valor
Entrada Tenant obtenido desde JWT y un objeto JSON con: FechaInicio, FechaFin y Tipo (Emision, Recepcion o Nomina).
Salida JSON

Esta API permite realizar la consulta de los LDF de un contrato por tipo (Emisión, Recepción y Nómina) dentro de un rango de fechas de máximo 7 días.

El sistema consulta los LDF agrupados por tipo de documento, incluyendo información histórica cuando aplica.

Headers

Nombre Tipo Requerido Descripción Ejemplo
Accept string Sí Tipo de respuesta esperado application/json
X-WHO string Sí Subscription Key asignada para el consumo del servicio xxxxxxxxxx

5. Modelos de Datos

Ejemplo Request

POST https://apimng-beta.facture.co/Documents/GetDocumentsLDF

{
  "FechaInicio": "2026-05-25",
  "FechaFin": "2026-05-29",
  "Tipo": "Emision"
}

Ejemplo Response

{
  "Tenant": "900399741",
  "FechaInicio": "2026-05-25",
  "FechaFin": "2026-05-29",
  "Tipo": "Emision",
  "LDFs": [
    "FACTURA-UBL(900399741;SETP994712370;2026-05-27;PHABILITACION;PRINCIPAL)",
    "FACTURA-UBL(900399741;SETP994712376;2026-05-29;PHABILITACION;PRINCIPAL)",
    "FACTURA-UBL(900399741;SETP994712374;2026-05-29;PHABILITACION;PRINCIPAL)"
  ]
}

CURL Ejemplo

curl --location 'https://apimng-beta.facture.co/Documents/GetDocumentsLDF' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN_DE_AUTENTICACION' \
--header 'X-WHO: subscription-key-descarga-masiva' \
--data '{
  "FechaInicio":"2026-05-25",
  "FechaFin":"2026-05-29",
  "Tipo":"Emision"
}'

Respuestas Posibles

Código Significado Descripción
200 OK Retorna el JSON con la información solicitada.
400 Error parámetros de entrada Validaciones de FechaInicio, FechaFin o Tipo.
429 Rate limit exceeded Límite de consultas agotado.
500 Internal Server Error Error interno obteniendo la información.

6. Rate Limit

Concepto Valor
Por producto Máximo 5 usuarios concurrentes por segundo
Por usuario Máximo 5 peticiones por segundo
Respuesta 429 Too Many Requests

7. Errores Comunes

Código Error Causa Solución
500 Error al realizar la consulta RepexT no respondió o falló Revisar AppInsights y dependencias
429 Rate limit exceeded Bloqueo por Rate Limit Esperar tiempo de renovación

8. Flujo del Proceso Interno [No entregar al cliente final]

  1. Identificación del contrato y validación de parámetros.
  2. Consulta de LDF en bases principales e históricas.
  3. Consolidación de resultados.
  4. Retorno del JSON al consumidor.