Documente Academic
Documente Profesional
Documente Cultură
Índice de Tablas
Tabla 1 – Conjuntos de Grupos Coumunes a los Documentos Fiscales Electrónicos.................................................13
Tabla 2 – Convenciones Utilizadas en la Tablas de Definición de los Formatos XML.................................................13
Tabla 3 – Tipos de Campo en los Archivos XML.........................................................................................................14
Tabla 4 – Tipos de Datos de los Elementos en los Archivos XML...............................................................................14
Tabla 5 – Tamaños de Elementos..............................................................................................................................15
Tabla 6 – Ejemplos de Información de Valores Utilizando los Formatos Numéricos.................................................15
Tabla 7 – Nombres de las Columnas de las Tablas de Reglas de Validación..............................................................16
Tabla 8 – Ubicaciones Estándar para Informaciones Comunes.................................................................................17
Tabla 9 – Relacionamientos Mutuos Entre los Eventos.............................................................................................44
Tabla 10 – Ejemplos de Mensajes de Validación.....................................................................................................200
Tabla 11 – Códigos de Colombia Compra Eficiente.................................................................................................232
Índice de Figuras
Figura 1 – Niveles jerárquivos del sistema de codificación Colombia Compra Eficiente..........................................232
Figura 2 – Estructura de los códigos GTIN 8, 12 y 13...............................................................................................423
Figura 3 – Estructura del código GTIN 14.................................................................................................................424
Figura 4 – Árbol de decisión para elección de código GTIN.....................................................................................426
Figura 5 – Estructura de almacenamiento de códigos GTIN....................................................................................427
1.3. 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:
Esta definición si hace para que si 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 si deberá utilizar el elemento
/de:Invoice/de:LegalMonetaryTotal/cbc:PayableRoundingAmount para informar la diferencia.
Ejemplos para redondear cuando el algarismo menos significativo es la segunda casilla decimal:
Valor a Valor
Redondear Redondeado
1.723 1.72
1.726 1.73
1.7252 1.72
1.7253 1.73
1.7258 1.72
3
Vea el documento Formatos de los Documentos XML de Facturación Electrónica.
4
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 si 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.
Ejemplos de cómo si debe informar valores en los elementos numéricos de acuerdo con el formato
especificado pueden ser encontrados en la Tabla 6.
Tabla 6 – Ejemplos de Información de Valores Utilizando los Formatos Numéricos
Formato Para Informar Llenar elemento con
1,105.13 00001105.13
1,105.137 0001105.137
11 p (0-6) 1,105 00000001105
0 00000000000
para no informar cantidad no es posible
1,105.13 001105.1300
1,105.137 001105.1370
11 p 4 1,105 001105.0000
0 000000.0000
para no informar cantidad no es posible
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 00000001105
11 0 00000000000
para no informar cantidad no es posible
1,105 1105
0-11 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
/
AA13 IssueTime Hora de emisión 14 Invoice 1..1 1.0 de:Invoice/cbc:IssueTim
e
Ver lista de valores posibles en 6.1.3
/
Rechazo si este elemento no corresponde a un
AA14 InvoiceTypeCode Tipo de Factura 2 Invoice 1..1 1.0 de:Invoice/cbc:InvoiceTy
valor de la columna "Código" de uso “Tipo de
peCode
factura”
Información adicional: Texto libre, 15 -
AA15 Note Invoice 0..1 1.0 /de:Invoice/cbc:Note
relativo al documento 5000
/
Información Adicional: Texto libre para 20..500
AB03 cbc Note E A InvoiceLine 0..1 1.0 de:Invoice/de:InvoiceLin
añadir información adicional al artículo. 0
e/cbc:Note
< ApplicationResponse>
< UBLExtension>
Firma digital sobre la estructura del evento
< UBLExtension/>
…datos generales del evento
<SenderParty>
<Datos del responsable por la generación del evento: PA o DIAN/>
<SenderParty/>
< DocumentResponse>
<Response>
Autorización de uso del DFE: evento 001 o 002
<Response/>
<AdditionalDocumentReference>
Caracterización del documento validado
<AdditionalDocumentReference/>
<IssuerParty>
Datos del emitente del documento validado
<IssuerParty/>
<RecipientParty>
Datos del adquiriente del documento validado
<RecipientParty/>
<LineResponse>
< Response>
< ApplicationResponse>
<XML del evento #1 />
< ApplicationResponse/>
< ApplicationResponse>
<XML del evento #2 />
< ApplicationResponse/>
< AttachedDocument/>
3.5.4.3. Documento Fiscal 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 5.4.6; y
o Después que haya sido validado, enviar el nuevo documento para el adquiriente, con las explicaciones adecuadas,
y seguir otros procedimientos legales que eventualmente sean requeridos para la debida corrección.
PA deberá corregir su aplicación para que no se repita el problema.
Cardinalidad: solamente puede ser registrado uno de estos eventos para un determinado documento electrónico.
3.5.4.4. Documento Fiscal Electrónico Referenciado por Otro Documento Fiscal Electrónico
DFE fue referenciado en el elemento root/cac:AdditionalDocumentReference del DFE apuntado por el evento.
Responsable por el Registro: DIAN
Efectos:
Si el otro DFE es una Nota Crédito o Nota Débito, el registro de la operación pasa a valer de acuerdo con las
informaciones corregidas por la Nota.
Si el otro DFE es una Factura, el elemento /de:/de:ApplicationResponse/cbc:Note debe contener la explicación del
motivo de la referencia
Cardinalidad: solamente puede ser registrado uno de estos eventos para una determinada Nota Crédito o una determinata
Nota Débito, pero no existen restricciones para el número de DFE que pueden referenciar una determinada factura.
ID NS Campo Descripción T F Tam Padre Oc Observacíones V Xpath
Application
BE01 cac SenderParty Responsable por el registro del evento: DIAN G 1..1 Ver definición del grupo en 5.1.5 1.0 /de:ApplicationResponse/cac:Party
Response
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
Grupo de la primera referencia que root/ext:UBLExtensions/ext:UBLExt
DC05 ds Reference contiene la firma aplicada de todo G Signature 1..1 URI="" 1.0 ension/ext:ExtensionContent/ds:Si
el documento gnature/ds:SignedInfo/ds:Referenc
e
/
root/ext:UBLExtensions/ext:UBLExt
DC06 ds Transforms Grupo de trasformación del documento G Reference 1..1 1.0 ension/ext:ExtensionContent/ds:Si
gnature/ds:SignedInfo/ds:Referenc
e/ds:Transforms
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
Resultado de aplicar el algoritmo de
root/ext:UBLExtensions/ext:UBLExt
generación hash especificado en el
DC09 ds DigestValue Reference 1..1 1.0 ension/ext:ExtensionContent/ds:Si
“DigestMethod” en codificación
gnature/ds:SignedInfo/ds:Referenc
base64
e/ds:DigestValue
/
Grupo de la segunda referencia donde se root/ext:UBLExtensions/ext:UBLExt
DC10 ds Reference especifica clave pública contenida G Signature 1..1 URI="#{UUID}-KeyInfo" 1.0 ension/ext:ExtensionContent/ds:Si
en el elemento KeyInfo. gnature/ds:SignedInfo/ds:Referenc
e
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
Resultado de aplicar el algoritmo de
root/ext:UBLExtensions/ext:UBLExt
generación hash especificado en el
DC12 ds DigestValue Reference 1..1 1.0 ension/ext:ExtensionContent/ds:Si
“DigestMethod” en codificación
gnature/ds:SignedInfo/ds:Referenc
base64
e/ds:DigestValue
/
Grupo de la tercera referencia de los root/ext:UBLExtensions/ext:UBLExt
DC13 ds Reference elementos contenidos dentro G Signature 1..1 URI="#xmldsig-{UUID}-signedprops" 1.0 ension/ext:ExtensionContent/ds:Si
“SignedProperties” gnature/ds:SignedInfo/ds:Referenc
e
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
Resultado de aplicar el algoritmo de
root/ext:UBLExtensions/ext:UBLExt
generación hash especificado en el
DC15 ds DigestValue Reference 1..1 1.0 ension/ext:ExtensionContent/ds:Si
“DigestMethod” en codificación
gnature/ds:SignedInfo/ds:Referenc
base64
e/ds:DigestValue
Resultado de aplicar el algoritmo de /
generación hash especificado en el root/ext:UBLExtensions/ext:UBLExt
DC16 ds SignatureValue Signature 1..1 1.0
“SignatureMethod” en codificación ension/ext:ExtensionContent/ds:Si
base64 gnature/ds:SignatureValue
/
Grupo de información para embeber el
root/ext:UBLExtensions/ext:UBLExt
DC17 ds KeyInfo certificado público requerido para G Signature 1..1 1.0
ension/ext:ExtensionContent/ds:Si
validar la firma.
gnature/ds:KeyInfo
/
Grupo que contiene el certificado publico root/ext:UBLExtensions/ext:UBLExt
DC18 ds X509Data G KeyInfo 1..1 1.0
del que firma el documento ension/ext:ExtensionContent/ds:Si
gnature/ds:KeyInfo/ds:X509Data
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
root/ext:UBLExtensions/ext:UBLExt
Resultado de aplicar el algoritmo de ension/ext:ExtensionContent/ds:Si
generación hash especificado en el SignedSignature gnature/ds:Object/xades:Qualifyin
DC29 ds DigestValue 1..1 1.0
“DigestMethod” en codificación Properties gProperties/xades:SignedPropertie
base64 s/xades:SignedSignatureProperties
/xades:SigningCertificate/xades:Ce
rt/xades:CertDigest/ds:DigestValue
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
/
root/ext:UBLExtensions/ext:UBLExt
Resultado de aplicar el algoritmo de ension/ext:ExtensionContent/ds:Si
generación hash especificado en el SignedSignature gnature/ds:Object/xades:Qualifyin
DC43 ds DigestValue 1..1 1.0
“DigestMethod” en codificación Properties gProperties/xades:SignedPropertie
base64 s/xades:SignedSignatureProperties
/xades:SigningCertificate/xades:Ce
rt/xades:CertDigest/ds:DigestValue
/
root/ext:UBLExtensions/ext:UBLExt
ension/ext:ExtensionContent/ds:Si
Grupo para definir los datos del SignedSignature gnature/ds:Object/xades:Qualifyin
DC44 xades IssuerSerial G 1..1 1.0
certificado Properties gProperties/xades:SignedPropertie
s/xades:SignedSignatureProperties
/xades:SigningCertificate/xades:Ce
rt/xades:IssuerSerial
RSAwithSHA512=http://www.w3.org/2
001/04/xmldsig-more#rsa-sha512
5.4.7. Referencia a DFE que Debe Existir en la Base de Datos de la DIAN: de:DocumentReference
Referencia a Documento Electrónico Autorizado de Acuerdo con Ley 1819, que debe existir en la base de datos de la DIAN.
ID NS Campo Descripción T F Tam Padre Oc Observacíones V Xpath
Document Referencia Documento (orden):
HI01 de G Root 1.0
Reference Referencia a un documento
6.3.4. Pagos
Contenidos del elemento de acuerdo con los atributos arriba (si recomienda cambiar a español):
Códig Códig
Medio Medio
o o
1 Instrumento no definido 39 Crédito Negocio Intercambio Corporativo (CTX)
2 Crédito ACH 40 Débito Negocio Intercambio Corporativo (CTX)
3 Débito ACH 41 Concentración efectivo/Desembolso Crédito plus (CCD+)
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
2U megagramo C88 voltios de electrones recíprocos M7 micropulgada
por metro cúbico
2V megagramo por hora C89 Henry Recíproco M9 millones de Btu por 1000 pies cúbicos
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
B60 lumen por metro cuadrado GL gramo por litro U1 tratamiento
B61 lumen por vatio GLD galón seco (EE. UU.) U2 tableta
B62 lumen segundo GLI galón (Reino Unido) UA torr
B63 hora de lux GLL galón UB Línea de telecomunicaciones en servicio
promedio.
B64 lux segundo GM gramo por metro cuadrado UC puerto de telecomunicaciones
B65 Maxwell GN galón bruto UD décimo minuto
B66 megaamperios por metro cuadrado GO miligramos por metro cuadrado UE décima hora
B67 megabecquerel por kilogramo GP miligramo por metro cúbico UF uso por línea de telecomunicación
promedio
B69 megacoulomb por metro cúbico GQ microgramos por metro cúbico UH diez mil yardas
B7 ciclo GRM gramo UM millones de unidades
B70 megacoulomb por metro cuadrado GRN grano VA voltio amperio por kilogramo
B71 megaelectronvolt GRO bruto VI frasco
B72 megagramo por metro cúbico GRT tonelada de registro bruto VLT voltio
B73 meganewton GT tonelada bruta VQ abultar
B74 medidor de meganewton GV gigajoule VS visitar
B75 megaohm GW galón por mil pies cúbicos W2 kilo mojado
B76 metro megaohm GWH hora de gigavatios W4 dos semanas
B77 megasiemens por metro GY patio bruto WA vatio por kilogramo
B78 megavoltio GZ sistema de medición WB libra mojada
B79 megavolt por metro H1 media página - electrónica WCD cable
B8 julios por metro cúbico H2 medio litro WE tonelada mojada
B81 metro recíproco cuadrado recíproco HA madeja WEB weber
segundo
B83 metro a la cuarta potencia HAR hectárea WEE semana
B84 microamperios HBA hectobar WG galon de vino
B85 microbar HBX cien cajas WH rueda
B86 microcoulomb HC cien cuentas WHR vatios hora
Codigo
Código
Departament Nombre Departamento Nombre Municipio
Municipio
o
05 05001 Antioquia MEDELLÍN
05 05002 Antioquia ABEJORRAL
05 05004 Antioquia ABRIAQUÍ
05 05021 Antioquia ALEJANDRÍA
05 05030 Antioquia AMAGÁ
05 05031 Antioquia AMALFI
05 05034 Antioquia ANDES
05 05036 Antioquia ANGELÓPOLIS
05 05038 Antioquia ANGOSTURA
05 05040 Antioquia ANORÍ
05 05042 Antioquia SANTA FÉ DE ANTIOQUIA
05 05044 Antioquia ANZÁ
05 05045 Antioquia APARTADÓ
05 05051 Antioquia ARBOLETES
05 05055 Antioquia ARGELIA
05 05059 Antioquia ARMENIA
05 05079 Antioquia BARBOSA
05 05086 Antioquia BELMIRA
05 05088 Antioquia BELLO
05 05091 Antioquia BETANIA
05 05093 Antioquia BETULIA
05 05101 Antioquia CIUDAD BOLÍVAR
05 05107 Antioquia BRICEÑO
05 05113 Antioquia BURITICÁ
05 05120 Antioquia CÁCERES
05 05125 Antioquia CAICEDO
05 05129 Antioquia CALDAS
05 05134 Antioquia CAMPAMENTO
05 05138 Antioquia CAÑASGORDAS
05 05142 Antioquia CARACOLÍ
05 05145 Antioquia CARAMANTA
7.1.5.2.3. Documento Fiscal Electrónico Validado por PA, y que Debería Haber Sido Rechazado
No existen reglas de validación específicas para este grupo.
7.1.5.2.4. Documento Fical Electrónico Referenciado por Otro Documento Fiscal Electrónico
No existen reglas de validación específicas para este grupo.
7.3.4.7. Referencia a DFE que Debe Existir en la Base de Datos de la DIAN: de:DocumentReference
ID Y Elemento Regla Mensaje V Xpath
CUFE del documento referenciado dene CUFE del documento referenciado no /
HI02a N UUID existir en la base de datos del PA o de la existe en la base de datos del PA o 1.0 root/DocumentReference
DIAN de la DIAN: <XPath> /cbc:UUID
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
HI02b R UUID “Factura Negociada como Título 1.0 root/DocumentReference
como Título Valor” el documento
Valor”, pero el documento /cbc:UUID
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 algoritmos
root/DocumentReference
HI03 R @scheme utilizado para el cáculo del CUFE debe permitidos para el cáculo del CUFE: 1.0
/cbc:UUID/@schemeNam
Name ser uno de los permitidos <Xpath>
e
DigestValue del documento
DigestValue del documento referenciado
referenciado debe e no /
debe corresponder al existente en el
HI04 N DigestValue corresponde al existente en el 1.0 root/DocumentReference
documento referido por este UUID en la
documento referido por este UUID /ds:DigestValue
base de datos de la DIAN
en la base de datos de la DIAN
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.
6
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 246 de 504
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.
El prefijo GS1 y el Número de Compañía conforman el prefijo de la compañía GS1 que si le asigna a cada
usuario del sistema mediante una organización. En general, contiene de 6 a 10 dígitos dependiendo de la
La asignación de los Números de Identificación GTIN8 si 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 si los solicita.
Antes de decidir si si 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.
Un símbolo truncado (un símbolo de longitud normal, pero de altura reducida) solo podrá
utilizarse si no existe ninguna otra posibilidad de imprimir un símbolo de tamaño normal. Pero
tenga en cuenta que el truncamiento no permite el escaneo omnidireccional del símbolo.
Cuando hay menos de 14 números en una estructura de datos, Ej. GTIN8, los números si 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. Los elementos que componen los
detalles se encuentran en el documento «Anexo Técnico 001 – Formatos de los Documentos XML de
Facturación Electrónica».
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.
<ds:CanonicalizationMethod
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
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”.
Pueden estar presentes ambos motivos.
Si el lapso de validez inhabilita a
/
de:Invoice/ext:UBLExtensions/ext:UBLExtension[2]/ext:ExtensionContent/ds:Signature/ds:Object/xades:Qualif
yingProperties/xades:SignedProperties/xades:SignedSignatureProperties/xades:SigningTime, entonces deberá
registrarse como una firma digital fallida para el documento electrónico, motivada en:
Fecha de expedición del documento electrónico no corresponde con el lapso de vigencia del certificado
digital.
Este motivo puede ser concurrente con los descritos en la celda anterior.
Regla-2
Regla-3
Algoritmo de firma Certificado digital expedido después de 30 de septiembre de
digital aplicado a la 2016 T23:59:59
factura electrónica dentro
del documento
electrónico UBL
/ Algoritmo=RSAwithSHA256
de:Invoice/ext:UBLExten Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha256
sions/ext:UBLExtension[ Algoritmo=RSAwithSHA384
X]/ext:ExtensionContent/ Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha384
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 451 de 504
Algoritmo de firma Certificado digital expedido después de 30 de septiembre de
digital aplicado a la 2016 T23:59:59
factura electrónica dentro
del documento
electrónico UBL
ds:Signature/ds:SignedInf Algoritmo=RSAwithSHA512
o/ds:SignatureMethod/@ Use: http://www.w3.org/2001/04/xmldsig-more#rsa-sha512
Algorithm=
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. Vea Anexo 2.
Si el valor del ../ds:SignatureMethod/@Algorithm corresponde a
http://www.w3.org/2000/09/xmldsig#rsa-sha1, entonces deberá registrarse como una firma digital fallida para
el documento electrónico, motivada en:
Empleó un algoritmo de firma digital que está caducado según el reglamento de la Ley de Comercio
Electrónico de Colombia. Vea Anexo 2.
/
de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[X]/ext:Extens
ionContent/ds:Signature/ds:Sign
edInfo/ds:Reference[3]/ds:Diges
tMethod/@Algorithm
/
de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[X]/ext:Extens
ionContent/ds:Signature/ds:Obje
ct/xades:QualifyingProperties/xa
des:SignedProperties/xades:Sign
edSignatureProperties/xades:Sig
ningCertificate/xades:Cert[1]/xa
des:CertDigest/ds:DigestMethod
/@Algorithm=
/
de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[2]/ext:Extensi
onContent/ds:Signature/ds:Obje
ct/xades:QualifyingProperties/xa
des:SignedProperties/xades:Sign
edSignatureProperties/xades:Sig
ningCertificate/xades:Cert[2]/xa
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 453 de 504
Algoritmos de resumen Certificado digital expedido después de 30 de septiembre
criptográfico aplicado a los de 2016 T23:59:59
fragmentos de la factura
electrónica que se incluyen
dentro del fragmento que se
firma digitalmente
des:CertDigest/ds:DigestMethod
/@Algorithm=
/
de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[2]/ext:Extensi
onContent/ds:Signature/ds:Obje
ct/xades:QualifyingProperties/xa
des:SignedProperties/xades:Sign
edSignatureProperties/xades:Sig
ningCertificate/xades:Cert[3]/xa
des:CertDigest/ds:DigestMethod
/@Algorithm=
/
de:Invoice/ext:UBLExtensions/e
xt:UBLExtension[X]/ext:Extens
ionContent/ds:Signature/ds:Obje
ct/xades:QualifyingProperties/xa
des:SignedProperties/xades:Sign
edSignatureProperties/xades:Sig
naturePolicyIdentifier/xades:Sig
naturePolicyId/xades:SigPolicy
Hash/ds:DigestMethod/@Algori
thm=
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 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.
Si el valor del ../ds:DigestMethod/@Algorithm corresponde a http://www.w3.org/2000/09/xmldsig#sha1,
entonces deberá registrarse como una firma digital fallida para el documento electrónico, motivada en:
Empleó un algoritmo de resumen criptográfico que está caducado según el reglamento de la Ley de
Comercio Electrónico de Colombia. 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
Factura de exportación
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 y tendrá el alcance definido en el Decreto XXXX de 201X.
Este identificador y el atributo están localizados en la siguiente ruta:
XPathii:
/de:Invoice/cbc:UUID
/de:Invoice/cbc:UUID/@schemeName tendrá el valor «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.
Donde + significa la concatenación de las cadenas de caracteres con separador de campos por punto y
coma (;).
10.3.1.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 factura de venta
NumFac /de:Invoice/cbc:ID
FecFac sinSimbolos(/de:Invoice/cbc:IssueDate + /de:Invoice/cbc:IssueTime)
formato AAAAMMDDHHMMSS i.e. año + mes + día + hora + minutos +
segundos
ValFac = /de:Invoice/de:LegalMonetaryTotal/cbc:LineExtensionAmount
CodImp1 = /de:Invoice/de:TaxTotal[x]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID =
01
ValImp1 = /de:Invoice/de:TaxTotal[x]/de:TaxSubtotal/cbc:TaxAmount
CodImp2 = /de:Invoice/de:TaxTotal[y]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID =
a356c87627fc074e950011070786d2c635596d4f
Destino: /de:Invoice/cbc:UUID
CUFE.vr
Nota: Para este tipo de factura en el cálculo del CUFE se considera como vacío y no se debe incluir
en la cadena los valores de TipAdq y de NumAdq de acuerdo al ejemplo.
Ref.def
sha-1
(811000787120140112000000235.280119.00020.00038.28235.2890037307631835599009
8285716064913246c1dee13c7ccbb19c530817)
3859f98792a630784c47e67d1353396273300531
Destino: /de:Invoice/cbc:UUID
Ref.vr
Nota: las transcripciones de datos de una factura de contingencia utilizan el contenido del elemento
/de:Invoice/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID en reemplazo de la Clave
técnica durante el cálculo del identificador universal que se registra en el elemento /de:Invoice/cbc:UUID.
El cálculo del valor Ref se detalla a continuación:
10.3.4. Ref.cálculo.paso-1
Se incluye un nuevo fragmento.
Ubicación: /de:Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/sts:DianExtensions/sts:OFEContingencia
Formación:
<sts:OFEContingencia>
<sts:OFEContingenciaPeriod><!--fecha de comienzo y terminación de la contingencia-->
<cbc:StartDate>2014-01-04<!--aaaa-mm-dd; fecha de comienzo-->
</cbc:StartDate>
<cbc:StartTime>00:01:00<!--hh:mm:ss-->
</cbc:StartTime>
<cbc:EndDate>2014-01-12<!--aaaa-mm-dd; fecha de terminación-->
</cbc:EndDate>
<cbc:EndTime>23:59:00<!--hh:mm:ss-->
10.3.5. Ref.cálculo.paso-2
Se incluye un nuevo fragmento.
Ubicación:
/de:Invoice/cac:BillingReference
/de:Invoice/de:AccountingSupplierParty
Formación:
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID schemeName="Rango del OFE" schemeURI="http://www.dian.gov.co/">DIAN-PT0001-1<!--
identificador de la transcripción de datos, asignado por el OFE; prefijo=DIAN-PT0001, consecutivo=-1;
e.g. [../sts:OFEContingenciaID]-1: primera factura transcrita de la contingencia señalada en el prefijo -->
</cbc:ID>
<cbc:CopyIndicator>true<!-- constante-->
</cbc:CopyIndicator>
<cbc:UUID schemeName="identificador universal de la factura contingente; el valor se utiliza en
reemplazo de la clave técnica"
schemeURI="http://www.dian.gov.co/">098285716064913246c1dee13c7ccbb19c530817<!--sha-
1([../sts:OFEContingencia/sts:UUID]+transform[../cac:InvoiceDocumentReference/cbc:ID]
+transform[../cac:InvoiceDocumentReference/cbc:IssueDate]
+transform[/de:Invoice/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate])==sha-
1(38a529348ac2d99727900e504102a7fe631e8a7dDIANPT0001120140116)-->
</cbc:UUID>
10.3.6. Ref.cálculo.paso-3
Aplique la sección “10.3.3.” de este documento
<cbc:UUID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y
Aduanas Nacionales)" schemeName="identificador universal calculado para la transcripción; no CUFE;
Anexo-3" schemeURI="http://www.dian.gov.co/">
<!--identificador universal de la transcripción de datos de una factura de venta por contingencia; equivale
al paso del procedimiento previsto en forma estándar para la expedición de facturas de venta-->
</cbc:UUID>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<de:Invoice xmlns:fe="http://www.dian.gov.co/contratos/facturaelectronica/v1"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns:clm54217="urn:un:unece:uncefact:codelist:specification:54217:2001"
xmlns:clm66411="urn:un:unece:uncefact:codelist:specification:66411:2001"
xmlns:clmIANAMIMEMediaType="urn:un:unece:uncefact:codelist:specification:IANAMIMEMediaTyp
e:2003" xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
xmlns:qdt="urn:oasis:names:specification:ubl:schema:xsd:QualifiedDatatypes-2"
xmlns:sts="http://www.dian.gov.co/contratos/facturaelectronica/v1/Structures"
xmlns:udt="urn:un:unece:uncefact:data:specification:UnqualifiedDataTypesSchemaModule:2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dian.gov.co/contratos/facturaelectronica/v1
http://www.dian.gov.co/micrositios/fac_electronica/documentos/XSD/r0/DIAN_UBL.xsd">
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent/>
</ext:UBLExtension>
</ext:UBLExtensions>
<!--<cbc:UBLVersionID>UBL 2.0</cbc:UBLVersionID>-->
<cbc:UBLVersionID/>
<cbc:CustomizationID/>
10.3.6.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 /de:Invoice/cbc:ID
FecFac sinSimbolos(/de:Invoice/cbc:IssueDate + /de:Invoice/cbc:IssueTime)
formato AAAAMMDDHHMMSS i.e. año + mes + día + hora + minutos +
segundos
ValFac /de:Invoice/de:LegalMonetaryTotal/cbc:LineExtensionAmount
=
CodImp1 = /de:Invoice/de:TaxTotal[x]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID =
01
ValImp1 = /de:Invoice/de:TaxTotal[x]/de:TaxSubtotal/cbc:TaxAmount
CodImp2 = /de:Invoice/de:TaxTotal[y]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID =
02
ValImp2 = /de:Invoice/de:TaxTotal[y]/de:TaxSubtotal/cbc:TaxAmount
CodImp3 = /de:Invoice/de:TaxTotal[z]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID =
03
ValImp3 = /de:Invoice/de:TaxTotal[z]/de:TaxSubtotal/cbc:TaxAmount
ValPag /de:Invoice/de:LegalMonetaryTotal/cbc:PayableAmount
=
NitOFE /de:Invoice/de:AccountingSupplierParty/de:Party/cac:PartyIdentification/cbc:ID
=
TipAdq /de:Invoice/de:AccountingCustomerParty/de:Party/cac:PartyIdentification/cbc:ID/@schemeID
=
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 472 de 504
NumAdq = /
de:Invoice/de:AccountingCustomerParty/de:Party/cac:PartyIdentification/cb
c:ID
ClTec Realice el cálculo descrito en los subtítulos Ref.cálculo
=
Ref.def
sha-1
(811000787120140112000000235.280119.00020.00038.28235.2890037307631835599009
8285716064913246c1dee13c7ccbb19c530817)
3859f98792a630784c47e67d1353396273300531
Destino: /de:CreditNote/cbc:UUID
Ref.vr
</de:CreditNote>
NumCr /de:CreditNote/cbc:ID
FecCr sinSimbolos(/de:CreditNote/cbc:IssueDate + /de:CreditNote/cbc:IssueTime)
formato AAAAMMDDHHMMSS i.e. año + mes + día + hora + minutos +
segundos
ValCr = /de:CreditNote/de:LegalMonetaryTotal/cbc:LineExtensionAmount
CodImp1 = /de:CreditNote/de:TaxTotal[X]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
ValImp1 = /de:CreditNote/de:TaxTotal[X]/de:TaxSubtotal/cbc:TaxAmount
CodImp2 = /de:CreditNote/de:TaxTotal[y]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 02
ValImp2 = /de:CreditNote/de:TaxTotal[y]/de:TaxSubtotal/cbc:TaxAmount
CodImp3 = /de:CreditNote/de:TaxTotal[z]/de:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 03
ValImp3 = /de:CreditNote/de:TaxTotal[z]/de:TaxSubtotal/cbc:TaxAmount
ValPag = /de:CreditNote/de:LegalMonetaryTotal/cbc:PayableAmount
NitOFE /de:CreditNote/de:AccountingSupplierParty/de:Party/cac:PartyIdentification/cbc:ID
=
TipAdq /de:CreditNote/de:AccountingCustomerParty/de:Party/cac:PartyIdentification/cbc:ID/@schemeID
=
NumAdq = /de:CreditNote
/de:AccountingCustomerParty/de:Party/cac:PartyIdentification/cbc:ID
ClTec = Examine la sección Cálculos para Nota Cr.
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 factura de venta
NumFac /de:DebitNote/cbc:ID
FecFac sinSimbolos(/de:DebitNote/cbc:IssueDate + /de:DebitNote/cbc:IssueTime)
formato AAAAMMDDHHMMSS i.e. año + mes + día + hora + minutos +
segundos
ValFac /de:DebitNote/de:LegalMonetaryTotal/cbc:LineExtensionAmount
=
CodImp1 = /
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 pre fijo 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
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] en formato YYYYmmddHHMMss
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: A02F-00117836
FecFac: 20140319105605
NitFac: 808183133
DocAdq: 8081972684
ValFac: 1000.00
ValIva: 160.00
ValOtroIm: 0.00
ValFacIm: 1160.00
CUFE: 2836a15058e90baabbf6bf2e97f05564ea0324a6
Tamaño
11.2.1. Tipos
targetNamespace="http://www.dian.gov.co/servicios/facturaelectronica/ConsultaResolucionFacturaci
on"
<complexType name="RangoFacturacion">
<annotation>
<documentation xml:lang="es">
Contiene la informacion relevante en la consulta del rango de facturacion perteneciente a la resolucion
</documentation>
</annotation>
<sequence>
<element name="NumeroResolucion" type="long"/>
<element name="FechaResolucion" type="date"/>
<element name="Prefijo" type="tns:PrefijoType"/>
<element name="RangoInicial" type="tns:RangoType"/>
<element name="RangoFinal" type="tns:RangoType"/>
<element name="FechaVigenciaDesde" type="date"/>
<element name="FechaVigenciaHasta" type="date"/>
<element name="ClaveTecnica" type="string"/>
</sequence>
</complexType>
<simpleType name="NitType">
<annotation>
<documentation>NIT</documentation>
</annotation>
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="35"></maxLength>
</restriction>
</simpleType>
<simpleType name="CodigoType">
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 490 de 504
<annotation>
<documentation></documentation>
</annotation>
<restriction base="string">
<enumeration value='OK'/>
<enumeration value='ND'/>
<enumeration value='EP'/>
<enumeration value='ES'/>
<enumeration value='EH'/>
<enumeration value='EA'/>
<enumeration value='ER'/>
<enumeration value='EF'/>
<enumeration value='EN'/>
</restriction>
</simpleType>
<simpleType name="DescripcionType">
<annotation>
<documentation></documentation>
</annotation>
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="500"></maxLength>
</restriction>
</simpleType>
<simpleType name="PrefijoType">
<annotation>
<documentation></documentation>
</annotation>
<restriction base="string">
<minLength value="1"></minLength>
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 491 de 504
<maxLength value="4"></maxLength>
</restriction>
</simpleType>
<simpleType name="RangoType">
<restriction base="long">
<minExclusive value="0"/>
<maxInclusive value="9999999999999999"/>
</restriction>
</simpleType>
<simpleType name="IdOperacionType">
<restriction base="decimal">
<minExclusive value="0"/>
<maxInclusive value="99999999999999999999"/>
</restriction>
</simpleType>
</schema>
11.3. Definiciones
Rangos de Numeración: Son los rangos de tipo Factura Electrónica autorizados a un Obligado a Facturar
Electrónicamente por una resolución de numeración.
Prefijo: Las facturas podrán llevar una serie alfabética, numérica o alfanumérica como prefijo al número
consecutivo de la factura.
HTTP: (Hypertext Transfer Protocol o HTTP) Protocolo de comunicación que permite las transferencias de
información en la World Wide Web.
SOAP: (Simple Object Access Protocol) Protocolo estándar que define cómo dos objetos en diferentes procesos
pueden comunicarse por medio de intercambio de datos XML. Es uno de los protocolos utilizados en los
servicios Web.
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 492 de 504
WSDL: (Web Service Description Language) Formato XML que se utiliza para describir servicios Web. WSDL
describe la interfaz pública a los servicios Web. Está basado en XML y describe la forma de comunicación, es
decir, los requisitos del protocolo y los formatos de los mensajes necesarios para interactuar con los servicios
listados en su catálogo. Un programa cliente que se conecta a un servicio web puede leer el WSDL para
determinar qué funciones están disponibles en el servidor.
WSS (WS-Security): (Web Services Security). Protocolo de comunicaciones que suministra un medio para aplicar
seguridad a los Servicios Web. El protocolo contiene especificaciones sobre cómo debe garantizarse la
integridad y seguridad en mensajería de Servicios Web.
ADVERTENCIA: 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 webService, le entregará una nueva CLAVE TÉCNICA, esta CLAVE
TÉCNICA, es diferente a la del anterior rango.
11.5. Autenticación
El servicio web utiliza las extensiones WSS (WS-Security), perfil UsernameToken 1.0 para autenticar el
software de facturación del OFE que solicita el establecimiento de una conexión. El software de
facturación debe seguir la especificación e incluir los elementos Username, Password, Nonce y Created
correspondientes para permitir su autenticación.
<soapenv:Body>
<con:ConsultaResolucionesFacturacionPeticion>
<con:NITObligadoFacturarElectronicamente>860046645
</con:NITObligadoFacturarElectronicamente>
<con:NITProveedorTecnologico>800037646</con:NITProveedorTecnologico>
<con:IdentificadorSoftware>
13a6a789-47ca-4728-adb8-372fca76e692
</con:IdentificadorSoftware>
</con:ConsultaResolucionesFacturacionPeticion>
</soapenv:Body>
Los rangos de numeración asignados contienen la información relevante en la consulta del rango de
facturación perteneciente a la resolución del servicio web, incluye el número de la resolución, la fecha de
resolución, el prefijo, rango inicial, rango final, la fecha de inicio de vigencia del rango, la fecha de fin de
vigencia y la clave técnica.
El siguiente es el cuerpo SOAP de la respuesta del servicio web de factura electrónica mencionada en el
ejemplo:
<SOAP-ENV:Body wsu:Id="id-163"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<ns2:ConsultaResolucionesFacturacionRespuesta
xmlns:ns2="http://www.dian.gov.co/servicios/facturaelectronica/ConsultaResolucionFacturacion">
<ns2:CodigoOperacion>OK</ns2:CodigoOperacion>
<ns2:DescripcionOperacion>
La operación se ejecutó satisfactoriamente
</ns2:DescripcionOperacion>
<ns2:IdentificadorOperacion>813557</ns2:IdentificadorOperacion>
<ns2:RangoFacturacion>
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 498 de 504
<ns2:NumeroResolucion>9310000085419</ns2:NumeroResolucion>
<ns2:FechaResolucion>
2015-05-27T09:15:07-05:00
</ns2:FechaResolucion>
<ns2:Prefijo>0</ns2:Prefijo>
<ns2:RangoInicial>10001</ns2:RangoInicial>
<ns2:RangoFinal>18400</ns2:RangoFinal>
<ns2:FechaVigenciaDesde>
2015-05-27T00:00:00-05:00
</ns2:FechaVigenciaDesde>
<ns2:FechaVigenciaHasta>
2017-05-27T00:00:00-05:00
</ns2:FechaVigenciaHasta>
<ns2:ClaveTecnica>
FC8EAC422EBA16E22FFD8C6F94B3F40A6E38162C
</ns2:ClaveTecnica>
</ns2:RangoFacturacion>
</ns2:ConsultaResolucionesFacturacionRespuesta>
</SOAP-ENV:Body>
C Mensaje Comentarios
ó
d
i
g
o
O La operación se ejecutó satisfactoriamente El Software del Consumidor del
K servicio web se encuentra
registrado y El Obligado a
Facturar Electrónicamente está
habilitado y registra rangos de
facturación autorizados y
vigentes.
E Parámetros de entradas no cumplen con la Este escenario se presenta en el
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 499 de 504
P estructura definida caso en que los parámetros de
entrada no cumplan con la
estructura requerida por el
servicio web, es decir no se están
enviando todos los parámetros o
alguno de los parámetros que se
está enviando no está
especificado.
11.6.5. Referencias
OASIS. (26 de Febrero de 2016). Web Services Security UsernameToken Profile 1.1. Obtenido de
https://www.oasis-open.org/committees/download.php/13392/wss-v1.1-spec-pr-UsernameTokenProfile-
01.htm
w3c. (26 de Febrero de 2016). SOAP Message Transmission Optimization Mechanism. Obtenido de
https://www.w3.org/TR/soap12-mtom/
w3c. (26 de Febrero de 2016). SOAP Version 1.2. Obtenido de http://www.w3.org/TR/soap
w3c. (26 de Febrero de 2016). Web Services Description Language (WSDL) 1.1. Obtenido de
http://www.w3.org/TR/wsdl