CEMU011 V10 M 2

Código: CE-MU-011
DEFINICIÓN DE ESTRUCTURA DE
Versión No.: 10
DATOS PARA INTEGRACIÓN
Fecha Aprobación: 2 1 / J u l / 2 0 2 0
DEFINICIÓN DE ESTRUCTURA DE
DATOS PARA INTEGRACIÓN
DISPAPELES S.A.S
VERSIÓN FECHA RAZÓN DE LA ACTUALIZACIÓN

0 Abril 2019 Creación del documento
1 Mayo 2019 Actualización introducción, objetivos y alcance
2 Junio 2019 Actualización cuadro de datos
3 Junio 2019 Actualización de numeral 7.1, 7.11, 9.2, 10.1 y 10.2.
4 Junio 2019 Actualización de numeral 7.4, 7.10 y 7.11.
5 Agosto 2019 Actualización del numeral 7.1, 7.2, 7.3, 7.6,7.11, 7.15 y 7.16.
6 Septiembre 2019 Actualización del numeral 7.2, 7.3, 7.7, 9.1, 9.2, 10.1, 10.2, 11 y 12 y se
adiciona tabla en el numeral 7.5.
7 Octubre 2019 Actualización del numeral 7.1, 7.2, 7.3, 7.5, 7.6, 7.7, 7.9, 7.13, 7.14, 9.1,
9.2, 10.1, 10.2, 16.1, 16.2, 16.3, 16.4, 16.5, 16.6, 16.7 y 16.8.
8 Abril 2020 Actualización del numeral 7.1, 7.2, 7.4, 7.12, 8, 8.1, 8.2, 8.3 y 16.2
9 Junio 2020 Actualización del numeral 7.1, 7.2, 7.3, 7.4, 7.5, 7.7, 7.8, 14, 16.1, 16.2,
16.4, 16.5, 16.6, 16.7, 16.8 y creación del numeral 19, 19.1 y 19.2.
10 Julio 2020 Actualización numeral 7.1, 7.2, 7.3, 7.4, 7.5, 7.8, 7.13, 7.16, 16.6, 16.8 y
17.
Código: CE-MU-011
DEFINICIÓN DE ESTRUCTURA Versión No.: 10
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 21/Jul/2020
TABLA DE
CONTENIDO
1. INTRODUCCIÓN ........................................................................................................................ 4
2. OBJETIVOS .............................................................................................................................. 4
2.1 GENERAL ................................................................................................................................. 4
2.2 ESPECÍFICOS ........................................................................................................................... 4
3. ALCANCE ................................................................................................................................... 4
4. DEFINICIONES .......................................................................................................................... 5
5. PROCESO GLOBAL “MODELO VALIDACIÓN PREVIA” ................................................................ 6
5.1 ESCENARIO DE INTEGRACIÓN DETALLADO 1 – Integración Indirecta por Manejo de archivos . 7
5.2 ESCENARIO DE INTEGRACIÓN DETALLADO 2 – Integración Indirecta por Base de datos ........ 7
5.3 ESCENARIO DE INTEGRACIÓN DETALLADO 3 – Integración Indirecta por web service ........... 8
5.4 ESCENARIO DE INTEGRACIÓN DETALLADO 4 – Integración directa..................................... 8
6 ARQUITECTURA DE SERVIDORES Y SERVICIOS ......................................................................... 9
7 . DICCIONARIO DE DATOS ........................................................................................................ 10
7.1 CABEZA DEL DOCUMENTO ELECTRÓNICO ........................................................................ 11
7.2 DETALLE DE LA FACTURA ................................................................................................. 12
7.3 ADQUIRENTES “PERSONA NATURAL O JURÍDICA QUE COMPRA UN BIEN O UN SERVICIO”
13
7.4 PAGO................................................................................................................................ 13
7.5 IMPUESTOS Y RETENCIONES............................................................................................ 14
7.6 FACTURA(S)A MODIFICAR EN NOTA ............................................................................... 15
7.7 MANDANTES .................................................................................................................... 16
7.8 LISTA DE CAMPOS ADICIONALES ...................................................................................... 16
7.9 LISTA ORDEN DE COMPRA ................................................................................................ 17
7.10 LISTA DE CARGOS ............................................................................................................ 17
7.11 LISTA DE DESCUENTOS .................................................................................................... 17
7.12 LISTADO CÓDIGOS DE BARRA ........................................................................................... 17
7.13 LISTA DATOS DE ENTREGA ............................................................................................... 19
7.14 LISTADO MEDIOS DE PAGO ............................................................................................... 19
7.15 LISTA DE DOCUMENTOS ADJUNTOS ................................................................................. 20
7.16 LISTA DE ANTICIPOS ......................................................................................................... 20
8 CÓDIGOS DE RESPUESTA DE ESTADOS ...................................................................................... 20
8.1 ESTADOS DIAN ................................................................................................................. 20
8.2 ESTADOS ENVÍO EMAIL ................................................................................................... 20
8.3 ESTADOS ADQUIRENTES .................................................................................................. 21
9 MÉTODOS DE ENVÍO DE DATOS AL WEB SERVICE DE DISPAPELES ........................................... 21
9.1 ENVIAR DOCUMENTO.................................................................................................... 21
10 MÉTODOS DE CONSULTA Y DEFINICIÓN DE ESTRUCTURAS DE CONSULTA Y RESPUESTA ......... 23
10.1 CONSULTAR ESTADO FACTURA ..................................................................................... 23
10.2 CONSULTAR ARCHIVOS .................................................................................................. 24
11. MENSAJE DE RESPUESTA ................................................................................................... 24
12 MENSAJES DE ERROR ............................................................................................................... 25
13. MATRIZ DE CAMBIOS A CONSIDERAR ..................................................................................... 25
14. CONEXIÓN SOAP AMBIENTE PRUEBAS ................................................................................. 26
15. SEGURIDAD DE PRUEBAS EN AMBIENTE DEMO .................................................................... 26
16. TABLAS .................................................................................................................................... 26
16.1 INCOTERM ......................................................................................................................... 26
16.2 IMPUESTOS ........................................................................................................................ 26
Página 2 de 31
Código: CE-MU-011
16.3 TIPO DE DOCUMENTO DE IDENTIFICACIÓN .................................................................... 27

16.4 TIPO PERSONA ................................................................................................................ 27
16.5 REGIMEN FISCAL ............................................................................................................. 27
16.6 RESPONSABILIDADES FISCALES....................................................................................... 27
16.7 MEDIOS DE PAGO ............................................................................................................ 28
16.8 TIPO OPERACIÓN ............................................................................................................ 28
17. CARACTERES PROHIBIDOS ..................................................................................................... 29
18. OBSERVACIONES .NET .......................................................................................................... 29
19. INTEGRACIÓN DE SERVICIOS PARA GENERACIÓN DE REPRESENTACIÓN GRÁFICA ................ 29
19.1 EL FACTURADOR ASUME LA RESPONSABILIDAD DE CREACIÓN Y ENVÍO DE LA
REPRESENTACIÓN GRÁFICA ....................................................................................................... 29
19.2 EL FACTURADOR ENVIA PDF PARA QUE DISPAPELES CARGUE EL CUFE, FECHA DE
EXPEDICIÓN Y QR ....................................................................................................................... 30
Página 3 de 31
Código: CE-MU-011
1. INTRODUCCIÓN
Teniendo en cuenta el nuevo modelo de validación previa propuesto por la DIAN, Dispapeles plantea una
serie de cambios en la estructura de datos requerida en el proceso de integración.
Con el fin de dar a conocer dichos cambios, Dispapeles ha creado el presente manual, el cual expone en
primera instancia una breve descripción del proceso de facturación electrónica según el modelo propuesto
por la DIAN, seguido de los diferentes escenarios de integración y de la arquitectura de servidores y
servicios.
Luego se presenta el diccionario de datos, el cual define los objetos y la estructura de estos, así como
el tipo de datos que lo componen, de manera que sea posible la comunicación con el web service.
Posteriormente se expone información relacionada con los métodos de envío y consulta de información,
seguido de una serie de tablas que contienen información adicional referente al diccionario de datos y
finalmente se presenta una tabla que recopila todos los cambios que se deben aplicar debido al cambio
del modelo de la DIAN.
2. OBJETIVOS
2.1 GENERAL
Garantizar el entendimiento del usuario acerca de los cambios que necesitan implementarse con el fin de
ajustar las integraciones al nuevo modelo de validación previa propuesto por la DIAN.
2.2 ESPECÍFICOS
• Informar a los diferentes interesados las modificaciones que se deben realizar para ajustar la
estructura de datos actual.
• Detallar las modificaciones a la estructura de datos con el fin de que esta sea acorde a lo solicitado
por la DIAN.
• Generar un manual que cuente con información precisa y veraz con el propósito de brindar un
soporte documental.
3. ALCANCE
El presente manual ha sido diseñado con la finalidad de reunir toda la información necesaria para
comprender el cambio en la estructura de datos de manera que esta se pueda adaptar a lo requerido por
la DIAN. Este documento está dirigido al personal técnico y administrativo de parte del cliente y de
Dispapeles, que son aquellos que se encargan del proceso de configuración de la facturación electrónica.
Página 4 de 31
Código: CE-MU-011
4. DEFINICIONES
Adquirente: Persona natural o jurídica que adquiere bienes y/o servicios y debe exigir factura o
documento equivalente y que, tratándose de la factura electrónica, la recibe, rechaza cuando sea del caso
y conserva para su posterior exhibición, en las condiciones que se establecen en el Decreto 2242/2015.
Código Único de Factura Electrónica (CUFE): El código único de factura electrónica para las facturas
electrónicas, corresponde a un valor alfanumérico obtenido a partir de la aplicación de un procedimiento
que utiliza datos de la factura, que adicionalmente incluye la clave de contenido técnico de control
generada y entregada por la DIAN.
El código único de factura electrónica deberá ser incluido como un campo más dentro de la factura
electrónica. Este código deberá visualizarse en la representación gráfica, las facturas electrónicas y en los
códigos bidimensionales QR definidos para tal fin.
Factura Electrónica (F.E.): Documento que soporta transacciones de venta bienes y/o servicios y que
operativamente tiene lugar a través de sistemas computacionales y/o soluciones informáticas que
permiten el cumplimiento de las características y condiciones que se establecen en el Decreto 2242/2015,
en relación con la expedición, recibo, rechazo y conservación. La expedición de la factura electrónica
comprende la generación por obligado a facturar y su entrega al adquirente
Obligado a facturar electrónicamente (OFE): Persona natural o jurídica comprendida en el ámbito del
Decreto 2242/2015 y que como tal debe facturar electrónicamente en las condiciones que se establecen
en el mismo. Estas personas deben cumplir con la obligación formal de expedir factura de venta o
documento equivalente a factura de venta, por todas y cada una de las ventas y/o servicios que preste, se
incluye dentro de este concepto los sujetos no obligados a expedir factura de venta o documento
equivalente a la factura de venta que de manera voluntaria opten por cumplir con la citada obligación
formal.
Proveedor tecnológico: Es la persona natural o jurídica que podrá prestar a los obligados a facturar
electrónicamente y/o a los adquirentes que opten por recibir la factura en formato electrónico de
generación, cuando unos u otros así lo autoricen, los servicios inherentes a la expedición de la factura
electrónica, incluida la entrega del ejemplar a la DIAN como se indica en el Artículo 7 del Decreto
2242/2015, así como los servicios relacionados con su recibo, rechazo y conservación.
Validación previa de la factura electrónica de venta: Procedimiento electrónico a cargo de la

Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales – DIAN, que
consiste en la verificación de las reglas de validación de la factura electrónica contenidas en el
“Anexo técnico de factura electrónica de venta”, en relación con el cumplimiento de todos los
requisitos de acuerdo a las condiciones, términos y mecanismos técnicos y tecnológicos que para
tal efecto establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas
Nacionales – DIAN.
WebServices: El término Web Services describe una forma estandarizada de integrar aplicaciones WEB
mediante el uso de XML, SOAP, WSDL y UDDI sobre los protocolos de la Internet. XML es usado para
describir los datos, SOAP se ocupa de la transferencia de los datos, WSDL se emplea para describir los
servicios disponibles y UDDI se ocupa de conocer cuáles son los servicios disponibles.
Página 5 de 31
Código: CE-MU-011
5. PROCESO GLOBAL “MODELO VALIDACIÓN PREVIA”

Para lograr que cada implementación de facturación electrónica sea rápida y fácil, es decir, que no se vea
afectada la operación de cada empresa debido a cambios muy invasivos en los sistemas de información
actuales, se ha diseñado el siguiente proceso.
La primera parte del proceso de facturación electrónica en las empresas obligadas a facturar inicia cuando
se realiza la venta de un bien o un servicio. En ese momento, el ERP dueño de la factura deberá hacer
entrega de los datos de la factura al proveedor tecnológico, y para hacerlo hay distintas formas.
En la siguiente imagen podemos ver de forma global como es la iteración entre el ERP y el web service del
proveedor tecnológico.
Imagen 1. Proceso global
Página 6 de 31
Código: CE-MU-011
5.1 ESCENARIO DE INTEGRACIÓN DETALLADO 1 – Integración Indirecta por Manejo de archivos

Entrando más al detalle podemos ver que una de las formas de integración entre un ERP y un web service
para proceso de facturas electrónicas es la de exportar en un archivo la información de esa factura que
pueden ser xml, txt, csv, etc. Actualmente contamos con conectores o programas que se encargan de
hacer la lectura y mapeo de datos para enviarlos hasta nuestro web service. En este escenario, se delega
la responsabilidad de extracción de la data al ERP Y es esta la actividad que más tiempo consume.
Imagen 2. Uso de conector para lectura de archivos
5.2 ESCENARIO DE INTEGRACIÓN DETALLADO 2 – Integración Indirecta por Base de datos

