# 📚 Glosario Técnico :::info 📖 Referencia Normativa y Conceptual 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 [A](https://docs.matias-api.com/docs/glossary#a) [B](https://docs.matias-api.com/docs/glossary#b) [C](https://docs.matias-api.com/docs/glossary#c) [D](https://docs.matias-api.com/docs/glossary#d) [E](https://docs.matias-api.com/docs/glossary#e) [F](https://docs.matias-api.com/docs/glossary#f) [G](https://docs.matias-api.com/docs/glossary#g) [H](https://docs.matias-api.com/docs/glossary#h) [I](https://docs.matias-api.com/docs/glossary#i) [J](https://docs.matias-api.com/docs/glossary#j) [L](https://docs.matias-api.com/docs/glossary#l) [M](https://docs.matias-api.com/docs/glossary#m) [N](https://docs.matias-api.com/docs/glossary#n) [O](https://docs.matias-api.com/docs/glossary#o) [P](https://docs.matias-api.com/docs/glossary#p) [Q](https://docs.matias-api.com/docs/glossary#q) [R](https://docs.matias-api.com/docs/glossary#r) [S](https://docs.matias-api.com/docs/glossary#s) [T](https://docs.matias-api.com/docs/glossary#t) [U](https://docs.matias-api.com/docs/glossary#u) [V](https://docs.matias-api.com/docs/glossary#v) [W](https://docs.matias-api.com/docs/glossary#w) [X](https://docs.matias-api.com/docs/glossary#x) [Z](https://docs.matias-api.com/docs/glossary#z) :::warning ⚠️ Nota Crítica: IDs de API vs Códigos DIAN **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: 7` para 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](https://docs.matias-api.com/docs/glossary#persona-de-recepcion) y no cambia. Se consulta con `GET /events/mailbox/address`. Ver [Buzón de recepción](https://docs.matias-api.com/docs/endpoints/events-radian#buzon-recepcion). --- ## 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](https://docs.matias-api.com/docs/glossary#buzon-de-recepcion) 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](https://docs.matias-api.com/docs/endpoints/events-radian#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_code` del `01` al `04`). * **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](https://docs.matias-api.com/docs/endpoints/events-radian.md). --- ## 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](https://docs.matias-api.com/docs/endpoints/events-radian#personas-recepcion). --- ### 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](https://docs.matias-api.com/docs/endpoints/events-radian#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