Integration Guide

API Agencia Virtual

Documentacion operativa para integracion FEL.

Base URL: https://apifelcore.com/api

Abrir Swagger UI Descargar Postman
Contenido
Overview Auth Errores Emitir Documento Anular Documento Nombre Receptor Consultar Documentos Descargar XML Descargar PDF

Overview

Las rutas principales disponibles son 6 y todas son POST.

Metodo Endpoint Descripcion
POST /agencia-virtual/emitir-documento Emite DTE.
POST /agencia-virtual/anular-documento Anula DTE.
POST /agencia-virtual/nombre-receptor Consulta nombre por NIT.
POST /agencia-virtual/consultar-documentos Consulta DTE emitidos/recibidos.
POST /agencia-virtual/descargar-xml Retorna XML.
POST /agencia-virtual/descargar-pdf Retorna PDF (URL y base64).

Auth

1) Crear token API:

POST https://apifelcore.com/api/login
{
  "email": "dev@tuempresa.com",
  "password": "tu_password",
  "device_name": "postman"
}

2) Header obligatorio para rutas agencia-virtual:

Authorization: Bearer TU_TOKEN

3) En body de negocio usar token_fel para credenciales SAT/FEL.

Errores Frecuentes

Codigo Causa
400 NIT no coincide con token o request invalido.
403 Plan no activo o limite de solicitudes excedido.
404 Documento o recurso no encontrado.
500 Error interno.

POST /agencia-virtual/emitir-documento

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "nit_receptor": "CF",
  "nombre_receptor": "Consumidor Final",
  "direccion_receptor": "Ciudad",
  "establecimiento": 1,
  "items": [
    { "cantidad": 1, "descripcion": "Servicio", "precio": 100, "tipo": "S" }
  ]
}

POST /agencia-virtual/anular-documento

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "numero_autorizacion": "UUID-DTE",
  "nit_receptor": "CF",
  "observacion": "Anulacion solicitada"
}

POST /agencia-virtual/nombre-receptor

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "nit_receptor": "CF"
}

POST /agencia-virtual/consultar-documentos

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "tipo_operacion": "EMITIDOS",
  "fecha_inicio": "01-01-2026",
  "fecha_fin": "31-01-2026",
  "tipo_documento": "FACT",
  "estado_dte": "VIGENTE",
  "nit_receptor": "CF"
}

POST /agencia-virtual/descargar-xml

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "nit_receptor": "CF",
  "numero_autorizacion": "UUID-DTE"
}

POST /agencia-virtual/descargar-pdf

{
  "nit": "1234567",
  "token_fel": "TOKEN_ENCRIPTADO_CLIENTE",
  "nit_receptor": "CF",
  "numero_autorizacion": "UUID-DTE"
}