Este escenario es muy similar al anterior, la única diferencia es que en vez de archivos el programa deberá
extraer la data de una base de datos sea por vistas o acceso directo a las tablas de ERP. Este
escenario se recomienda solo si no se invade la base de datos del ERP, es decir, se usa una base de
datos diferente exclusivamente para este fin. Acá también se debe instalar un programa conector que
intermedie entre el ERP y el web service.
Imagen 3. Uso de conector para lectura de BD

Página 7 de 31
Código: CE-MU-011
5.3 ESCENARIO DE INTEGRACIÓN DETALLADO 3 – Integración Indirecta por webservice

En esta opción se busca la conexión entre los sistemas mediante el consumo de un web service expuesto
por el ERP, leído por un conector o programa intermedio y enviado a otro web service del proveedor
tecnológico. Este escenario es ideal para los ERP’S porque exponen de manera estándar los datos y estos
pueden ser consumidos por los PT.
Imagen 4. Uso de conector para lectura de web service
5.4 ESCENARIO DE INTEGRACIÓN DETALLADO 4 – Integración directa.

Este último escenario plantea el consumo directo del web service del proveedor tecnológico. De esta
forma, la solución se puede ver nativamente en el ERP y es un valor agregado a sus clientes.
Imagen 5. Consumo directo del web service
A continuación, se describen los campos necesarios para la integración de un ERP con el web service de
Dispapeles para la implementación de la factura electrónica:
Página 8 de 31
Código: CE-MU-011
6 ARQUITECTURA DE SERVIDORES Y SERVICIOS
Dispapeles cuenta con una serie de servicios y servidores basados en Amazon AWS. En la siguiente
imagen se puede observar la configuración de la infraestructura técnica usada por Dispapeles.
Imagen 6. Arquitectura de software
Servidores web: Soportan todos los aplicativos webs que maneja Dispapeles, estos son: Web
Service, Portal de emisión de facturas, portal de recepción de facturas, portal de adquirentes y
portal de proveedores.
Estos servidores están ubicados en zonas geográficamente diferentes, la distancia de cada

datacenter es de por lo menos 100km y garantizan una disponibilidad del servicio superior al
99.95%. Adicionalmente estos servidores son auto escalables, esto es que en horas pico
automáticamente se crean nuevos servidores para garantizar el óptimo funcionamiento a nuestros
clientes.
Servidor de base de datos: Usamos Amazon Aurora, esta base de datos es nativa de Amazon y
está diseñada para suministrar una disponibilidad mayor al 99,99%, lo que aumenta la
disponibilidad y el rendimiento mediante la integración estrecha del motor de base de datos con
Página 9 de 31
Código: CE-MU-011
una capa de almacenamiento virtualizada respaldada por SSD diseñada específicamente para
cargas de trabajo de bases de datos. El almacenamiento de Amazon Aurora es tolerante a errores
y se recupera automáticamente. Además, los errores de disco se reparan en segundo plano sin
afectar la disponibilidad de la base de datos. Amazon Aurora está diseñado para detectar
automáticamente los bloqueos de las bases de datos y se reinicia sin necesidad de realizar
recuperaciones tras bloqueos, ni de recompilar la caché de la base de datos. Si falla la instancia
completa, Amazon Aurora realizará una conmutación por error automática a una de las 15 réplicas
de lectura.
Elastic File System: Amazon Elastic File System (Amazon EFS) suministra un almacenamiento
de archivos simple, escalable y elástico para utilizar con los servicios de la nube de AWS y los
recursos locales. Amazon EFS es un servicio regional diseñado para brindar altos niveles de
disponibilidad y durabilidad, y que, además, ofrece compatibilidad con una amplia gama de casos
de uso. Entre ellos, la administración de contenido y entrega web, aplicaciones empresariales,
flujos de trabajo de procesamiento multimedia y entretenimiento, directorios principales, backups
de bases de datos, herramientas para desarrolladores, almacenamiento en contenedores y cargas
de trabajo de análisis de big data.
WAF: AWS WAF es un firewall web que ayuda a proteger sus aplicaciones web de ataques web
habituales que podrían afectar a la disponibilidad de la aplicación, comprometer la seguridad o
consumir excesivos recursos. AWS WAF permite controlar el tráfico que desea habilitar o bloquear
en su aplicación web mediante la definición de reglas de seguridad web personalizables. Puede
usar AWS WAF para crear reglas personalizadas que bloquean patrones de ataque comunes,
como la inyección de código SQL y los scripts de sitios, así como reglas diseñadas para su
aplicación específica. Las nuevas reglas se pueden implementar en cuestión de minutos, con lo
que puede responder rápidamente ante cambios en los patrones de tráfico. Además, AWS WAF
incluye una completa API que puede utilizar para automatizar la creación, la implementación y el
mantenimiento de reglas de seguridad en la web.
Balanceador de carga: Application Load Balancer es usado para el equilibrio de carga del tráfico
HTTP y HTTPS y proporciona un enrutamiento de solicitudes avanzado dirigido a la entrega de
arquitecturas de aplicaciones modernas, incluyendo microservicios y contenedores. Operando en
el nivel de petición individual (Capa 7), Application Load Balancer dirige el tráfico a los objetivos
dentro de Amazon Virtual Private Cloud (Amazon VPC) basado en el contenido de la solicitud.
7 . DICCIONARIO DE DATOS
A continuación, se definen los objetos y la estructura de estos, así como los tipos de datos que lo componen,
para la comunicación con el web service.
IMPORTANTE: Tanto la estructura de campos como su obligatoriedad y descripción que se indican a

continuación, corresponden a las actuales indicaciones de la DIAN, las cuales pueden variar
posteriormente, información que le será transmitida en su momento.
Página 10 de 31
Código: CE-MU-011
7.1 CABEZA DEL DOCUMENTO ELECTRÓNICO

A continuación, se describen todos los campos que hacen parte de la cabeza del documento y que
conforman la raíz del objeto factura, que es enviado como parámetro al Web Service de
Dispapeles para la generación, conservación y exposición de los documentos electrónicos. Los
datos a continuación hacen parte del objeto principal que se envía como parámetro al Servicio
Web, esta estructura es de tipo “felCabezaDocumento”, que a su vez encapsula también las
estructuras de los detalles (Items), impuestos, facturas modificadas, mandantes, contratos, entre
otros que hacen parte del documento, los cuales se describirán más adelante.
OBLIGATORIO
NOMBRE TIPO DE DATOS DESCRIPCIÓN
DIAN PT
idEmpresa Int NO SI
usuario varchar(40) NO SI CAMPOS PARA VALIDAR LA SEGURIDAD. ESTOS VALORES SON ENTREGADOS POR
contrasenia varchar(40) NO SI DISPAPELES A CADA EMPRESA FACTURADORA.
token varchar(40) NO SI
versión varchar(40) NO SI VERSIÓN DEL MANUAL CON LA QUE EL CLIENTE TRABAJÓ LA INTEGRACIÓN
TIPO DE DOCUMENTO --1. FACTURA DE VENTA, 2. NOTA CRÉDITO, 3. NOTA DÉBITO 4.
tipodocumento varchar(1) SI SI FACTURA DE EXPORTACIÓN, 5. FACTURA DE CONTINGENCIA, 6. FACTURA DE
IMPORTACIÓN, 7. DOCUMENTO SOPORTE.
prefijo varchar(5) NO NO PREFIJO DE DOCUMENTO, SOLO SI LA EMPRESA LO MANEJA.
consecutivo Long SI SI CONSECUTIVO ENTREGADO EN LA RESOLUCIÓN DE LA DIAN O NÚMERO DE FACTURA.
fechafacturacion timestamp SI SI 'FECHA Y HORA EN LA QUE SE FACTURÓ EN FORMATO YYYY-MM-DD HH:mm:ss'.
CODIGO DEL FORMATO DEL DOCUMENTO ELECTRÓNICO A IMPLEMENTAR. APLICA SOLO
codigoPlantillaPdf Int NO SI SI LA EMPRESA MANEJA MAS DE UN FORMATO PARA FACTURAS Y NOTAS.
CUANDO EL VALOR ES CERO (0), INDICA QUE NO SE REQUIERE CREAR REPRESENTACIÓN
GRÁFICA.
idErp varchar(40) NO NO ID DEL ERP PARA ASOCIARLO A LA FACTURA.
VERIFICA EL NUMERO DE LOS DETALLES, ESTE ES UN CONTROL DE LA DIAN PARA

cantidadLineas int SI SI COMPROBAR QUE LOS SERVICIOS Y PRODUCTOS VAN COMPLETOS.
OBLIGATORIO PARA FACTURAS DE EXPORTACIÓN. VER TABLA INCOTERM.

incoterm varchar(3)
SI SI
NOTA CRÉDITO: 1. DEVOLUCIÓN DE PARTE DE LOS BIENES 2. ANULACIÓN DE FACTURA 3.
REBAJA TOTAL APLICADA 4. DESCUENTO TOTAL APLICADO 5. RESCISIÓN: NULIDAD POR
tiponota varchar(2) SI SI FALTA DE REQUISITOS 6. OTROS.
NOTA DEBITO: 7. INTERESES 8. GASTOS POR COBRAR 9. CAMBIO DEL VALOR 10. OTROS.
aplicafel varchar(2) NO SI APLICA FACTURA ELECTRÓNICA A ESTE CLIENTE. VALORES POSIBLES (SI, NO). ESTA
VARIABLE PERMITE EL ENVIO O NO DEL DOCUMENTO POR EMAIL AL COMPRADOR O
ADQUIRENTE.
centroCostos varchar(100) NO NO CENTRO DE COSTOS AL QUE SE DEBE ASOCIAR LA FACTURA.
descripcionCentroCostos varchar(240) NO NO DESCRIPCIÓN DEL CENTRO DE COSTOS.
codigovendedor varchar(50) NO NO CODIGO O IDENTIFICACIÓN DEL VENDEDOR.
nombrevendedor varchar(50) NO NO NOMBRE DEL VENDEDOR.
sucursal varchar(50) NO NO SUCURSAL DE LA EMPRESA
pago FEL_PAGOS SI SI ESTRUCTURA QUE ALMACENA LA INFORMACIÓN DEL PAGO. VER TABLA FEL_PAGOS.
List<felDetalleDocume LISTA QUE ALMACENA LOS DETALLES DE PRODUCTOS Y/O SERVICIOS.
listaDetalle SI SI
nto>
listaImpuestos List<Fel_Impuesto> SI SI LISTA DE LOS IMPUESTOS ASOCIADOS A LA FACTURA.
List<Fel_FacturaModific LISTA DE LAS FACTURAS ASOCIADAS A UNA NOTA O FACTURA DE CONTINGENCIA. ESTE
listaFacturasModificadas NO NO VALOR SE HACE OBLIGATORIO CUANDO EL TIPO DOCUMENTO ES UNA NOTA CRÉDITO,
ada>
NOTA DÉBITO O FACTURA DE CONTINGENCIA.
List<Fel_DocumentoAdj LISTA DE DOCUMENTOS ADJUNTOS QUE SE ENVÍAN POR EL WEB SERVICE. EL CARGUE
listaDocumentosAdjuntos unto> NO NO AUTOMÁTICO DE ADJUNTOS APLICA PARA ADJUNTOS QUE PESAN HASTA 5MB, PARA
CUALQUIER OTRO ESCENARIO SE DEBERÁ REVISAR OTRA ALTERNATIVA DE SOLUCIÓN.
ESTE SERVICIO TIENE UN VALOR POR RECURRENCIA QUE SE ESPECIFICA EN LA
PROPUESTA.
listaAdquirentes List<Fel_Adquirente> SI SI LISTA DE ADQUIRENTES O CLIENTES QUE COMPRAN ASOCIADOS A LA FACTURA.
LISTA QUE ALMACENA UNO O VARIOS ELEMENTOS CON ASOCIACIÓN CAMPO VALOR PARA
List<Fel_CampoAdiciona l > MANEJAR CAMPOS NO TENIDOS EN CUENTA EN EL ESTÁNDAR UBL2.1 DEFINIDO POR LA
listaCamposAdicionales NO NO
DIAN. ESTE CAMPO HACE PARTE DE LOS CAMBIOS POR EL NUEVO MODELO.
CONTIENE UN LISTADO DE LAS ORDENES DE COMPRAS ASOCIADAS A UNA FACTURA. UNA
listaOrdenesCompras List<Fel_OrdenCompra> NO NO OPCIÓN ES MANEJAR LA INICIAL SEPARANDO TODO POR PUNTO Y COMA “;”
listaDescuentos List<Fel_Descuento> NO NO LISTADO DE DESCUENTOS ASOCIADOS A LA FACTURA.
listaCargos List<Cargos> NO NO LISTADO DE CARGOS ASOCIADOS A LA FACTURA.
listaCodigoBarras List<Fel_CodigoBarras > NO NO LISTADO DE LOS CÓDIGOS DE BARRAS.
listaDatosEntrega List<Fel_DatoEntrega> NO NO LISTADO DE INFORMACIÓN QUE PERMITE HACER LA ENTREGA DE LA MERCANCÍA.
listaMediosPagos List<Fel_MedioPago> SI SI LISTADO DE LOS MEDIOS DE PAGO. VER POSIBLES VALORES EN LA TABLA 15.7 MEDIOS DE
PAGO
listaAnticipo List<Fel_Anticipos> NO NO ESTRUCTURA QUE DETALLA CADA ANTICIPO ASOCIADO A LA FACTURA
tipoOperacion Varchar(2) SI SI VER EN LA SECCION TABLAS TIPOS DE OPERACIÓN
nombreImpresora Varchar(240) NO NO NOMBRE DE LA IMPRESORA CUANDO SE UTILICE IMPRESIÓN AUTOMÁTICA
campoAdicional1 Varchar(240) NO NO CAMPO ADICIONAL DE COMODÍN
Página 11 de 31
Código: CE-MU-011

