Summary

This document provides a detailed explanation of the basic structure of a sales invoice, focusing on the essential nodes and their hierarchy within an XML format. It emphasizes the importance of maintaining proper node order in the document structure to prevent errors in generating the sales invoice. The document is a technical guide for creating and understanding sales invoices.

Full Transcript

Para crear la estructura básica de una factura, necesitamos de algunos nodos en específico, los cuales nos ayudaran a establecer los valores primordiales sobre la factura que se realiza. Es importante mantener y respetar el orden de cada nodo dentro de la estructura, ya que de lo contrario cualquier...

Para crear la estructura básica de una factura, necesitamos de algunos nodos en específico, los cuales nos ayudaran a establecer los valores primordiales sobre la factura que se realiza. Es importante mantener y respetar el orden de cada nodo dentro de la estructura, ya que de lo contrario cualquier nodo mal colocado o definido repercutirá en una respuesta de error de estructura. Los nodos principales se enlistan a continuación en orden descendente. Factura ENC EMI o TAC o DFE o ICC o CDE o GTE ADQ o TCR o ILA o DFA o ICR o CDA o GTA TOT DRF MEP ITE o IAE Algunos de estos nodos contienen nodos complementarios que de igual manera son imprescindibles dentro de la estructura del nodo principal (El caso de los nodos EMI, ADQ y ITE). Actualizado: 19/01/2024 Cada nodo dentro de la estructura XML_SIMPLIFICADA se expresa con un nodo de apertura y uno de cierre es decir “” y “” los cuales nos ayudan a delimitar el inicio y fin del nodo que se está estableciendo. De esta manera la estructura XML_SIMPLIFICADA quedaría de la siguiente forma Actualizado: 19/01/2024 Cada nodo padre define o contiene n subnodos hijos, en los cuales se definirán los valores correspondientes a cada valor que se denota en la factura. Para efectos de ejemplo tomaremos el nodo ENC. Nota Importante: los nodos mencionados aquí, son los principales y más básicos para que el cliente pueda realizar una factura básica, por este motivo no se hará énfasis en los demás nodos en este capítulo, pero se retomaran en los módulos siguientes. Cada nodo padre contiene información correspondiente a la factura. Información que se explicara a continuación. FACTURA/NOTA: Nodo principal de apertura del documento Actualizado: 19/01/2024 ENC: Nodo correspondiente al encabezado del documento Composición: 20 Sub nodos. Mandatorios: ENC_1,2,3,4,5,6,9,10,15,20,21 Opcionales: ENC_11,12,13,14,16,17,18,19,22 Dependientes: ENC_12 Eliminados por Versión 1.9 : ENC_7,8 Nodos complementarios: Ninguno ENC_1: Identificador de tipo de documento. (NC, ND, INVOIC) ENC_2: NIT Emisor ENC_3: NIT Adquiriente ENC_4: Versión del esquema UBL (UBL 2.1) ENC_5: Versión del formato del documento (DIAN 2.1) ENC_6: Prefijo (Obligatorio) + Folio Nota: Para consumo de WS el prefijo es obligatorio y el prefijo por si solo no tiene que contener números al final de este por que puede ocasionar problema al momento de colocar el prefijo+ el folio. ENC_9: Tipo de Factura (01,02,03,04,91,92) ENC_10: Tipo de moneda (Tabla 13) ENC_15: Numero de Productos Global ENC_20: Ambiente (Prod:1/Demo:2) ENC_21: Tipo de Operación (Tabla 38) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 EMI: Información del Emisor Composición: 22 Sub nodos. Mandatorios: EMI_1,2,3,6,7,10,11,13,15,19,22,23,24 Opcionales: EMI _5,7,14,16,17,21,25 Dependientes: EMI _8,9 Eliminados: EMI _4,12,18,20 Nodos complementarios: TAC, DFE, ICC, CDE, GTE EMI_1: Código de Tipo de Persona (Jurídica/Natural -Tabla 20) EMI_2: NIT del emisor Nota: Se validará la autorización del NIT para poder facturar electrónicamente. Y debe corresponder con el definido en el RUT EMI_3: Código de Documento de Identificación (31-NIT-Tabla 3) Nota: Para emisor es obligatorio que este código sea 31 EMI_6: Razón Social de la empresa Nota: Nombre ó Razón social debe corresponder con el definido en el NIT EMI_7: Nombre o Razón social del emisor EMI_10: Dirección EMI_11: Código de Departamento (Tabla 34) EMI_13: Nombre de la Ciudad/Municipio (Tabla 35) EMI_15: Código del País (Tabla 1) EMI_19: Nombre del Departamento (Tabla 34) EMI_22: Digito Verificador EMI_23: Código del Municipio (Tabla 35) EMI_24: Nombre registrado en RUT Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 Nodos complementarios de Nodo EMI TAC: Información Tributaria, Aduanera y Cambiaria Composición: 11 Sub nodos. Mandatorios: TAC_1 Opcionales: TAC _2,3,4,5,6,7,8,9,10,11 Dependientes: Ninguno Nodos complementarios: Ninguno TAC_1: Obligaciones del Contribuyente Nota: Los códigos validos O-13, O-15, O-23, O-47, R-99-PN listados a continuación. Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 DFE: Información del Emisor Electrónico del Documento Composición: 8 Sub nodos. Mandatorios: DFE_1,2,3, 4,5,6,7,8 Opcionales: Ninguno Dependientes: Ninguno Nodos complementarios: Ninguno DFE_1: Código del Municipio (Tabla 35) DFE_2: Código del Departamento (Tabla 34) DFE_3: Código del País (Tabla 1) DFE_4: Código Postal (Tabla 39) DFE_5: Nombre del País (Tabla 1) DFE_6: Nombre del Departamento (Tabla 34) DFE_7: Nombre de la Ciudad (Tabla 35) DFE_8: Campo para Texto Libre ICC: Información del Emisor Electrónico del Documento Composición: 8 Sub nodos. Mandatorios: ICC_1,9 Opcionales: ICC_2,3,4,5,6,7 Dependientes: ICC_1,9(Solo si es persona Jurídica) Nodos complementarios: Ninguno ICC_1: Número de Matricula Mercantil ICC_9: Prefijo Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 CDE: Información del Emisor Electrónico del Documento Composición: 6 Sub nodos. Mandatorios: CDE_1,2,3,4 Opcionales: CDE_5,6 Dependientes: Ninguno Nodos complementarios: Ninguno CDE_1: Tipo de contacto (1-Persona de Contacto,2-Despacho ,3-Contabilidad ,4- Ventas) CDE_2: Nombre y Cargo de la Persona de Contacto CDE_3: Teléfono de la Persona de Contacto CDE_4: Correo Electrónico GTE: Información del Emisor Electrónico del Documento Composición: 2 Sub nodos. Mandatorios: GTE_1,2 Opcionales: Ninguno Dependientes: Ninguno Nodos complementarios: Ninguno GTE_1: Identificador del Tributo (Tabla 11) GTE_2: Nombre del Tributo (Tabla 11) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 ADQ: Información del Adquiriente Composición: 26 Sub nodos. Mandatorios: ADQ_1,2,3,6 Opcionales: ADQ _5,7,9,10,14 ,16,24 Dependientes: ADQ _7,8,9,11,13,15,19,21,22,23,25,26 Eliminados: ADQ_4,17,18,20 Nodos complementarios: TCR, ILA, DFA, ICR, CDA, GTA ADQ_1: Tipo de Identificación (Tabla 20) Nota: Para personas naturales (2) al definir ADQ_1=2 se necesitará definir ADQ_8 y 9 y ADQ_24 ADQ_2: NIT del Adquiriente ADQ_3: Tipo de documento de Identificación (Tabla 3) Nota: Para adquiriente este valor puede ser cualquiera de los valores de la tabla 3 mencionada. ADQ_6: Razón Social* ADQ_7: Nombre Comercial* ADQ_10: Dirección del Adquiriente Nota: La definición de este nodo condiciona el requerimiento de los nodos ADQ_11,13,15,19,21,23. ADQ_11: Código del Departamento (Tabla 34) ADQ_13: Nombre de la Ciudad (Tabla 35) ADQ_14: Código Postal (Tabla 39) ADQ_15: Código del País (Tabla 1) ADQ_19: Nombre del Departamento (Tabla 34) ADQ_21: Nombre del País (Tabla 1) ADQ_22: Digito de Verificación ADQ_23: Código del Municipio (Tabla 35) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 Nodos complementarios de Nodo ADQ TCR: Información del Tributaria Composición: 11 Sub nodos. Mandatorios: TCR_1 Opcionales: TCR _2,3,4,5,6,7,8,9,10,11 Dependientes: Ninguno Nodos complementarios: Ninguno TCR_1: Información Tributaria Nota: Los códigos validos O-13, O-15, O-23, O-47, R-99-PN listados a continuación. ILA: Grupo de Información Legal del Adquiriente Composición: 4 Sub nodos. Mandatorios: ILA_1,2,3 Opcionales: Ninguno Dependientes: ILA_4 Nodos complementarios: Ninguno ILA_1: Nombre registrado en el RUT (Razón Social) ILA _2: Identificación del Adquiriente ILA _3: Tipo de Identificación fiscal de la Persona (Tabla 3) ILA _4: Digito Verificador del Adquiriente* Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 DFA: Dirección Física del Adquiriente Composición: 8 Sub nodos. Mandatorios: Ninguno Opcionales: 8 Dependientes: DFA_1, 2,3,4,5,6,7 Nodos complementarios: Ninguno DFA_1: Código de Identificador del País (Tabla 1) DFA_2: Código de Departamento (Tabla 34) DFA_3: Código Postal (Tabla 39) DFA_4: Código del Municipio (Tabla 35) DFA_5: Nombre del País (Tabla 1) DFA_6: Nombre del Departamento (Tabla 34) DFA_7: Nombre de la Ciudad (Tabla 35) DFA_8: Texto Libre Nota: La definición de este nodo condiciona el requerimiento de los nodos DFA_1,2,3,4,5,6,7. ICR: Información de la Cámara de Comercio* Composición: 8 Sub nodos. Mandatorios: ICR_1 Opcionales: ICR_2,3,4,5,6,7,8 Dependientes: Ninguno Nodos complementarios: Ninguno ICR_1: Matricula Mercantil de la Empresa Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 CDA: Información del Adquiriente Composición: 6 Sub nodos. Mandatorios: Ninguno Opcionales: CDA_1,2,3,4,5,6, Dependientes: Ninguno Nodos complementarios: Ninguno CDA_1: Tipo de Contacto CDA _2: Nombre y Cargo de la Persona de Contacto CDA _3: Teléfono de la Persona de Contacto CDA _4: Correo Electrónico de la Persona de Contacto Nota: Al no definir este nodo, los comprobantes no se estarán enviando al destinatario pues no se contará con este dato. Es importante saber que en el caso de los ERP que omitan este nodo, deberán realizar la entrega de los comprobantes a sus respectivos clientes. GTA: Detalles Tributarios del Adquiriente Composición: 2 Sub nodos. Mandatorios: GTA_1,2 Opcionales: Ninguno Dependientes: Ninguno Nodos complementarios: Ninguno GTA_1: Identificador del Tributo (Tabla 11) GTA _2: Nombre del Tributo (Tabla 11) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 TOT: Importes Totales Composición: 16 Sub nodos. Mandatorios: TOT_1,2,3,4,5,6,7,8 Opcionales: TOT_9,11,13,15 Dependientes: TOT_10,12,14,16 Nodos complementarios: Ninguno TOT_1: Valor bruto antes de Tributos (TOT_1=Suma de todos los ITE_5 de cada Ítem definido) TOT _2: Tipo de Moneda TOT _3: Total Valor Base Imponible (TOT_3=Suma de todos los IIM_4 de cada Ítem definido) TOT _4: Tipo de Moneda TOT _5: Total de la Factura (TOT_5=TOT_7 - Descuentos a nivel total (DSC)+ Cargos a nivel total (DSC)) TOT _6: Tipo de Moneda TOT _7: Total Incluyendo todos los impuestos (TOT_7=TOT_1+Sumatoria de todos los impuestos a nivel ítem de cada ítem) TOT _8: Tipo de Moneda DRF: Datos de Resolución de Numeración Composición: 6 Sub nodos. Mandatorios: DRF_1,2,3, 4,5,6 Opcionales: Ninguno Dependientes: Ninguno Nodos complementarios: Ninguno DRF_1: Número de Autorización DRF _2: Fecha de Inicio de Periodo de Autorización de Numeración DRF _3: Fecha de Fin de Periodo de Autorización de Numeración DRF _4: Prefijo DRF _5: Rango de Numeración (Mínimo) DRF _6: Rango de Numeración (Máximo) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 MEP: Medio de Pago Nota: Se validará el envió de este nodo Composición: 9 Sub nodos. Mandatorios: MEP_1 Opcionales: MEP_2,4,5,6,7,8,9 Dependientes: MEP_2,3 Nodos complementarios: Ninguno MEP_1: Medio de Pago (Tabla 5) Nota: Se validara que el código corresponda con los establecidos en la tabla 5 MEP _2: Método de Pago (Tabla 26) * MEP _3: Fecha de Pago * Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 ITE: Items del documento Composición: 27 Sub nodos. Mandatorios: ITE_1,3,4,5,6,7,8,11,19,21,27,28 Opcionales: ITE _9,10,11,12,15,17,18,23,25,26,29 Dependientes: ITE _4,20,22,24 Eliminados: ITE_13,14,16 Nodos complementarios: IAE Nota: El nodo ITE se va a generar por cada producto o servicio que se defina en la factura, independientemente de la cantidad del producto en mención. ITE_1: Número de Item ITE_3: Cantidad de Producto ITE_4: Unidad de Medida de los bienes ITE_5: Costo Total (ITE_5= (ITE 27*ITE_7)-Descuentos a nivel Ítem (IDE) +Cargos a nivel Ítem (IDE)) ITE_6: Tipo de Moneda ITE_7: Precio Unitario ITE_8: Tipo de Moneda ITE_11: Descripción ITE_19: Total del ítem (incluyendo Descuentos y cargos) * (ITE_19 = (ITE 27*ITE_7)-Descuentos a nivel Ítem (IDE) +Cargos a nivel Ítem (IDE)) ITE_20: Tipo de Moneda* ITE_21: Valor a Pagar del Item* (ITE_21= ITE_19+Suma de todos los Impuestos (IIM_2) a nivel Ítem) ITE_22: Tipo de Moneda* ITE_27: La cantidad real sobre la cual el precio aplica. ITE_28: Unidad de medida de la cantidad del artículo solicitado Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 Nodos complementarios de Nodo ITE IAE: Identificación del Articulo o Servicio Composición: 4 Sub nodos. Mandatorios: IAE_1,2 Opcionales: IAE _3,4 Dependientes: Ninguno Nodos complementarios: Ninguno IAE_1: Código del Producto IAE_2: Código del Estándar (Tabla 31) Nota: Para efectos de descripción de los sub nodos, se tomarán los mandatorios, en el caso de los nodos opcionales o dependientes, podrá revisarlos en su documento “Simplificado_Anexo1.9.xlsx” (https://webservice.facturatech.co/Doc19/Simplificado_Anexo1.9.xlsx) Actualizado: 19/01/2024 Cuando se necesite mostrar información de un producto de regalo dentro de la factura impresa que no afecte en los totales de esta, estos se pueden realizar definiendo el nodo IPA dentro de la estructura base. IPA: Precios Adicionales Composición: 3 Sub nodos. Mandatorios: IPA_1,2,3 Opcionales: Ninguno Dependientes: Ninguno IPA_1: Código para Precio (01- Valor comercial) * IPA_2: Precio IPA_3: Tipo de Moneda El orden dentro de la estructura es entre los nodos ITE y IAE, recordar que el nodo IAE es nodo complementario del nodo ITE por lo cual al introducir el nodo IPA este queda de la siguiente manera. "NODOS HIJOS" "NODOS HIJOS" "NODOS HIJOS" Nota: Recordar que como se está emitiendo un producto que no generara costos sobre los totales (Muestra gratis) los valores que corresponden al precio del ítem se estarán denotando en 0, llámese ITE_5,7,19,21 Actualizado: 19/01/2024

Use Quizgecko on...
Browser
Browser