Académique Documents
Professionnel Documents
Culture Documents
Página 1 de 610
Sumario
Índice de Tablas .......................................................................................................................................................... 8
Índice de Figuras......................................................................................................................................................... 9
1. Introducción .........................................................................................................................................................10
1.1. Confiabilidad de la Información: el Formato ................................................................................................10
1.2. Calidad de la Información: las Validaciones ..................................................................................................10
1.2.1. Redondeos ........................................................................................................................................... 11
1.2.2. El Identificador de los Documentos Electrónicos ................................................................................ 12
2. Convenciones Utilizadas en las Tablas .................................................................................................................13
2.1. Columnas de las Tablas de Definición ...........................................................................................................13
2.2. Tipos de Campos de los Archivos XML ..........................................................................................................13
2.3. Tamaños de los Elementos ...........................................................................................................................14
2.4. Convenciones Utilizadas en las Tablas de Reglas de Validación ...................................................................15
2.5. Ubicaciones Estándar para Informaciones Comunes....................................................................................16
3. Formato XML de los Documentos Electrónicos ...................................................................................................18
3.1. Factura Electrónica: Invoice ..........................................................................................................................18
3.2. Nota Crédito: CreditNote ..............................................................................................................................88
3.3. Nota Débito: DebitNote ..............................................................................................................................133
3.4. Contenedor de Documentos: AttachedDocument .....................................................................................177
3.4.1. Identificación de un PA en los Registros de Eventos: cac:SenderParty ............................................. 182
3.4.2. Identificación de la DIAN en los Registros de Eventos: cac:SenderParty........................................... 182
3.5. Registro de Evento: ApplicationResponse...................................................................................................183
3.5.1. Garantia de que el Evento Será Registrado en el Documento Correcto............................................ 183
3.5.2. Relacionamientos Mutuos Entre los Eventos .................................................................................... 184
3.5.3. Estructura Común a Todos los Eventos.............................................................................................. 185
3.5.4. Detalles de Cada Evento .................................................................................................................... 187
3.5.4.1. Uso Autorizado por PA ..................................................................................................................187
3.5.4.2. Uso Autorizado por la DIAN ..........................................................................................................189
3.5.4.3. Documento Electrónico Validado por PA, y que Debería Haber Sido Rechazado ........................191
3.5.4.4. Documento Electrónico Referenciado por Otro Documento Electrónico ....................................193
3.5.4.5. Documento Referenciado no Existe en la Base de Datos de la DIAN ...........................................195
3.5.4.6. Anulación de Efecto de Evento .....................................................................................................196
3.5.4.7. Anotación de Oficio por la DIAN ...................................................................................................198
3.5.4.8. Anulación de Negocio ...................................................................................................................199
3.5.4.9. Anulación de Documento..............................................................................................................203
3.5.4.10. Solicitación de Corrección en Documento ..................................................................................207
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 2 de 610
3.5.4.11. Acuse de recibo ...........................................................................................................................211
3.5.4.12. Rechazo de Documento ..............................................................................................................214
3.5.4.13. Recibimiento de los Bienes .........................................................................................................218
3.5.4.14. Aceptación de Documento..........................................................................................................221
3.5.4.15. Factura Ofrecida para Negociación como Título Valor ...............................................................224
3.5.4.16. Factura Negociada como Título Valor .........................................................................................226
4. Campos Definidos en las Extensiones DIAN .......................................................................................................229
4.1. Firma Electrónica del Documento: ds:Signature ........................................................................................229
5. Tablas de Contenidos de Elementos y de Atributos ..........................................................................................242
5.1. Códigos Relacionados con Documentos .....................................................................................................242
5.1.1. Ambiente de Destino del Documento: cbc:UUID.@ .......................................................................... 242
5.1.2. Algoritmo de CUFE: cbc:UUID.@schemeName.................................................................................. 242
5.1.3. Tipo de Documento: @listName........................................................................................................ 242
5.2. Códigos para Identificación Fiscal ...............................................................................................................242
5.2.1. Documento de Identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName;
sts:ProviderID.@schemeName ................................................................................................... 242
5.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name ......................................................................... 243
5.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID.@schemeName ....................... 243
5.2.4. Régimen Fiscal: cbc:TaxLevelCode.@listName .................................................................................. 243
5.2.5. Concepto de Correción para Notas crédito ....................................................................................... 243
5.2.6. Concepto de Correción para Notas débito ........................................................................................ 244
5.2.7. Responsabilidades fiscales: cbc:TaxLevelCode ................................................................................... 244
5.3. Códigos Diversos .........................................................................................................................................246
5.3.1. Eventos de un Documento Electrónico: cbc:DocumentResponse/Description; cbc:ResponseCode .. 246
5.3.2. Lenguaje (ISO 639): @languageID ..................................................................................................... 247
5.3.3. Moneda (ISO 4217): @currencyID ..................................................................................................... 249
5.3.4. Pagos .................................................................................................................................................. 254
5.3.4.1. Formas de Pago: cbc:PaymentMeans/ID ......................................................................................254
5.3.4.2. Medios de Pago: cbc:PaymentMeansCode ...................................................................................254
5.3.5. Productos: @schemeID, @schemeName, @schemeAgencyID .......................................................... 255
5.3.6. Unidades de Cantidad: @unitCode .................................................................................................... 255
5.3.7. Condiciones de Entrega (INCOTERMS)............................................................................................... 267
5.3.8. Códigos de descuento ........................................................................................................................ 267
5.3.9. Tablas de tarifas por Impuesto .......................................................................................................... 268
5.3.10. Lista de códigos para precios de referencia..................................................................................... 270
5.4. Códigos Geográficos....................................................................................................................................270
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 3 de 610
5.4.1. Países (ISO 3166-1): cbc:IdentificationCode....................................................................................... 270
5.4.2. Departamentos (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode ...................... 279
5.4.3. Municipios: cbc:CityName ................................................................................................................. 279
6. Reglas y Mensajes de Validación .......................................................................................................................311
6.1. Documentos Electrónicos ...........................................................................................................................312
6.1.1. Factura Electrónica: Invoice ............................................................................................................... 312
6.1.1.1. Línea de Factura: InvoiceLine ........................................................................................................313
6.1.2. Nota Crédito: CreditNote ................................................................................................................... 313
6.1.3. Nota Débito: DebitNote ..................................................................................................................... 315
6.1.4. Contenedor de Documentos: AttachedDocument ............................................................................ 316
6.1.5. Registro de Evento: ApplicationResponse.......................................................................................... 316
6.1.5.1. Estructura Común a Todos los Eventos .........................................................................................316
6.1.5.2. Detalles de Cada Evento ...............................................................................................................317
6.2. Campos Definidos en las Extensiones DIAN ................................................................................................319
6.2.1. Datos de Control de la DIAN para Factura Electrónica: sts:DianExtensions ...................................... 319
6.2.2. Firma Electrónica del Documento: ds:Signature ............................................................................... 321
6.3. Campos Comunes a los Documentos Electrónicos .....................................................................................328
6.3.1. Conjunto A: Identificación de Personas ............................................................................................. 328
6.3.1.1. Emisor: AccountingSupplierParty ..................................................................................................328
6.3.1.2. Adquirente: AccountingCustomerParty AccountingCustomerParty .............................................328
6.3.1.3. Autorizado a Descargar el Documento: TaxRepresentativeParty .................................................328
6.3.1.4. Identificación de un PA en los Registros de Eventos: cac:SenderParty ........................................329
6.3.1.5. Identificación de la DIAN en los Registros de Eventos: cac:SenderParty ......................................329
6.3.1.6. Información Genérica Sobre una Persona o Entidad: cac:Party ...................................................329
6.3.1.7. Datos sobre el Prestador de Servicios de Software: sts:SoftwareProvider ...................................329
6.3.2. Conjunto B: Campos que Describen cada Ítem de la Transacción Documentada ............................. 330
6.3.2.1. Características del Artículo o Servicio: de:Item.............................................................................330
6.3.2.2. Precios del Artículo o Servicio: Price .............................................................................................331
6.3.3. Conjunto C: Campos Complementarios de Uso Comercial Específico ............................................... 331
6.3.4. Conjunto D: Campos de Información Tributaria ................................................................................ 331
6.3.4.1. Tributo, Definición: cac:TaxScheme ..............................................................................................331
6.3.4.2. Tributo, Informaciones Sobre un: cac:TaxTotal, cac:WithholdingTaxTotal..................................332
6.3.4.3. Informaciones Tributarias de una Persona: PartyTaxScheme ......................................................332
6.3.4.4. Naturaleza de Corrección en Nota Crédito y Nota Débito: cac:DiscrepancyResponse .................334
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 4 de 610
6.3.4.5. Periodo de Facturación: cac:InvoicePeriod ...................................................................................334
6.3.4.6. Referencia a DFE en otro DFE: cac:AdditionalDocumentReference..............................................334
6.3.4.7. Referencia a DFE que Debe Existir en la Base de Datos de la DIAN: de:DocumentReference ......334
6.3.5. Conjunto E: Subtotales y Totales del Documento Electrónico .......................................................... 335
6.3.5.1. Medios de Pago: cac:PaymentMeans ...........................................................................................335
6.3.5.2. Totales monetarios de la Factura: LegalMonetaryTotal / RequestedMonetaryTotal ..................335
6.3.6. Conjunto F: Informaciones Financieras.............................................................................................. 336
6.3.6.1. Cargos y Descuentos: AllowanceCharge .......................................................................................336
6.3.6.2. Pagos Anticipados: PrePaidPayment ............................................................................................336
6.3.6.3. Conversión de divisas: cac:PaymentExchangeRate ......................................................................337
6.3.7. Conjunto G: Informaciones Relacionadas con la Entrega .................................................................. 337
6.3.7.1. Medios de Transporte: DeliveryTerms ..........................................................................................337
6.3.7.2. Transporte y Entrega de los Bienes: Delivery................................................................................337
6.3.8. Conjunto H: Estructuras Genéricas Relacionadas con Direcciones.................................................... 338
6.3.8.1. Localización Física: cac:PhysicalLocation ......................................................................................338
6.3.8.2. Datos de la Dirección: cac:Address ...............................................................................................338
6.4. Reglas Relativas al Establecimiento de la Conexión ...................................................................................339
6.4.1. Mensaje del Web Service ................................................................................................................... 339
6.4.2. Schema XML ....................................................................................................................................... 339
6.4.3. Certificado Digital de Transmisión (conexión) ................................................................................... 340
6.4.4. Certificado Digital de Firma (Firma XML) ........................................................................................... 340
6.4.5. Firma .................................................................................................................................................. 340
7. Anexo – Códigos de Productos...........................................................................................................................341
7.1. Colombia Compra Eficiente.........................................................................................................................341
7.2. Números Globales de Identificación de Productos – GTIN .........................................................................533
Definiciones............................................................................................................................................................539
Abreviaturas Utilizadas ..........................................................................................................................................542
8. Política de firma .................................................................................................................................................543
8.1. Consideraciones Generales .........................................................................................................................543
8.2. Especificaciones técnicas sobre la Firma Electrónica Avanzada: ................................................................543
8.3. Alcance de la Política de Firma ...................................................................................................................544
8.4. Política de Firma..........................................................................................................................................544
8.4.1. Actores de la Firma ............................................................................................................................ 544
8.4.2. Formato de Firma............................................................................................................................... 545
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 5 de 610
8.5. Algoritmo de Firma .....................................................................................................................................545
8.6. Algoritmo de Organización de Datos según el Canon .................................................................................545
8.7. Ubicación de la Firma ..................................................................................................................................545
8.8. Condiciones de la Firma ..............................................................................................................................546
8.9. Identificador de la Política ..........................................................................................................................547
8.10. Hora de Firma............................................................................................................................................548
8.11. Firmante ....................................................................................................................................................548
8.12. Mecanismo de firma electrónica ..............................................................................................................548
8.13. Certificado digital desde la vigencia de la circular 03-2016 de la ONAC...................................................548
9. Mecanismos Sistema Técnico de Control ..........................................................................................................555
9.1. ESPECIFICACIÓN TÉCNICA DE GENERACIÓN DEL CUFE ...............................................................................555
9.1.1. Consideraciones Generales ................................................................................................................ 555
9.2. Generación de CUFE....................................................................................................................................556
9.3. Ejemplos ......................................................................................................................................................557
9.3.1. Ejemplo de CUFE para Factura de venta ............................................................................................ 557
9.3.1.1. XPath .............................................................................................................................................558
9.3.2. Ejemplo de CUFE para Factura de exportación.................................................................................. 558
9.3.2.1. XPath .............................................................................................................................................559
9.3.3. Ejemplo de Identificador universal para Factura de contingencia .................................................... 559
9.3.3.1. XPath .............................................................................................................................................560
9.3.4. Ejemplo de Identificador universal para Nota crédito ....................................................................... 561
9.3.4.1. XPath .............................................................................................................................................561
9.3.5. Ejemplo de Identificador universal para Nota débito ........................................................................ 562
10.3.5.1. XPath ..........................................................................................................................................562
9.4. Localización de la CLAVE TÉCNICA «ClTec».................................................................................................563
9.5. CÓDIGO BIDIMENSIONAL «QR» DEL CUFE..................................................................................................564
9.6. ESPECIFICACIÓN TÉCNICA DEL CÓDIGO DE SEGURIDAD DEL SOFTWARE ..................................................565
10. Descripción Tecnológicas del Web Services de Validación Previa. ..................................................................566
10.1. Modelo conceptual de comunicación .......................................................................................................566
10.2. Servicios síncronos ....................................................................................................................................567
10.2.1. Secuencia del servicio síncrono : ..................................................................................................... 567
10.3. Servicio asíncrono .....................................................................................................................................567
Página 6 de 610
10.3.1. Secuencia del servicio asíncrono ..................................................................................................... 568
11. Aspectos tecnológicos de los web services de Validación Previa DIAN ..............................................................569
11.1. Estándar de comunicación ........................................................................................................................569
11.2. Estándar de mensajes de los servicios de La DIAN ...................................................................................570
12. Descripción de los servicios web de La DIAN .....................................................................................................570
12.1. WS recepción documento electrónico - SendBillAsync ...............................................................................570
12.1.1. Descripción de procesamiento ........................................................................................................ 570
12.1.2. Mensaje de petición ......................................................................................................................... 572
12.1.3. Mensaje de respuesta ...................................................................................................................... 573
12.2. WS recepción documento electrónico - SendTestSetAsync ........................................................................574
12.2.1. Descripción de procesamiento ........................................................................................................ 574
12.2.2. Mensaje de petición ......................................................................................................................... 575
12.2.3. Mensaje de respuesta ...................................................................................................................... 575
12.3. WS recepción documento electrónico - SendBillSync .................................................................................576
12.3.1. Descripción de procesamiento ........................................................................................................ 577
12.3.2. Mensaje de petición ......................................................................................................................... 578
12.3.3. Mensaje de respuesta ...................................................................................................................... 579
12.4. WS recepción documento electrónico - SendBillAttachmetAsync ..............................................................580
12.4.1. Descripción del procesamiento........................................................................................................ 580
12.4.2. Protocolo de petición ....................................................................................................................... 582
12.4.3. Mensaje de respuesta ...................................................................................................................... 583
12.5. WS Consulta del estado de DFE - GetStatus................................................................................................584
12.5.1. WS Consulta del estado de DFE - GetStatus .................................................................................... 584
12.5.2. Protocolo de petición ....................................................................................................................... 584
12.5.3. Protocolo de respuesta .................................................................................................................... 585
12.6. WS Consulta del estado del ZIP - GetStatusZip ...........................................................................................587
12.6.1. WS Consulta del estado de ZIP - GetStatusZip ................................................................................. 587
12.6.2. Protocolo de petición ....................................................................................................................... 587
12.6.3. Protocolo de respuesta .................................................................................................................... 587
12.7. WS recepción eventos ante La DIAN - SendEventUpdateStatus..................................................................590
12.7.1. Descripción de procesamiento ........................................................................................................ 590
12.7.2. Mensaje de petición ......................................................................................................................... 591
12.7.3. Mensaje de respuesta ...................................................................................................................... 591
Página 7 de 610
12.8. WS Consulta contribuyentes activos de IVA - GetTaxPayer.........................................................................593
12.8.1. Descripción del procesamiento........................................................................................................ 593
12.8.2. Mensaje de petición ......................................................................................................................... 593
12.8.3. Mensaje de respuesta ...................................................................................................................... 594
12.9. WS descarga de XML (GetXmlByDocumentKey) .........................................................................................594
12.9.1. Descripción de procesamiento ........................................................................................................ 594
12.9.2. Mensaje de petición ......................................................................................................................... 595
12.9.3. Mensaje de respuesta ...................................................................................................................... 596
12.10. WS consulta de rangos de numeración - GetNumberingRange ................................................................597
12.10.1. Descripción de procesamiento ...................................................................................................... 597
12.10.2. Mensaje de petición....................................................................................................................... 597
12.10.3. Mensaje de respuesta .................................................................................................................... 598
13. Anexo: Herramienta para el consumo de Web Services ....................................................................................601
13.1. Introducción ...............................................................................................................................................601
13.2. Descargar SOAP UI .....................................................................................................................................601
13.3. Ejecutar SOAP UI ........................................................................................................................................601
13.4. Crear un nuevo proyecto tipo SOAP ...........................................................................................................601
13.5. Configuración inicial ...................................................................................................................................602
13.6. Configurar Keystore....................................................................................................................................602
13.7. Configurar WS-Security Signature ..............................................................................................................603
13.8. Configurar TimeStamp ...............................................................................................................................604
13.9. Configurar GetStatus Request, Authentication y WS-A addressing .............................................................605
13.10. Configurar y ejecutar GetStatus Request ..................................................................................................607
13.11. Configurar y ejecutar SendBillAsync Request............................................................................................608
13.12. SendBillAsync Response ...........................................................................................................................609
13.13. Recomendaciones ....................................................................................................................................609
Índice de Tablas
Tabla 1 – Convenciones Utilizadas en la Tablas de Definición de los Formatos XML ..............................................13
Tabla 2 – Tipos de Campo en los Archivos XML .......................................................................................................13
Tabla 3 – Tipos de Datos de los Elementos en los Archivos XML ............................................................................13
Tabla 4 – Tamaños de Elementos ............................................................................................................................14
Tabla 5 – Ejemplos de Información de Valores Utilizando los Formatos Numéricos ..............................................15
Tabla 6 – Nombres de las Columnas de las Tablas de Reglas de Validación............................................................15
Tabla 8 – Ubicaciones Estándar para Informaciones Comunes ...............................................................................16
Tabla 9 – Relacionamientos Mutuos Entre los Eventos .........................................................................................184
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 8 de 610
Tabla 10 – Ejemplos de Mensajes de Validación ...................................................................................................311
Tabla 11 – Códigos de Colombia Compra Eficiente ...............................................................................................343
Índice de Figuras
Figura 1 – Niveles jerárquivos del sistema de codificación Colombia Compra Eficiente .......................................343
Figura 2 – Estructura de los códigos GTIN 8, 12 y 13 .............................................................................................534
Figura 3 – Estructura del código GTIN 14...............................................................................................................535
Figura 4 – Árbol de decisión para elección de código GTIN ...................................................................................537
Figura 5 – Estructura de almacenamiento de códigos GTIN ..................................................................................538
Figura 6. Ejemplo de código bidimensional QR ......................................................................................................564
Página 9 de 610
1. Introducción
El presente documento describe el formato de los documentos electrónicos para utilización en el marco
de las validaciones previstas en la Ley 1819 de 29 de diciembre de 2016 y la ley 1943 de 28 de diciembre
de 2018.
El formato es un subconjunto del Universal Business Language – UBL, del cual si utilizarán cinco tipos de
documento1: Invoice (factura), CreditNote (Nota Crédito), DebitNote (Nota Débito),
ApplicationResponse (Registro de Evento2) y AttachedDocument (Contenedor de Documentos).
El objetivo de la presente descripción del UBL es buscar, una estandarización de las facturas electrónicas
en el país, de manera que si impulse el comercio electrónico, permitiendo que la información pueda ser
utilizada de la manera más eficaz, eficiente y efectiva posible.
Se imponen por lo tanto dos (2) requisitos: confiabilidad y calidad en las informaciones tal como se
describe a continuación.
1
Otros documentos descritos en el UBL podrán ser utilizados por las empresas, pero serán rechazados en las
validaciones. Por otro lado, campos y grupos de los cinco documentos citados que no se encuentren descritos en
el presente documento serán aceptados como integrantes de los mismos, siguiendo las siguientes condiciones:
Deben obedecer al schema UBL 2.1, de acuerdo con los XSD correspondientes; y
No serán objeto de ninguna crítica o validación de contenido.
2
Por evento, en el citado marco legal, si entiende todo y cualquier hecho relacionado con un Documento
Electrónico, o con la operación descrita en una factura; ver más detalles en las definiciones, al final del presente
documento.
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 10 de 610
Rechazo, si la aplicación de la regla apunta a una discrepancia grave, que indica que las
informaciones del archivo no pueden ser utilizadas de manera confiable o de manera legal;
Notificación, si la aplicación de la regla apunta a una discrepancia menos importante, pero que
asimismo merece que se advierta al emisor de un posible problema con las informaciones del
archivo;
Aprobación, si la aplicación de la regla no apunta a ningún tipo de problema.
Las reglas de validación serán aplicadas en los siguientes momentos:
Por la DIAN al recibir en línea, del facturador electrónico directamente, o a través de un
Proveedor Tecnologico (PT), o a través de la solución gratuita de facturación electrónica, un
documento electrónico para validación.
Por la DIAN al recibir en contingencia, del facturador electrónico directamente, o a través de un
Proveedor Tecnologico (PT), o a través de la solución gratuita de facturación electrónica, un
documento electrónico para validación. En esta situación:
1.2.1. Redondeos
La suma de elementos que son resultado de otras operaciones aritméticas, como aplicación de
porcentajes, por ejemplo, puede llevar a diferencias entre los totales calculados y los correctos. Para
evitar la propagación de errores, para redondeos si recomienda que sea utilizado el siguiente
procedimiento:
Dígito siguiente al dígito menos significativo es Redondeo
Entre 0 y 4 Mantener el dígito menos significativo
Entre 6 y 9 Incrementar el dígito menos significativo
5, y el segundo dígito siguiente al dígito menos significativo es cero o par Mantener el dígito menos significativo
5, y el segundo dígito siguiente al dígito menos significativo es impar Incrementar el dígito menos significativo
Esta definición se hace para que se reduzca el riesgo de problemas de sumas de los valores redondeados,
para valores originales con décimas conteniendo el número “5”.
En caso de que, mismo con la adopción de este procedimiento, haya diferencia entre los totales
calculados y la suma de las parciales, para el valor total de un documento se deberá utilizar el elemento
/Invoice/LegalMonetaryTotal/cbc:PayableRoundingAmount para informar la diferencia.
Ejemplos para redondear cuando el digito menos significativo es la segunda casilla decimal:
Valor a Redondear Valor Redondeado
1.723 1.72
1.726 1.73
1.7252 1.72
1.7253 1.73
1.7258 1.72
Página 11 de 610
1.2.2. El Identificador de los Documentos Electrónicos
El Código Único de Factura Electrónica – CUFE, es el identificador de los diferentes documentos
electrónicos, para su cálculo debe remitirse al numeral 9.2 del presente documento.
Para posibilitar la referencia cruzada entre los diferentes documentos electrónicos, se incluiye la
etiqueta cbc:UUID, la cual contendrá un identificador universal denominado “CUFE”. Este identificador
y sus atributos están localizados en la siguiente ruta:
/Invoice/cbc:UUID
/Invoice/cbc:UUID/@schemeName
El atributo @schemeName se encuentra definido en 5.1.2, y la etiqueta UUID contendrá:
Como se menciono anteriromente, el lector debe remitirse al numeral 9.2, con el objeto de
revisar como se calcula o genera el CUFE para los diferentes documentos electrónicos
Para los DFE del tipo Application Response el resultado del cálculo deberá ser objeto de
definición por parte de la DIAN; para efecto del presente entregable, se establece que será
utilizada la definición CUFE-SHA256, lo que es suficiente para las necesidades de descripción de
referencia cruzada entre DFE.
Los elementos utilizados en los cálculos se encuentran especificados en el presente documento.
Página 12 de 610
2. Convenciones Utilizadas en las Tablas
Este capítulo presenta la definición de las estructuras de las tablas de definición del formato XML de los
Documentos Electrónicos y de las reglas de validación.
Página 13 de 610
Tipo Descripción
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
Fecha: elementos que deben ser informados en el formato AAAA-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:
AAAA: año
F
MM: mes
DD: día
Hora: elementos que deben ser informados en el formato de tiempo universal coordinado HH:MM:SSdhh:mm, de acuerdo con
la norma ISO 8601-2, en el cual:
HH: hora UTC (número de horas contadas desde la media noche, o sea, de 00 hasta 23)
MM: minutos
H
SS: segundos
hh:mm – diferencia en horas y minutos con relación a la hora GMT
d: señal (“+” o “-“) para la diferencia con relación a la hora GMT3
Ejemplo: dos y treinta de la tarde en Bogotá debe ser informado como 14:30:00-05:00
Intervalo de tiempo: elementos que deben ser informados en el formato <Fecha Inicial>/<Fecha Final>, siendo que obedece el
I formato “F” para ambas las fechas
Ejemplo: el período entre 01 de septiembre y 30 de septiembre de 2018 debe ser informado como 2018-09-01/2018-09-30
X Documento XML
3
Atención: no es la hora “Zulu”, o sea, referenciada al meridiano zero. Debe ser informada una hora en una zona
horaria específica, de libre elección del emisor: en el ejemplo fue escogido -5, que es la zona horaria oficial de
Colombia.
La zona horaria elegida por el emisor del documento electrónico es indiferente para la aplicación de las
reglas de validación: todas las operaciones de evaluación de horas se realizan tomando en cuenta la
zona horaria informada en el campo específico.
No existe necesidad de utilizar la misma zona horaria en todos los campos del tipo “hora” a lo largo de
un mismo archivo.
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 14 de 610
Formato Descripción
o informar menos o más de cinco posiciones tendrá como resultado el rechazo del archivo
Tamaño mínimo de “x”, máximo de “y”
ej.: 0-10
x-y
o es posible expresar ningún valor, porque se permite el tamaño “0”
o informar más de dez posiciones tendrá como resultado el rechazo del archivo
Tamaño exacto del elemento de “x”, con exactamente “n” casillas decimales
ej.: 11 p 4
xpn o El número debe tener once posiciones, siendo exactamente seis posiciones antes del punto decimal, y
exactamente cuatro posiciones después del punto decimal; cualquier otro número de posiciones tendrá
como resultado el rechazo del archivo
Tamaño exacto del elemento de “x”, con entre “n” y “m” casillas decimales
ej.: 11 p (0-6)
x p (n-m) o El número debe tener exatamente once posiciones, aceptándose cualquier combinación desde once
posiciones sin punto decimal hasta exactamente cuatro posiciones antes del punto decimal, y
exactamente seis posiciones después del punto decimal
Tamaño mínimo de “x”, máximo de “y”, con entre “n” y “m” casillas decimales
ej.: 1-11 p (0-6)
o Es obligatorio expresar algún valor, porque no se permite el tamaño “0”
(x-y) p (n-m)
o El número debe entre una y once posiciones, aceptándose cualquier combinación desde once posiciones
sin punto decimal hasta exactamente cuatro posiciones antes del punto decimal, y exactamente seis
posiciones después del punto decimal, pero la parte fraccionaria es opcional
Valores separados El elemento deberá ser informado con tamaño de exactamente una de las opciones listadas
por comas ej.: 1, 3, 5, 8 significa que se debe informar el elemento con uno de estos cuatro tamaños fijos
Ejemplos de cómo se debe informar los valores en los elementos numéricos de acuerdo con el formato
especificado pueden ser encontrados en la Tabla 5.
Tabla 5 – Ejemplos de Información de Valores Utilizando los Formatos Numéricos
Formato Para Informar Llenar elemento con
1,105.13 1105.13
1,105.137 1105.137
0-11 p (0-6) 1,105 1105
0 0
para no informar cantidad dejar el elemento vacío
1,105 1105
1-11 0 0
para no informar cantidad no es posible
Página 15 de 610
Regla Descripción de la regla de validación
Cod Código de mensaje correspondiente a la regla de validación
Efecto de la regla de validación:
R: Rechazo, el procesamiento correspondiente ha encontrado problemas que impiden el atendimiento de la solicitud
Y
N: Notificación. el procesamiento correspondiente ha encontrado indicios de potenciales problemas, los cuales no
impiden el atendimiento la solicitud
Mensaje Mensaje regresado como resultado de un rechazo el de una notificación
V Versión de las reglas de validación
Página 16 de 610
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Página 17 de 610
3. Formato XML de los Documentos Electrónicos
El sistema de facturación electrónica de Colombia utiliza cinco documentos del estándar UBL: Invoice, CreditNote, DebitNote, ApplicationResponse y AttachedDocument.
/root/ext:UBLExtensions/ext:UBL
DA03 Ext DianExtensions G ExtensionContent 0..1 1.0 Extension/ext:ExtensionContent/
sts:DianExtensions
/root/ext:UBLExtensions/ext:UBL
Datos Resolución de Numeración de Extension/ext:ExtensionContent/
DA04 Sts InvoiceControl G DianExtensions 1..1 1.0
Facturas sts:DianExtensions/sts:InvoiceCo
ntrol
AA06 cbc CustomizationID Versión del Formato: XSD E A 3..4 Invoice 1..1 1.0 /Invoice/cbc:CustomizationID
Versión del Formato: Indicar versión del
AA07 cbc ProfileID E A 8 Invoice 1..1 Rechazo si este elemento no equivale al literal "DIAN 2.1" 1.0 /Invoice/cbc:ProfileID
documento.
Rechazo si
/Invoice/cac:InvoiceLine/cbc:LineExtensionAmount <>
/Invoice/Price/cbc:PriceAmount *
/Invoice/Price/cbc:Price/ BaseQuantity
Para la evaluación de esta regla, en el caso de que
exista(n) grupo(s)
/Invoice/cac:InvoiceLine/cac:AllowanceCharge, antes de
ser multiplicado por el elemento /Invoice/Price/cbc:Price/
BaseQuantity, el elemento
/Invoice/Price/cbc:PriceAmount deberá ser
Valor total de la línea. Resultado: Unidad de
o Sumado de los valores de los elementos
LineExtension Medida x Precio Unidad, libre de tributos, 0..15 /Invoice/cac:InvoiceLine/cbc:Line
AB04 cbc E N InvoiceLine 1..1 /Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:Amou 1.0
Amount sumando cargos y restando descuentos que p (2..6) ExtensionAmount
nt, correspondientes a aquellos grupos en donde
apliquen para la línea.
AllowanceCharge/cbc:ChargeIndicator es “true”
o Restado de los valores de los elementos
/Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:Amou
nt, correspondientes a aquellos grupos en donde
/Invoice/cac:InvoiceLine/cac:AllowanceCharge/cbc:Charg
eIndicator es “false”
o Si se informa el grupo
InvoiceLine/cac:PricingReference entonces el valor de
LineExtensionAmout es cero (0.0), ya que se trata de
muestra o regalo comercial
/root/ext:UBLExtensions/ext:UBL
DA03 DianExtensions G ExtensionContent 0..1 1.0 Extension/ext:ExtensionContent/
sts:DianExtensions
AC06 cbc CustomizationID Versión del Formato: XSD E A 3..4 CreditNote 1..1 1.0 /CreditNote/cbc:CustomizationID
Versión del Formato: Indicar versión del
AC07 cbc ProfileID E A 8 CreditNote 1..1 Rechazo si este elemento no contiene el literal “DIAN 2.1” 1.0 /CreditNote/cbc:ProfileID
documento. Debe usarse “DIAN 2.1”
Código que describe el “ambiente de
destino donde será procesada la validación
previa de este documento electrónico”;
Rechazo si este elemento está vacío
este código es el testigo de que el valor /CreditNote/cbc:ProfileExecution
AC38 ProfileExecutionID E N 1 CreditNote 1..1 Rechazo si contiene un valor distinto a los definidos en el 1.0
registrado en cbc:UUID.@schemeID es lo ID
grupo en 5.1.1
que desea realizar el HFE: en igualdad
confirma el ambiente y en desigualdad
rechaza el procesamiento.
Número de documento: Número de nota
o No se permiten caracteres adicionales como espacios
AC08 cbc ID crédito. Incluye prefijo + consecutivo de E A 12 CreditNote 1..1 1.0 /CreditNote/cbc:ID
o guiones
nota crédito.
CUFE: Código Único de Facturación
Electrónica. Elemento que verifica la Definido en el numeral 9.1
AC09 cbc UUID E A 20-32 CreditNote 1..1 1.0 /CreditNote/cbc:UUID
integridad de la información recibida, es Rechazo si el valor UUID no está correctamente calculado
un elemento generado por el sistema
Identificador del esquema de
Ver lista de valores posibles en 5.1.2
identificación /CreditNote/cbc:UUID/@scheme
AC11 cbc @schemeName A A 4 UUID 1..1 Rechazo si el contenido de este atributo no corresponde 1.0
Algoritmo utilizado para el cáculo del Name
a algún de los valores de la columna “Código”
CUFE
/CreditNote/cac:C
Información Adicional: Texto libre para reditNoteLine/cbc
AC29 cbc Note E A 20..5000 CreditNoteLine 0..1 1.0
añadir información adicional al artículo.
:ID
/CreditNote/cac:CreditNoteLine/c
AC30 cbc CreditedQuantity Cantidad de items creditados E N 1..10 CreditNoteLine 0..1 o 1.0
bc:CreditedQuantity
/root/ext:UBLExtensions/ext:UBL
DA03 DianExtensions G ExtensionContent 0..1 1.0 Extension/ext:ExtensionContent/
sts:DianExtensions
AD06 cbc CustomizationID Versión del Formato: XSD E A 3..4 DebitNote 1..1 1.0 /DebitNote/cbc:CustomizationID
Versión del Formato: Indicar versión del
AD07 cbc ProfileID E A 8 DebitNote 1..1 Rechazo si este elemento no contiene el literal “DIAN 2.1” 1.0 /DebitNote/cbc:ProfileID
documento. Debe usarse “DIAN 2.1”
Código que describe el “ambiente de
destino donde será procesada la validación
previa de este documento electrónico”;
Rechazo si este elemento está vacío
este código es el testigo de que el valor /DebitNoteNote/cbc:ProfileExec
AD38 ProfileExecutionID E N 1 DebitNote 1..1 Rechazo si contiene un valor distinto a los definidos en el 1.0
registrado en cbc:UUID.@schemeID es lo utionID
grupo en 5.1.1
que desea realizar el HFE: en igualdad
confirma el ambiente y en desigualdad
rechaza el procesamiento.
Número de documento: Número de nota
o No se permiten caracteres adicionales como espacios
AD08 cbc ID débito. Incluye prefijo + consecutivo de E A 12 DebitNote 1..1 1.0 /DebitNote/cbc:ID
o guiones
nota débito.
Código Único de Facturación
Definido en el numeral 9.1
Electrónica. Elemento que verifica la
AD09 cbc UUID E A 20-32 DebitNote 1..1 Rechazo si el valor de este elemento no está 1.0 /DebitNote/cbc:UUID
integridad de la información recibida, es
correctamente calculado
un elemento generado por el sistema
Identificador del esquema de
Ver lista de valores posibles en 5.1.2
identificación /DebitNote/cbc:UUID/@scheme
AD11 cbc @schemeName A A 4 UUID 1..1 Rechazo si el contenido de este atributo no corresponde 1.0
Algoritmo utilizado para el cáculo del Name
a algún de los valores de la columna “Código”
CUFE
Considerando zona horaria de Colombia:
Notificación: si la Nota Débito referencia a una FE, no
Fecha de emisión: Fecha de emisión de la puede ser anterior a esta FE
AD12 cbc IssueDate E F 10 DebitNote 1..1 1.0 /DebitNote/cbc:IssueDate
nota débito a efectos fiscales /DebitNote/cbc:IssueDate >= IssueDate de la factura
identificada por
/DebitNote/cac:AdditionalDocumentReference/cbc:UUID
/DebitNote/cac:DebitNoteLine/cb
AD30 cbc DebitedQuantity Cantidad de items creditados E N 1..10 DebitNoteLine 0..1 o 1.0
c:DebitedQuantity
< ApplicationResponse>
< UBLExtension>
Firma digital sobre la estructura del evento
< ApplicationResponse>
< ApplicationResponse>
<XML del evento #2 />
< ApplicationResponse/>
< AttachedDocument/>
3.5.4.3. Documento Electrónico Validado por PA, y que Debería Haber Sido Rechazado
Documento electrónico validado exitosamente por un PA, transmitido por este PA para la DIAN, pero que no cumple satisfactoriamente con todas las validaciones, y que, por
lo tanto, no debiera haber sido validado exitosamente por el PA.
Responsable por el Registro: DIAN
Efectos:
Impide el registro de los eventos “Aceptación de Documento” y “Factura Ofrecida para Negociación como Título Valor”, sin posibilidad de resolución de esta situación
PA deberá comunicar el emisor del problema, y el emisor deberá:
o Registrar el evento de anulación en el documento con problema;
o Emitir otro documento de misma naturaleza para respaldar correctamente la operación, referenciando el documento con problema en el elemento
root/cac:DocumentReference o en el elemento root/cac:AdditionalDocumentReference del nuevo documento
o Colocar el literal “Documento emitido para sustituir <xxxx>, que fue indebidamente validado” en el elemento XPath del nuevo documento, de acuerdo con
instrucciones en ¡Error! No se encuentra el origen de la referencia.; y
RSAwithSHA256=http://www.w3.org/2001/04/ /root/ext:UBLExtensions/ext:UBLExtension
El algoritmo de firma usado sobre el elemento
DC04 ds SignatureMethod Signature 1..1 xmldsig-more#rsa-sha256 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
«SignedInfo»
nedInfo/ds:SignatureMethod
RSAwithSHA384=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha384
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
/root/ext:UBLExtensions/ext:UBLExtension
Grupo de la primera referencia que contiene la firma
DC05 ds Reference G Signature 1..1 URI="" 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
aplicada de todo el documento
nedInfo/ds:Reference
/root/ext:UBLExtensions/ext:UBLExtension
DC06 ds Transforms Grupo de trasformación del documento G Reference 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
nedInfo/ds:Reference/ds:Transforms
/root/ext:UBLExtensions/ext:UBLExtension
Transformación del documento. Se debe especificar
Algorithm="http://www.w3.org/2000/09/xmld /ext:ExtensionContent/ds:Signature/ds:Sig
DC07 ds TransForm que la firma se aplica a todo el documento y esta se Transforms 1..1 1.0
sig#enveloped-signature" nedInfo/ds:Reference/ds:Transforms/ds:Tr
encuentre embebida en este.
ansForm
RSAwithSHA256=http://www.w3.org/2001/04/ /root/ext:UBLExtensions/ext:UBLExtension
DC08 ds DigestMethod El algoritmo de firma usado sobre el elemento Reference 1..1 xmldsig-more#rsa-sha256 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
nedInfo/ds:Reference/ds:DigestMethod
RSAwithSHA384=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha384
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
Resultado de aplicar el algoritmo de generación hash /root/ext:UBLExtensions/ext:UBLExtension
DC09 ds DigestValue especificado en el “DigestMethod” en codificación Reference 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
base64 nedInfo/ds:Reference/ds:DigestValue
/root/ext:UBLExtensions/ext:UBLExtension
Grupo de la segunda referencia donde se especifica
DC10 ds Reference G Signature 1..1 URI="#{UUID}-KeyInfo" 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
clave pública contenida en el elemento KeyInfo.
nedInfo/ds:Reference
Puede ser cualquiera de los definidos en la
especificación XML-Signature Syntax and
Processing (http://www.w3.org/TR/xmldsig-
core2/#sec-Algorithms) que actualmente son:
RSAwithSHA256=http://www.w3.org/2001/04/ /root/ext:UBLExtensions/ext:UBLExtension
DC11 ds DigestMethod El algoritmo de firma usado sobre el elemento Reference 1..1 xmldsig-more#rsa-sha256 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
nedInfo/ds:Reference/ds:DigestMethod
RSAwithSHA384=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha384
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
RSAwithSHA256=http://www.w3.org/2001/04/ /root/ext:UBLExtensions/ext:UBLExtension
DC14 ds DigestMethod El algoritmo de firma usado sobre el elemento Reference 1..1 xmldsig-more#rsa-sha256 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
nedInfo/ds:Reference/ds:DigestMethod
RSAwithSHA384=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha384
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
Resultado de aplicar el algoritmo de generación hash /root/ext:UBLExtensions/ext:UBLExtension
DC15 ds DigestValue especificado en el “DigestMethod” en codificación Reference 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
base64 nedInfo/ds:Reference/ds:DigestValue
Resultado de aplicar el algoritmo de generación hash /root/ext:UBLExtensions/ext:UBLExtension
DC16 ds SignatureValue especificado en el “SignatureMethod” en Signature 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Sig
codificación base64 natureValue
/root/ext:UBLExtensions/ext:UBLExtension
Grupo de información para embeber el certificado
DC17 ds KeyInfo G Signature 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Key
público requerido para validar la firma.
Info
/root/ext:UBLExtensions/ext:UBLExtension
Grupo que contiene el certificado publico del que
DC18 ds X509Data G KeyInfo 1..1 1.0 /ext:ExtensionContent/ds:Signature/ds:Key
firma el documento
Info/ds:X509Data
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Resultado de aplicar el algoritmo de generación hash
SignedSignature ect/xades:QualifyingProperties/xades:Signe
DC29 ds DigestValue especificado en el “DigestMethod” en codificación 1..1 1.0
Properties dProperties/xades:SignedSignatureProperti
base64
es/xades:SigningCertificate/xades:Cert/xad
es:CertDigest/ds:DigestValue
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Resultado de aplicar el algoritmo de generación hash
SignedSignature ect/xades:QualifyingProperties/xades:Signe
DC36 ds DigestValue especificado en el “DigestMethod” en codificación 1..1 1.0
Properties dProperties/xades:SignedSignatureProperti
base64
es/xades:SigningCertificate/xades:Cert/xad
es:CertDigest/ds:DigestValue
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
SignedSignature ect/xades:QualifyingProperties/xades:Signe
DC37 xades IssuerSerial Grupo para definir los datos del certificado G 1..1 1.0
Properties dProperties/xades:SignedSignatureProperti
es/xades:SigningCertificate/xades:Cert/xad
es:IssuerSerial
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Subject del certificado digital de la entidiad sub
SignedSignature ect/xades:QualifyingProperties/xades:Signe
DC38 ds X509IssuerName ordinada que emitio el certificado con que firma el 1..1 1.0
Properties dProperties/xades:SignedSignatureProperti
documento electrónico
es/xades:SigningCertificate/xades:Cert/xad
es:IssuerSerial/ds:X509IssuerName
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
RSAwithSHA512=http://www.w3.org/2001/04/
xmldsig-more#rsa-sha512
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Resultado de aplicar el algoritmo de generación hash ect/xades:QualifyingProperties/xades:Signe
SignedSignature
DC53 ds DigestValue especificado en el “DigestMethod” en codificación 1..1 1.0 dProperties/xades:SignedSignatureProperti
Properties
base64 es/xades:SignaturePolicyIdentifier/xades:Si
gnaturePolicyId/xades:SigPolicyHash/ds:Dig
estValue
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Grupo de informaciones sobre la persona que firma SignedSignature
DC54 xades SignerRole G 1..1 1.0 ect/xades:QualifyingProperties/xades:Signe
el documento electrónico Properties
dProperties/xades:SignedSignatureProperti
es/xades:SignerRole
/root/ext:UBLExtensions/ext:UBLExtension
/ext:ExtensionContent/ds:Signature/ds:Obj
Grupo de informaciones sobre los roles de la persona SignedSignature
DC55 xades ClaimedRoles G 1..1 1.0 ect/xades:QualifyingProperties/xades:Signe
que firma el documento electrónico Properties
dProperties/xades:SignedSignatureProperti
es/xades:SignerRole/xades:ClaimedRoles
2I Unidad térmica británica por hora. C8 Millicoulomb por kilogramo LTR litro
2J centímetro cúbico por segundo C80 rad LUM lumen
2K pie cúbico por hora C81 radián LUX lux
2L pie cúbico por minuto C82 medidor de radianes al cuadrado LX yarda lineal por libra
por mol
2M centímetro por segundo C83 medidor de radianes al cuadrado LY yarda lineal
por kilogramo
2N decibel C84 radian por metro M0 cinta magnética
2P kilobyte C85 â € ngstr recíproco “m M1 miligramos por litro
2Q kilobecquerel C86 metro cúbico recíproco M4 valor monetario
2R kilocurie C87 metro cúbico recíproco por M5 microcurie
segundo
B55 kilovoltios por metro GGR gramo TSH tonelada de vapor por hora
B56 kiloveber por metro GH medio galón (EE. UU.) TT mil metros lineales
B57 año luz GIA branquias TU tubo
B58 litro por mol GII Gill (Reino Unido) TV mil kilogramos
B59 hora lumen GJ gramo por mililitro TW mil hojas
B6 bollo GK gramo por kilogramo TY tanque, cilíndrico
Codigo Código
Nombre Departamento Nombre Municipio
Departamento Municipio
6.1.5.2.3. Documento Electrónico Validado por PA, y que Debería Haber Sido Rechazado
No existen reglas de validación específicas para este grupo.
/ApplicationResponse/cac:Party/cac:Pa
@schemeI DV del NIT debe estar DV del NIT del PA no está
6 ED05 N D correctamente calculado correctamente calculado
1 rtyTaxScheme/cbc:CompanyID/@sche
meID
/root/cac:AccountingSupplierParty/cac
@schemeI DV del NIT de la DIAN no fue
1 EE05 R
D
DV del NIT de la DIAN es 4
informado correctamente
1 :Party/cac:PartyTaxScheme/cbc:Comp
anyID/@schemeID
/ApplicationResponse/cac:Party/cac:P
@scheme NIT de la DIAN debe ser informado NIT de la DIAN debe ser informado
6 EE06 R
Name con dígito verificador con dígito verificador
1 artyTaxScheme/cbc:CompanyID/@sch
emeName
/root/cac:AccountingCustomer
Si el adquirente es responsable, el El adquirente es responsable, y su NIT
6 HC07 N TaxScheme NIT debe estar activo en el RUT no está activo en el RUT
1 Party/cac:Party/cac:PartyTaxSc
heme
6.3.4.7. Referencia a DFE que Debe Existir en la Base de Datos de la DIAN: de:DocumentReference
T
i
ID Y Elemento Regla Mensaje V Xpath
p
o
CUFE del documento referenciado debe CUFE del documento referenciado
/root/DocumentReference
6 HI02a N UUID existir en la base de datos del PA o de la no existe en la base de datos del PA 1
/cbc:UUID
DIAN o de la DIAN
Tentativa de registro de evento
En el caso de registro de evento “Factura
“Factura Ofrecida para Negociación
Ofrecida para Negociación como Título
como Título Valor” o de evento
Valor” o de evento “Factura Negociada /root/DocumentReference
4 HI02b R UUID como Título Valor” el documento
“Factura Negociada como Título 1
/cbc:UUID
Valor”, pero el documento
referenciado debe ser una Factura
referenciado no es una Factura
Electrónica
Electrónica
UUID Esquema de identificación de algoritmo No fue utilizado uno de los
/root/DocumentReference
1 HI03 R @scheme utilizado para el cáculo del CUFE debe ser algoritmos permitidos para el cáculo 1
/cbc:UUID/@schemeName
Name uno de los permitidos del CUFE: <Xpath>
DigestValue del documento
DigestValue del documento referenciado
referenciado debe e no corresponde
debe corresponder al existente en el /root/DocumentReference
4 HI04 N DigestValue
documento referido por este UUID en la
al existente en el documento 1
/ds:DigestValue
referido por este UUID en la base de
base de datos de la DIAN
datos de la DIAN
CUFE del documento referenciado, cifrado El resultado de descifrar el
ClaveDel /root/DocumentReference
5 HI05 R
Documento
por la DIAN debe ser igual a la contenido de 1
/cbc:ClaveDelDocumento
concatenación de /root/DocumentReference/cbc:Clave
6.4.5. Firma
Tipo # Regla Y Mensaje V
Verificar si la firma está en el estándar (XMLDSig con Certificado de la Firma con estándar
7 ZE01 R 1.0
formato XAdES-EPES) inválido
Verificar si el valor de la Firma está válido (difiere del
7 ZE02 R Valor de la Firma inválido 1.0
calculado)
Identificación (ID) del emisor difiere de la Identificación ID del emisor difiere del proprietário del
7 ZE03 R 1.0
(proprietário) del Certificado Digital Certificado Digital
4
La guía puede ser descargada desde la dirección
https://www.colombiacompra.gov.co/sites/cce_public/files/cce_documents/cce_guia_codificacion_bienes.pdf.
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Subdirección de Gestión de Fiscalización Tributaria
Cra. 7 Nº 6C-54 piso 7º PBX 607 9800 ext. 907401
Código postal 111711
www.dian.gov.co Página 341 de 610
o Componentes y suministros electrónicos
o Componentes, accesorios y suministros de sistemas eléctricos e iluminación
o Componentes y equipos para distribución y sistemas de acondicionamiento
o Equipos y suministros de laboratorio, de medición, de observación y de pruebas
Segmentos 42 al 60: Productos de uso final
o Equipo médico, accesorios y suministros
o Difusión de tecnologías de información y telecomunicaciones
o Equipos de oficina, accesorios y suministros
o Equipos y suministros para impresión, fotografía y audiovisuales
o Equipos y suministros de defensa, orden público, protección, vigilancia y seguridad
o Equipos y suministros para limpieza
o Maquinaria, equipo y suministros para la industria de servicios
o Equipos, suministros y accesorios para deportes y recreación
o Alimentos, bebidas y tabaco
o Medicamentos y productos farmacéuticos
o Artículos domésticos, suministros y productos electrónicos de consumo
o Ropa, maletas y productos de aseo personal
o Productos para relojería, joyería y piedras preciosas
o Publicaciones impresas, publicaciones electrónicas y accesorios
o Muebles, mobiliario y decoración
o Instrumentos musicales, juegos, juguetes, artes, artesanías y equipo educativo, materiales,
o accesorios y suministros
Segmento 95: Terrenos, edificios, estructuras y vías
Para servicios:
Segmentos 70 al 94: Servicios
o Servicios de contratación agrícola, pesquera, forestal y de fauna
o Servicios de minería, petróleo y gas
o Servicios de edificación, construcción de instalaciones y mantenimiento
o Servicios de producción industrial y manufactura
o Servicios de limpieza, descontaminación y tratamiento de residuos
o Servicios medioambientales
o Servicios de transporte, almacenaje y correo
o Servicios de gestión, servicios profesionales de empresa y servicios administrativos
o Servicios basados en ingeniería, investigación y tecnología
o Servicios editoriales, de diseño, de artes gráficas y bellas artes
o Servicios públicos y servicios relacionados con el sector público
o Servicios financieros y de seguros
o Servicios de salud
o Servicios educativos y de formación
o Servicios de viajes, alimentación, alojamiento y entretenimiento
Fuente: Guía para la codificación de bienes y servicios de acuerdo con el código estándar de productos y servicios de Naciones
Unidas, V.14.080, página 02, disponible en
https://www.colombiacompra.gov.co/sites/cce_public/files/cce_documents/cce_guia_codificacion_bienes.pdf, acceso en 13 de
septiembre de 2018.
5
Acceso en 14 de septiembre de 2018
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Subdirección de Gestión de Fiscalización Tributaria
Cra. 7 Nº 6C-54 piso 7º PBX 607 9800 ext. 907401
Código postal 111711
www.dian.gov.co Página 343 de 610
Código Descripción
Los primeros dos o tres dígitos N1, N2, N3, en el caso de la estructura GTIN-13 y GTIN-8, constituyen el
prefijo GS1, asignado por GS1 Global a cada Organización Miembro. No significa que el artículo fue
producido o distribuido en el país donde si le haya asignado el prefijo. El Prefijo GS1 sólo indica la
Organización Miembro de GS1 que asignó el Número de Compañía. La estructura GTIN 12 no contiene
prefijos de organización miembro.
Después del prefijo GS1 viene el número de compañía y es asignado por la Organización Miembro.
La asignación de los Números de Identificación GTIN8 se limita a los artículos que verdaderamente no
pueden acomodarse en un código de barras GTIN13 o UPC-A y si asignan de manera individual a través de
las Organizaciones Miembros de GS1, cuando se los solicita.
Antes de decidir si se utilizará un Número de Identificación GTIN8, el usuario debería considerar, (junto
con el impresor), todas las opciones disponibles para utilizar un número de Identificación GTIN13. Estas
opciones pueden ser:
Si es posible reducir el tamaño del símbolo, es decir, imprimirlo con una magnificación menor,
teniendo en cuenta los requerimientos mínimos de calidad de impresión de código de barras.
Si es posible cambiar la etiqueta de manera razonable (la etiqueta significa toda la superficie de
diseño impresa, ya sea que si la adhiera por separado o no) permitiendo así incluir el tamaño del
Símbolo EAN estándar recomendado por el impresor. Esto podría lograrse rediseñando la etiqueta,
incrementando el tamaño de la etiqueta (en especial cuando ésta es pequeña en comparación con
el área del paquete) o utilizando una etiqueta adicional.
Cuando hay menos de 14 números en una estructura de datos, Ej. GTIN8, los números se deben justificar
a la derecha en un campo de 14 dígitos rellenado con ceros en las posiciones ubicadas más a la izquierda.
El GTIN es una clave de acceso a toda la información relacionada con el artículo comercial, que está
almacenada en los campos de datos o en los mensajes de transacción.
La etiqueta contendrá los elementos que constituyen la implementación del estándar técnico XAdES, i.e.
XML Advanced Electronic Signature asc; firma electrónica avanzada XML.
La política de firma suministra la información que sobre la firma digital con destino al control fiscal de la
DIAN, deberá aplicar el facturador electrónico como medida de ampliación del proceso de expedición de
las facturas electrónicas. Se advierte que los detalles de las técnicas informáticas de implementación no
forman parte de esta política. Únicamente se incluyen las referencias a los estándares que describen las
especificaciones técnicas sobre la implementación.
La política de firma suministra la información que sobre la firma digital debiera verificar el Adquirente, de
acuerdo con lo previsto en el Artículo 5. Verificación y Rechazo de la factura electrónica, del decreto 2242
de 2015.
El certificado público requerido para validar la firma debe ser embebido dentro del XPath:
/fe:Invoice/ext:UBLExtensions/ext:UBLExtension[2]/ext:ExtensionContent
/ds:Signature/ds:KeyInfo/ds:X509Data/ds:X509Certificate
en formato base64:
<ds:KeyInfo Id="xmldsig-50280329-cdf3-4bb7-9d8f-edd480c8079c-keyinfo">
<ds:X509Data>
<ds:X509Certificate>
MIIHEjCCBfqgAwIBAgIQRMochPrzPAhYXX/wKSkB/DANBgkqhkiG9w0BAQsFADCBqDEcMBoGA1UECQwTd3d3LmNlcnRpY2F
tYXJhLmNvbTEPMA0GA1UEBwwGQk9HT1RBMRkwFwYDVQQIDBBESVNUUklUTyBDQVBJVEFMMQswCQYDVQQGEwJDTzEY
MBYGA1UECwwPTklUIDgzMDA4NDQzMy03MRgwFgYDVQQKDA9DRVJUSUNBTUFSQSBTLkExGzAZBgNVBAMMEkFDIFNVQ
iBDRVJUSUNBTUFSQTAgFw0xNjEyMjMxOTUwMDhaGA8yMDE4MTIyMzE5NTAwNVowggEZMRQwEgYDVQQIDAtCT0dPVE
EgRC5DLjENMAsGA1UECwwERElBTjEPMA0GA1UEBRMGNjQ0NjM1MRowGAYKKwYBBAGBtWMCAxMKODAwMTk3MjY4N
DE7MDkGA1UECgwyVS5BLkUuIERJUkVDQ0lPTiBERSBJTVBVRVNUT1MgWSBBRFVBTkFTIE5BQ0lPTkFMRVMxFDASBgNVBA
cMC0JPR09UQSBELkMuMSgwJgYJKoZIhvcNAQkBFhlTQU5USUFHT1JPSkFTQERJQU4uR09WLkNPMQswCQYDVQQGEwJDTz
xPath
/Invoice/ext:UBLExtensions/ext:UBLExtension[2]/ext:ExtensionContent/ds:Signature/ds:Object/xade
s:QualifyingProperties/xades:SignedProperties/xades:SignedSignatureProperties/xades:SignaturePoli
cyIdentifier/xades:SignaturePolicyId/xades:SigPolicyHash/ds:DigestMethod/@Algorithm:=
Valor: http://www.w3.org/2001/04/xmlenc#sha512
xPath:
/Invoice/ext:UBLExtensions/ext:UBLExtension[2]/ext:ExtensionContent/ds:Signature/ds:Object/xade
s:QualifyingProperties/xades:SignedProperties/xades:SignedSignatureProperties/xades:SignaturePoli
cyIdentifier/xades:SignaturePolicyId/xades:SigPolicyId/xades:Description
Valor: Política de firma para facturas electrónicas de la República de Colombia.
8.11. Firmante
El elemento xades:SignerRole contiene uno y sólo uno de los siguientes atributos:
• “supplier” cuando la firma de la factura la realiza el Obligado a Facturar.
• “third party” cuando la firma la realiza un Proveedor Tecnológico que en su caso, actué en su nombre.
<xades:SignerRole>supplier</xades:SignerRole>
El no cumplimiento de estos valores deberá registrarse como una firma digital fallida para el documento
electrónico, motivada en:
Algoritmo de Firma del certificado digital (tipo SHA1) no previsto por la DIAN
Uso de la clave pública del certificado digital carece de los propósitos “firma digital” o “no repudio”.
Este motivo puede ser concurrente con los descritos en la celda anterior.
Regla-2
Lapso de Validez del Después de 30 de septiembre de 2016 T23:59:59
certificado digital
Signature Algorithm Valores válidos dentro del certificado digital:
sha256WithRSAEncryption
sha384WithRSAEncryption
sha512WithRSAEncryption
X509v3 Key Usage: critical Valores necesarios dentro del certificado digital:
Digital Signature
Non Repudiation
Descripción:
Estamos aplicando la reglamentación de la ONAC, URL
http://onac.org.co/anexos/documentos/TRANSICIRCULARES/2016circulares/circular03-2016.pdf
Si el valor “Validity” del lapso de vigencia del certificado empezó después del 30 de septiembre de 2016
T23:59:59, la firma digital de la factura electrónica tiene que:
Emplear certificados digitales que hayan sido generados con resúmenes criptográficos del tipo SHA256;
existen otras opciones como aparece en la lista << Signature Algorithm >>
Que el resumen criptográfico que se aplicó al fragmento que fue firmado digitalmente corresponda con el <<
SignatureMethod >> empleado
El no cumplimiento de estos valores deberá registrarse como una firma digital fallida para el documento
electrónico, motivada en:
Algoritmo de Firma del certificado digital (tipo SHA2) no previsto por la DIAN
Uso de la clave pública del certificado digital carece de los propósitos “firma digital” o “no repudio”. Vea
Anexo 2.
Este motivo puede ser concurrente con los descritos en la celda anterior.
Regla-3
Algoritmo de firma digital Certificado digital expedido después de 30 de septiembre de 2016
aplicado a la factura T23:59:59
electrónica dentro del
documento electrónico
UBL
/Invoice/ext:UBLExtension Algoritmo=RSAwithSHA256
s/ext:UBLExtension[X]/ext Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha256
:ExtensionContent/ds:Sig
Algoritmo=RSAwithSHA384
nature/ds:SignedInfo/ds:S
Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha384
ignatureMethod/@Algori
thm= Algoritmo=RSAwithSHA512
Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha512
Descripción:
Estamos aplicando la reglamentación de la ONAC, URL
http://onac.org.co/anexos/documentos/TRANSICIRCULARES/2016circulares/circular03-2016.pdf
El algoritmo de firma digital aplicado a la facture electrónica no tiene correspondencia directa con el
resumen criptográfico utilizado para obtener los fragmentos de la Regla-4, i.e. pueden usarse tamaños de
Si el valor del ../ds:SignatureMethod/@Algorithm no corresponde con los valores paramétricos, entonces deberá
registrarse como una firma digital fallida para el documento electrónico, motivada en:
Empleó un algoritmo de firma digital no previsto por la DIAN.
/Invoice/ext:UBLExtensions/ext:
UBLExtension[X]/ext:ExtensionC
ontent/ds:Signature/ds:SignedIn
fo/ds:Reference[3]/ds:DigestMe
thod/@Algorithm
/Invoice/ext:UBLExtensions/ext:
UBLExtension[X]/ext:ExtensionC
ontent/ds:Signature/ds:Object/x
ades:QualifyingProperties/xades
:SignedProperties/xades:SignedS
ignatureProperties/xades:Signin
gCertificate/xades:Cert[1]/xades
:CertDigest/ds:DigestMethod/@
Algorithm=
/de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[2]/ext:Extensio
nContent/ds:Signature/ds:Objec
t/xades:QualifyingProperties/xa
des:SignedProperties/xades:Sign
edSignatureProperties/xades:Sig
ningCertificate/xades:Cert[2]/xa
El algoritmo de resumen criptográfico utilizado para los fragmentos que intervienen y forman parte del
elemento que se firma digitalmente no tiene correspondencia con el algoritmo de firma digital de la Regla-
3.
Si el valor del ../ds:DigestMethod/@Algorithm no corresponde con los valores paramétricos, entonces deberá
registrarse como una firma digital fallida para el documento electrónico, motivada en:
Empleó un algoritmo de resumen criptográfico no previsto por la DIAN. Vea Anexo 2.
El CUFE tal como se calcula en esta especificación técnica está indicado y referenciado para las instancias o
ejemplares que contienen datos con la sintaxis y la semántica de operaciones mercantiles y que se producen
para dejar registro electrónico de la ocurrencia de las mismas. Las instancias corresponden a los siguientes
documentos que forman parte de los perfiles de transacciones comerciales para la DIANi:
Factura de venta
Nota Crédito
Nota Débito
Para todos los documentos de los perfiles de transacciones comerciales para la DIAN se incluirá la etiqueta
<cbc:UUID/> que contendrá un identificador universal que para los documentos Factura de venta y Factura
de exportación, se denomina CUFE. Este identificador y el atributo están localizados en la siguiente ruta:
XPathii:
/Invoice/cbc:UUID
/Invoice/cbc:UUID/@schemeName tendrá el valor indicado en la sección 6.1.2 Algoritmo CUFE
La etiqueta contendrá el resultado del cálculo especificado en esta sección. Los elementos que componen
los detalles se encuentran en el documento «ANEXO TÉCNICO – FORMATOS DE INTERCAMBIO DE LA
FACTURACIÓN ELECTRÓNICA – Definición de los Esquemas y Perfiles XSD».
Esta especificación suministra la información que sobre el CUFE, como mecanismo del sistema técnico de
control fiscal de la DIAN, deberá aplicar el OFE como medida de la ampliación del proceso de expedición de
las facturas electrónicas. Los mecanismos de esta medida facilitarán la inclusión de evidencias de validez de
la firma electrónica avanzada así el FE o quien verifique la validez de la firma intente repudiar la factura
electrónica posteriormente, haciendo más confiable la circulación de los documentos electrónicos entre
los participantes en las operaciones de compra-venta de bienes y servicios, y serán tenidas en cuenta por
la autoridad competente cuando se reglamente el parágrafo 1 del artículo primero de la Ley 1231 de 2008,
según lo dispuesto en los considerandos el Decreto 2242-2015. Los ingenieros de software del OFE deberán
conocer este documento, y se advierte que los detalles de las técnicas informáticas de implementación del
CUFE se describen en esta sección.
Composición del CUFE = SHA-1 o Sha256(NumFac + FecFac + HorFac + ValFac + CodImp1 + ValImp1 + CodImp2 +
ValImp2 + CodImp3 + ValImp3 + ValTot + NitOFE + NumAdq + ClTec + TipoAmbie)
CUFE.SHA1 4646e6270c8873d13113f74511454d97b24b9d2a
Destino: /Invoice/cbc:UUID
Ref: http://www.sha1-online.com/
CUFE.SHA256 e5bac48e354bc907bccff0ea7d45fbf784f0a8e7243b58337361e1fbd430489d
Destino: /Invoice/cbc:UUID
Ref: http://www.sha1-online.com/
9.3.2.1. XPath
De forma no ambigua se especifican las expresiones XPath que deben aplicarse a una factura electrónica para obtener
la información requerida y permitir la generación del CUFE.
Definición identificadora de la transcripción de una factura de venta de exportación.
NumFac /Invoice/cbc:ID
FecFac /Invoice/cbc:IssueDate/>
Hora Factura /Invoice/cbc:IssueTime/>
Valor Bruto = /Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount/>
Codigo Impuesto 1 /Invoice/cac:TaxTotal[x]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
Valor Impuesto 1 /Invoice/cac:TaxTotal[x]/cac:TaxSubtotal/cbc:TaxAmount
CodImp2 /Invoice/ cac:TaxTotal[y]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 02
Valor Impuesto 1 2 /Invoice/cac:TaxTotal[y]/cac:TaxSubtotal/cbc:TaxAmount
CodImp3 /Invoice/cac:TaxTotal[z]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 03
Valor Impuesto 1 3 /Invoice/cac:TaxTotal[z]/cac:TaxSubtotal/cbc:TaxAmount
Valor Total a Pagar /Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount/>
NitOFE /Invoice/ cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID/>
NumAdq = /Invoice/ cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID/>
ClTec = no está en el XML
Tipo de Ambiente /Invoice/cbc:ProfileExecutionID
Nota-1: las transcripciones de datos de una factura de contingencia no utilizan la Clave técnica durante el
cálculo del identificador universal que se registra en el elemento /fe:Invoice/cbc:UUID, debido a que a este
rango autorizado no se le asigna este identificador.
Nota-2: las verificaciones sobre la autorización del NumFac en el SIE FE para los documentos-e con el
«/fe:Invoice/cbc:InvoiceTypeCode=3» se realizan y se registran por parte de la DIAN para las operaciones de
recepción electrónica. Los documentos-e con «/Invoice/cbc:InvoiceTypeCode=3» entregados a la DIAN antes de
la fecha de aplicación de esta medida correctiva en el Sistema informático (agosto 15 de 2018), y que aparecen
con el resultado de la verificación del NumFac como “fallido”, serán sometidas al tratamiento de excepción
porque el error se originó en la información suministrada por la DIAN.
9.3.3.1. XPath
De forma no ambigua se especifican las expresiones XPath que deben aplicarse a la transcripción de una factura de
contingencia para obtener la información requerida y permitir la generación del identificador.
Definición del identificador de una factura de contingencia.
NumFac /Invoice/cbc:ID
FecFac / Invoice/cbc:IssueDate/>
HorFac / Invoice/cbc:IssueTime/>
ValFac / Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount
CodImp1 / Invoice/cac:TaxTotal[x]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
ValImp1 / Invoice/cac:TaxTotal[x]/cac:TaxSubtotal/cbc:TaxAmount
CodImp2 / Invoice/cac:TaxTotal[y]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 02
ValImp2 / Invoice/cac:TaxTotal[y]/cac:TaxSubtotal/cbc:TaxAmount
CodImp3 / Invoice/cac:TaxTotal[z]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 03
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Subdirección de Gestión de Fiscalización Tributaria
Cra. 7 Nº 6C-54 piso 7º PBX 607 9800 ext. 907401
Código postal 111711
www.dian.gov.co Página 560 de 610
ValImp3 / Invoice/cac:TaxTotal[z]/cac:TaxSubtotal/cbc:TaxAmount
ValTol / Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount
NitOFE /Invoice/ cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID/>
NumAdq /Invoice/ cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID/>
TipoAmb / Invoice/cbc:ProfileExecutionID
9.3.4.1. XPath
De forma no ambigua se especifican las expresiones XPath que deben aplicarse a una nota crédito para obtener la
información requerida y permitir la generación del identificador universal.
Definición del identificador de una nota crédito.
NumFac / CreditNote/cbc:ID
FecFac / CreditNote/cbc:IssueDate/>
HorFac / CreditNote/cbc:IssueTime/>
ValFac / CreditNote/cac:LegalMonetaryTotal/cbc:LineExtensionAmount
CodImp1 / CreditNote/cac:TaxTotal[x]/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
10.3.5.1. XPath
De forma no ambigua se especifican las expresiones XPath que deben aplicarse a una factura electrónica para obtener
la información requerida y permitir la generación del CUFE.
Definición CUFE de una NotaDebito
NumFac / DebitNote/cbc:ID
FecFac / DebitNote/cbc:IssueDate/>
Examine la Autorización expedida por la DIAN que definió el Rango de Facturación; examine el Anexo 6 y el archivo
wsdl que lo acompaña. En el archivo response los rangos vienen acompañado de un identificador denominado clave
técnica: ese es el valor que estamos necesitando.
Asegúrese de que el prefijo de dicho rango fue asociado al NIT del proveedor de la versión de software i.e. el OFE o
el PT según el caso— de acuerdo con lo registrado en los servicios del sistema de facturación electrónica de la DIAN;
de esta manera cuando el OFE o el PT entreguen a la DIAN la factura expedida, el mecanismo de control fiscal validará
que este documento electrónico fue generado por un sistema de software activo en el sistema de facturación
electrónica a nombre del OFE o del PT que expide la factura, y podrá recuperar el rango autorizado y la clave técnica
asignada. Con estos últimos el mecanismo de control fiscal validará que la factura está consumiendo elementos del
rango, y podrá aplicar el algoritmo de cálculo del CUFE.
ADVERTENCIA: De acuerdo al anexo 6, cuando un Facturador Electrónico haya agotado el rango de numeración que
le fue asignado y deba solicitar la autorización de un nuevo rango de numeración para facturas electrónicas que sea
la continuación de un rango ya autorizado, se debe tener en cuenta, que el SIE Rangos de Numeración cuando haga
la consulta del web Service, le entregará una nueva CLAVE TÉCNICA, esta CLAVE TÉCNICA, es diferente a la del anterior
rango.
Para la representación gráfica de las facturas electrónicas, es requisito la generación de un código QR con
la siguiente información:
NumFac: [NUMERO_FACTURA]
FecFac: [FECHA_FACTURA]
HorFac: [HORA_FACTURA(con GMT)]
NitFac: [NIT FACTURADOR] sin puntos ni guiones
DocAdq: [NUMERO_ID_ADQUIRIENTE] sin puntos ni guiones
ValFac: [VALOR_FACTURA] con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo
pesos.
ValIva: [VALOR_IVA] con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
ValOtroIm: [VALOR_OTROS_IMPUESTOS] con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles,
ni símbolo pesos.
ValFacIm: [VALOR_OTROS_IMPUESTOS] con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles,
ni símbolo pesos.
CUFE: [CUFE]
Ejemplo:
Teniendo en cuenta los datos de entrada, se presenta el código QR que se incluye en la representación
gráfica de la factura electrónica:
NumFac: 323200000129
FecFac: 2019-16-01
HorFac: 10:53:10-05:00
NitFac: 700085371
DocAdq: 800199436
ValFac: 1500000.00
ValIva: 285000.00
ValOtroIm: 0.00
ValTolFac: 1785000.00
CUFE: e5bac48e354bc907bccff0ea7d45fbf784f0a8e7243b58337361e1fbd430489d
Tamaño
El tamaño mínimo que debe tener el código bidimensional QR es de 2cm para facilitar la lectura por los
diferentes dispositivos.
La Representación Gráfica
La representación gráfica puede ser diseñada de acuerdo con las necesidades del OFE; como la generación
está en formato XML, entonces cualquier herramienta informática de conversión de este formato a .pdf,
Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN
Subdirección de Gestión de Fiscalización Tributaria
Cra. 7 Nº 6C-54 piso 7º PBX 607 9800 ext. 907401
Código postal 111711
www.dian.gov.co Página 564 de 610
.docx, u otros formatos digitales será suficiente para cumplir lo exigido en el parágrafo 1 del artículo 3 del
Decreto 2242-2015. El requisito que debe cumplir es la inclusión del código bidimensional QR tal como se
precisa arriba.
Una alternativa a los formatos digitales es la impresión en papel de la representación gráfica diseñada de
acuerdo con las necesidades del OFE. El requisito que debe cumplir es la inclusión del código bidimensional
QR tal como se precisa arriba.
La representación gráfica debe incluir el código QR en todas las páginas de los formatos digitales y de la
impresión en papel de la factura electrónica.
La representación gráfica siempre será “una representación, una imagen” de la información consignada en
el formato XML de los perfiles de transacciones comerciales para la DIAN. Esto significa que el documento
electrónico siempre será el que tenga valor legal para las autoridades nacionales. Si cualquier persona
requiere validar la autenticidad de una representación gráfica, entonces deberá acceder al sitio web que la
DIAN disponga para ello, activar el hiperenlace, diligenciar los campos de información, disparar el botón de
Validación, y comparar lo que le muestra la respuesta devuelta por el sistema de facturación electrónica de
la DIAN con lo que le exhibe la representación que tiene a la mano, y proceder en consecuencia. Si la
información difiere, podrá denunciar el hecho a la DIAN, porque puede tratarse de un documento apócrifo,
sin validez legal, y que podría ser la evidencia de una acción que amerita ser investigada fiscalmente, con
las implicaciones comerciales, administrativas y penales que se deriven por la infracción del Estatuto
tributario.
Cada servicio se encuentra respaldado por un metodo Web específico. El modelo de comunicación e
interoperabilidad siempre iniciará en el sistema del contribuyente (HFE), por medio del consumo del
método correspondiente para validar los documentos ante la DIAN.
Metodos Asíncronos:
La llamada (Request) del servidor del cliente a los servicios síncronos es procesado de forma inmediata por
el servidor de DIAN y la respuesta (Response) se realiza en la misma conexión.
Para ello el sistema de los participantes, deberán tener las siguientes consideraciones:
El medio físico de comunicación es Internet, con la utilización del protocolo TLS versión 1.2, con
autentificación mutua través de certificados digitales.
El modelo de comunicación sigue el estándar de servicios web definido por el WS-Security 1.0 Oasis, con
autenticación X.509 Certificate Token Profile 1.1
El intercambio de mensajes entre los Servicios Web de la DIAN y el sistema del Habilitado para Facturar
Electrónicamente (HFE) o el Proveedor Tecnológico (PT) / Autorizado (PA) será realizado mediante el
estándar SOAP versión 1.2, con intercambio de mensajes XML en el estándar Style/Encoding:
Document/Literal.
La llamada de cada uno de los servicios web es realizada con el envío de un mensaje XML a través del campo
<soap:Body/>
La información de control de las llamadas a los Servicios Web se almacena en el elemento Header del SOAP
y su fin es identificar y autenticar por medio del certificado digital utilizado.
Cada servicio se encuentra respaldado por un Método Web específico. El modelo de comunicación e
interoperabilidad siempre iniciará en el sistema del contribuyente (HFE), por medio del consumo del servicio
correspondiente de un PA, el cual posteriormente, consumirá los servicios de la DIAN para validar los
documentos ante esta.
A continuación, se detalla cada uno de los Servicio Web que el sistema provee
El servicio puede recibir un ZIP con uno o más (Máximo 50) documentos electrónicos firmados digitalmente,
en formato UBL y construido según el esquema detallado en este Manual Técnico.
Ejemplo de Petición
El servicio puede recibir un ZIP con uno o todos los documentos asociados al Set de Prueba.
Se envían los parámetros de consumo en la estructura XML definida para este método.
Se generara un TrackId al ZIP.
Se descomprime ZIP y se validan los siguientes elementos del ZIP:
o Archivo ZIP no este vacío.
o Archivo ZIP no esté corrupto
o No den error de lectura los archivos UBLs.
Validaciones iniciales:
Ejemplo de Petición
El servicio puede recibir un ZIP con un solo documento electrónico firmado digitalmente, en formato UBL y
construido según el esquema detallado en este Manual Técnico.
Se envían los parámetros de consumo en la estructura XML definida para este método.
Se genera un TrackId al UBL (en general es el CUFE del documento, en caso que no contenga CUFE
se le asignara un TracId)
Se descomprime ZIP y se validan los siguientes elementos del ZIP:
o Archivo ZIP no este vacío.
o Archivo ZIP no esté corrupto
o Que no sean más de 1 UBL en el ZIP.
o No den error de lectura del archivos UBL.
Validaciones iniciales:
Ejemplo de Petición
00 = Procesado Corectamente
R StatusCode string 1.0
66= NSU no encontrado
90 = TrackId no encontrado
99 = validaciones contienen errores en
campos mandatorios
00 = Procesado Corectamente
R StatusDescription string 1.0
66= NSU no encontrado
90 = TrackId no encontrado
99 = validaciones contienen errores en
campos mandatorios
Entrega una descripción del error de
O StatusMessage string 1.0
cada una de la vaidaciones iniciales . Si
no hay errores no entrega descripción
Entrega el UBL correspondiente al
Arreglo de
R XmlBase64Bytes ApplicationResponse con la respuesta 1.0
Bytes
oficial del la DIAN en forma
estructurada en base64
Arreglo de
O XmlBytes 1.0
Bytes
El servicio puede recibir un ZIP con uno o más (Máximo 50) AttachedDocument con los archivos a validar
(DFE+AR-Validación)
Se envían los parámetros de consumo en la estructura XML definida para este método.
Se genera un TrackId al ZIP.
Se descomprime ZIP y se validan los siguientes elementos del ZIP:
o Archivo ZIP no este vacío.
Nota: El procedimiento de validación de campo se aplica concretamente sobre el contenido del valor del
campo UBL transmitido.
Ejemplo de Petición
Ejemplo
Ejemplo:
<b:XmlBase64Bytes>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5kYWxvbmU9Im5vIj8+PGRlOkFwcGxpY2F
0aW9u....==</b:XmlBase64Bytes>
<b:XmlBytes i:nil="true"/>
<b:XmlDocumentKey>00636660a1b4e22bb2f70c19d4d2fd99e498902b</b:XmlDocumentKey>
<b:XmlFileName>11a65c09-a4ba-4990-9491-3a9d47521aaa</b:XmlFileName>
</GetStatusResult>
</GetStatusResponse>
</s:Body>
</s:Envelope>
La respuesta . ApplicationResponse
con la información del evento
correspondiente. En Base54 ( puede Arreglo de
XmlBase64Bytes 1.0
ser configurado para que esta bytes
información se entregue en un arreglo
de byte
Arreglo de
R XmlBytes Corresponde al valor parámetro: true 1 1.0
bytes
Ejemplo
Ejemplo:
<b:XmlDocumentKey>A08f2283e5dd6c1878e6ea9ec3a695a9431c924e1086607f6ae7123d081af7b88</b:XmlDocumentKey>
<b:XmlFileName>invoice-1-firmado-SHA256</b:XmlFileName>
</b:DianResponse>
</GetStatusZipResult>
</GetStatusZipResponse>
</s:Body>
</s:Envelope>
La respuesta . ApplicationResponse
con la información del evento
correspondiente. En Base54 ( puede Arreglo de
XmlBase64Bytes
ser configurado para que esta bytes
información se entregue en un arreglo
de byte
Arreglo de
R XmlBytes Corresponde al valor parámetro: true 1 1.0
bytes
Se envían los parámetros de consumo en la estructura XML definida para este método.
Se descomprime ZIP y se validan los siguientes elementos del ZIP:
o Archivo ZIP no este vacío.
o Archivos ZIP no este corrupto
o Que no sean más de 50 ApplicationResponse en el ZIP.
o No den error de lectura los archivos UBLs.
Validaciones iniciales:
Ejemplo de Petición
Codigo de respuesta
100= Acción completada OK
NOTA: Se envían solo los parámetros de autenticación por certificado definida para este método.
Ejemplo
Se envían los parámetros de consumo en la estructura XML definida para este método.
Ejemplo
401= No autorizado
Ejemplo
401= No autorizado
https://www.soapui.org/downloads/soapui.html
Ejemplo URL:
https://colombia-dian-webservices-input-sbx.azurewebsites.net/WcfDianCustomerServices.svc?wsdl
Los próximos campos a completar debe tener los mismos valores que se indican en la imagen a continuación.
12.13. Recomendaciones
Se recomienda después de crear o actualizar la configuración del WS-Security eliminar
el request anterior y crear uno nuevo. Estos no ven reflejados las actualizaciones de la
configuración global.