correoRecepcion Varchar(240) NO NO CORREO AL CUAL EL FACTURADOR RECIBIRÁ LAS NOTIFICACIONES DEL ESTADO DE LA
FACTURA (ACUSE DE RECIBO, ACEPTACIÓN O RECHAZO DEL DOCUMENTO)
Debido a la nueva reglamentación de la DIAN fue necesario eliminar, agregar y cambiar de posición
algunos campos con respecto a los manuales anteriores. Los campos adicionales que no hacen
parte de datos de lista son para control interno, favor no tener en cuenta.
7.2 DETALLE DE LA FACTURA

Los siguientes campos conforman la estructura “felDetalleDocumento” que hace parte del objeto principal
“felCabezaDocumento”, en estos, se almacenan los distintos productos y/o servicios que pueda tener un
facturador. El objeto “felDetalleDocumento” se guarda en una lista asociada a la cabeza de la factura para
permitir crear tantos registros como requiera el negocio. Es decir, un objeto “felCabezaDocumento”
contiene una lista de tipo “felDetalleDocumento” que puede contener varios productos y/o servicios
documentos.
listaDetalle
OBLIGATORIO
DIAN
PT
codigoproducto varchar(30) SI SI CÓDIGO DEL PRODUCTO O SERVICIO
INDICA QUE CÓDIGO DEL ESTÁNDAR DEL PRODUCTO. 001: COLOMBIA COMPRA EFICIENTE.
tipocodigoproducto varchar(30) SI SI 010: NÚMEROS GLOBALES DE IDENTIFICACIÓN DE PRODUCTOS – GTIN. 020: PARTIDA
ARANCELARIA.
999: ESTÁNDAR DE ADOPCIÓN DEL CONTRIBUYENTE
nombreProducto varchar(240) SI SI NOMBRE DEL PRODUCTO O SERVICIO
grupo varchar(240) NO NO GRUPO AL QUE PERTENECE EL PRODUCTO
familia varchar(240) NO NO FAMILIA AL QUE PERTENECE EL PRODUCTO
marca varchar(240) NO NO MARCA DEL PRODUCTO
modelo varchar(240) NO NO MODELO DEL PRODUCTO
descripcion varchar(240) NO NO INFORMACIÓN DESCRIPTIVA DEL PRODUCTO
referencia varchar(100) NO NO REFERENCIA O GRUPO DEL PRODUCTO
cantidad decimal(28,8) SI SI CANTIDAD DEL PRODUCTO, POR DEFECTO DEBE ENVIARSE EL VALOR UNO “1”, EL
VALOR DEBE SER SIEMPRE MAYOR A CERO.
UNIDAD DE MEDIDA QUE MANEJA EL FACTURADOR. SE DEBE USAR LOS VALORES
DESCRITOS EN LA TABLA 6.3.6. DEL DOCUMENTO ADJUNTO
unidadmedida varchar(5)
ANEXO%20TÉCNICO%20DE%20FACTURA%20ELECTRÓNICA.PDF. ESTOS VALORES SON
SI SI
OBLIGATORIOS, EL NO USO DE LOS VALORES DE ESTA TABLA GENERARÁ UN RECHAZO DE
LA FACTURA EN LA PLATAFORMA DE LA DIAN.
valorunitario decimal(28,8) SI SI VALOR UNITARIO DEL PRODUCTO O SERVICIO. ES EL VALOR COMERCIAL DEL
PRODUCTO SIN APLICAR IMPUESTOS NI DESCUENTOS. EL VALOR DEBE SER MAYOR A
CERO.
VALOR SIN IMPUESTOS. (CANTIDAD X VALOR UNITARIO – DESCUENTO +CARGOS)
preciosinimpuestos decimal(28,8) SI SI
preciototal decimal(28,8) SI SI VALOR TOTAL A PAGAR POR EL/LOS PRODUCTOS POR LA LÍNEA DE DETALLE. FORMULA
(CANTIDAD X VALOR UNITARIO – DESCUENTO +CARGOS) +IMPUESTOS.
posición INT NO NO VALOR PARA RESPETAR EL ORDEN ASIGNADO POR EL ERP
seriales String(800) NO NO SERIALES REGISTRADOS
gramaje String(800) NO NO PESO EN GRAMOS
tamanio decimal(28,8) NO NO TAMAÑO
INDICA SI ES UNA MUESTRA COMERCIAL O UN REGALO. LOS VALORES SON
muestracomercial INT
“MUESTRA=1, REGALO=2”. ESTE CAMPO ES OBLIGATORIO SI EL CLIENTE MANEJA
NO NO REGALOS A NIVEL DE DETALLE. INDEPENDIENTE DE LA OPCION QUE SE ESCOJA,
SIEMPRE SE DEBE ENVIAR EL VALOR COMERCIAL DEL PRODUCTO, AUNQUE ESTE
NO SUMA AL VALOR TOTAL DE LA FACTURA.
ESTE CAMPO ES OBLIGATORIO SI HAY MUESTRA COMERCIAL. LOS CODIGOS ACEPTADOS SON:
muestracomercialcodigo INT NO NO
1. VALOR COMERCIAL, 2. VALOR EN INVENTARIOS, 3. OTRO VALOR
tipoImpuesto INT SI SI GRAVADO=1, EXCLUIDO=2, EXENTO=3. SI NO SE ENVÍA POR DEFECTO SE CARGARÁ
EL VALOR COMO GRAVADO.
listaImpuestos List<Fel_ImpuestoDto> SI SI LISTA DE LOS IMPUESTOS Y/O RETENCIONES ASOCIADOS AL DETALLE. SI EL
PRODUCTO O SERVICIO ES EXCLUIDO NO SE HACE OBLIGATORIO ESTE VALOR.
listaDescuento List<Descuento> NO NO LISTA DE DESCUENTOS ASOCIADOS AL PRODUCTO POR LÍNEA DE DETALLE
listaCargos List<Cargos> NO NO LISTADO DE DESCUENTOS ASOCIADOS
listaCodigoBarras List<Fel_CodigoBarras> NO NO LISTA TODOS LOS CÓDIGOS DE BARRA ASOCIADOS A UN PRODUCTO
LISTA QUE ALMACENA UNO O VARIOS ELEMENTOS CON ASOCIACIÓN CAMPO VALOR
listaCamposAdicionales List<Adicionales> NO NO PARA MANEJAR CAMPOS NO TENIDOS EN CUENTA EN EL ESTÁNDAR UBL2.1 DEFINIDO POR
LA DIAN. ESTE CAMPO HACE PARTE DE LOS CAMBIOS POR EL NUEVO MODELO.
aplicaMandato String(2) NO NO INDICA SI EL PRODUCTO O SERVICIO MANEJA MANDATO O NO. LOS VALORES SON ‘SI’ O ‘NO’
LISTA DE LOS MANDANTES ASOCIADOS A LA FACTURA. APLICA SOLO SI EL CAMPO
listaMandantes List<Fel_Mandantes> NO NO
aplicaMandato ES IGUAL A SI.
ESTE CAMPO NO ES EXIGIDO POR LA DIAN, ES UN COMODÍN PARA CLIENTES QUE QUIERAN
valorUnitarioPorCantidad Decimal(28,8) NO NO
VER ESTA INFORMACIÓN EN SU REPRESENTACIÓN GRÁFICA
Página 12 de 31
Código: CE-MU-011
NOTAS ADICIONALES A LA DESCRIPCIÓN DEL PRODUCTO. OBLIGATORIO: DEBERÁ

descripciones List<varchar (240)> NO NO
INFORMARSE DENTRO DE LOS PERIODOS DE TRES (3) DÍAS AL AÑO QUE LA DIAN DEFINA, EN
LOS QUE LOS BIENES CUBIERTOS SE ENCUENTREN EXENTOS DEL IMPUESTO SOBRE LAS
VENTAS, EL TEXTO QUE DEBE INCLUIRSE ES “Bienes Cubiertos”. OBLIGATORIO: DEBERÁ
INFORMARSE PARA EL CASO DE FACTURAS CON SERVICIOS AIU PARA EL ITEM
ADMINISTRACIÓN, ESTE CAMPO DEBE INICIAR CON EL TEXTO “Contrato de servicios AIU por
concepto de:” EL CONTRIBUYENTE DEBE INCLUIR EL OBJETO DEL CONTRATO FACTURADO
7.3 ADQUIRENTES “PERSONA NATURAL O JURÍDICA QUE COMPRA UN BIEN O UN SERVICIO”

La siguiente estructura de campos conforman la estructura “felAdquirente” que hace parte del objeto
principal “felCabezaDocumento”, en estos, se almacenan los distintos clientes que hacen referencia al
comprador. El objeto “felAdquirente” se guarda en una lista para obtener tantos clientes como se
requieran.
listaAdquirentes
TIPO DE DATOS OBLIGATORIO
NOMBRE DESCRIPCIÓN
DIAN PT
tipoPersona varchar(1) SI SI TIPO DE PERSONA, 1. PERSONA JURÍDICA, 2. PERSONA NATURAL
CONCATENACIÓN DE NOMBRES Y APELLIDOS. SI NO SE TIENEN LOS NOMBRE Y APELLIDOS POR SEPARADOS SE
nombreCompleto varchar(240) SI SI PUEDE ENVIAR SOLO ESTE CAMPO. SI LA PERSONA ES JURIDICA, EN ESTE CAMPO SE AGREGA LA RAZON
SOCIAL.
tipoIdentificacion smallintt(6) SI SI VER EN LA SECCION DE TABLAS -> TIPO DE DOCUMENTO DE IDENTIFICACIÓN
NÚMERO DEL DOCUMENTO DE IDENTIFICACIÓN SIN DIGITO DE VERIFICACION EN CASO DEL NIT, SIN
numeroIdentificacion varchar(30) SI SI CARACTERES ESPECIALES
digitoverificacion varchar(2) NO NO DÍGITO DE VERIFICACIÓN DEL DOCUMENTO DE IDENTIDAD. SE HACE OBLIGATORIO CUANDO EL TIPO
DOCUMENTO ES NIT.
regimen varchar(240) NO NO 48. IMPUESTO SOBRE LAS VENTAS - IVA 49. NO RESPONSABLE DE IVA
CORREO ELECTRÓNICO DEL CLIENTE. ESTE CAMPO SE VUELVE OBLIGATORIO SI EL CAMPO APLICAFEL ES “SI” Y
email varchar(200) NO NO
ENVIOPOREMAILPLATAFORMA ES EMAIL
pais varchar(2) SI SI PAIS CLIENTE EN ESTÁNDAR ISO 3116-1, ES DECIR COLOMBIA "CO"
DEPARTAMENTO DE RESIDENCIA DEL CLIENTE. EL CAMPO DEPARTAMENTO DEBE RECIBIR EL CODIGO DEL
departamento varchar(50) SI SI
MUNICIPIO SEGÚN TABLA DEL DANE. VER TABLA ANEXA SUB-REGIONES DANE.
nombreDepartamento varchar(50) NO NO NOMBRE DEL DEPARTAMENTO
CIUDAD DE RESIDENCIA DEL CLIENTE. EL CAMPO CIUDAD DEBE RECIBIR EL CODIGO DEL MUNICIPIO SEGÚN
Ciudad varchar(50) SI SI
TABLA DEL DANE. VER TABLA ANEXA SUB-REGIONES DANE.
descripcionCiudad varchar(100) NO NO NOMBRE DESCRIPTIVO DE LA CIUDAD
barioLocalidad varchar(50) NO NO BARRIO DEL CLIENTE
Dirección varchar(100) SI SI DIRECCIÓN DEL CLIENTE
Teléfono varchar(50) NO NO TELÉFONO DEL CLIENTE
codigoPostal varchar(6) NO NO CODIGO POSTAL
SI APLICA FEL ES SI, DEBE INDICAR SI EL ENVÍO SE HARÁ AL EMAIL O POR PLATAFORMA TECNOLÓGICA. SI NO SE
envioPorEmailPlataforma varchar(10) NO NO
CARGA CON LAS VARIABLES EMAIL O PLATAFORMA NO SE TRANSMITIRÁ EL DOCUMENTO.
NIT DEL PROVEEDOR TECNOLOGICO. ESTE CAMPO ES OBLIGATORIO SI envioPorEmailPlataforma ES
nitProveedorTecnologico varchar(30) NO NO
PLATAFORMA
CODIGO DE LA OBLIGACIÓN CUANDO EL TIPO DE IDENTIFICACIÓN ES NIT. VER TABLA RESPONSABILIDADES
Tipoobligacion varchar(30) NO NO
FISCALES. SI LA EMPRESA TIENE MAS DE UN TIPO DE OBLIGACIÓN, DEBERÁN IR SEPARADOS POR PUNTO Y
COMA “;”. GENERA RECHAZO SI SE ENVÍA UN VALOR DIFERENTE DE LA TABLA DE RESPONSABILIDADES
FISCALES.
paisnombre varchar(30) NO NO NOMBRE DEL PAÍS RELACIONADO CON EL CÓDIGO ENVIADO
codigoCIUU varchar(30) NO NO CODIGO CIIU DEL ADQUIRENTE
matriculaMercantil varchar(60) NO NO NUMERO DE MATRICULA MERCANTIL ASOCIADA AL PREFIJO.
porcentajeParticipacion Decimal(28,8) NO NO APLICA PARA CONSORCIOS Y UNIONES TEMPORALES
7.4 PAGO
Esta estructura que muestra todos los campos asociados al pago de la factura.
OBLIGATORIO
DIAN PT
moneda varchar(3) SI SI 'MONEDA EN LA QUE SE NEGOCIA EN ESTÁNDAR ISO 4217'
SUMATORIA DE TODOS LOS PRECIOS SIN IMPUESTO DE LAS LÍNEAS DE DETALLE DE LA
totalimportebruto decimal (28,8) SI SI
FACTURA.
ES LA SUMATORIA DE TODAS LAS BASES IMPONIBLES EN LA LISTA DE IMPUESTOS
totalbaseimponible decimal (28,8) SI SI ASOCIADAS AL DETALLE DE LA FACTURA, QUE APLICAN COMO IMPUESTOS Y NO COMO
RETENCIONES.
totalbaseconimpuestos decimal (28,8) SI SI ES EL TOTAL IMPORTE BRUTO MAS LA SUMATORIA DE TODOS LOS VALORES DE IMPUESTOS
A NIVEL DE DETALLE. NO APLICA PARA CODIGOS DE RETENCIÓN.
Totalimportebruto + ∑ valorImpuestoRetencion(NIVEL DETALLE)
ES LA BASE CON IMPUESTOS, MAS CARGOS, MENOS DESCUENTOS, MENOS ANTICIPOS,

