Manual de Integraciones FASE 2 - DISPAPELES

Código: CE-MU-011
DEFINICIÓN DE ESTRUCTURA DE
Versión No.: 1
DATOS PARA INTEGRACIÓN
Fecha Aprobación: 17 / M a y / 2 0 1 9
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

Código: CE-MU-011
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
TABLA DE CONTENIDO
1. INTRODUCCIÓN .............................................................................................................................. 4
2. OBJETIVOS ...................................................................................................................................... 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 ......... 8
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. ..................................... 9
6. ARQUITECTURA DE SERVIDORES Y SERVICIOS. ............................................................................. 9
7. DICCIONARIO DE DATOS................................................ .................................... ..... ........ .. .. .. 11
7.1 CABEZA DEL DOCUMENTO ELECTRÓNICO ................................................................................ 11
7.2 DETALLE DE LA FACTURA ............................................................................................................. 12
7.3 ADQUIRENTES “PERSONA NATURAL O JURIDICA QUE COMPRA UN BIEN O UN SERVICIO” ..... 13
7.4 FEEL PAGOS ............................................................................................................................ 13
7.5 IMPUESTOS Y RETENCIONES ............................................................................................... 14
7.6 FACTURA(S) A MODIFICAR EN NOTA .................................................................................... 14
7.7 MANDANTES ................................................................................................................. 14
7.8 LISTA DE CAMPOS ADICIONALES................................................................................................. 15
7.9 LISTA ORDEN DE COMPRA..................................................................................................... 15
7.10 LISTA DE CARGOS ....................................................................................................................... 15
7.11 LISTA DE DESCUENTOS .............................................................................................................. 16
7.12 LISTADO CÓDIGOS DE BARRA.................................................................................................... 16
7.13 LISTA DATOS DE ENTREGA ........................................................................................................ 17
7.14 LISTADO MEDIOS DE PAGO ................................................................................................. 17
7.15 LISTA DE DOCUMENTOS ADJUNTOS .................................................................................. 18
8. CÓDIGOS DE RESPUESTA DE ESTADOS .......................................................................................... 18
8.1 ESTADOS DISPAPELES ................................................................................................................. 19
8.2 ESTADOS DIAN ........................................................................................................................ 19
8.3 ESTADOS ENVÍO EMAIL .......................................................................................................... 20
8.4 ESTADOS ADQUIRENTES ....................................................................................................... 20
9. MÉTODOS DE ENVÍO DE DATOS AL WEB SERVICE DE DISPAPELES ............................................. 21
9.1 ENVIAR DOCUMENTO .................................................................................................. 21
9.2 ENVIAR DOCUMENTO POR LOTE ............................................................................... 23
10. MÉTODOS DE CONSULTA Y DEFINICIÓN DE ESTRUCTURAS DE CONSULTA Y RESPUESTA ...... 25
10. 1 CONSULTAR ESTADO FACTURA .............................................................................. 25
10.2 CONSULTAR ESTADO FACTURA POR LOTE ........................................................... 25
10.3 CONSULTAR ARCHIVOS ........................................................................................... 26
11. MENSAJES DE ERROR ............................................................................................ ........27
12. MATRIZ DE CAMBIOS A CONSIDERAR ........................................................................... 28
Página 2 de 34
Código: CE-MU-011
13. CONEXIÓN SOAP AMBIENTE PRUEBAS ........................................................................ 29

14. SEGURIDAD DE PRUEBAS EN AMBIENTE DEMO .......................................................... 29
15. TABLAS ............................................................................................................................. 29
15.1 INCOTERM ................................................................................................................... 30
15. 2 IMPUESTOS................................................................................................................. 31
15.3 TIPO DE DOCUMENTO DE IDENTIFICACIÓN ............................................................. 31
15.4 TIPO PERSONA ............................................................................................................ 31
15.5 REGIMEN FISCAL ......................................................................................................... 31
15.6 RESPONSABILIDADES FISCALES .............................................................................. 31
15.7 MEDIOS DE PAGO........................................................................................................ 32
16. CARACTERES PROHIBIDOS...............................................................................................32
17. OBSERVACIONES .NET.......................................................................................................33
18. CAMBIOS APLICADOS POR CAMBIO DE MODELO DE LA DIAN .................................. 33
18.1 CABEZA DE FACTURA ................................................................................................. 34
18.2 DETALLE DE LA FACTURA .......................................................................................... 34
Página 3 de 34
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 34
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 34
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 34
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
Página 7 de 34
Código: CE-MU-011
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 no
es recomendado ya que no es bueno invadir la base de datos del cliente salvo que se tenga el
acompañamiento del fabricante del producto. 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
5.3 ESCENARIO DE INTEGRACIÓN DETALLADO 3 – Integración Indirecta por web service

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
Página 8 de 34
Código: CE-MU-011
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:
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
Página 9 de 34
Código: CE-MU-011
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
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.
Página 10 de 34
Código: CE-MU-011
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.
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
“Fel_CabezaDocumento”, 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.
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.
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 DISPAPELES
contrasenia varchar(40) NO SI 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
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'
matriculaMercantil varchar(60) NO NO NUMERO DE MATRICULA MERCANTIL ASOCIADA AL PREFIJO.
CODIGO DEL FORMATO DEL DOCUMENTO ELECTRÓNICO A IMPLEMENTAR. APLICA SOLO SI
codigoPlantillaPdf Int NO NO
LA EMPRESA MANEJA MAS DE UN FORMATO PARA FACTURAS Y NOTAS.
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
COMPROBAR QUE LOS SERVICIOS Y PRODUCTOS VAN COMPLETOS. IDEAL QUE ESTE VALOR
cantidadLineas int NO NO
SEA ENVIADO POR EL CLIENTE, DE LO CONTRARIO SERÁ CALCULADO POR DISPAPELES. CAMPO
NUEVO
INCOTERM --CAMPO DE USO EXCLUSIVO PARA FACTURAS DE EXPORTACIÓN. VER TABLA
incoterm varchar(3) NO NO
INCOTERM.
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(1) SI SI FALTA DE REQUISITOS
NOTA DEBITO: 6. OTROS 7. INTERESES 8. GASTOS POR COBRAR 9. CAMBIO DEL VALOR. SOLO
SI EL TIPO DE DOCUMENTO ES NOTA C/D
aplicafel varchar(2) NO SI APLICA FACTURA ELECTRÓNICA A ESTE CLIENTE SI-NO
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
pago FEL_PAGOS SI SI ESTRUCTURA QUE ALMACENA LA INFORMACIÓN DEL PAGO. VER TABLA FEL_PAGOS
List<Fel_DetalleDocume
listaDetalle SI SI LISTA QUE ALMACENA LOS DETALLES DE PRODUCTOS Y/O SERVICIOS.
nto>
Página 11 de 34
Código: CE-MU-011
listaImpuestos List<Fel_Impuesto> SI SI LISTA DE LOS IMPUESTOS ASOCIADOS A LA FACTURA

