Validar con soporte Webservice el tipo de conexión (Nativa, Integrador Facturatech,

DLL, WS Intermediario) que se esté usando para dar el seguimiento correcto.

1. Se agiliza la recuperación de documentos (PDF, CUFE, XML_DIAN y QR).

2. La definición de retenciones a nivel Item está permitida con el uso de los

nodos TII y IIM.
El uso de las retenciones a nivel Item requiere de manera obligatoria que se
declaren a nivel global en los nodos TIM e IMP, ya que de éstos se tomarán
los valores referentes a la retención.

3. Para Notas crédito y débito se podrá hacer uso de los nodos CDN_1 y
CDN_2 para definir un código valido y una descripción del motivo de la nota
que será visible en la representación gráfica (PDF).

4. Definición de numeración y prefijo para Notas débito, Notas crédito y

facturas de contingencia.
Será necesario definir un prefijo para estos tipos de documentos, evitar el
uso de prefijos SETT, TCNC y TCND en ambientes productivos, ya que estos
se utilizan para realizar pruebas con consumo y pruebas Dummy.
No será permitido el uso de prefijos con numerales al final de estos, por
Ejemplos: “FAC1”, “FAC36”, “NC1”, etc.
En el caso de necesitar un numeral dentro del prefijo, podrá colocarlo al
inicio o en intermedio del mismo. Ejemplos: “A1B”, “G903G”, “26F”.

5. La longitud del nodo ILA_2 se extendió para admitir más de 12 caracteres

alfanuméricos, en específico para clientes extranjeros a los que se les
generan facturas de exportación.
Obligatorio enviar el nodo ILA_4 vacío sin espacios. El tipo de documento
tiene que ser 42 persona extrajera.
Y se necesita quitar el nodo ADQ_22 para evitar notificaciones.

6. En el caso extremo y especial en que se necesite definir una base para un

impuesto iva diferente a la base del producto, se podrá realizar siempre y
cuando ésta concuerde con el porcentaje aplicado a la base en los demás
nodos IIM y TII (Es decir, que cuadren los montos calculados).

Actualizado:15/06/2021
 7. La validación del nodo ADQ_11 y ADQ_23 con respecto a coherencia de
datos, es decir que el departamento y municipio tienen que contenerse uno
en el otro.

8. La validación de la existencia de los nodos ADQ_13 , ADQ_15, ADQ_19,

ADQ_21, es decir que no estén vacíos.

9. El código postal del adquiriente ADQ_14 y DFE_3 ya no será mandatorio,

por lo cual podría omitirse o quedar vacío.

10. Recuperación de documentos con los mensajes “Attached Document y

Documento no encontrado”.
Bastará con enviar nuevamente la factura por parte del ERP para poder
recuperar correctamente el documento (PDF, CUFE, XML_DIAN).

11. Para los nodos CDA_2 y CDE_2 referentes a “Nombre y Cargo de la Persona
de Contacto”, en caso de mandar vacíos no se permiten espacios, Ejemplo:
“<CDA_2> </CDA_2>”.
La forma correcta de definirlo vacío seria: “<CDA_2></CDA_2>”.

12. El nodo ADQ_4 y EMI_4 correspondientes a “Régimen al que pertenece”

pasa a ser opcional.

13. Validación de nodo ENC_10 con respecto a moneda, es decir, si ENC_10 es

diferente a COP se entiende que es una factura de exportación y se iniciará
la validación de nodos necesarios para factura de exportación, entre ellos el
nodo TDC.

14. Se retoman los nodos TDE, ITT y DFT como subnodos del nodo IEN para
facturas que reportan flete

Representación gráfica representando información de subnodos TDE, ITT y DFT

Actualizado:15/06/2021
IEN: Información de la Entrega

Composición: 22 Sub nodos.

Mandatorios: IEN_1, 4, 5, 6, 8, 9, 12, 22, 23, 24
Opcionales: IEN_3, 7, 10, 11,
Dependientes: Ninguno
Eliminados por Versión UBL2.1: IEN_13, 14, 15, 16, 17, 18, 19, 20, 21
Nodos complementarios: TDE, ITT, DFT

IEN_1: Dirección del lugar de entrega.