totalfactura decimal (28,8) SI SI
TODO A NIVEL GLOBAL.
Página 13 de 31
Código: CE-MU-011
Totalbaseconimpuestos+ totalCargos- totalDescuento- pagoanticipado
pagoanticipado decimal (28,8) NO NO CONSOLIDADO DE TODOS LOS ANTICIPOS DE LA FACTURA. ESTE VALOR SALE DE LA
SUMATORIA DE TODOS LOS ANTICIPOS EN LA LISTA DE ANTICIPOS A NIVEL GLOBAL.
tipocompra smallint (6) SI SI ESTE CAMPO INDICA SI LA COMPRA ES 1. DE CONTADO O 2. A CRÉDITO
NO NO ESTE CAMPO INDICA EL NÚMERO DE DIAS EN QUE SE PAGARA LA COMPRA CUANDO ES A
periododepagoa smallint(6)
CREDITO, ES DECIR tipocompra=2. ESTE CAMPO ES OBLIGATORIO SI tipocompra=2
NO NO APLICA PARA VENTAS A CREDITO tipocompra=2, INFORMA LA FECHA LIMITE EN QUE SE DEBE
fechavencimiento Date PAGAR LA FACTURA DE ACUERDO CON LO ACORDADO EN EL PERDIODO DE PAGO. ESTE
CAMPO
ES OBLIGATORIO SI tipocompra=2
trm decimal (28,8) NO NO SE HACE OBLIGATORIO PARA FACTURAS DE EXPORTACIÓN O NACIONALES EN OTRA
MONEDA
trm_alterna decimal (28,8) NO NO APLICA PARA FACTURAS DE EXPORTACIÓN O NACIONALES EN OTRA MONEDA
fechaTasaCambio Date NO NO OBLIGATORIO PARA FACTURAS DE EXPORTACIÓN O NACIONALES EN OTRA MONEDA.
FECHA CON LA QUE SE FIJA LA TASA DE CAMBIO. CAMPO NUEVO
codigoMonedaCambio varchar(3) SI SI MONEDA EN LA QUE SE CONVIERTE CON LA TRM EN ESTÁNDAR ISO 4217, ESTE
VALOR SIEMPRE DEBE SER COP
totalDescuento decimal (28,8) NO NO CONSOLIDADO DEL TOTAL DE LOS DESCUENTOS APLICADOS. EL VALOR SALE DE
LA SUMATORIA DEL VALOR DESCUENTO DE LA LISTA DE DESCUENTOS A NIVEL
GLOBAL.
totalCargos decimal (28,8) NO NO CONSOLIDADO DEL TOTAL DE LOS CARGOS APLICADOS. EL VALOR SALE DE LA
SUMATORIA DEL VALORCARGO DE LA LISTA DE CARGOS A NIVEL GLOBAL.
subtotal Decimal (28,8) NO NO VALOR UTILIZADO COMO COMODÍN PARA LAS EMPRESAS QUE REQUIERAN EN EL
CAMPO SUBTOTAL UN VALOR PARTICULAR.
valorEnLetrasSubTotal Varchar (240) NO NO COMODÍN PARA REPRESENTACIONES GRÁFICAS. CON BASE EN EL CAMPO
SUBTOTAL SE CALCULARÁ EL VALOR EN LETRAS QUE SE COLOCARÁ EN ESTE
CAMPO.
valorAdicional1 Varchar (240) NO NO COMODÍN PARA REPRESENTACIONES GRÁFICAS
valorEnLetras1 Varchar (240) NO NO COMODÍN PARA REPRESENTACIONES GRÁFICAS
redondeoTotalFactura Decimal (28,8) NO NO COMODÍN PARA REPRESENTACIONES GRÁFICAS
7.5 IMPUESTOS Y RETENCIONES

Los siguientes campos conforman la estructura “felImpuesto” que hace parte del objeto principal
“felCabezaDocumento”, en estos, se almacenan los distintos impuestos y/o retenciones que se apliquen a
una factura o nota. El objeto “felImpuesto” se guarda en una lista asociada a la cabeza de la factura para
permitir crear tantos registros de impuestos y/o retenciones como requiera el negocio.
Esta estructura se encontrará a nivel global de la factura y a nivel de ítems. Cuando el impuesto es global
se cargará la lista en la raíz del objeto FELCabezaDocumento, cuando es por item’s la lista se llenará desde
el objeto felDetalleDocumento.
felImpuestos
NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN
CÓDIGO DEL IMPUESTO O RETENCIÓN. VER NUEVA TABLA DE IMPUESTOS EN LA

codigoImpuestoRetencion varchar(2) SI
SECCIÓN TABLAS.
porcentaje decimal(7,8) SI PORCENTAJE DE IMPUESTO O RETENCIÓN A APLICAR.
valorImpuestoRetencion decimal(28,8) SI VALOR DEL IMPUESTO O RETENCIÓN A APLICAR
BASE IMPONIBLE SOBRE LA QUE SE CALCULA LA RETENCIÓN O IMPUESTO. TENER EN
baseimponible decimal(28,8) SI
CUENTA QUE ESTE VALOR DEBE TENER DESCUENTOS INCLUIDOS.
isAutoRetenido boolean SI INDICA SI LO QUE SE REPORTA ES IMPUESTO O RETENCIÓN. VALORES POSIBLES:
true (ES RETENCIÓN), false (ES IMPUESTO)
La siguiente tabla indica las tarifas que debe reportar el Obligado a Facturar Electrónicamente
(OFE) en el campo cbc:Percent (porcentaje) del grupo TaxTotal (grupo de información de totales
relacionados con los impuestos) de acuerdo al impuesto reportado. Es importante aclarar que para
los impuestos que no figuran en la siguiente tabla, el OFE es el responsable por informar
correctamente la tarifa del impuesto que reporta. Esta tabla corresponde a la tabla 6.3.9. Tablas de
Página 14 de 31
Código: CE-MU-011
tarifas por impuesto del anexo técnico publicado por la DIAN.
IMPUESTO CONCEPTO TARIFA
Cuando el item
sea “excluido” del
IVA, no se debe
Excluido
reportar el IVA en
el grupo de
IVA impuestos
Exento 0.00
Bienes / Servicios al 5 5.00
Contratos firmados con el estado antes de ley 1819 16.00
Tarifa general 19.00
Tarifa especial 2.00
INC
15.00
RETEIVA
100.00
Compras generales (declarantes) 2.50
Compras generales (no declarantes) 3.50
Compras con tarjeta débito o crédito 1.50
Compras de bienes o productos agrícolas o pecuarios sin procesamiento industrial 1.50
Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (declarantes) 2.50
Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial declarantes (no declarantes) 3.50
Compras de café pergamino o cereza 0.50
Compras de combustibles derivados del petróleo 0.10
Enajenación de activos fijos de personas naturales (notarías y tránsito son agentes retenedores) 1.00
Compras de vehículos 1.00
Compras de bienes raíces cuya destinación y uso sea vivienda de habitación (por las primeras 20.000 UVT, es decir hasta $637.780.000) 1.00
Compras de bienes raíces cuya destinación y uso sea vivienda de habitación (exceso de las primeras 20.000 UVT, es decir superior a
2.50
$637.780.000)
Compras de bienes raíces cuya destinación y uso sea distinto a vivienda de habitación 2.50
Servicios generales (declarantes) 4.00
Servicios generales (no declarantes) 6.00
Por emolumentos eclesiásticos (declarantes) 4.00
Por emolumentos eclesiásticos (no declarantes) 3.50
Servicios de transporte de carga 1.00
Servicios de transporte nacional de pasajeros por vía terrestre (declarantes) 3.50
Servicios de transporte nacional de pasajeros por vía terrestre (no declarantes) 3.50
RETEFUENTE
Servicios de transporte nacional de pasajeros por vía aérea o marítima 1.00
Servicios prestados por empresas de servicios temporales (sobre AIU) 1.00
Servicios prestados por empresas de vigilancia y aseo (sobre AIU) 2.00
Servicios integrales de salud prestados por IPS 2.00
Servicios de hoteles y restaurantes (declarantes) 3.50
Servicios de hoteles y restaurantes (no declarantes) 3.50
Arrendamiento de bienes muebles 4.00
Arrendamiento de bienes inmuebles (declarantes) 3.50
Arrendamiento de bienes inmuebles (no declarantes) 3.50
Otros ingresos tributarios (declarantes) 2.50
Otros ingresos tributarios (no declarantes) 3.50
Honorarios y comisiones (personas jurídicas) 11.00
Honorarios y comisiones personas naturales que suscriban contrato o cuya sumatoria de los pagos o abonos en cuenta superen las 3.300
11.00
UVT ($105.135.000)
Honorarios y comisiones (no declarantes) 10.00
Servicios de licenciamiento o derecho de uso de software 3.50
Intereses o rendimientos financieros 7.00
Rendimientos financieros provenientes de títulos de renta fija 4.00
Loterías, rifas, apuestas y similares 20.00
Retención en colocación independiente de juegos de suerte y azar 3.00
Contratos de construcción y urbanización 2.00
7.6 FACTURA(S)A MODIFICAR EN NOTA

La siguiente estructura de campos conforman la estructura “felFacturaModificada” que hace parte del
objeto principal “felCabezaDocumento”, en estos, se almacenan las distintas facturas que están asociadas a
una nota y solo se debe usar esta estructura cuando es una nota crédito o débito. El objeto
“felFacturaModificada” se guarda en una lista para obtener tantas facturas como se requieran.
listaFacturasModificadas
OBLIGATORIO
PT
Página 15 de 31
Código: CE-MU-011
VALOR NECESARIO PARA PODER ENCONTRAR EL CUFE DE LA FACTURA A

tipoDocumentoFacturaModificada varchar(1) SI AFECTAR.
VALOR NECESARIO PARA PODER ENCONTRAR EL CUFE DE LA FACTURA A
prefijoFacturaModificada varchar(5) SI AFECTAR. EJ: FACT
CONSECUTIVO DE LA FACTURA A MODIFICAR. ESTE CAMPO SOLO APLICA PARA LAS
consecutivoFacturaModificada Long SI
NOTAS DÉBITO Y/O CRÉDITO. EJ: 564231
7.7 MANDANTES
La siguiente estructura de campos conforma la estructura “felMandante” que hace parte del objeto
principal “felDetalleDocumento”, en estos, se almacenan los distintos términos que hacen referencia al
contrato de mandante de la factura. El objeto “felMandante” se guarda en una lista para obtener tantos
términos como se requieran. Esta opción solo deberá ser usada si existe un contrato de mandato.
listaMandantes
OBLIGATORIO
DIAN PT
identificacionMandante varchar(3) SI SI IDENTIFICACIÓN MANDANTE
SI LA FACTURA MANEJA MANDANTE, SE DEBE AGREGAR ESTE VALOR DE MANERA
digitoVerificacion varchar(2) SI SI
OBLIGATORIA. OBLIGATORIO SOLO SI TIPO IDENTIFICACIÓN ES NIT
tipoIdentificacionMandante smallint(6) SI SI VER EN LA SECCION DE TABLAS -> TIPO DE DOCUMENTO DE IDENTIFICACIÓN
tipoPersona varchar(1) NO NO TIPO DE PERSONA, 1. PERSONA JURÍDICA, 2. PERSONA NATURAL
CODIGO DE LA OBLIGACIÓN CUANDO EL TIPO DE IDENTIFICACIÓN ES NIT. VER
tipoObligacion varchar(30) NO NO
TABLA RESPONSABILIDADES FISCALES. SI LA EMPRESA TIENE MAS DE UN TIPO DE
OBLIGACIÓN, DEBERÁN IR SEPARADOS POR PUNTO Y COMA “;”
tipoRepresentacion varchar(20) NO NO PENDIENTE DEFINICIÓN DIAN
tipoEstablecimiento varchar(20) NO NO TIPO DE ESTABLECIMIENTO
pais varchar(2) NO NO PAIS CLIENTE EN ESTÁNDAR ISO 3116-1, ES DECIR COLOMBIA "CO"
DEPARTAMENTO DE RESIDENCIA DEL CLIENTE. EL CAMPO DEPARTAMENTO DEBE
departamento varchar(100) NO NO RECIBIR EL CODIGO DEL MUNICIPIO SEGÚN TABLA DEL DANE. VER TABLA ANEXA
SUB-REGIONES DANE.
CIUDAD DE RESIDENCIA DEL CLIENTE. EL CAMPO CIUDAD DEBE RECIBIR EL CODIGO
Ciudad varchar(100) NO NO
DEL MUNICIPIO SEGÚN TABLA DEL DANE. VER TABLA ANEXA SUB-REGIONES DANE.
direccion varchar(100) NO NO DIRECCIÓN MANDANTE
nombreMandante varchar(200) NO NO NOMBRE DEL MANDANTE
zonaPostal varchar(30) NO NO CODIGO POSTAL
numeroContrato varchar(100) NO NO NUMERO DE CONTRATO DE MANDATO.
descripcionContrato varchar(240) NO NO DESCRIPCIÓN DEL CONTRATO DE MANDATO.
tipoContrato varchar(100) NO NO TIPO DE CONTRATO DE MANDATO.
porcentajeParticipacion Decimal NO NO APLICA PARA CONSORCIOS Y UNIONES TEMPORALES
(28,8)
7.8 LISTA DE CAMPOS ADICIONALES