List<Fel_FacturaModific
listaFacturasModificadas NO NO LISTA DE LAS FACTURAS ASOCIADAS A UNA NOTA
ada>
List<Fel_DocumentoAdj
listaDocumentosAdjuntos NO NO LISTA DE DOCUMENTOS ADJUNTOS QUE SE ENVÍAN POR EL WEB SERVICE
unto>
listaAdquirentes List<Fel_Adquirente> NO NO 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
listaCamposAdicionales NO NO MANEJAR CAMPOS NO TENIDOS EN CUENTA EN EL ESTÁNDAR UBL2.1 DEFINIDO POR LA DIAN.
l>
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
Los campos Server, username, password, port, rutaCarga y rutaDescarga se utilizan cuando un cliente
quiere recibir la factura por medio de su proveedor tecnológico “Proyecto de Interoperabilidad” y no por
correo. En este caso se hace necesario diligenciar dichos campos para colocar la información en los
servidores de su proveedor tecnológico. Esto hace parte de un proyecto cuya iniciativa nació del sector
privado y lo que busca es la interconexión de todos los proveedores tecnológicos, sin embargo, este
proyecto está bastante atrasado, pero desde ya contemplamos esta solución.
7.2 DETALLE DE LA FACTURA

Los siguientes campos conforman la estructura “Fel_DetalleDocumento” que hace parte del objeto
principal “Fel_CabezaDocumento”, en estos, se almacenan los distintos productos y/o servicios que
pueda tener un facturador. El objeto “Fel_DetalleDocumento” 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
“Fel_CabezaDocumento” contiene una lista de tipo “Fel_DetalleDocumento” que puede contener
varios productos y/o servicios documentos.
OBLIGATORIO
NOMBRE TIPO DE DATOS DIAN DESCRIPCIÓN
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. 010:
tipocodigoproducto varchar(30) SI NO 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”
UNIDAD DE MEDIDA QUE MANEJA EL FACTURADOR. SE RECOMIENDA USAR LOS VALORES
DESCRITOS EN LA TABLA 5.4.1 DEL DOCUMENTO ADJUNTO
unidadmedida varchar(5) NO NO
ANEXO%20TÉCNICO%20DE%20FACTURA%20ELECTRÓNICA.PDF. EL USO DE ESTE CAMPO
INICIALMENTE NO SERÁ OBLIGATORIO, PERO DE SEGURO LO SERÁ.
valorunitario decimal(28,8) SI SI VALOR UNITARIO DEL PRODUCTO O SERVICIO
VALOR SIN IMPUESTOS Y SIN DESCUENTO. (CANTIDAD X VALOR UNITARIO – DESCUENTO +
preciosinimpuestos decimal(28,8) SI SI
CARGOS)
preciototal decimal(28,8) SI SI VALOR TOTAL A PAGAR POR EL/LOS PRODUCTOS POR LÍNEA DE DETALLE
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 “MUESTRA=1,
muestracomercial INT REGALO=2”
ESTE CAMPO ES OBLIGATORIO SI HAY MUESTRA COMERCIAL. LOS CODIGOS ACEPTADOS SON: 1.
muestracomercialcodigo INT NO NO
VALOR COMERCIAL, 2. VALOR EN INVENTARIOS, 3. OTRO VALOR
tipoImpuesto INT GRAVADO=1, EXCLUIDO=2, EXCENTO=3
listaImpuestos List<Fel_ImpuestoDto> SI SI LISTA DE LOS IMPUESTOS ASOCIADOS AL DETALLE
listadedescuentos 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
Página 12 de 34
Código: CE-MU-011
LISTA QUE ALMACENA UNO O VARIOS ELEMENTOS CON ASOCIACIÓN CAMPO VALOR PARA
listaAdicionales List<Adicionales> NO NO 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 aplicaMandato
listaMandantes List<Fel_Mandantes> NO NO ES IGUAL A SI.
7.3 ADQUIRENTES “PERSONA NATURAL O JURIDICA QUE COMPRA UN BIEN O UN SERVICIO”

La siguiente estructura de campos conforman la estructura “Fel_Adquirente” que hace parte del
objeto principal “Fel_CabezaDocumento”, en estos, se almacenan los distintos clientes que hacen
referencia al comprador. El objeto “Fel_Adquirente” se guarda en una lista para obtener tantos
clientes como se requieran.
TIPO DE OBLIGATORIO
NOMBRE DIAN
DESCRIPCIÓN
DATOS 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) N/A N/A 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
régimen varchar(240) NO NO 04. SIMPLE 05. ORDINARIO
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
direccion varchar(100) SI SI DIRECCIÓN DEL CLIENTE
telefono varchar(50) NO NO TELÉFONO DEL CLIENTE
codigopostal varchar(5) NO NO CODIGO POSTAL
digitoVerificacion varchar(2) NO NO DÍGITO DE VERIFICACIÓN DEL DOCUMENTO DE IDENTIDAD
coordenadas varchar(240) NO NO UBICACIÓN CON COORDENADAS GPS. PENDIENTE VERIFICACIÓN POR PARTE DE LA DIAN.
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
paisnombre varchar(30) NO NO NOMBRE DEL PAÍS RELACIONADO CON EL CÓDIGO ENVIADO
codigoCIUU varchar(30) NO NO CODIGO CIIU DEL ADQUIRENTE
7.4 FEEL PAGOS
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'
TOTAL IMPORTE BRUTO ANTES DE IMPUESTOS, SUMA DE LOS IMPORTES BRUTOS DE LAS
totalimportebruto decimal (28,8) SI SI
LÍNEAS DE LA FACTURA
TOTAL BASE IMPONIBLE (IMPORTE BRUTO+CARGOS-DESCUENTOS): BASE IMPONIBLE PARA EL
totalbaseimponible decimal (28,8) SI SI
CÁLCULO DE LOS IMPUESTOS
totalbaseconimpuestos decimal (28,8) SI SI INDICA EL VALOR BRUTO + VALOR DE LOS IMPUESTO
TOTAL DE FACTURA, TOTAL IMPORTE BRUTO +TOTAL IMPUESTOS-TOTAL IMPUESTO
totalfactura decimal (28,8) SI SI
RETENIDOS.
pagoanticipado decimal (28,8) NO NO VALOR DE PAGO ANTICIPADO A LA FACTURA.
tipocompra smallint (6) SI SI ESTE CAMPO INDICA SI LA COMPRA ES 1. DE CONTADO O 2. A CRÉDITO
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
APLICA PARA VENTAS A CREDITO tipocompra=2, INFORMA LA FECHA LIMITE EN QUE SE DEBE
fechavencimiento Date PAGAR LA FACTURA DE ACUERDO A LO ACORDADO EN EL PERDIODO DE PAGO. ESTE CAMPO
ES OBLIGATORIO SI tipocompra=2
trm decimal (28,8) NO NO APLICA PARA FACTURAS DE EXPORTACIÓN
trm_alterna decimal (28,8) NO NO APLICA PARA FACTURAS DE EXPORTACIÓN. CAMPO NUEVO
fechaTasaCambio Date NO NO FECHA CON LA QUE SE FIJA LA TASA DE CAMBIO. CAMPO NUEVO
Página 13 de 34
Código: CE-MU-011
7.5 IMPUESTOS Y RETENCIONES