IEN _2: Código del Departamento de Entrega.
IEN _4: Ciudad del lugar de entrega.
IEN _5: Código postal del lugar de entrega.
IEN _6: Código País del lugar de entrega. (Ver tabla 1)
IEN _8: Fecha efectiva de salida de los bienes.
Nota: No puede ser anterior a la fecha de emisión.
IEN _9: Hora efectiva de salida de los bienes. (HH:MM:SS-05:00)
Nota: La hora definida en el nodo IEN_9 tiene que ir con respecto a el horario UTC de Colombia y no
meramente al horario actual de Colombia.
IEN _12: Código del municipio.
IEN _22: Nombre del Departamento del lugar de entrega.
IEN _23: Nombre del País de Entrega.
IEN _24: Identificador del lenguaje utilizado en el nombre del país. (Ver tabla 25)

Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios. En el caso de los nodos
opcionales, dependientes y tablas, podrá revisarlos en su documento “Factura Electrónica Colombia - Insumo
Simplificado - 2021_JUNIO_02.xlsx”

Actualizado:15/06/2021
 Nodos complementarios de Nodo IEN

TDE: Datos con Información Sobre La Empresa De Transporte

Composición: 10 Sub nodos.

Mandatorios: TDE_1,2,3,4,5,6,7,8,9,10
Opcionales: Ninguno
Dependientes: Ninguno
Nodos complementarios: Ninguno

TDE_1: Nombre comercial de la empresa de transporte.

TDE _2: Código identificador del país sobre la dirección de la empresa de
transporte. (Ver tabla 2)
TDE _4: Código Postal. (Ver tabla 39)
TDE _5: Código del municipio sobre la dirección de la empresa de transporte. (Ver
tabla 35)
TDE _6: Nombre del municipio. (Ver tabla 35)
TDE _8: Nombre del país sobre la dirección de la empresa de transporte. (Ver tabla
1)
TDE _9: Identificador del lenguaje utilizado en el nombre del país. (Ver tabla 25)
Nota: Preferible el uso de “es”
TDE _10: Dirección de la empresa de transporte

Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios. En el caso de los nodos
opcionales, dependientes y tablas, podrá revisarlos en su documento “Factura Electrónica Colombia - Insumo
Simplificado - 2021_JUNIO_02.xlsx”

Actualizado:15/06/2021
ITT: Datos con Información Tributaria del Transportador

Composición: 6 Sub nodos.

Mandatorios: ITT_1,2,3,4,5
Opcionales: ITT_6
Dependientes: Ninguno
Nodos complementarios: Ninguno

ITT_1: Nombre o Razón Social de la persona o entidad.

ITT_2: Obligaciones del transportador. (Ver tabla 36)
ITT_3: Régimen al que pertenece el transportador. (Ver tabla 2)
ITT_4: Identificador del transportador.
ITT_5: Tipo de documento de identificación. (Ver tabla 3)

Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios. En el caso de los nodos
opcionales, dependientes y tablas, podrá revisarlos en su documento “Factura Electrónica Colombia - Insumo
Simplificado - 2021_JUNIO_02.xlsx”

Actualizado:15/06/2021
DFT: Dirección Fiscal del Transportador

Composición: 11 Sub nodos.

Mandatorios: DFT_1,2,3,4,5,6,7,8,9,10,11
Opcionales: Ninguno
Dependientes: Ninguno
Nodos complementarios: Ninguno

DFT_1: Identificador del tributo del transportador. (Ver tabla 11)

DFT _2: Nombre del tributo del transportador. (Ver tabla 11)
DFT _3: Código identificador del país de la dirección fiscal del transportador. (Ver tabla 1)
DFT _4: Código del Departamento de la dirección fiscal del transportador. (Ver tabla 34)
DFT _5: Código Postal de la dirección fiscal del transportador. (Ver tabla 39)
DFT_6: Código del municipio de la dirección fiscal del transportador. (Ver tabla 35)
DFT _7: Nombre del municipio/ciudad de la dirección fiscal del transportador. (Ver tabla
35)
DFT _8: Nombre del Departamento de la dirección fiscal del transportador. (Ver
tabla 34)
DFT _9: Nombre del país sobre la dirección fiscal del transportador. (Ver tabla 1)
DFT _10: Identificador del lenguaje utilizado en el nombre del país. (Ver tabla 25)
Nota: Preferible el uso de “es”
DFT _11: Dirección fiscal del transportador

Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios. En el caso de los nodos
opcionales, dependientes y tablas, podrá revisarlos en su documento “Factura Electrónica Colombia - Insumo
Simplificado - 2021_JUNIO_02.xlsx”

Actualizado:15/06/2021
 Orden Jerárquico dentro de la estructura simplificada.