La siguiente estructura de campos hacen parte de la estructura “felCampoAdicional” que hace parte del
objeto principal “felCabezaDocumento”, en estos, se almacenan campos adicionales que sean requeridos
en la representación gráfica de la factura.
listaCamposAdicionales
OBLIGATORIO
NOMBRE TIPO DE DATOS DIAN
DESCRIPCIÓN
PT
DESCRIPCION DEL VALOR ALMACENADO. PARA EL MANEJO DE LAS NOTAS DE LA DIAN, COLOCAR
nombreCampo varchar(50) NO NO
EL CONCEPTO DESCRIPCION.
valorCampo varchar(800) NO NO VALOR DEL CAMPO ADICIONAL INDICADO SI ES TEXTO.
GRUPO DE DATOS ADICIONALES QUE SIRVE PARA SABER UNA DETERMINADA POSICIÓN EN LA QUE SE
seccion Int(11) NO NO
QUIERA
REPRESENTAR LA INFORMACIÓN EN EL PDF
orden Int(11) NO NO ORDEN EN EL QUE SE PRESENTARÁ LA INFORMACIÓN, DA UNA JERARQUIA AL MOMENTO DE PINTAR EL
DATO.
fecha Date NO NO FECHA DE REFERENCIA ASOCIADA AL CAMPO NECESARIO PARA MOSTRAR EN LA REPRESENTACIÓN
GRÁFICA
nombreSector Varchar(240) NO NO NOMBRE DEL SECTOR DE LA EMPRESA
valor Decimal (28,8) NO NO VALOR DEL CAMPO ADICIONAL INDICADO SI ES VALOR NUMÉRICO
Página 16 de 31
Código: CE-MU-011
7.9 LISTA ORDEN DE COMPRA

Esta estructura permite asociar varias órdenes de compra a una misma factura, este cambio está
disponible para la versión de validación previa implementada por la Dian.
listaOrdenesCompras
OBLIGATORIO
NOMBRE TIPO DE DATOS DIAN DESCRIPCIÓN
PT
ordencompra varchar(40) NO NO ORDEN DE COMPRA ASOCIADA A LA FACTURA
fechaemisionordencompra Date NO NO FECHA DE CREACIÓN DE LA ORDEN DE COMPRA
numeroaceptacioninterno varchar(40) NO NO NUMERO DE ACEPTACIÓN, CODIGO INTERNO DEL COMPRADOR.
7.10 LISTA DE CARGOS
Esta estructura permite asociar varios cargos tanto en el detalle como el global de una misma factura, este
cambio está disponible para la versión de validación previa implementada por la Dian.
listaCargos
OBLIGATORIO
DIAN PT
codigoCargo Varchar(2) NO NO CÓDIGO INTERNO QUE MANEJA LA EMPRESA PARA ESE CARGO. AÚN LA
DIAN NO DEFINE CODIGOS ESTÁNDAR.
valorCargo decimal (28,8) SI SI INDICA SI ES UN CARGO O UN DESCUENTO APLICADO A LA FACTURA
porcentajeCargo decimal (28,8) NO NO PORCENTAJE DEL CARGO
descripcion Varchar(240) NO NO DESCRIPCIÓN DEL CARGO APLICADO A LA FACTURA
7.11 LISTA DE DESCUENTOS

Esta estructura permite asociar varios descuentos tanto en el detalle como el global de una misma factura,
este cambio está disponible para la versión de validación previa implementada por la Dian. Estos
códigos solamente se utilizan para categorizar el tipo de descuento otorgado. Es importante que el
facturador lo mencione en caso de que haga descuentos por impuestos asumidos.
listaDescuentos
DIAN PT
CÓDIGO QUE IDENTIFICA EL TIPO DE DESCUENTO. LOS VALORES DEFINIDOS POR LA
DIAN SON:
00 DESCUENTO POR IMPUESTO ASUMIDO;
01 PAGUE UNO LLEVE OTRO;
02 DESCUENTOS CONTRACTUALES;
03 DESCUENTO POR PRONTO PAGO;
04 ENVÍO GRATIS;
codigoDescuento Varchar(2) NO NO
05 DESCUENTOS ESPECÍFICOS POR INVENTARIOS;
06 DESCUENTO POR MONTO DE COMPRAS;
07 DESCUENTO DE TEMPORADA;
08 DESCUENTO POR ACTUALIZACIÓN DE PRODUCTOS / SERVICIOS;
09 DESCUENTO GENERAL;
10 DESCUENTO POR VOLUMEN;
11 OTRO DESCUENTO
descuento decimal (28,8) SI SI VALOR DEL DESCUENTO
porcentajeDescuento decimal (28,8) SI SI PORCENTAJE DEL DESCUENTO
descripcion varchar(240) NO NO DESCRIPCIÓN DEL DESCUENTO
7.12 LISTADO CÓDIGOS DE BARRA

Esta estructura permite asociar varios códigos de barras tanto en el detalle como el global de una misma
factura, este cambio está disponible para la versión de validación previa implementada por la Dian.
Página 17 de 31
Código: CE-MU-011
listaCodigoBarras
OBLIGATORIO
NOMBRE TIPO DE DATOS DIAN
DESCRIPCIÓN
PT
CADENA PARA LA GENERACIÓN DEL CÓDIGO DE BARRAS, VER LAS ESPECIFICACIONES PARA EL ENVÍO
cadenaACodificar varchar(255) NO SI
DEL CÓDIGO DE BARRAS DE RECAUDO. SI LA LISTA DE CODIGO DE BARRAS TIENE MAS DE UN ITEM
ESTE VALOR SE HACE OBLIGATORIO PARA EL PT.
MODELO DE CÓDIGO QUE SE IMPLEMENTARÁ AL INTERIOR DE DISPAPELES. DISPAPELES INDICARÁ ESTE
tipoModelo varchar(255) NO SI
VALOR PARA QUE SEA ENVIADO POR EL FACTURADOR DE ACUERDO CON SU NECESIDAD. SI LA LISTA
DE CODIGO DE BARRAS TIENE MAS DE UN ITEM ESTE VALOR SE HACE OBLIGATORIO PARA EL PT.
orden Int(11) NO NO ORDEN EN EL QUE SE MOSTRARÁ CADA CÓDIGO EN LA REPRESENTACIÓN GRÁFICA.
tipoCodificacion varchar(255) NO NO INDICA SI ES EAN, UPC U OTRA VERSIÓN. POR DEFECTO SE USARÁ EL EAN128
descripcion varchar(255) NO NO NOTA ASOCIADA AL CÓDIGO DE BARRAS
fecha Date NO NO FECHA DE REFERENCIA ASOCIADA AL CAMPO NECESARIO PARA MOSTRAR EN LA REPRESENTACIÓN
GRÁFICA
Especificaciones código de barras de recaudo
El código de barras de recaudo se compone de 4 partes principales:
7.12.1 415
---> Número Mundial de Localización EAN/UCC de la Parte que Factura
---> Para GS1 Colombia el indicador corresponde al 770
---> Longitud fija: 13 dígitos
---> Obligatorio
7.12.2 8020
---> Caracteres numéricos asignados por la entidad que factura, para identificar su usuario.
---> Longitud mínima: 2 dígitos
---> Longitud máxima: 24 dígitos
---> Obligatorio
7.12.3 390n
---> Valor a pagar expresado en moneda nacional para recaudos
---> n representa el número de cifras decimales, si no se utilizan centavos, toma el valor de
0 ---> Longitud mínima: 2 dígitos
---> Longitud máxima: 14 dígitos
---> Campo obligatorio para entidades de servicios públicos y opcionales para otras
entidades.
7.12.4 96
---> Fecha máxima de pago
---> Longitud fija: 8 dígitos
---> Opcional
De acuerdo con estos códigos, la cadena para la generación del código de barras se enviaría de la
siguiente forma:
(415)770000000(8020)000000000000(3900)000000(96)00000000
Nota: La cadena debe enviarse con los paréntesis como se observa.
Para la generación del código de barras de recaudo es importante tener en cuenta lo siguiente:
1. Los dígitos que llegan para los códigos (8020) y (3900) deben ser pares.
EJ: 1.000.000 en la cadena debe aparecer de la siguiente forma:
Página 18 de 31
Código: CE-MU-011
(415)770000000(8020)000000000000(3900)01000000(96)00000000
2. Los dígitos correspondientes a la fecha deben llevar 8 dígitos en el siguiente orden:
AAAAMMDD EJ: 20181002 -> octubre 02 de 2018
3. Lista de campos de cabecera
Se tiene la lista codigodebarras para el envío de la cadena.
7.12.5 Campo de envío de la cadena: Codigodebarras (String 255)
Para realizar el envío de la cadena inicial del código de barras de acuerdo con el formato
anteriormente indicado, cada una de las posiciones de la lista representa un código de barras. Existen
tipos de facturas que requieren n códigos de barras de recaudo, por ello es importante que solamente
se llene la cantidad de posiciones que se necesite.
7.13 LISTA DATOS DE ENTREGA
Esta estructura permite asociar los datos de entrega del producto comercializado a la factura, este cambio
está disponible para la versión de validación previa implementada por la Dian.
listaDatosEntrega
PT
cantidad Long SI CANTIDAD POR TRANSPORTAR
cantidadMaxima Long SI CANTIDAD MAXIMA POR TRANSPORTAR
cantidadMínima Long SI CANTIDAD MÍNIMA POR TRANSPORTAR
identificadorTransporte String SI PLACA DEL VEHÍCULO
paisEntrega String SI PAIS CLIENTE EN ESTÁNDAR ISO 3116-1, ES DECIR COLOMBIA "CO"
ciudadEntrega String NO CIUDA DE ENTREGA
direccionEntrega String NO DIRECCION DE ENTREGA
lugarEntrega String NO LUGAR DE ENTREGA
telefonoEntrega String NO TELEFONO DE ENTREGA
periodoEntregaEstimado Date NO PERIODO DE ENTREGA ESTIMADO
periodoEntregaPrometido Date NO PERIODO DE ENTREGA PROMETIDO
periodoEntregaSolicitado Date NO PERIODO DE ENTREGA SOLICITADO
tiempoRealEntrega Time NO TIEMPO REAL DE ENTREGA
ultimaFechaEntrega Date NO ULTIMA FECHA DE ENTREGA
nombreTransportista String NO NOMBRE TRANSPORTISTA
tipoidentificacionTransportista String SI VER EN LA SECCION DE TABLAS -> TIPO DE DOCUMENTO DE
IDENTIFICACIÓN
identificacionTransportista String SI NÚMERO DEL DOCUMENTO DE IDENTIFICACIÓN SIN DIGITO DE
VERIFICACION EN CASO DEL NIT, SIN CARACTERES ESPECIALES
dVIdentificaciontransportista String SI DIGITO DE VERIFICACIÓN DE LA IDENTIFICACIÓN, SE REQUIERE
OBLIGATORIO CUANDO EL TIPO DE IDENTIFICACION DEL
TRANSPORTISTA ES 31 (NIT)
empresaTransportista String NO EMPRESA TRANSPORTISTA
tipoIdentificacionEmpresaTransportista String NO TIPO DE IDENTIFICACION DE LA EMPRESA TRANSPORTISTA
nitEmpresaTransportista String NO NIT DE LA EMPRESA TRANSPORTISTA
descripcion String NO DESCRIPCIONES ASOCIADAS A LA ENTREGA COMO REFERENCIA.
7.14 LISTADO MEDIOS DE PAGO

Esta estructura permite asociar las distintas formas de pago de una factura, este cambio está disponible
para la versión de validación previa implementada por la Dian.
listaMediosPagos
TIPO DE OBLIGATORIO
NOMBRE DESCRIPCIÓN
DATOS DIAN PT
medioPago varchar(2) SI SI LISTADO DE LOS MEDIOS DE PAGO. VER POSIBLES VALORES EN LA TABLA 15.7 MEDIOS DE PAGO
Página 19 de 31
Código: CE-MU-011
7.15 LISTA DE DOCUMENTOS ADJUNTOS

Esta estructura permite asociar varios documentos como arreglo de bytes a una factura para que de forma
automática se carguen al sistema.
listaDocumentosAdjuntos
DIAN PT
nombreConExtension varchar(240) NO NO NOMBRE DEL ARCHIVO A ADJUNTAR
contenidoDelDoc byte [] NO NO CONTENIDO DEL ARCHIVO EN BASE 64. ESTE CAMPO CONTIENE UN ARREGLO
DE BYTE’S QUE REPRESENTA EL DOCUMENTO ADJUNTO QUE
POSTERIORMENTE SE PASA POR UN BASE 64.
7.16 LISTA DE ANTICIPOS
Esta estructura es para almacenar y reportar todos los anticipos asociados a la factura. La sumatoria de
estos valores no deberá superar el valor total de la factura.

DIAN PT
anticipo decimal (28,8) SI SI VALOR DE UN ANTICIPO DE LA FACTURA.
fechaAnticipo timestamp NO NO FECHA DE UNO DE LOS ANTICIPOS
descripcion String NO NO DESCRIPCIONES ASOCIADAS A LA ENTREGA COMO REFERENCIA.
tipoAnticipo Long NO NO PROPORCIONA LA INFORMACIÓN DE LOS TIPOS DE ANTICIPOS PARA EL
SECTOR SALUD 1. COPAGO, 2. CUOTA MODERADORA, 3. CUOTA DE
RECUPERACIÓN
8 CÓDIGOS DE RESPUESTA DE ESTADOS

