📚 Glosario Técnico
Este glosario contiene los términos técnicos, normativas, acrónimos y conceptos principales relacionados con la facturación electrónica, documentos equivalentes, nómina electrónica, RADIAN y el Sector Salud (Resolución 000948 de 2026 / RIPS) en Colombia.
🗯️ Navegación Alfabética
Esta es la distinción más importante para utilizar la API correctamente:
- ID (Base de Datos API): Número entero único usado en las peticiones JSON (ej:
type_document_id: 7para Factura Electrónica). - Code (DIAN): Código normativo de la DIAN, usado exclusivamente para referencia regulatoria (ej: Code
01= Factura de Venta).
🔑 REGLA FUNDAMENTAL: En el cuerpo de las peticiones SIEMPRE utilizas el ID numérico de la API, NUNCA el código alfanumérico DIAN.
A
Additional Document Reference (Documento Adicional de Referencia)
Definición: Grupo de datos que contiene referencias a documentos comerciales o de soporte adicionales.
- Uso Obligatorio: Facturas tipo 03 (Factura de Contingencia) para referenciar el documento de papel o talonario original.
- Estructura:
number,uuid(CUFE/CUDE),scheme_name,date,code.
ADRES
Definición: Administradora de los Recursos del Sistema General de Seguridad Social en Salud. Entidad pública adscrita al MinSalud que administra los recursos financieros del SGSSS y efectúa pagos/giros directos a prestadores y proveedores.
Ambiente de Destino
Definición: El entorno al cual se envía el documento electrónico.
- Producción (
1): Ambiente real con validez fiscal y transmisión directa a la DIAN. - Pruebas / Habilitación (
2): Ambiente del set de pruebas para validar habilitación de software.
Anticipo (advance)
Definición: Valor monetario entregado con anterioridad a la prestación del servicio que se legaliza y descuenta en la factura electrónica en ejecución del contrato pactado.
ARL
Definición: Administradora de Riesgos Laborales. Entidad responsable de financiar y prestar servicios de salud derivados de accidentes de trabajo y enfermedades laborales.
B
Base Imponible
Definición: Valor sobre el cual se calcula el porcentaje de impuesto (IVA, INC, Retención) aplicable a cada línea o al total del documento.
Buzón de Recepción
Definición: Dirección de correo única por empresa, con la forma {identificador}@{dominio}, a la que los proveedores envían sus facturas electrónicas para que la API las registre como recepciones. Se asigna al registrar la primera persona de recepción y no cambia. Se consulta con GET /events/mailbox/address. Ver Buzón de recepción.
C
Certificado Digital
Definición: Archivo criptográfico PKCS#12 (.p12 o .pfx) emitido por una entidad de certificación acreditada (ONAC) que garantiza la autoría, integridad y no repudio de los documentos XML transmitidos a la DIAN.
Cobertura o Plan de Beneficios (coverage)
Definición: Plan de beneficios en salud bajo el cual se prestan los servicios (ej. Plan de Beneficios en Salud - UPC, Plan Complementario, Pólizas de Salud, SOAT).
Contingencia
Definición: Mecanismo operativo que permite emitir facturas cuando se presentan fallas técnicas atribuibles a la DIAN (Contingencia Tipo 04) o al facturador (Contingencia Tipo 03).
Copago (copayment)
Definición: Aporte en dinero correspondiente a una parte del valor del servicio cubierto por el Plan de Beneficios en Salud, a cargo exclusivo de los beneficiarios del régimen contributivo.
Correo Retenido
Definición: Correo del buzón de recepción que llegó cuando el plan de pago de la empresa estaba vencido. Queda con status IGNORED y reason_code PLAN_EXPIRED (is_held = true), no consume cupo y se procesa automáticamente al renovar el plan si no han pasado más de 30 días desde su llegada (también con POST /events/mailbox/{id}/retry). Una suscripción de pago cancelada no retiene correos: quedan IGNORED sin retención. Ver Correos retenidos.
CUCON
Definición: Código Único de Facturación Electrónica en Contingencia.
CUDE
Definición: Código Único de Documento Electrónico. Cadena criptográfica SHA-384 que identifica unívocamente notas crédito, notas débito, documentos soporte y documentos equivalentes POS.
CUFE
Definición: Código Único de Facturación Electrónica. Cadena criptográfica generada mediante algoritmo SHA-384 que identifica de manera única e irrepetible cada factura electrónica de venta autorizada por la DIAN.
CUNE
Definición: Código Único de Nómina Electrónica. Identificador unívoco generado a partir de los datos de liquidación del Documento Soporte de Pago de Nómina Electrónica.
Cuota Moderadora (moderator_fee)
Definición: Pago monetario que regula la utilización de los servicios de salud y estimula su buen uso, a cargo de cotizantes y beneficiarios en el régimen contributivo.
D
DIAN
Definición: Dirección de Impuestos y Aduanas Nacionales. Autoridad tributaria, aduanera y cambiaria de Colombia encargada de regular y validar los documentos fiscales electrónicos.
Dígito Verificador (DV)
Definición: Cifra numérica calculada mediante el algoritmo oficial módulo 11 de la DIAN que valida la integridad y congruencia del NIT.
Documento Equivalente POS Electrónico
Definición: Documento electrónico (tipo 20) que reemplaza la tradicional tirilla de máquina registradora POS y otorga derecho a deducción de costos y gastos cuando identifica al adquirente.
Documento Soporte Electrónico (DS)
Definición: Documento electrónico (tipo 11) expedido por el comprador para soportar transacciones con personas o proveedores no obligados a expedir factura de venta.
E
EPS
Definición: Entidad Promotora de Salud. Entidad responsable de la afiliación, registro y recaudo de cotizaciones de los usuarios en el sistema de salud colombiano.
Eventos RADIAN
Definición: Mensajes electrónicos oficiales transmitidos a la DIAN para gestionar el ciclo de vida de la factura electrónica como título valor:
- Evento 030: Acuse de recibo de la factura.
- Evento 031: Reclamo de la factura (con
claim_codedel01al04). - Evento 032: Recibo de bienes y/o servicios.
- Evento 033: Aceptación expresa.
Solo aplican a facturas electrónicas de venta a crédito: las facturas de contado (o sin medio de pago) y las notas crédito/débito no admiten eventos. Ver Eventos RADIAN.
F
Factura Electrónica de Venta (FEV)
Definición: Título valor digital que soporta transacciones de compraventa de bienes o prestación de servicios, validado previamente en tiempo real por la DIAN antes de su entrega al adquirente.
Factura del Sector Salud
Definición: Factura electrónica que incorpora el objeto regulatorio health conforme a la Resolución 000948 de 2026, integrando la información estructurada de atenciones de salud con los RIPS.
G
Generación de Documentos
Definición: Proceso de estructuración y validación sintáctica del JSON de entrada para construir el XML conforme al estándar UBL 2.1 antes de la firma digital.
Geolocalización DANE
Definición: Codificación oficial de departamentos y municipios establecida por el Departamento Administrativo Nacional de Estadística (DANE) utilizada en los campos city_id y department_id.
H
Health (Objeto health)
Definición: Objeto JSON opcional pero obligatorio para facturas del sector salud. Contiene información asistencial, periodos de atención, modalidad de pago, copagos y cuotas moderadoras.
I
ICA
Definición: Impuesto de Industria y Comercio. Tributo territorial municipal que grava la realización de actividades industriales, comerciales o de servicios.
INCOTERM
Definición: Términos internacionales de comercio (ej. FOB, CIF, EXW) requeridos en facturas de exportación para definir responsabilidades entre comprador y vendedor.
IPS
Definición: Institución Prestadora de Servicios de Salud. Hospitales, clínicas, laboratorios y centros médicos habilitados para prestar servicios de salud.
IVA
Definición: Impuesto sobre las Ventas. Tributo nacional indirecto de valor agregado que grava la venta de bienes y la prestación de servicios (tarifas estándar: 0%, 5%, 19%).
J
JSON (JavaScript Object Notation)
Definición: Formato estándar de intercambio de datos ligero y legible por humanos utilizado en toda la API de MATIAS para el envío y recepción de información.
L
Línea de Factura (lines)
Definición: Array de ítems o conceptos facturados que detalla cantidades, precios unitarios, descuentos, tributos y descripciones del servicio o producto.
Lote Masivo (Bulk)
Definición: Conjunto de múltiples documentos electrónicos enviados de manera agrupada mediante POST /bulk/documents para procesamiento en cola asíncrona.
M
Magic Values
Definición: Catálogo de 32 cabeceras HTTP especiales (X-Sandbox-Force-Status) utilizables en el ambiente Sandbox para simular rechazos, códigos de error y respuestas DIAN específicas.
Modalidad de Pago (Salud)
Definición: Mecanismo contractual de pago de servicios de salud entre prestadores y pagadores (ej. Pago por evento 01, Pago por capitación 02, Pago por conjunto integral 03).
Modo de Eventos (Automático / Manual)
Definición: Configuración de la empresa (send_events) que define qué eventos RADIAN se generan sin intervención del usuario al registrar una factura a crédito (buzón o importación por Excel/CUFE). Automático (true): se crean y envían el 030, el 032 y el 033. Manual (false, valor inicial de una empresa nueva): no se crea ninguno, tampoco el 030; el usuario los envía con POST /events/send/{trackId} o POST /events/send-bulk. Se cambia con PUT /events/reception-people/mode.
N
NIT
Definición: Número de Identificación Tributaria asignado por la DIAN para la individualización de personas jurídicas y naturales en Colombia.
Nómina Electrónica
Definición: Documento soporte de pago de nómina electrónica y notas de ajuste que sustentan los costos deducibles derivados de pagos laborales.
Nota Crédito
Definición: Documento electrónico (tipo 5) utilizado para anular facturas, conceder descuentos posteriores o registrar devoluciones de mercancías.
Nota Débito
Definición: Documento electrónico (tipo 4) utilizado para registrar cargos adicionales, intereses de mora o aumentos de valor sobre facturas previamente emitidas.
O
ONAC
Definición: Organismo Nacional de Acreditación de Colombia. Entidad responsable de acreditar a las Entidades de Certificación Digital que emiten certificados de firma válidos ante la DIAN.
Operación de Facturación
Definición: Código paramétrico (operation_type_id) que define el tipo de operación mercantil (ej. Estándar 1, Servicios 2, Salud 7).
P
Pago Compartido (shared_payments)
Definición: Montos recaudados por el prestador en planes voluntarios de salud (medicina prepagada, planes complementarios) a cargo del usuario o titular.
Persona de Recepción
Definición: Persona cuyos datos firman (acusan, reciben, aceptan o reclaman) los eventos RADIAN de la empresa. Una empresa puede tener varias, con una por defecto: la que firma los eventos automáticos del buzón y la que se usa cuando no se indica reception_person_uuid. La persona indicada al importar por Excel o CUFE firma solo los eventos automáticos de esa recepción; los envíos manuales usan la persona de su propia solicitud o la por defecto. Se administra con /events/reception-people. Ver Personas de recepción.
Personal Access Token (PAT)
Definición: Token de autenticación de larga duración (JWT estándar basado en Laravel Passport) que permite autenticar peticiones API desde sistemas ERP o servidores backend.
P.O.S (Point of Sale)
Definición: Punto de venta o caja registradora donde se originan transacciones comerciales directas con el consumidor final.
Q
QR Code (Código QR)
Definición: Código bidimensional de respuesta rápida generado e insertado obligatoriamente en la representación gráfica (PDF) que enlaza al catálogo público de validación de la DIAN.
R
RADIAN
Definición: Plataforma oficial administrada por la DIAN que registra y custodia los eventos y operaciones de factoring electrónico sobre facturas electrónicas de venta como título valor.
RECEPTION_NOT_IN_PLAN
Definición: Código de error (error_code) de la respuesta 403 que devuelve todo el módulo de recepción (/events/*: eventos RADIAN, importación, buzón y personas de recepción) cuando la empresa no tiene un plan de pago vigente (plan FREE, plan vencido o sin suscripción). Para una sub-cuenta cuenta el plan de su Casa de Software. Reemplaza al código MAILBOX_NOT_IN_PLAN, que el buzón ya no emite. Ver Requisito de plan.
REPS
Definición: Registro Especial de Prestadores de Servicios de Salud del Ministerio de Salud y Protección Social. Contiene el código de habilitación (provider_code) de las IPS y profesionales del país.
RIPS
Definición: Registro Individual de Prestación de Servicios de Salud. Conjunto de datos estructurados de atenciones en salud que constituye el soporte obligatorio de la Factura Electrónica en salud conforme a la Resolución 000948 de 2026.
RUT
Definición: Registro Único Tributario. Mecanismo de identificación administrado por la DIAN que clasifica la responsabilidad fiscal de los contribuyentes.
S
Sector Salud (FEV Salud)
Definición: Régimen especial de emisión de facturación electrónica obligatorio para prestadores de servicios y proveedores de tecnologías en salud reglamentado por el MinSalud y la DIAN.
SOAT
Definición: Seguro Obligatorio de Accidentes de Tránsito. Cobertura obligatoria para víctimas de accidentes de tránsito que se referencia con código 04 en health.coverage y requiere health.policy_number.
T
TRM
Definición: Tasa Representativa del Mercado. Tipo de cambio oficial peso colombiano / dólar estadounidense certificado por la Superintendencia Financiera de Colombia.
U
UBL 2.1
Definición: Universal Business Language (versión 2.1). Estándar XML internacional adoptado por la DIAN para la estructura formal de los documentos tributarios electrónicos en Colombia.
UPC (Unidad de Pago por Capitación)
Definición: Valor anual que reconoce el Estado a las EPS por cada afiliado para garantizar la prestación de los servicios del Plan de Beneficios en Salud.
V
Validación Previa
Definición: Mecanismo tecnológico mediante el cual la DIAN revisa y valida en tiempo real las reglas fiscales y aritméticas del XML antes de autorizar su entrega legal al adquirente.
W
Webhook
Definición: Mecanismo de notificación HTTP asíncrono en tiempo real mediante el cual la API avisa a tu servidor cuando un documento o evento cambia de estado o completa su validación ante la DIAN.
X
XML
Definición: Extensible Markup Language. Formato de texto estructurado en el que se codifican, firman y transmiten los documentos electrónicos ante la DIAN.
Z
ZIP (Contenedor AttachedDocument)
Definición: Archivo comprimido .zip generado por la API que contiene el documento XML firmado electrónicamente junto con el ApplicationResponse oficial de aprobación emitido por la DIAN.
📊 Tablas de Referencia Rápida
📄 Identificadores de Tipos de Documento en la API (type_document_id)
| ID (API) | Código DIAN | Tipo de Documento | Endpoint Principal | Identificador Criptográfico |
|---|---|---|---|---|
| 7 | 01 | Factura Electrónica de Venta (Estándar / Salud) | POST /invoice | CUFE |
| 8 | 02 | Factura de Exportación | POST /invoice | CUFE |
| 9 | 03 | Factura de Contingencia (Tipo 03) | POST /invoice | CUFE |
| 10 | 04 | Factura de Contingencia (Tipo 04) | POST /invoice | CUFE |
| 11 | 05 | Documento Soporte Electrónico | POST /ds/document | CUDS / CUDE |
| 20 | 20 | Documento Equivalente POS Electrónico | POST /invoice | CUDE |
| 5 | 91 | Nota Crédito Electrónica | POST /notes/credit | CUDE |
| 4 | 92 | Nota Débito Electrónica | POST /notes/debit | CUDE |
🆔 Tipos de Identificación (identity_document_id)
| ID (API) | Documento |
|---|---|
| 1 | Cédula de Ciudadanía |
| 2 | NIT |
| 3 | Cédula de Extranjería |
| 4 | Tarjeta de Identidad |
| 5 | Pasaporte |
| 6 | Documento de Identificación Extranjero |
| 10 | Sin identificación del exterior / Consumidor Final |
🏛️ Tipos de Organización (type_organization_id)
| ID (API) | Organización |
|---|---|
| 1 | Persona Jurídica |
| 2 | Persona Natural |
📅 Versión: 3.7.0 (Agosto 2026) • 📚 Términos: 150+ definiciones completas • 🎯 Nivel: ⭐⭐⭐ Referencia Técnica y Normativa