Este nodo se colocará entre los nodos DRF y MEP, como se muestra a
continuación.
Los subnodos de este nodo se contendrán y colocarán entre los nodos de apertura
y cierre del nodo IEN en el siguiente orden TDE, ITT, DFT.

<DRF>
Nodos Hijos
</DRF>
<IEN>
Nodos Hijos
<TDE>
Nodos Hijos
</TDE>
<ITT>
Nodos Hijos
</ITT>
<DFT>
Nodos Hijos
</DFT>
</IEN>
<MEP>
Nodos Hijos
</MEP>

Actualizado:15/06/2021
 Orden dentro de la estructura simplificada.
<IEN>
<IEN_1>AV. Principal 9 Sur Col. Marques, Antioquia</IEN_1>
<IEN_2>05</IEN_2>
<IEN_4>MEDELLÍN</IEN_4>
<IEN_5>110111</IEN_5>
<IEN_6>CO</IEN_6>
<IEN_8>2020-12-10</IEN_8>
<IEN_9>[Link]-05:00</IEN_9>
<IEN_12>05001</IEN_12>
<IEN_22>Antioquia</IEN_22>
<IEN_23>Colombia</IEN_23>
<IEN_24>es</IEN_24>
<TDE>
<TDE_1>DHL S.A.S</TDE_1>
<TDE_2>CO</TDE_2>
<TDE_3>05</TDE_3>
<TDE_4>110111</TDE_4>
<TDE_5>05001</TDE_5>
<TDE_6>MEDELLÍN</TDE_6>
<TDE_7>Antioquia</TDE_7>
<TDE_8>Colombia</TDE_8>
<TDE_9>es</TDE_9>
<TDE_10>Av. Mayor esperanza Num. 45</TDE_10>
</TDE>
<ITT>
<ITT_1>DHL S.A.S</ITT_1>
<ITT_2>R-99-PN</ITT_2>
<ITT_3>48</ITT_3>
<ITT_4>15152200</ITT_4>
<ITT_5>31</ITT_5>
<ITT_6>1</ITT_6>
</ITT>
<DFT>
<DFT_1>01</DFT_1>
<DFT_2>IVA</DFT_2>
<DFT_3>CO</DFT_3>
<DFT_4>05</DFT_4>
<DFT_5>110111</DFT_5>
<DFT_6>55001</DFT_6>
<DFT_7>MEDELLÍN</DFT_7>
<DFT_8>Antioquia</DFT_8>
<DFT_9>Colombia</DFT_9>
<DFT_10>es</DFT_10>
<DFT_11>Av. Nueva esperanza Num. 45</DFT_11>
</DFT>
</IEN>

Actualizado:15/06/2021
WS Nativo
Si tu ERP consume WS de manera directa mediante un endpoint que el desarrollador del ERP coloca dentro de su
codificación para poder conectarse con el WS de Facturatech. Entonces los endpoint serán los siguiente.

Productivo: [Link]
Demo: [Link]

Integrador
Si tu consumo del WS lo realizas mediante el integrador de Facturatech, lo único que necesitas hacer es descargar la última
actualización de éste en el siguiente enlace.

Descarga: [Link]

DLL
Si tu ERP consume WS mediante una librería para conectarse con el endpoint, lo único que necesitas hacer es buscar la
actualización en el enlace mencionado a continuación y verificar el ejemplo de conexión correspondiente al lenguaje de
programación sobre el cual esta implementado tu ERP.
Generalmente los lenguajes que hacen uso de esta librería son (.net, visual fox pro, visual basic 6, C#).

Productivo y Demo: [Link]

En el caso de necesitar ayuda con la conexión, se adjuntan ejemplos de conexiones con los lenguajes (.net, visual basic 6,
C#) en el siguiente enlace.

C#: [Link]
.Net: [Link]
VB6: [Link]

WS Intermediario
Si tu ERP consume WS mediante WS intermedio (endpoint) que el desarrollador del ERP coloca dentro de su codificación
para poder conectarse con el WS de Facturatech. Entonces los endpoint serán los siguiente.
Generalmente los lenguajes que hacen uso de este servicio son (.net, Java, visual basic 6, C#).

Productivo: [Link]

Demo: [Link]

En caso de continuar con dudas después de haber revisado el apartado de recomendaciones, favor de comunicarse con
Soporte Webservice a soportews@[Link] o a la Opción 3 de las líneas telefónicas de Facturatech para aclarar
sus dudas.

Actualizado:15/06/2021