Al consultar las transacciones, Dispapeles devuelve un consolidado con el último estado por el que pasó la
factura en la plataforma tecnológica de Dispapeles, de la DIAN y del Adquirente. Es decir, con una sola
consulta se devuelven tres códigos de estados con sus respectivas descripciones.
A continuación, se describen los estados por los que pasa una factura en la plataforma tecnológica de la
empresa Dispapeles, en la DIAN y con el Adquirente:
8.1 ESTADOS DIAN

La DIAN entrega los siguientes estados de respuesta del documento enviado:
Nombre estado Descripción estado
Uso autorizado por la DIAN La DIAN ha autorizado el documento enviado.
La DIAN no ha autorizado el documento debido a que encontró dentro de sus validaciones información no
Uso no autorizado por la DIAN correspondiente a lo definido por esta entidad. Cuando la DIAN no autoriza el documento indica el listado de
notificaciones y rechazos. Estos últimos son los que deben ajustarse antes de volver a enviar el documento.
8.2 ESTADOS ENVÍO EMAIL

A continuación, los distintos estados que describen lo sucedido en el proceso de envío de email.
Código Nombre estado Descripción estado

83 Reject Rechazado
86 Failure Fallido
90 Bounce undetermined Rebote indeterminado
91 Bounce permanent general No existe
92 Bounce permanent NoEmail No existe email
93 Bounce permanent Supressed Vetado en SES Amazon
Página 20 de 31
Código: CE-MU-011
94 Bounce transient general Puede intentarse nuevamente

95 Bounce transient MailboxFull Bandeja llena
96 Bounce transient MessageTooLarge Mensaje muy grande
97 Bounce transient ContentRejected Contenido rechazado
98 Bounce transient AttachementRejected Adjuntos rechazados
8.3 ESTADOS ADQUIRENTES

A continuación, los distintos estados que describen si una factura fue aceptada o rechazada y/o
acusada por el adquirente.
Código Nombre estado Descripción estado

0 Sin Acusar La factura aún no es acusada por el adquirente.
1 Aceptar La factura se acepta explícitamente por el adquirente
2 Acusar El adquirente acusa el recibo de la factura
3 Rechazar La factura es rechazada por el adquirente
4 Sin Verificación Email El email proporcionado para el adquirente no es válido.
5 Aceptación Tácita Se acepta la factura de forma automática luego de 72 horas
9 MÉTODOS DE ENVÍO DE DATOS AL WEB SERVICE DE DISPAPELES

Dispapeles cuenta con dos opciones para que los facturadores envíen los datos de la factura al web service
de Dispapeles Fact-e y así dar inicio al proceso de factura electrónica. Estas dos opciones son:
9.1 ENVIAR DOCUMENTO

El método “enviarDocumento” sirve para transmitir los datos del documento de uno en uno, este
método recibe como parámetro de entrada un objeto de tipo Fel_CabezaDocumento que contiene
toda la información de la factura como la cabeza, detalle e impuestos de la factura entre otros. Con
esta información, el web service realiza el almacenamiento de la información y genera los documentos
xml y pdf para luego dar una respuesta al cliente del web service de tipo “Fel_RespuestaEnvio” para
que el facturador pueda registrar el cufe en su ERP. Esta respuesta se da de forma síncrona.
Si la respuesta entregada con el web service es fallida, es decir, que el documento no cumple con algunas
validaciones y por este motivo es rechazado, se recomienda disparar una alerta en el ERP para corregir el
problema y no volver a enviar esta factura hasta se resuelva esta situación. Con esto se busca evitar
congestionar el servicio del web service y disminuir los costos para quien emite el documento debido al
reprocesamiento de una misma factura o nota.
Si se hace el envío de un documento al web service y no se recibe una respuesta, se recomienda consultar
el documento antes de un nuevo envío, esto porque la entrega de la información al web service pudo ser
correcta, pero la respuesta se pudo perder por algún problema en el canal de comunicación, un timeout, u
otra causa similar.
Objeto de respuesta “Fel_RespuestaEnvio”:
CAMPO TIPO DE DATOS DESCRIPCION

tipoDocumento varchar(1) TIPO DE DOCUMENTO ELECTRÓNICO.
Prefijo varchar(5) PREFIJO DEL DOCUMENTO ELECTRÓNICO.
consecutivo int(11) CONSECUTIVO HABILITADO POR LA DIAN PARA FACTURAR ELECTRÓNICAMENTE.
CU varchar(40) CÓDIGO ÚNICO DE FACTURA ELECTRÓNICA. CON ESTE VALOR EL CLIENTE PODRÍA GENERAR LA
REPRESENTACIÓN GRÁFICA SI ASÍ LO QUISIERA.
CÓDIGO QR PARA QUE SEA IMPLEMENTADO POR EL CLIENTE EN EL PDF. ESTE VALOR ES LA CADENA
codigoQr varchar(2000)
CONCATENADA DA LOS DATOS COMO LO
Página 21 de 31
Código: CE-MU-011
PIDE LA DIAN.
fechaFactura TIMESTAMP FECHA DE CREACIÓN DE LA FACTURA EN EL ERP

fechaRespuesta TIMESTAMP FECHA DE LA RESPUESTA DEL WEB SERVICE
fechaExpedicion TIMESTAMP FECHA EN LA CUAL LA DIAN REALIZA LA VALIDACIÓN

APLICA SOLO CUANDO LA EMPRESA ENVÍA EL ID DEL ERP QUE IDENTIFICA LA FACTURA, Y DEVUELVE DICHO
IdErp Int
VALOR, DE LO CONTRARIO DEVUELVE
CERO.
firmaDelDocumento text FIRMA DEL DOCUMENTO EN CASO TAL EL CLIENTE LO REQUIERA PARA CONTROL INTERNO
selloDeValidacion text FIRMA DE VALIDACIÓN POR PARTE DE LA DIAN, SE DEVUELVE PARA CONTROL INTERNO DEL CLIENTE
estadoProceso int 0 = ERROR; 1 = EXITOSO; 2 = EXITOSO CON NOTIFICACIONES; 3 = DOCUMENTO INGRESADO
PREVIAMENTE; 4 = EL DOCUMENTO ESTÁ SIENDO PROCESADO; 24 = CONTINGENCIA DIAN
listaMensajesProceso List<Fel_MensajeProceso> LISTADO CON LOS MENSAJES DE ERROR ASOCIADOS AL DOCUMENTO
Imagen 7 Flujo para enviar documento
Como se puede observar en el flujo, una vez se envían los datos de la factura por el método uno a uno
“enviarDocumento”, Dispapeles responde de forma síncrona con código de error si la factura no pasa
las validaciones básicas, de lo contrario, devuelve el valor del cufe, con prefijo, consecutivo, tipo
Página 22 de 31
Código: CE-MU-011
de documento un mensaje de ok.
Luego de enviar las facturas y si estas son exitosas es necesario si y solo si se requiere que el ERP tenga
toda la trazabilidad de cada documento, consultar el estado de las facturas mediante el método
“consultarEstadofactura”. Esta operación no siempre es necesaria ya que a todos los facturadores
cuentan con usuarios para ingresar al portal de emisión y recepción que permitirá ver todos los
movimientos de facturas con los distintos estados por los que han pasado.
Si se necesita imprimir la representación gráfica generada por el proveedor tecnológico, se debe consultar
el método “consultarPdfFactura”. Si, por el contrario, el facturador por temas de rapidez quiere
agregar el CUFE y el QR a su formato actual entonces no se deberá consultar este método.
Se recomienda realizar la consulta de los estados cada hora para tener posibilidades de una respuesta por
parte de la DIAN y del Adquirente.
10 MÉTODOS DE CONSULTA Y DEFINICIÓN DE ESTRUCTURAS DE CONSULTA Y RESPUESTA
10.1 CONSULTAR ESTADO FACTURA

Recibe un objeto de tipo “Fel_ConsultaFactura”, son obligatorios los campos: “tipoDocumento”, prefijo
y consecutivo, estos valores se cargan en la estructura del objeto “Fel_ConsultaFactura”. Este método
sirve para saber qué pasó con una factura en cada uno de sus procesos. Se debe consultar este método
antes de enviar un documento que previamente fue enviado y no se obtuvo respuesta. Ver tabla
“Fel_ConsultaFactura”.
felConsultaFactura
TIPO DE
CAMPO DESCRIPCION
DATOS
Prefijo varchar(5) PREFIJO DEL DOCUMENTO
consecutivo long CONSECUTIVO DEL DOCUMENTO ELECTRÓNICO
idEmpresa Int
usuario varchar(40) CAMPOS PARA VALIDAR LA SEGURIDAD. ESTOS VALORES SON ENTREGADOS POR DISPAPELES A CADA EMPRESA FACTURADORA.
contrasenia varchar(40)
Token varchar(40)
versión varchar(40) VERSIÓN DEL MANUAL CON LA QUE EL CLIENTE TRABAJÓ LA INTEGRACIÓN
CAMPO TIPO DE DATOS DESCRIPCION

Prefijo varchar(5) PREFIJO DEL DOCUMENTO
consecutivo long CONSECUTIVO DEL DOCUMENTO ELECTRÓNICO
fechaFactura Date FECHA EN QUE SE CREÓ EL DOCUMENTO EN EL ERP DEL FACTURADOR
Cufe Varchar(240) CUFE DE LA FACTURA
IdErp Varchar(240) CÓDIGO INTERNO QUE IDENTIFICA LA FACTURA EN EL ERP
IdLote Varchar(240) IDENTIFICADOR DEL LOTE AL QUE PERTENECE LA FACTURA, APLICA SOLO SI LA FACTURACIÓN ES POR
LOTE.
codigoUltimoEstadoDispapeles int CÓDIGO DE DISPAPELES PARA IDENTIFICAR CADA FASE DE LA CREACIÓN DEL DOCUMENTO.
SE DEVUELVE EL ULTIMO ESTADO DEL DOCUMENTO EN LA PLATAFORMA DE DISPAPELES, ESTO ES, SI PASA O NO
descripcionUltimoEstadoDispapeles Varchar(240) LAS VALIDACIONES INTERNAS, SI SE GENERA Y FIRMA EL XML, SI SE GENERA LA REPRESENTACIÓN Y SI SE
PRESENTA UN ERROR EN CUALQUIERA DE ESAS ETAPAS.
FechaRespuestaUltimoEstadoDispapele Date FECHA EN LA QUE SE PROCESÓ LA FACTURA EN DISPAPELES
s
codigoUltimoEstadoDian int SE DEVUELVE EL CÓDIGO QUE MANEJA LA DIAN PARA DICHOS ESTADOS
CAMPO QUE DESCRIBE EL ÚLTIMO ESTADO DEL DOCUMENTO ANTE LA DIAN, ES DECIR, SI SE RECIBIÓ EL ENVÍO Y
descripcionUltimoEstadoDian Varchar(240)
SI PASÓ O NO LAS VALIDACIONES.
fechaRespuestaUltimoEstadoDian Date FECHA EN LA QUE CONTESTÓ LA DIAN
codigoUltimoEstadoEmail int SE DEVUELVE EL CÓDIGO DE LOS ESTADOS DEL ENVÍO
Página 23 de 31
Código: CE-MU-011
descripcionUltimoEstadoEmail Varchar(240) CAMPO QUE DESCRIBE EL ÚLTIMO ESTADO DEL DOCUMENTO EN EL PROCESO DE ENVÍO POR EMAIL
fechaRespuestaUltimoEstadoEmail Date FECHA EN LA QUE SE ENVÍA EL EMAIL
int CÓDIGO DEL ESTADO DEL DOCUMENTO CON RELACIÓN AL ADQUIRENTE. ESTOS CÓDIGOS SON INTERNOS DE
codigoUltimoEstadoAdquirente
DISPAPELES.
DESCRIPCIÓN DEL ESTADO DEL DOCUMENTO POR PARTE DEL ADQUIRENTE, ES DECIR, SI SE ACUSÓ EL RECIBO, SE
descripcionUltimoEstadoAdquirente Varchar(240) ACEPTÓ O RECHAZÓ.
FechaRespuestaUltimoEstadoAdquirent Date FECHA EN LA QUE CONTESTÓ EL CLIENTE
e
fechaRespuesta Timestamp FECHA Y HORA DE LA RESPUESTA LA CONSULTA
firmaDelDocumento text FIRMA DEL DOCUMENTO EN CASO TAL EL CLIENTE LO REQUIERA PARA CONTROL INTERNO
selloDeValidacion text FIRMA DE VALIDACIÓN POR PARTE DE LA DIAN, SE DEVUELVE PARA CONTROL INTERNO DEL CLIENTE
estadoProceso int 0 = ERROR; 1 = EXITOSO; 2 = EXITOSO CON NOTIFICACIONES; 3 = DOCUMENTO INGRESADO
PREVIAMENTE; 4 = EL DOCUMENTO ESTÁ SIENDO PROCESADO; 24 = CONTINGENCIA DIAN
10.2 CONSULTAR ARCHIVOS

Recibe un objeto de tipo Fel_ConsultaFacturaArchivo, son obligatorios los campos: tipoDocumento,
prefijo, consecutivo y tipo de archivo, estos valores se cargan en la estructura del objeto
Fel_ConsultaFacturaArchivo. Ver tabla Fel_ConsultaFacturaArchivo. Este método se encarga de descargar el
pdf, el xml o ambos de acuerdo con el parámetro enviado en la variable tipoArchivo.
OBLIGATORIO
DIAN PT
idEmpresa Int NO SI
usuario varchar(40) NO SI CAMPOS PARA VALIDAR LA SEGURIDAD. ESTOS VALORES SON ENTREGADOS POR DISPAPELES
contrasenia varchar(40) NO SI A CADA EMPRESA FACTURADORA
Token varchar(40) NO SI
version varchar(40) NO SI VERSIÓN DEL MANUAL CON LA QUE EL CLIENTE TRABAJÓ LA INTEGRACIÓN
TIPO DE DOCUMENTO --1. FACTURA DE VENTA, 2. NOTA CRÉDITO, 3. NOTA DÉBITO 4.
tipodocumento varchar(1) SI SI
FACTURA DE EXPORTACIÓN, 5. FACTURA DE CONTINGENCIA, 6. FACTURA DE IMPORTACIÓN
prefijo varchar(5) NO NO PREFIJO DE DOCUMENTO, SOLO SI LA EMPRESA LO MANEJA
consecutivo Long SI SI CONSECUTIVO ENTREGADO EN LA RESOLUCIÓN DE LA DIAN O NÚMERO DE FACTURA
tipoArchivo int NO SI INDICA QUE TIPO DE ARCHIVO SE DEBE DESCARGAR. 0 = PDF Y XML; 1 = PDF; 2 = XML
Devuelve un objeto “Fel_RepuestaDescargaDocumentos” que contiene información del archivo y el flujo de