Los siguientes campos conforman la estructura “Fel_Impuesto” que hace parte del objeto
principal “Fel_CabezaDocumento”, en estos, se almacenan los distintos impuestos y/o retenciones que
se apliquen a una factura o nota. El objeto “Fel_Impuesto” 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 Fel_CabezaDocumento, cuando es por item’s la lista se llenará desde
el objeto Fel_DetalleDocumento.
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 EL IMPUESTO APLICA AUTORETENCIÓN O NO.
7.6 FACTURA(S)A MODIFICAR EN NOTA

La siguiente estructura de campos conforman la estructura “Fel_FacturaModificada” que hace parte
del objeto principal “Fel_CabezaDocumento”, 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 “Fel_FacturaModificada” se guarda en una lista para obtener tantas facturas como se
requieran.
Importante aclarar que, aunque los campos consecutivofacturamodificada, cufefacturamodificada y

fechafacturamodificada son obligatorios en la siguiente tabla, también es posible enviar una nota sin
facturas asociadas, por lo que es ese escenario la obligatoriedad no aplica ya que no se cargaría la
estructura al web service.
OBLIGATORIO
DIAN PT
PREFIJO MAS CONSECUTIVO DE LA FACTURA A MODIFICAR. ESTE CAMPO SOLO APLICA PARA
consecutivofacturamodificada int(11) SI SI LAS NOTAS DÉBITO Y/O CRÉDITO. EJ: FACT564231
CUFE DE LA FACTURA QUE SE MODIFICARÁ, SOLO APLICA PARA LAS NOTAS DÉBITO Y/O
cufefacturamodificada varchar(40) SI SI CRÉDITO.
FECHA Y HORA EN LA QUE SE GENERÓ LA FACTURA QUE SE ESTÁ MODIFICANDO EN FORMATO
fechafacturamodificada Date SI SI
YYYY-MM-DD HH:MM:SS.
observacion varchar(400) NO NO INFORMACIÓN DESCRIPTIVA
7.7 MANDANTES
La siguiente estructura de campos conforma la estructura “Fel_Mandante” que hace parte del
objeto principal “Fel_DetalleDocumento”, en estos, se almacenan los distintos términos que hacen
referencia al contrato de mandante de la factura. El objeto “Fel_Mandante” 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.
Página 14 de 34
Código: CE-MU-011
OBLIGATORIO
DIAN PT
identificacionMandante varchar(30) SI SI IDENTIFICACIÓN MANDANTE
SI LA FACTURA MANEJA MANDANTE, SE DEBE AGREGAR ESTE VALOR DE MANERA
digitoDeVerificacionMandante varchar(2) SI SI
OBLIGATORIA
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
tipoObligacion varchar(100) NO NO PENDIENTE DEFINICIÓN DIAN
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.
7.8 LISTA DE CAMPOS ADICIONALES

La siguiente estructura de campos hacen parte de la estructura “Fel_CampoAdicional” que hace parte
del objeto principal “Fel_CabezaDocumento”, en estos, se almacenan campos adicionales que sean
requeridos en la representación gráfica de la factura.
OBLIGATORIO
PT
DESCRIPCION DEL VALOR ALMACENADO. PARA EL MANEJO DE LAS NOTAS DE LA DIAN, COLOCAR EL
nombreCampo varchar(50) NO NO
CONCEPTO DESCRIPCION.
valorCampo varchar(400) NO NO VALOR DEL CAMPO ADICIONAL INDICADO.
GRUPO DE DATOS ADICIONALES QUE SIRVE PARA SABER UNA DETERMINADA POSICIÓN EN LA QUE SE QUIERA
seccion Int(11) NO NO
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
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.
OBLIGATORIO
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.
OBLIGATORIO
DIAN PT
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) SI SI DESCRIPCIÓN DEL CARGO APLICADO A LA FACTURA
Página 15 de 34
Código: CE-MU-011
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.

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(1) SI SI
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
valorDescuento decimal (28,8) NO NO VALOR DEL DESCUENTO
porcentajeDescuento decimal (28,8) NO NO 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.
TIPO DE OBLIGATORIO
NOMBRE DESCRIPCIÓN
DATOS DIAN PT
CADENA PARA LA GENERACIÓN DEL CÓDIGO DE BARRAS1, VER ANEXO ESPECIFICACIONES PARA EL ENVÍO DEL
cadenaACodificar varchar(255) NO NO CÓDIGO DE BARRAS DE RECAUDO
MODELO DE CÓDIGO QUE SE IMPLEMENTARÁ AL INTERIOR DE DISPAPELES. DISPAPELES INDICARÁ ESTE VALOR PARA
tipoModelo varchar(255) NO NO
QUE SEA ENVIADO POR EL FACTURADOR DE ACUERDO A SU NECESIDAD.
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:
 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
 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
Página 16 de 34
Código: CE-MU-011
 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.
 96
