Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Manual de Integraciones FASE 2 - DISPAPELES PDF
Manual de Integraciones FASE 2 - DISPAPELES PDF
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
Página 3 de 34
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
Página 6 de 34
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
Página 7 de 34
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
Página 8 de 34
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
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:
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.
Página 9 de 34
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
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.
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
Página 12 de 34
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
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.
Esta estructura que muestra todos los campos asociados al pago de la factura.
OBLIGATORIO
NOMBRE TIPO DE DATOS DESCRIPCIÓN
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
OBLIGATORIO
NOMBRE TIPO DE DATOS DESCRIPCIÓN
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.
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
NOMBRE TIPO DE DATOS DIAN DESCRIPCIÓN
PT
ordencompra varchar(40) NO NO ORDEN DE COMPRA ASOCIADA A LA FACTURA
fechaemisionordencompra Date NO NO FECHA DE CREACIÓN DE LA ORDEN DE COMPRA
numeroaceptacioninterno varchar(40) NO NO NUMERO DE ACEPTACIÓN, CODIGO INTERNO DEL COMPRADOR.
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
NOMBRE TIPO DE DATOS DESCRIPCIÓN
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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
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
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.
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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
Esta estructura permite asociar varios documentos como arreglo de bytes a una factura para que de forma
automática se carguen al sistema.
NOMBRE TIPO DE DATOS OBLIGATORIO DESCRIPCIÓN
DIAN PT
nombreConExtension varchar(240) NO NO NOMBRE DEL ARCHIVO A ADJUNTAR
contenidoDelDoc byte [] NO NO CONTENIDO DEL ARCHIVO EN ARREGLO DE BYTE’S
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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:
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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.
ESTADOS EMAIL
ESTADOS ADQUIRENTE
Página 20 de 34
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
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.
Página 21 de 34
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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”.
Página 23 de 34
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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:
Página 25 de 34
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
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
Página 26 de 34
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
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:
Página 27 de 34
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
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
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
15. 2 IMPUESTOS
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 *
CODIGO SIGNIFICADO
1 Persona Jurídica
2 Persona Natural
CODIGO SIGNIFICADO
04 Régimen Simple
05 Régimen Ordinario
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
DEFINICIÓN DE ESTRUCTURA Versión No.: 1
DE DATOS PARA INTEGRACIÓN Fecha Aprobación: 17 / M a y / 2 0 1 9
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
Página 31 de 34
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
Página 32 de 34
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
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
campoAdicional2 Valor para información adicional no contemplada inicialmente
campoAdicional3 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
campoAdicional8 Valor para información adicional no contemplada inicialmente
cada valor debe tener
campoAdicional9 Valor para información adicional no contemplada inicialmente
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.
campoAdicional12 Valor para información adicional no contemplada inicialmente
campoAdicional13 Valor para información adicional no contemplada inicialmente
campoAdicional14 Valor para información adicional no contemplada inicialmente
Página 33 de 34
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
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
campoAdicional1 Valor para información adicional no contemplada inicialmente
campoAdicional2 Valor para información adicional no contemplada inicialmente
campoAdicional3 Valor para información adicional no contemplada inicialmente
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
CampoAdicional9 Valor para información adicional no contemplada inicialmente
CampoAdicional10 Valor para información adicional no contemplada inicialmente
Página 34 de 34