datos de este. Objeto devuelto al consultar un documento electrónico de una factura, PDF o XML.

consecutivo varchar NÚMERO DE CONSECUTIVO DE LA FACTURA
nameFile varchar NOMBRE DEL ARCHIVO, TAL COMO SE ENCUENTRA EN EL SERVIDOR
Prefijo varchar PREFIJO DE FACTURACIÓN
mimeType varchar MIMETYPE, FORMATO ESTÁNDAR DE HTML PARA IDENTIFICAR EL TIPO DE ARCHIVO.
streamFile byte[] FLUJO DE BYTES QUE CONTIENE EL ARCHIVO COMO UN ARREGLO DE BYTES
formato varchar EXTENSIÓN PARA EL ARCHIVO (.XML O .PDF)
Error int 1 = ERROR; 0 = EXITOSO; 2 = EXITOSO CON NOTIFICACIONES
11. MENSAJE DE RESPUESTA

Especifica el código del mensaje y una descripción relacionada al código de respuesta:
fel_mensajeProceso

codigoMensaje Varchar(50) IDENTIFICADOR DEL MENSAJE
descripcionMensaje Varchar(240) CAMPO QUE DESCRIBE LOS MENSAJES DE ERROR ASOCIADOS AL DOCUMENTO
rechazoNotificacion Varchar(2) CAMPO QUE DESCRIBE SI LA VALIDACIÓN ES DE TIPO RECHAZO (R) O NOTIFICACIÓN (N)
Página 24 de 31
Código: CE-MU-011
12 MENSAJES DE ERROR
Mensajes globales retornados de manera Síncrona:
CODIGO MENSAJE
10002 Error!, el campo Tipodocumento no puede ser nulo o vacío.
10002 Error!, el campo fechaFacturacion no puede ser nulo o vacío.
10002 Error!, el campo AplicaFel no puede ser nulo o vacío.
10002 Error!, el Objeto Pago no puede ser nulo o vacío.
10002 Error!, el campo Moneda no puede ser nulo o vacío.
10002 Error!, el campo TotalImporteBruto no puede ser nulo o vacío.
10002 Error!, el campo TotalImporteBruto no puede ser nulo o vacío.
10002 Error!, el campo Cantidad no puede ser nulo o vacío.
10002 Error!, el campo TipoPersona no puede ser nulo o vacío.
10002 Error!, el campo ValorCargo no puede ser nulo o vacío.
10002 Error!, el campo Descripcion no puede ser nulo o vacío.
10002 Error!, el campo Descripcion no puede ser nulo o vacío.
10003 Error!, el valor del campo Tipodocumento tiene una longitud diferente a la esperada. Longitud esperada: 1, longitud recibida: ####
10003 Error!, el valor del campo AplicaFel tiene una longitud diferente a la esperada. Longitud esperada: 2, longitud recibida: ####
10003 Error!, el valor del campo email tiene una longitud diferente a la esperada. Longitud esperada: 200, longitud recibida: ####
10003 Error!, el valor del campo Moneda tiene una longitud diferente a la esperada. Longitud esperada: 3, longitud recibida: ####
10003 Error!, el valor del campo TipoPersona tiene una longitud diferente a la esperada. Longitud esperada: 1, longitud recibida: ####
10003 Error!, el valor del campo Direccion tiene una longitud diferente a la esperada. Longitud esperada: 1, longitud recibida: ####
10003 Error!, el valor del campo Direccion tiene una longitud diferente a la esperada. Longitud esperada: 1, longitud recibida: ####
10004 Error!, los valores para el campo Tipodocumento no son los esperados. Los códigos esperados son:### Valor de entrada: ###
10004 Error!, los valores para el campo TipoNota no son los esperados. Los códigos esperados son:### Valor de entrada: ###
10004 Error!, los valores para el campo AplicaFel no son los esperados. Los códigos esperados son:### Valor de entrada: ###
10004 Error!, los valores para el campo TipoPersona no son los esperados. Los códigos esperados son:### Valor de entrada: ###
10005 Error!, el campo Consecutivo debe tener un valor mayor a cero.
10005 Error!, el campo Valorunitario debe tener un valor mayor a cero.
10005 Error!, el campo Preciosinimpuestos debe tener un valor mayor a cero.
10005 Error!, el campo Preciototal debe tener un valor mayor a cero.
10005 Error!, el campo Impuestos.Baseimponible debe tener un valor mayor a cero.
10005 Error!, el campo Impuestos.Baseimponible debe tener un valor mayor a cero.
10006 Error!, el formato del campo email no es válido.
10007 Error!, Si el porcentaje de impuesto es cero, el campo Impuestos.Valorretenido debe tener un valor igual a cero (0). Valor actual: ###.
10020 Error!, No debe existir más de un registro de Lista Descuento en el encabezado.
10022 Error! La factura no está aprobada por la DIAN.
Para verificar los mensajes que devuelve la DIAN por favor dirigirse al anexo: ANEXO - CÓDIGOS
DE RESPUESTAS DE LA DIAN.
13. MATRIZ DE CAMBIOS A CONSIDERAR

Al momento de implementar factura electrónica, el facturador debe contemplar un mínimo de cambios
técnicos y de procedimientos. A continuación, describimos los más básicos:
ID NOMBRE DESCRIPCIÓN
Se debe considerar hacer cambios en la data maestra actual asociada al cliente para poder identificar si este cliente quiere recibir la factura de
forma electrónica o si por el contrario se le seguirá entregando la factura en físico. Para esto se deben asociar como mínimo los siguientes
campos:
1 DATA MAESTRA • aplicaFel: Si, No. Si aplicaFel es Sí se deberán solicitar los siguientes campos:
• email. Se deberá garantizar la validez del correo electrónico del cliente.
• proveedorTecnologico. Si el cliente tiene un proveedor tecnológico para administrar la recepción de la factura se deberá solicitar
la identificación de este.
Si el facturador pretende tener un amplio control sobre cada transacción de documento electrónico deberá agregar a su ERP data adicional. Los
datos necesarios son los siguientes:
• idFactura: Es el identificador de la factura
• estado: Código del estado en el que está la factura en un determinado instante de tiempo.
2 DATA PARA MONITOREO • descripcionEstado: Es la descripción del estado
• fecha: fecha de reporte del estado
• fechaRespuesta: fecha en que se entrega la respuesta por parte del proveedor tecnológico
Se debe tener en cuenta que esta es una relación de uno a muchos, una factura tendrá varios estados, por tanto, de esta forma debe
diseñar su estructura de almacenamiento.
Cuando el cliente solicite que su representación gráfica se le entregue físicamente como hasta ahora, usted como facturador deberá decidir la
forma como imprimirá este documento.
1. Desde el ERP como actualmente lo hace. Con esta opción usted deberá descargar la representación gráfica por medio de una
consulta al web service del proveedor tecnológico para luego imprimirla como tradicionalmente lo hace.
3 MECANISMO DE IMPRESIÓN
2. Desde el portal web Fact-e: Usted deberá ingresar al portal web de Fact-e y descargar el documento electrónico generado para
luego imprimirlo.
3. Impresión automática: Servicio adicional que presta Dispapeles que permite de manera automática enviar el documento
generado a las impresoras configuradas desde la web.
Se deberán definir controles monitorear los motivos de rechazo de facturas y tomar acciones. Esto tiende más a procesos de seguimiento y
4 Acuse, aceptación o
control.
rechazo
Página 25 de 31
Código: CE-MU-011
Al iniciar en el proyecto de factura electrónica debe tener en cuenta que esta es una solución 100% web, por tal el rendimiento de su solución
5 Ancho de banda dependerá del canal de internet que disponga para este fin. Se recomienda un mínimo de 5mb.
Implementar procesos de monitoreo y gestión de facturas emitidas que no pasan las validaciones de la plataforma tecnológica de Dispapeles o
6 Envíos fallidos
de la DIAN
Integridad de los datos de Garantizar que al momento de enviar los datos de la factura a la plataforma tecnológica del proveedor tecnológico DISPAPELES esté completa.
7
las Revisar que con la transmisión viajen todos los conceptos asociados a la factura para que estos no sean rechazados posteriormente.
facturas y/o notas
IP publica desde el cual se consumirá el web service por parte del cliente para registrarla en la plataforma para acceso. Esto es necesario para el
8 IP PUBLICA
envío de datos entre plataformas desde el web service.
9 Email’s Adquirir y configurar correos electrónicos para el envío y recepción de los correos electrónicos.
14. CONEXIÓN SOAP AMBIENTE PRUEBAS
URL: Se entrega una vez se crea el cliente

Username: Se entrega una vez se crea el cliente
Password: Se entrega una vez se crea el cliente
Token: Se entrega una vez se crea el cliente
Id empresa: Se entrega una vez se crea el cliente
15. SEGURIDAD DE PRUEBAS EN AMBIENTE DEMO

Para dar cumplimiento a la norma ISO27001 respecto de protección de datos productivos en ambientes de
demo, se solicita que el cliente de DISPAPELES proporcione datos del cliente modificado para evitar
revelar información sensible cuando se encuentren realizando pruebas de integración. Adicional a lo
anterior, DISPAPELES borrará toda la información usada en ambiente test necesaria para garantizar un
paso a producción exitoso. Luego de las pruebas, el cliente deberá garantizar el envío de la información
correcta en ambiente productivo.
A continuación, se listan los campos que deben ser modificados para que no sea posible identificar las
ventas de los clientes:
TIPO DE
NOMBRE OBSERVACIONES
DATOS
Razonsocial varchar(120) Ocultar información real
Primernombre varchar(30) Ocultar información real
Segundonombre varchar(30) Ocultar información real
Primerapellido varchar(30) Ocultar información real
Segundoapellido varchar(30) Ocultar información real
nombrecompleto varchar(120) Ocultar información real
numeroidentificacion varchar(30) Ocultar información real
Email varchar(50) Colocar un email en el que nuestro cliente pueda validar el envío de los documentos electrónicos. Ocultar información real
Dirección varchar(100) Ocultar información real
Teléfono varchar(50) Ocultar información real
16. TABLAS
16.1 INCOTERM
CODIGO DESCRIPCION
CFR Costo y flete
CIF Costo, flete y seguro
CIP Transporte y seguro pagados hasta
CPT Transporte pagado hasta
DAP Entregado en un lugar
DAT Entregado en terminal
DDP Entregado con pago de derechos
EXW En fábrica
FAS Franco al costado del buque
FCA Franco transportista
FOB Franco a bordo
16.2 IMPUESTOS
Página 26 de 31
Código: CE-MU-011
IDENTIFICADOR NOMBRE DESCRIPCION

01 IVA Impuesto de Valor Agregado
02 IC Impuesto al Consumo Departamental Nominal
03 ICA Impuesto de Industria, Comercio y Aviso
04 INC Impuesto Nacional al Consumo
05 ReteIVA Retención sobre el IVA
06 ReteFuente Retención sobre Renta
07 ReteICA Retención sobre el ICA
20 FtoHorticultura Cuota de Fomento Hortifrutícula
21 Timbre Impuesto de Timbre
22 Bolsas Impuesto al Consumo de Bolsa Plástica
23 INCarbono Impuesto Nacional al Carbono
24 INCombustibles Impuesto Nacional a los combustibles
25 Sobretasa Combustibles Sobretasa a los combustibles
26 Sordicom Contribuciones minoristas (combustibles)
ZY No causa No responsable de tributo
ZZ Nombre de la figura Otros tributos, tasas, contribuciones y similares
tributaria
16.3 TIPO DE DOCUMENTO DE IDENTIFICACIÓN
CODIGO SIGNIFICADO
11 Registro Civil
12 Tarjeta de Identidad
13 Cédula de ciudadanía
21 Tarjeta de extranjería
22 Cédula de extranjería
31 NIT
41 Pasaporte
42 Documento de identificación extranjero
50 NIT de otro país
91 NUIP *Deberá utilizarse solamente para el adquiriente, debido a que este tipo de documento
no pertenece a los tipos de documento en la base de datos del RUT
16.4 TIPO PERSONA
CODIGO SIGNIFICADO
1 Persona Jurídica
2 Persona Natural
16.5 REGIMEN FISCAL
CODIGO SIGNIFICADO
48 Impuesto sobre las ventas – IVA
49 No responsable de IVA
16.6 RESPONSABILIDADES FISCALES

Para el campo cbc:TaxLevelCode (Obligaciones o responsabilidades del contribuyente; incluye el
régimen al que pertenece el emisor)
A partir del 1 de agosto de 2020 entran en vigor los siguientes códigos:
CODIGO SIGNIFICADO
O-13 Gran contribuyente
O-15 Autorretenedor
O-23 Agente de retención IVA
O-47 Régimen simple de tributación
R-99-PN No Aplica / Otro
Página 27 de 31
Código: CE-MU-011
16.7 MEDIOS DE PAGO
CODIGO MEDIO CODIGO MEDIO