---> Fecha máxima de pago
---> Longitud fija: 8 dígitos
---> Opcional
De acuerdo a 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:
(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.
 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.
Página 17 de 34
Código: CE-MU-011

DIAN PT
cantidad Long NO NO CANTIDAD POR TRANSPORTAR
cantidadMaxima Long NO NO CANTIDAD MAXIMA POR TRANSPORTAR
cantidadMínima Long NO NO CANTIDAD MÍNIMA POR TRANSPORTAR
identificadorTransporte String NO NO PLACA DEL VEHÍCULO
paisEntrega String NO NO PAIS DE ENTREGA
ciudadEntrega String NO NO CIUDA DE NTREGA
direccionEntrega String NO NO DIRECCION DE ENTREGA
lugarEntrega String NO NO LUGAR DE ENTREGA
telefonoEntrega String NO NO TELEFONO DE ENTREGA
periodoEntregaEstimado Date NO NO PERIODO DE ENTREGA ESTIMADO
periodoEntregaPrometido Date NO NO PERIODO DE ENTREGA PROMETIDO
periodoEntregaSolicitado Date NO NO PERIODO DE ENTREGA SOLICITADO
tiempoRealEntrega Time NO NO TIEMPO REAL DE ENTREGA
ultimaFechaEntrega Date NO NO ULTIMA FECHA DE ENTREGA
nombretransportista String NO NO NOMBRE TRANSPORTISTA
tipoidentificacionTransportista String NO NO TIPO DE IDENTIFICACION DEL TRANSPORTISTA
identificacionTransportista String NO NO IDENTIFICACION DEL TRANSPORTISTA
dVIdentificaciontransportista String NO NO DIGITO DE VERIFICACIÓN DE LA IDENTIFICACIÓN
empresaTransportista String NO NO EMPRESA TRANSPORTISTA
tipoIdentificacionEmpresaTransportista String NO NO TIPO DE IDENTIFICACION DE LA EMPRESA TRANSPORTISTA
nitEmpresaTransportista String NO NO NIT DE LA EMPRESA TRANSPORTISTA
descripcion String NO 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.
TIPO DE OBLIGATORIO
NOMBRE DESCRIPCIÓN
DATOS DIAN PT
medioPago varchar(2) NO NO VER TABLA MEDIOS DE PAGO, SECCIÓN TABLAS
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.
DIAN PT
nombreConExtension varchar(240) NO NO NOMBRE DEL ARCHIVO A ADJUNTAR
contenidoDelDoc byte [] NO NO CONTENIDO DEL ARCHIVO EN ARREGLO DE BYTE’S
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:
Página 18 de 34
Código: CE-MU-011
8.1 ESTADOS DISPAPELES

Los estados de Dispapeles son importantes ya que se puede identificar en qué fase del proceso se
encuentra su documento, y si este se generó de manera exitosa o si por el contrario ocurrió un error. A
continuación, los distintos estados internos:
ESTADOS MANEJADOS POR DISPAPELES
Código Nombre estado Descripción estado

SE VALIDAN VALORES OBLIGATORIOS, TIPOS DE DATOS, FECHAS DE VENCIMIENTO DEL CONSECUTIVO, ENTRE
7 Factura en verificación
OTROS.
8 Se crea xml SE CREA LA ESTRUCTURA XML DE LA FACTURA ANTES DE LA FIRMA
9 Se firma el xml SE FIRMA EL XML
10 Xml construido y firmado exitosamente XML CONSTRUIDO Y FIRMADO EXITOSAMENTE
11 Se crea pdf SE CREA PDF CON REPORTEADOR INTERNO
SE HACE UN LLAMADO A PRINTNET PARA LA GENERACIÓN DEL PDF. EN ESTE CASO EL CORE DE FACTURA
12 Se solicita creación de pdf
ELECTRÓNICA DELEGA ESTA RESPONSABILIDAD
13 PrintNet genera pdf EL APLICATIVO PRINTNET INFORMA DE LA CREACIÓN DE LA REPRESENTACIÓN GRÁFICA
14 Envío de la factura a la DIAN SE ENVÍA EL ZIP AL WEB SERVICE DE LA DIAN
18 Envío de la factura al usuario por email SE ENVÍA EL DOCUMENTO XML Y PDF AL CORREO DEL ADQUIRENTE
19 Error envío DIAN ERROR ENVÍO DIAN
8.2 ESTADOS DIAN

Parámetros de salida del Servicio Web Consulta Resultado de Transacciones desde Dispapeles a la Dian.
Los parámetros de salida que tiene definido el servicio web contienen la información del resultado general
de la transacción, listado de documentos encontrados con la misma información de la petición realizada.
La Dian entrega dos respuestas en momentos diferentes. El primero de estos momentos es cuando se
entregan los datos de la factura, la Dian responde con un valor de 200 si la información fue recibida
exitosamente, y devuelve los valores 300, 310 y 320 si se presentó algún inconveniente.
A continuación, se detalla en la siguiente tabla cada uno de los parámetros de salida de ese primer
momento:
Resultado General de la transacción
Requerido
Nombre del Campo Descripción Tipo de Dato Tamaño
(SI/NO)
codigoTransaccion Código de la transacción 200, 300, 310, 320 Numérico 3 SI
Fecha y hora en la cual se realizó la transacción Formato: YYYY-MM-
fechaTransaccion Fecha 19 SI
DD’T’HH24:MI: SS
200 = Transacción Exitosa
300 = Excepción en el Sistema
descripcióntransacción Alfanumérico 300 SI
310 = Parámetros enviados con error
320 = No existe información
Sin embargo, ahora nos falta saber si la factura pasó o no las validaciones que realiza la Dian, por lo que en
un segundo instante de tiempo se debe volver a consultar. Se debe tener claro que, al ser las respuestas
de la Dian en dos instantes diferentes de tiempo, Dispapeles se debe adaptar, por lo que el estado final de
la Dian lo obtenemos de la misma forma y así también la podrá ver nuestro cliente.
Página 19 de 34
Código: CE-MU-011
Los estados para saber si la factura pasó o no las validaciones son las siguientes:
LISTA DE DOCUMENTOS
Requerido
Nombre del Campo Descripción Tipo de Dato Tamaño
(SI/NO)
estadoDocumento Estado del documento 7200001, 7200002, 7200003, 7200004, 7200005 Numérico 7 SI
Descripción del estado del documento
7200001 = RECIBIDA
7200002 = EXITOSA
descripcionEstado Alfanumérico 60 SI
7200003 = EN PROCESO DE VALIDACIÓN
7200004 = FALLIDA (Documento no cumple 1 o más validaciones de DIAN)
7200005 = ERROR (El xml no es válido)
Se confirma que la factura pasó exitosamente en la Dian cuando se recibe el código 7200002. Si no es así,
la factura presenta un error o no ha sido validada aún por la Dian.
Recomendamos hacer la consulta de estos estados cada 24 horas ya que, si algo sale mal, la plataforma
Fact_e les estará notificando vía email a los líderes funcionales y técnicos de la compañía. En este orden
de ideas, los estados solo lo requieren para mantener una base de históricos en su ERP.
8.3 ESTADOS ENVÍO EMAIL

A continuación, los distintos estados que describen lo sucedido en el proceso de envío de email.
ESTADOS EMAIL

1 Correo adquirente y emisión fallidos Correo del adquirente y también correo de la empresa (correo de emisión) fallidos.
2 Imposible ubicar xml y pdf No se encuentran los adjuntos (xml y pdf), ruta definida en el campo rutaCarpeta de fel_pendiente_envio_email.
3 Envío adquirente exitoso Envió exitoso al correo del adquirente, incluye copia a los correos separados por “;”.
4 Pendiente para envío de notificación Indica que el correo del adquiriente falló, al momento de enviar la notificación al administrador, el campo notificado se actualiza a
1.
5 Correo emisión sin autorización en Correo de emisión sin autorización en la cuenta de Dispapeles en Amazon.
aws
6 Imposible ubicar los adjuntos Si la factura a enviar trae adjuntos y estos no se logran ubicar o adjuntar, se marca el campo estado en fel_pendiente_envio_email
en 6.
11 Pendiente Pendiente para envío.
8.4 ESTADOS ADQUIRENTES

A continuación, los distintos estados que describen si una factura fue aceptada o rechazada y/o acusada
por el adquirente.
ESTADOS ADQUIRENTE

4 Factura aceptada explícitamente La factura es aceptada por el adquirente.
5 Factura rechazada La factura es rechazada por el adquirente
6 Acuse de recibo El adquirente acusa el recibo de la factura
7 Aceptación tácita Se acepta la factura de forma automática luego de 72 horas
Página 20 de 34
Código: CE-MU-011
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.
cufe 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 concatenada da los datos como lo
codigoQr varchar(2000)
pide la Dian.
fechaFactura TIMESTAMP Fecha de creación de la factura en el ERP
fechaRespuesta TIMESTAMP Fecha de la respuesta del web service
Aplica solo cuando la empresa envía el id del erp que identifica la factura, y devuelve dicho valor, de lo contrario devuelve
idErp Int
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 1=Error; 0=Exitoso; 2=Exitoso con notificaciones
listaMensajesProceso List<Fel_MensajeProceso> Listado con los mensajes de error asociados al documento
Página 21 de 34
Código: CE-MU-011
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
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
se les entregan credenciales 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
Página 22 de 34
Código: CE-MU-011
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.
9.2 ENVIAR DOCUMENTO POR LOTE

El método “EnviarDocumentoLote” permite enviar una lista que contenga como máximo 100 documentos
y devuelve un objeto de forma síncrona donde se encuentra el atributo número del lote. El parámetro
de entrada de este método es una lista de tipo “Fel_CabezaDocumento” que contiene los distintos datos
de los documentos, y devuelve un objeto de tipo “Fel_RespuestaEnvioLote” en el que se encuentra
el atributo numeroLote, fechaRespuesta, codigoRespuesta y descripcionRespuesta. Si no se presenta
ningún error el campo para tener en cuenta es numeroLote, con este valor se deberá realizar la
consulta.
Este método procesa la información de forma asíncrona, es decir, a pesar de recibir una respuesta
inmediata, realmente los documentos se procesarán posteriormente. Luego de recibir el número del lote
que devuelve el web service, la plataforma tecnológica de Dispapeles inicia al procesamiento de todos los
documentos que hacen parte del lote. Puede ocurrir que de un lote no todos los documentos se procesen
de manera exitosa, en todo caso en la consulta posterior se entregará el resultado del proceso de cada
uno de ellos.
Se recomienda que el lote sea consultado dos (2) minutos después de la respuesta del número de lote
“Para lotes superiores a 50 documentos”, y que si en ese momento no está la respuesta de todos los
documentos que hacen parte del lote se haga un reintento al minuto siguiente. El método de consulta se
llama “consultarEstadoFacturaPorLote”.
Objeto de respuesta “Fel_RespuestaEnvioLote”:

TIPO DE
CAMPO DESCRIPCION
DATOS
estadoProceso int 1=Error; 0=Exitoso; 2=Exitoso con notificaciones
codigoRespuesta int Código interno con el resultado de la operación
descripcionRespuesta varchar(240) Texto que devuelve un código seguido del mensaje que describe ese código. Ejemplo: ok, se han recibido 100 facturas.
numeroLote varchar(40) Valor con el número del lote. Con este valor posteriormente se podrán consultar todas las facturas que hacen parte del lote.
fechaRespuesta timestamp Fecha y hora de la respuesta
Página 23 de 34
Código: CE-MU-011
Imagen 8 Flujo para enviar documento por lote
Como se observa en el flujo, una vez se envían los datos de la factura por el método de lotes
“enviarDocumentoLote”, Dispapeles responde de forma síncrona con el número del lote. Posterior a esto
y dependiendo del número de documentos emitidos “Máximo 100” se debe proceder a consultar el
lote y este devolverá una estructura en lista con todos los estados de las facturas del lote.
Se recomienda esta opción cuando son muchas facturas por procesar y los tiempos de generación de los
documentos no son tan inmediatos. Para consultar los estados y/o descargar las representaciones gráficas
lo ideal es que sea cada hora.
Página 24 de 34
Código: CE-MU-011
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”.

tipoDocumento varchar(1) TIPO DE DOCUMENTO ELECTRÓNICO.
prefijo varchar(5) PREFIJO DEL DOCUMENTO
consecutivo int(11) 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 Long NÚMERO 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.
fechaRespuestaUltimoEstadoDispapeles Date FECHA EN LA QUE SE PROCESÓ LA FACTURA EN DISPAPELES
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
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 INTE RNOS 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Ó.
fechaRespuestaUltimoEstadoAdquirente Date FECHA EN LA QUE CONTESTÓ EL CLIENTE
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 1 = ERROR; 0 = EXITOSO; 2 = EXITOSO CON NOTIFICACIONES
listaMensajesProceso List<Fel_MensajeProceso> LISTADO CON LOS MENSAJES DE ERROR ASOCIADOS AL DOCUMENTO
10.2 CONSULTAR ESTADO FACTURA POR LOTE

Se recomienda cada hora, aunque depende de la cantidad de documentos emitidos, consultar el lote
mediante el método consultarEstadosFacturaLote. Este método recibe un objeto de tipo
EbFelConsultaFacturaWS, donde el único valor relevante para la consulta es el campo idLote. La consulta
devolverá una lista de objetos tipo EbFelUltimoEstado, con todas las facturas que hacen parte del lote.
Para esta consulta solo se hace obligatorio como parámetro de entrada el campo idLote. La respuesta es
una estructura de lista con los siguientes campos:

tipoDocumento varchar(1) TIPO DE DOCUMENTO ELECTRÓNICO.
prefijo varchar(5) PREFIJO DEL DOCUMENTO
consecutivo int(11) 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 Long NÚMERO DEL LOTE AL QUE PERTENECE LA FACTURA, APLICA SOLO SI LA FACTURACIÓN ES POR LOTE.
Página 25 de 34
Código: CE-MU-011
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.
fechaRespuestaUltimoEstadoDispapeles Date FECHA EN LA QUE SE PROCESÓ LA FACTURA EN DISPAPELES
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
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Ó.
fechaRespuestaUltimoEstadoAdquirente Date FECHA EN LA QUE CONTESTÓ EL CLIENTE
fechaRespuesta Timestamp FECHA Y HORA DE LA RESPUESTA LA CONSULTA
codigoQr text CADENA PARA QUE EL CLIENTE PUEDA ARMAR EL CÓDIGO QR EN SUS REPRESENTACIONES GRÁFICAS.
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 1 = ERROR; 0 = EXITOSO; 2 = EXITOSO CON NOTIFICACIONES
listaMensajesProceso List<Fel_MensajeProceso> LISTADO CON LOS MENSAJES DEL PROCESO ASOCIADOS AL DOCUMENTO
10.3 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
listaMensajesProceso List<Fel_MensajeProceso> LISTADO CON LOS MENSAJES DE ERROR ASOCIADOS AL DOCUMENTO
Página 26 de 34
Código: CE-MU-011
11. MENSAJES DE ERROR

Mensajes globales retornados de manera Síncrona:
CODIGO MENSAJE
10000 ¡Operación exitosa!
10001 Error!, el objeto factura es nulo.
10002 Error!, el campo no puede ser un valor vacío o nulo.
10003 Error!, el valor del campo tiene una longitud diferente a la esperada
10004 Error!, los valores para el campo no son los esperados.
10005 Error!, el campo debe tener un valor mayor a cero.
10006 Error!, el formato del campo e-mail no es válido.
Mensajes detallados:
Procesos de validación y mensajes de error

Código
Validación Mensaje de Error Descripción
ERROR
Mensaje genérico mostrado cuando los datos
Autentificación
50001 Error! no se pudo verificar la autenticidad del cliente.

de autentificación no son válidos o no existen
del cliente
50002 Error! El campo username en el header no puede ser nulo o vacío.

Se presenta cuando el campo indicado no es
50002 Error! El campo password en el header no puede ser nulo o vacío. enviado en el header, o el valor es vacío
50002 Error! El campo token en el header no puede ser nulo o vacío.
10001 Error!, el objeto factura no puede ser nulo
10001 Error!, el objeto producto de la factura no puede ser nulo
10001 Error!, el objeto impuestos de la factura no puede ser nulo
10001 Error!, el objeto consulta no puede ser nulo
10002 Error!, el campo Tokenempresa no puede ser nulo o vacío.
10002 Error!, el campo Prefijo no puede ser nulo o vacío.
10002 Error!, el campo Fecha no puede ser nulo o vacío.
10002 Error!, el campo tipoPersona no puede ser nulo o vacío.
10002 Error!, el campo primerNombre no puede ser nulo o vacío.
10002 Error!, el campo primerApellido no puede ser nulo o vacío.
10002 Error!, el campo razón social no puede ser nulo o vacío. Se presenta si el objeto o campo indicado
esperado no es enviado, es nulo o está
10002 Error!, el campo tipoIdentificacion no puede ser nulo o vacío.
vacío
10002 Error!, el campo numeroIdentificacion no puede ser nulo o vacío.
10002 Error!, el campo AplicaFel no puede ser nulo o vacío.
10002 Error!, el campo email no puede ser nulo o vacío.
10002 Error!, el campo País no puede ser nulo o vacío.
10002 Error!, el campo Departamento no puede ser nulo o vacío.
10002 Error!, el campo Ciudad no puede ser nulo o vacío.
10002 Error!, el campo Dirección no puede ser nulo o vacío.
Validación de datos
10002 Error!, el campo Detalle. Descripción no puede ser nulo o vacío.

10002 Error!, el campo Impuestos.Codigoimpuesto no puede ser nulo o vacío.
Error!, el valor del campo Tokenempresa tiene una longitud diferente a la esperada. Longitud
10003
esperada: 40, longitud recibida: ####
Error!, el valor del campo Moneda tiene una longitud diferente a la esperada. Longitud esperada:
10003
3, longitud recibida: ####
Indica que la longitud del campo señalado es
Error!, el valor del campo tipoPersona tiene una longitud diferente a la esperada. Longitud
10003 mayor a la aprobada, muestra la longitud
esperada: 40, longitud recibida: ####
solicitada y la que se envió realmente
Error!, el valor del campo AplicaFel tiene una longitud diferente a la esperada. Longitud
10003 esperada: 40, longitud recibida: ####
Error!, el valor del campo País tiene una longitud diferente a la esperada. Longitud esperada: 40,
10003
longitud recibida: ####
Error!, los valores para el campo Tipodocumento no son los esperados. Los códigos esperados
10004
son: 1. FACTURA DE VENTA, 2. NOTA CRÉDITO, 3. NOTA DÉBITO. Valor de entrada: ####
Error!, los valores para el campo tipoPersona no son los esperados. Los códigos esperados son: 1.
10004
Persona jurídica, 2. Persona natural. Valor de entrada: ####
Se presenta para campos cuyos valores están
Error!, los valores para el campo Tipoidentificacion no son los esperados. Los códigos esperados
definidos por una lista establecida por la DIAN,
10004 son: 11. Registro civil, 12. Tarjeta de identidad, 13. Cédula de ciudadanía, 21. Tarjeta de
extranjería, 22. Cédula de extranjeria, 31. Nit, 41. Pasaporte. Valor de entrada: #### y el valor que se recibe no pertenece a esta
lista
Error!, los valores para el campo régimen no son los esperados. Los códigos esperados son: 0.
10004
Simplificado, 2. Común. Valor de entrada: ####
Error!, los valores para el campo AplicaFel no son los esperados. Los códigos esperados son: SI,
10004
NO. Valor de entrada: ####
10005 Error!, el campo consecutivo debe tener un valor mayor a cero.
El número enviado en el campo debe ser mayor
10005 Error!, el campo Detalle.Preciototal debe tener un valor mayor o igual a cero.
o igual a 0
10005 Error!, el campo Detalle.Valorunitario debe tener un valor mayor o igual a cero.
Página 27 de 34
Código: CE-MU-011
10005 Error!, el campo Detalle.Preciosinimpuestos debe tener un valor mayor o igual a cero.
10005 Error!, el campo Impuestos.Baseimponible debe tener un valor mayor o igual a cero.
Se espera un formato particular para el campo
10006 Error!, el formato del campo e-mail no es válido.
y no este no es encontrado
Ocurre cuando se pasa un valor diferente a
Error!, Si el porcentaje de impuesto es cero, el campo Impuestos.Valorretenido debe tener un
10007 cero en el impuesto retenido, a pesar del
valor igual a cero (0). Valor actual: ####
impuesto ser cero.
Error!, Debe ingresar el tipo de pago de la compra 'Tipocompra', 1. Pago de contado, 2. Pago a No se ingresa un tipo de pago para la compra,
10008
crédito. en el campo tipocompra
Se presenta cuando el número de factura
10010 Error!, Factura existente! La factura: #### fue ingresada previamente.
ingresado ya ha sido registrado anteriormente
10011 ¡Excepción!, Se presenta un error Con las credenciales: ####
10012 Error!, Credenciales no validas
Error!, No existen rangos de resolución asociados a la empresa o que estén activos!!!. La factura:
10013
####
10014 Error!, Excepción generada por posible valor nulo en el prefijo!!!. La factura: %1$s
10015 Error!, Debe ingresar el tipo de la nota.

Error!, Debe ingresar el CUFE de la factura modificada. Si la factura afectada no es electrónica
10016
colocar N/A.
10017 Error!, Debe ingresar una descripción asociado a la falta de CUFE.
10018 Error!, Debe ingresar la fecha de la factura modificada.
Error!, Debe ingresar el consecutivo de la factura modificada. En este campo se debe concatenar
10019 el prefijo + el valor del consecutivo. Ej. PRUE12345678.
12. 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 rechazo control.
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 las Garantizar que al momento de enviar los datos de la factura a la plataforma tecnológica del proveedor tecnológico DISPAPELES esté completa.
7
facturas y/o notas Revisar que con la transmisión viajen todos los conceptos asociados a la factura para que estos no sean rechazados posteriormente.
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.
Se debe garantizar que la información entregada es integra. Por ejemplo, en el caso de los detalles deben tener la totalidad de los conceptos de
10 INTEGRIDAD DE DATOS
la factura una vez sean entregados o expuestos al proveedor tecnológico para garantizar la integridad.
Página 28 de 34
Código: CE-MU-011
13. 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
14. 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
15. TABLAS
15.1 INCOTERM
CODIGO DESCRIPCION
CFR Costo y flete
CIF Costo, seguro y flete
CIP Flete y seguro pagado hasta
CPT Flete pagado hasta
DAF Entregado en frontera o “a mitad de puente”
DAP Entregado en un punto
DAT Entregado en terminal
DDP Entregado en destino con derechos pagados
DDU Entregado en destino de derechos no pagados
DEQ Entregado en muelle de destino con derechos pagados
DES Entregado sobre buque en puerto de destino
EXW En fábrica
FAS Libre al costado del buque
FCA Libre transportista
FOB Libre a bordo
OTR Otras condiciones de entrega distintas a las anteriores
Página 29 de 34
Código: CE-MU-011
15. 2 IMPUESTOS
IDENTIFICADOR NOMBRE DESCRIPCION

01 IVA Impuesto de Valor Agregado
02 IC Impuesto al Consumo
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 Contribución minoristas (combustibles)
ZZ Nombre de la figura tributaria Otros tributos, tasas, contribuciones y similares
15.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 *
15.4 TIPO PERSONA
CODIGO SIGNIFICADO
1 Persona Jurídica
2 Persona Natural
15.5 REGIMEN FISCAL
CODIGO SIGNIFICADO
04 Régimen Simple
05 Régimen Ordinario
15.6 RESPONSABILIDADES FISCALES
CODIGO SIGNIFICADO
O-06 Ingresos y patrimonio
O-07 Retención en la fuente a título de renta
O-08 Retención timbre nacional
O-09 Retención en la fuente en el impuesto sobre las ventas
O-11 Ventas régimen común
O-12 Ventas régimen simplificado
O-13 Gran contribuyente
O-14 Informante de exógena
Página 30 de 34
Código: CE-MU-011
O-15 Autorretenedor
O-16 Obligación de facturar por ingresos de bienes y/o servicios excluidos
O-17 Profesionales de compra y venta de divisas
O-19 Productor y/o exportador de bienes exentos
O-22 Obligado a cumplir deberes formales a nombre de terceros
O-23 Agente de retención en el impuesto sobre las ventas
O-32 Impuesto Nacional a la Gasolina y al ACPM
O-33 Impuesto Nacional al consumo
O-34 Régimen simplificado impuesto nacional consumo rest y bares
O-36 Establecimiento Permanente
O-37 Obligado a Facturar Electrónicamente Modelo 2242
O-38 Facturación Electrónica Voluntaria Modelo 2242
O-39 Proveedor de Servicios Tecnológicos PST Modelo 2242
O-99 Otro tipo de obligado
R-12-PN Factor PN
R-16-PN Mandatario PN
R-25-PN Agente Interventor PN
R-06-PJ Apoderado especial PJ
R-07-PJ Apoderado general PJ
R-12-PJ Factor PJ
R-16-PJ Mandatario PJ
R-99-PJ Otro tipo de responsable PJ
A-01 Agente de carga internacional
A-02 Agente marítimo
A-03 Almacén general de depósito
A-04 Comercializadora internacional (C.I.)
A-05 Comerciante de la zona aduanera especial de Inírida, Puerto Carreño, Cumaribo y Primavera
A-06 Comerciantes de la zona de régimen aduanero especial de Leticia
A-07 Comerciantes de la zona de régimen aduanero especial de Maicao, Uribia y Manaure
15.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 Bancario
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
17 Concentración de la demanda en efectivo / Desembolso Crédito (CCD) 61 Nota promisoria firmada por el acreedor
18 Concentración de la demanda en efectivo / Desembolso (CCD) Débito 62 Nota promisoria firmada por el acreedor, avalada por el banco
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 74 Retiro de nota por el acreedor sobre un banco
26 Cheque local 75 Retiro de nota por el acreedor, avalada por otro banco
27 Débito pago Negocio Corporativo (CTP) 76 Retiro de nota por el acreedor sobre un banco avalada por un tercero
28 Crédito Negocio Intercambio Corporativo (CTX) 77 Retiro de nota por el acreedor sobre un tercero
29 Débito Negocio Intercambio Corporativo (CTX) 78 Retiro de nota por el acreedor sobre un tercero avalada por un banco
30 Transferencia Crédito 91 Nota bancaria transferible
31 Transferencia Débito 92 Cheque local transferible
32 Concentración efectivo / Desembolso crédito plus (CCD+) 93 Giro referenciado
33 Concentración efectivo / Desembolso débito plus (CCD+) 94 Giro urgente
34 Pago y deposito pre acordado (PPD) 95 Giro formato abierto
35 Concentración efectivo ahorros / Desembolso crédito (CCD) 96 Método de pago solicitado no usado
36 Concentración efectivo ahorros / Desembolso débito (CCD) 97 Clearing entre Partners
37 Pago Negocio Corporativo Ahorros Crédito (CTP) ZZZ Acuerdo mutuo
38 Pago Negocio Corporativo Ahorros Débito (CTP)
Página 31 de 34
Código: CE-MU-011
16. 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.
17. 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.
Página 32 de 34
Código: CE-MU-011
18. CAMBIOS APLICADOS POR CAMBIO DE MODELO DE LA DIAN

A continuación, se describen todos los campos del modelo anterior que han sufrido cambios debido al
nuevo modelo de validación previa de la Dian.
18.1 CABEZA DE FACTURA
NOMBRE DESCRIPCIÓN ¿CAMBIÓ?
TIPO DE DOCUMENTO --1. FACTURA DE VENTA, 2. NOTA CRÉDITO, 3. NOTA DÉBITO 4. FACTURA DE EXPORTACIÓN, 5. SI, SE AGREGA LA OPCIÓN 6
tipodocumento FACTURA DE CONTINGENCIA, 6. FACTURA DE IMPORTANCIÓN. SE AGREGA UNA NUEVA OPCIÓN, FACTURAS DE PARA FACTURAS DE
IMPORTACIÓN. IMPORTACIÓN
VERIFICA EL NUMERO DE LOS DETALLES, ESTE ES UN CONTROL DE LA DIAN PARA COMPROBAR QUE LOS SERVICIOS Y
CantidadLineas SI, ESTE CAMPO ES NUEVO
PRODUCTOS VAN COMPLETOS.
Ordencompra ORDEN DE COMPRA ASOCIADA A LA FACTURA SI. SE QUITAN LOS CAMPOS
fechaemisionordencompra FECHA DE CREACIÓN DE LA ORDEN DE COMPRA DE LA ESTRUCTURA
PRINCIPAL PARA PASAR A LA
numeroaceptacioninterno NUMERO DE ACEPTACIÓN, CODIGO INTERNO DEL COMPRADOR.
LISTA DE ORDEN DE COMPRA
SI. SE QUITA PARA PASAR A
Mediopago VER TABLA MEDIOS DE PAGO, SECCIÓN TABLAS UNA LISTA Y CAMBIAN LA
TABLA DE VALORES
Descuento Valor del descuento SI. PASAN A UNA LISTA PARA
MANEJAR VARIOS
porcentajedescuento Porcentaje del descuento CONCEPTOS DE DESCUENTO.
Pagoanticipado VALOR DE PAGO ANTICIPADO A LA FACTURA SI. ESTE CAMPO ES NUEVO
SI. PASA A UNA LISTA PARA
Descripción NOTA --INFORMACIÓN ADICIONAL: TEXTO LIBRE, RELATIVO AL DOCUMENTO.
MANEJAR VARIAS NOTAS.
Tipopersona TIPO DE PERSONA, 1. PERSONA JURÍDICA, 2. PERSONA NATURAL
RAZÓN SOCIAL, APLICA PARA TIPO DE PERSONA JURÍDICA. ES OBLIGATORIO AGREGAR EL NOMBRE DE LA EMPRESA SI EL
Razonsocial CLIENTE ES UNA EMPRESA.
Primernombre PRIMER NOMBRE DE LA PERSONA, APLICA SI EL TIPO DE PERSONA ES PERSONA NATURAL Y EN ESTE CASO ES OBLIGATORIO
Segundonombre SEGUNDO NOMBRE DE LA PERSONA, APLICA SI EL TIPO DE PERSONA ES PERSONA NATURAL
PRIMER APELLIDO DE LA PERSONA, APLICA SI EL TIPO DE PERSONA ES PERSONA NATURAL, EN CUYO CASO DEBE SER
Primerapellido
OBLIGATORIO. SI. ESTOS CAMPOS PASAN A
Segundoapellido SEGUNDO APELLIDO DE LA PERSONA, APLICA SI EL TIPO DE PERSONA ES PERSONA NATURAL. LA ESTRUCTURA DE LISTA DE
Tipoidentificacion VER NUEVA TABLA DE TIPO DE IDENTIFICACIÓN, SECCIÓN TABLAS. CLIENTES, YA NO ESTARÁN EN
numeroidentificacion NÚMERO DEL DOCUMENTO DE IDENTIFICACIÓN SIN DIGITO DE VERIICACION EN CASO DEL NIT LA RAIZ DE LA ESTRUCTURA
Régimen RÉGIMEN DEL CLIENTE, 0. SIMPLIFICADO, 2. COMÚN ANTERIOR. CON ESTO SE
País. PAIS CLIENTE EN ESTÁNDAR ISO 3116-1, ES DECIR COLOMBIA "CO" BUSCA MANEJAR MAS DE UN
Departamento DEPARTAMENTO DE RESIDENCIA DEL CLIENTE ADQUIRENTE POR FACTURA.
Ciudad. CIUDAD DE RESIDENCIA DEL CLIENTE
Bariolocalidad BARRIO DEL CLIENTE
Dirección DIRECCIÓN DEL CLIENTE
CORREO ELECTRÓNICO DEL CLIENTE. ESTE CAMPO SE VUELVE OBLIGATORIO SI EL CAMPO APLICAFEL ES “SI” Y
Email
ENVIOPOREMAILPLATAFORMA ES EMAIL
Teléfono TELÉFONO DEL CLIENTE
descripcioncentrocostos SI. CAMPO NUEVO
Trm_alterna Aplica para facturas de exportación SI. CAMPO NUEVO
clasificacionCliente
condicionPagoReferencia
documentoEmitidoEn
horaEntregaProgramada
despachadoANombre SI. SE QUITAN ESTOS
CAMPOS Y PASAN A UNA
despachadoAObservacion CAMPOS DESCRIPTIVOS SOBRE LA ENTREGA DE LA FACTURA
ESTRUCTURA DE LISTA DE
despachadoAZonaDespacho
ENTREGA.
despachadoAObservacionLugar
despachadoATelefono
despachadoACiudad
despachadoADireccion
campoAdicional1 Valor para información adicional no contemplada inicialmente
campoAdicional4 Valor para información adicional no contemplada inicialmente SI. DESAPARECEN LOS
campoAdicional5 Valor para información adicional no contemplada inicialmente CAMPOS ADICIONALES
campoAdicional6 Valor para información adicional no contemplada inicialmente DEBIDO A QUE TODA LA
campoAdicional7 Valor para información adicional no contemplada inicialmente INFORMACIÓN DEL PDF DEBE
ESTAR EN EL XML. Para esto
cada valor debe tener
descripción. Por esto se usará
campoAdicional10 Valor para información adicional no contemplada inicialmente la estructura lista de campos
campoAdicional11 Valor para información adicional no contemplada inicialmente adicionales.
Página 33 de 34
Código: CE-MU-011

Codigodebarras1 Cadena para la generación del código de barras1, ver anexo Especificaciones para el envío del código de barras de recaudo
SI. Estos campos desaparecen
y se manejarán en estructura
de lista para código de barras
listaDetalle Lista que almacena los detalles de productos y/o servicios. Si. Se agregan nuevos valores
listaMandantes Lista de los mandantes asociados a la factura Si. Desaparecen y
listaTerminos Lista de los términos del contrato para mandantes Pasa al detalle de la factura
Contiene un listado de las ordenes de compras asociadas a una factura. Una opción es manejar la inicial separando todo por
listaordendecompra
punto y coma”;”
Listadedescuentos Listado de descuentos asociados a la factura
Listadecargos Listado de cargos asociados a la factura
SI. LISTAS NUEVAS
Listacodigodebarra Listado de los códigos de barras
Listadatosdeentrega
Listadescripciones
Listamediopago Listado de los medios de pago
18.2 DETALLE DE LA FACTURA
NOMBRE DESCRIPCIÓN ¿CAMBIÓ?
Unidad de medida que maneja el facturador. Se recomienda usar los valores descritos en la tabla 5.4.1 del documento adjunto
SI. Se recomienda usar
Unidadmedida Anexo%20técnico%20de%20factura%20electrónica.pdf. El uso de este campo inicialmente no será obligatorio, pero de seguro lo
valores de la tabla
será.
descuento Valor del descuento Si, pasan a una estructura de
lista para poder asociar varios
porcentajeDescuento Porcentaje del descuento
descuentos
campoAdicional4 Valor para información adicional no contemplada inicialmente Se eliminan. Se deberá usar
campoAdicional5 Valor para información adicional no contemplada inicialmente la estructura nombre, valor
CampoAdicional6 Valor para información adicional no contemplada inicialmente en la lista de campos
CampoAdicional7 Valor para información adicional no contemplada inicialmente adicionales
CampoAdicional8 Valor para información adicional no contemplada inicialmente
Página 34 de 34

Manual de Integraciones FASE 2 - DISPAPELES

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

Manual de Integraciones FASE 2 - DISPAPELES

Cargado por

Copyright:

Formatos disponibles

Código: CE-MU-011

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

13. CONEXIÓN SOAP AMBIENTE PRUEBAS ........................................................................ 29

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 web service

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

listaImpuestos List<Fel_Impuesto> SI SI LISTA DE LOS IMPUESTOS ASOCIADOS A LA FACTURA

7.2 DETALLE DE LA FACTURA

7.3 ADQUIRENTES “PERSONA NATURAL O JURIDICA QUE COMPRA UN BIEN O UN SERVICIO”

7.4 FEEL PAGOS

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

7.6 FACTURA(S)A MODIFICAR EN NOTA

Importante aclarar que, aunque los campos consecutivofacturamodificada, cufefacturamodificada y

7.8 LISTA DE CAMPOS ADICIONALES

7.9 LISTA ORDEN DE COMPRA

7.10 LISTA DE CARGOS

7.11 LISTA DE DESCUENTOS

NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN

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.

EJ: 20181002 -> octubre 02 de 2018

3. Lista de campos de cabecera

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

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

7.13 LISTA DATOS DE ENTREGA

NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN

7.14 LISTADO MEDIOS DE PAGO

7.15 LISTA DE DOCUMENTOS ADJUNTOS

8. CÓDIGOS DE RESPUESTA DE ESTADOS

8.1 ESTADOS DISPAPELES

ESTADOS MANEJADOS POR DISPAPELES

Código Nombre estado Descripción estado

8.2 ESTADOS DIAN

Resultado General de la transacción

8.3 ESTADOS ENVÍO EMAIL

Código Nombre estado Descripción estado

8.4 ESTADOS ADQUIRENTES

Código Nombre estado Descripción estado

9. MÉTODOS DE ENVÍO DE DATOS AL WEB SERVICE DE DISPAPELES

9.1 ENVIAR DOCUMENTO

Objeto de respuesta “Fel_RespuestaEnvio”:

CAMPO TIPO DE DATOS DESCRIPCION

Imagen 7 Flujo para enviar documento

agregar el CUFE y el QR a su formato actual entonces no se deberá consultar este método.