Documentación del API Consultar Resumen De Documentos

1. Información General

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

Consulta rangos mínimos y máximos de documentos por cliente en un solo llamado.

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

GET /Documents/SummaryDocuments
Elemento Valor
Entrada Recibe el número del contrato (Tenant) en el token de autenticación.
Salida JSON

Esta API permite consultar información resumida de la cantidad de documentos totales con la fecha de la primera emisión y la fecha de la última emisión de un contrato por tipo (Emisión, Recepción y Nómina) registradas en el sistema hasta la fecha.

Para consolidar la información el sistema realiza las consultas de los diferentes tipos de documentos incluyendo históricos de años anteriores, obteniendo la información resumida de todos los documentos emitidos junto con la fecha mínima y máxima de emisión.

Esta información puede ser utilizada para realizar procesos de descarga masiva de documentos.

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 xxxxxxxxxxxx

5. Modelos de Datos

Ejemplo Request

GET https://apimng-beta.facture.co/Documents/SummaryDocuments

Ejemplo Response

[
  {
    "Tenant": "900399741",
    "Tipo": "Emision",
    "FechaMin": "2019-01-28",
    "FechaMax": "2026-05-29",
    "CantidadTotalDocumentosEmitidos": 3020
  },
  {
    "Tenant": "900399741",
    "Tipo": "Recepcion",
    "FechaMin": "0001-01-01",
    "FechaMax": "2026-05-29",
    "CantidadTotalDocumentosEmitidos": 45432
  },
  {
    "Tenant": "900399741",
    "Tipo": "Nomina",
    "FechaMin": "2021-02-04",
    "FechaMax": "2026-05-12",
    "CantidadTotalDocumentosEmitidos": 3080
  }
]

CURL Ejemplo

curl --location 'https://apimng-beta.facture.co/Documents/SummaryDocuments' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN_AUTENTICACION' \
--header 'X-WHO: subscription-key-descarga-masiva'

Respuestas Posibles

Código Significado Descripción
200 OK Retorna el JSON con la información resumida.
429 Rate limit is exceeded. Try again in 5 seconds Límite de tasa de consulta agotado.
500 Internal Server Error Error al consultar 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 al exceder el límite 429 Too Many Requests
Condiciones especiales N/A

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 is exceeded. Try again in 5 seconds Bloqueo por Rate Limit Esperar el tiempo de renovación

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

  1. Identificación del contrato recibido mediante token JWT.
  2. Consulta del total de documentos, fecha mínima y fecha máxima para documentos emitidos, recibidos y nómina incluyendo históricos.
  3. Consolidación de la información obtenida.
  4. Retorno del archivo JSON con el resumen de la información.