1 Instrumento no definido 39 Crédito Negocio Intercambio Corporativo (CTX)
2 Crédito ACH 40 Débito Negocio Intercambio Corporativo (CTX)
3 Débito ACH 41 Concentración efectivo / Desembolso crédito plus (CCD+)
4 Reversión débito de demanda ACH 42 Consignación bancaria
5 Reversión crédito de demanda ACH 43 Concentración efectivo / Desembolso débito plus (CCD+)
6 Crédito de demanda ACH 44 Nota cambiaria
7 Débito de demanda ACH 45 Transferencia Crédito bancario
8 Mantener 46 Transferencia Débito Interbancario
9 Clearing Nacional o Regional 47 Transferencia Débito Bancaria
10 Efectivo 48 Tarjeta Crédito
11 Reversión crédito ahorro 49 Tarjeta Débito
12 Reversión débito ahorro 50 Postgiro
13 Crédito ahorro 51 Telex estándar bancario francés
14 Débito ahorro 52 Pago comercial urgente
15 Bookentry Crédito 53 Pago Tesorería urgente
16 Bookentry Débito 60 Nota promisoria
Concentración de la demanda en efectivo / Desembolso Crédito
17 61 Nota promisoria firmada por el acreedor
(CCD)
Concentración de la demanda en efectivo / Desembolso (CCD)
18 62 Nota promisoria firmada por el acreedor, avalada por el banco
Débito
19 Crédito Pago negocio corporativo (CTP) 63 Nota promisoria firmada por el acreedor, avalada por un tercero
20 Cheque 64 Nota promisoria firmada por el banco
21 Proyecto bancario 65 Nota promisoria firmada por un banco avalada por otro banco
22 Proyecto bancario certificado 66 Nota promisoria firmada
23 Cheque bancario 67 Nota promisoria firmada por un tercero avalada por un banco
24 Nota cambiaria esperando aceptación 70 Retiro de nota por el acreedor
25 Cheque certificado 71 Bonos
26 Cheque local 72 Vales
27 Débito pago Negocio Corporativo (CTP) 74 Retiro de nota por el acreedor sobre un banco
28 Crédito Negocio Intercambio Corporativo (CTX) 75 Retiro de nota por el acreedor, avalada por otro banco
29 Débito Negocio Intercambio Corporativo (CTX) 76 Retiro de nota por el acreedor, sobre un banco avalada por un tercero
30 Transferencia Crédito 77 Retiro de nota por el acreedor sobre un tercero
31 Transferencia Débito 78 Retiro de nota por el acreedor sobre un tercero avalada por un banco
32 Concentración efectivo / Desembolso crédito plus (CCD+) 91 Nota bancaria transferible
33 Concentración efectivo / Desembolso débito plus (CCD+) 92 Cheque local transferible
34 Pago y deposito pre acordado (PPD) 93 Giro referenciado
35 Concentración efectivo ahorros / Desembolso crédito (CCD) 94 Giro urgente
36 Concentración efectivo ahorros / Desembolso débito (CCD) 95 Giro formato abierto
37 Pago Negocio Corporativo Ahorros Crédito (CTP) 96 Método de pago solicitado no usado
38 Pago Negocio Corporativo Ahorros Débito (CTP) 97 Clearing entre Partners
ZZZ Acuerdo mutuo
16.8 TIPO OPERACIÓN

Factura electrónica
A partir del 1 de agosto de 2020 entrarán en vigor los siguientes códigos.
CODIGO SIGNIFICADO
10 Estándar *Valor por defecto
09 AIU
11 Mandatos
Nota crédito
CODIGO SIGNIFICADO
20 Nota Crédito que referencia una factura electrónica. *Valor por defecto, si no se informa se asume
que es este valor y aplicarán el conjunto de validaciones correspondiente.
22 Nota Crédito sin referencia a facturas. *Preferible para uso de notas rebate o de descuentos
condicionados.
23 Nota Crédito para facturación electrónica V1 (Decreto 2242).
Nota débito
CODIGO SIGNIFICADO
30 Nota Débito que referencia una factura electrónica. * Valor por defecto, si no se informa se asume
que es este valor y aplicarán el conjunto de validaciones correspondiente.
Página 28 de 31
Código: CE-MU-011
32 Nota Débito sin referencia a facturas.

33 Nota Débito para facturación electrónica V1 (Decreto 2242).
17. CARACTERES PROHIBIDOS
Los siguientes caracteres deben ser controlados para evitar errores de comunicación al momento de
consumir el web service Fact-E de Dispapeles. Estos errores no pueden ser controlados en el software de
Dispapeles ya que rompe la estructura del xml que se transmite, por lo que no es recibido al tratarse de
una estructura no válida, por esto se solicita hacer la transformación de este dato en la fuente.
CARACTER RESUELTO EN XML
Menor que (<) <

Mayor que (>) >
Comillas dobles (“) "
Apostrofe (´) '
El signo & (&) &
\r No hay traducción, debe eliminarse
18. OBSERVACIONES .NET

Para los desarrolladores que realicen la integración con el lenguaje de programación .NET, se recuerda
tener en cuenta colocar las variables Specified en true cuando una variable no viaje al web service.
19. INTEGRACIÓN DE SERVICIOS PARA GENERACIÓN DE REPRESENTACIÓN GRÁFICA
19.1 EL FACTURADOR ASUME LA RESPONSABILIDAD DE CREACIÓN Y ENVÍO DE LA

REPRESENTACIÓN GRÁFICA
Para la generación de la representación gráfica donde el responsable es el ERP debe realizarse lo

siguiente:
Consumir el servicio de emisión de documentos electrónicos descrito en el Manual de

Integraciones (ver 9.1 ENVIAR DOCUMENTO) enviar el campo “aplicafel” con el literal “NO” y
Adicionalmente enviar el campo “codigoPlantillaPdf” igual a cero “0”, guardar los datos
suministrados en la respuesta síncrona de este servicio para completar la información necesaria
para la generación de la representación gráfica tales como CUFE, QR y Fecha de Expedición,
estos se encuentran descritos en el objeto Fel_RespuestaEnvio.
Página 29 de 31
Código: CE-MU-011
Dado el escenario en el que el ERP no alcance a guardar los datos en la misma transacción
pueden hacer uso del servicio de consulta de estado (ver 10.1 CONSULTAR ESTADO FACTURA)
para recuperar los datos faltantes para la generación de la representación gráfica.
Para realizar el proceso de entrega de documentos al adquirente deben de obtener el contenedor
de documentos electrónicos el cual pueden consultar por medio del consumo el servicio de
consulta de documentos electrónicos ver (10.3 CONSULTAR ARCHIVOS).
19.2 EL FACTURADOR ENVIA PDF PARA QUE DISPAPELES CARGUE EL CUFE, FECHA DE
EXPEDICIÓN Y QR
Para realizar el proceso de edición de la representación gráfica la cual es suministrada por el

Facturador es necesario realizar lo siguiente:
1. Enviar en el campo de “codigoPlantillaPdf” el código 201.

2. Enviar en la lista “listaCamposAdicionales” de la cabecera del documento en el primer registro
la siguiente especificación:
a. nombreCampo = REPRESENTACION_GRAFICA
b. valorCampo = Formato Json con las Coordenadas.
i. X = (numérico) posición en el eje X del PDF (Obligatorio)
ii. Y = (numérico) posición TOP del eje Y del PDF (Obligatorio)
iii. tamanoLetra = (numérico)Tamaño de la letra del texto (Opcional = 9)
iv. prefijoTexto = (alfanumérico)Texto que antecede el valor a modificar (Opcional).
Ejemplo:
{ "nombreCampo": "REPRESENTACION_GRAFICA",
"valorCampo":
"{'CUFE_PDF': {'x':95,'y':723,'tamanioLetra':8,'prefijoTexto':'CUFE: '},
'CODIGO_QR_PDF': {'x':36,'y':340},
'FECHA_EXPEDICION_PDF': {'x':35,'y':330,'tamanioLetra':9,'prefijoTexto':'Fecha Expedición: '}}",
3. Enviar en la lista "listaDocumentosAdjuntos” en el primer registro el PDF a realizar la edición

en Base64 como lo indica el manual de integraciones.
Los errores generados, se podrán visualizar desde el portal o desde el servicio web de consulta
de estado de documentos.
1. Si la lista “listaCamposAdicionales” está vacía:

• No hay coordenadas disponibles para el documento.
2. Si en la primera posición de la lista “listaCamposAdicionales” el nombre del campo no es
“REPRESENTACION_GRAFICA”:
• No hay coordenadas disponibles en el Campo Adicional (0)
3. Si el valor del Json en “valorCampo” no es el correcto:
• No se reconocen las coordenadas enviadas.
4. Si en el Json enviado no existe una etiqueta con el valor “CUFE_PDF”
• No hay coordenadas disponibles para reemplazar CUFE en el documento
5. Si en el Json enviado no existe una etiqueta con el valor “CODIGO_QR_PDF”
• No hay coordenadas disponibles para reemplazar Codigo QR en el documento
6. Si en el Json enviado no existe una etiqueta con el valor “FECHA_EXPEDICION_PDF”
Página 30 de 31
Código: CE-MU-011
• No hay coordenadas disponibles para reemplazar Fecha de Expedición en el

documento.
7. Si la lista de adjuntos "listaDocumentosAdjuntos” viene vacía.
• No hay adjunto para realizar la edición.
8. Si el adjunto no se puede descargar.
• No hay adjunto para realizar la extracción
9. Si en el proceso de edición se genera alguna excepción.
• Error generando la actualización del PDF: {excepción generada}
Página 31 de 31

CEMU011 V10 M 2

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

CEMU011 V10 M 2

Cargado por

Copyright:

Formatos disponibles

Código: CE-MU-011

VERSIÓN FECHA RAZÓN DE LA ACTUALIZACIÓN

16.3 TIPO DE DOCUMENTO DE IDENTIFICACIÓN .................................................................... 27

Validación previa de la factura electrónica de venta: Procedimiento electrónico a cargo de la

5. PROCESO GLOBAL “MODELO VALIDACIÓN PREVIA”

Imagen 1. Proceso global

5.1 ESCENARIO DE INTEGRACIÓN DETALLADO 1 – Integración Indirecta por Manejo de archivos

Imagen 2. Uso de conector para lectura de archivos

5.2 ESCENARIO DE INTEGRACIÓN DETALLADO 2 – Integración Indirecta por Base de datos

Imagen 3. Uso de conector para lectura de BD

5.3 ESCENARIO DE INTEGRACIÓN DETALLADO 3 – Integración Indirecta por webservice

Imagen 4. Uso de conector para lectura de web service

5.4 ESCENARIO DE INTEGRACIÓN DETALLADO 4 – Integración directa.

Imagen 5. Consumo directo del web service

6 ARQUITECTURA DE SERVIDORES Y SERVICIOS

Imagen 6. Arquitectura de software

Estos servidores están ubicados en zonas geográficamente diferentes, la distancia de cada

IMPORTANTE: Tanto la estructura de campos como su obligatoriedad y descripción que se indican a

7.1 CABEZA DEL DOCUMENTO ELECTRÓNICO

VERIFICA EL NUMERO DE LOS DETALLES, ESTE ES UN CONTROL DE LA DIAN PARA

OBLIGATORIO PARA FACTURAS DE EXPORTACIÓN. VER TABLA INCOTERM.

campoAdicional5 Varchar(240) NO NO CAMPO ADICIONAL DE COMODÍN

7.2 DETALLE DE LA FACTURA

NOTAS ADICIONALES A LA DESCRIPCIÓN DEL PRODUCTO. OBLIGATORIO: DEBERÁ

7.3 ADQUIRENTES “PERSONA NATURAL O JURÍDICA QUE COMPRA UN BIEN O UN SERVICIO”

Totalimportebruto + ∑ valorImpuestoRetencion(NIVEL DETALLE)

ES LA BASE CON IMPUESTOS, MAS CARGOS, MENOS DESCUENTOS, MENOS ANTICIPOS,

Totalbaseconimpuestos+ totalCargos- totalDescuento- pagoanticipado

7.5 IMPUESTOS Y RETENCIONES

NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN

CÓDIGO DEL IMPUESTO O RETENCIÓN. VER NUEVA TABLA DE IMPUESTOS EN LA

tarifas por impuesto del anexo técnico publicado por la DIAN.

IMPUESTO CONCEPTO TARIFA

7.6 FACTURA(S)A MODIFICAR EN NOTA

VALOR NECESARIO PARA PODER ENCONTRAR EL CUFE DE LA FACTURA A

7.8 LISTA DE CAMPOS ADICIONALES

7.9 LISTA ORDEN DE COMPRA

7.10 LISTA DE CARGOS

7.11 LISTA DE DESCUENTOS

7.12 LISTADO CÓDIGOS DE BARRA

Especificaciones código de barras de recaudo

El código de barras de recaudo se compone de 4 partes principales:

Nota: La cadena debe enviarse con los paréntesis como se observa.

2. Los dígitos correspondientes a la fecha deben llevar 8 dígitos en el siguiente orden:

AAAAMMDD EJ: 20181002 -> octubre 02 de 2018

3. Lista de campos de cabecera

Se tiene la lista codigodebarras para el envío de la cadena.

7.12.5 Campo de envío de la cadena: Codigodebarras (String 255)

7.13 LISTA DATOS DE ENTREGA

7.14 LISTADO MEDIOS DE PAGO

7.15 LISTA DE DOCUMENTOS ADJUNTOS

7.16 LISTA DE ANTICIPOS

NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN

8 CÓDIGOS DE RESPUESTA DE ESTADOS

8.1 ESTADOS DIAN

Uso autorizado por la DIAN La DIAN ha autorizado el documento enviado.

8.2 ESTADOS ENVÍO EMAIL

Código Nombre estado Descripción estado

92 Bounce permanent NoEmail No existe email

93 Bounce permanent Supressed Vetado en SES Amazon

94 Bounce transient general Puede intentarse nuevamente

8.3 ESTADOS ADQUIRENTES

Código Nombre estado Descripción estado

Menor que (<) <