tfhkacolwiki - Contribuciones del usuario [es]

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-06-06T13:34:26Z

Eruiz2:

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Para que puedan verificar los tipos de identificación permitidos, les pedimos amablemente que consulten la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]. Allí encontrarán el listado completo de las identificaciones válidas. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

 
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1nrXBJgpdugR9_fK5REsDfiJGNuxyM7h9/view <big>Grabación 08-05-2025 de Sesión Especial API para Consulta para Completar Información de Adquirientes en Factura Electrónica</big>] 
 
 

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}
 

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:
 

URL´s Servicio SOAP

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 

Ambiente de Producción

https://emision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 
 

URL´s Servicio REST

Ambiente DEMO

https://demoemision21-api.thefactoryhka.com.co/api/adquiriente/consulta

Ambiente de Producción

https://emision21-api.thefactoryhka.com.co/api/adquiriente/consulta

A continuación encontrará los ejemplos SOAP y REST dando click en el siguiente enlace:

<includeonly>=</includeonly>====Ejemplos:<includeonly>=</includeonly>====

[https://drive.google.com/drive/u/0/folders/1diYXglEZsQ-rIq8NA9X7riKYeos6lpfQ Ejemplos Soap y Rest]
{{clear}}

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente SOAP]]
 
 

<div style="text-align: center;">Ejemplo consumo REST</div>

 
[[Archivo:consultaadquirienterest.png|800px|sinmarco|center|EjemploconsultaAdquiriente REST]]
 

<div style="text-align: center;">Catálogo de errores de respuesta del servicio web</div>

{| class="wikitable" "style="text-align:center;"

|+ Método ConsultaAdquiriente

! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

 
'''Recomendación:''' Asegúrese que el tipo de documento del adquiriente concuerde con el número de documento ya que de lo contrario retornara valores incorrectos.
 
 

===Preguntas frecuentes===
 

<ul>
1. ¿Qué es el servicio "Consulta Adquiriente" de la DIAN?
</ul>
Es un servicio web implementado por la DIAN que permite consultar el nombre, razón social y correo electrónico de un adquiriente o comprador utilizando únicamente su tipo y número de identificación. Su objetivo principal es facilitar y agilizar la generación de facturas electrónicas, permitiendo completar automáticamente los datos del adquiriente y evitando el ingreso manual, mejorando así la eficiencia en los procesos de facturación.

 
<ul>
2. ¿Cuál es la base normativa para este servicio?
</ul>
Este servicio se fundamenta en la Resolución 202 del 31 de marzo de 2025, la cual modifica los artículos 69 y 70 de la Resolución 165. El artículo 69 establece los datos mínimos exigibles al adquiriente (nombre/razón social, tipo y número de identificación, y correo electrónico) para la expedición de la factura electrónica. El artículo 70 describe el servicio provisto por la DIAN para facilitar la obtención de estos datos. La solicitud mínima de estos datos proviene de la circular externa número 007 del 24 de octubre de 2022, que buscaba evitar la exigencia de requisitos adicionales a los establecidos legalmente para la facturación electrónica.

 
<ul>
3. ¿Qué tan confiable es la data que retorna la DIAN.?
</ul>

El servicio, al recibir el Tipo y Número de identificación, busca en sus registros para completar automáticamente los datos necesarios para la factura electrónica de la siguiente manera:

Adquirente Facturador Electrónico: Si el documento de identificación consultado pertenece a un contribuyente registrado ante la DIAN como facturador electrónico, el sistema retornará el correo electrónico que dicho facturador haya declarado como correo de recepción de documentos electrónicos. Esta información se obtiene directamente de los registros de la DIAN. Data confiable

Adquirente No Facturador con RUT: En caso de que el adquiriente no esté registrado como facturador electrónico, el sistema procederá a verificar la existencia de un correo asociado al RUT. De encontrarse un correo, se mostrará el correo electrónico que figure en dicho registro. Data confiable

Persona Natural No Facturadora sin RUT: Si el adquiriente corresponde a una persona natural que no es facturadora electrónica y no posee un RUT registrado, el sistema realizará una búsqueda retrospectiva de la última factura electrónica emitida a ese número de identificación. El correo electrónico asociado a dicho adquiriente en esa factura será el valor retornado. Cabe destacar que esta información puede ser actualizada. Si el adquiriente modifica su dirección de correo electrónico en una factura posterior, esta actualización se reflejará en la API al día siguiente. Es tan confiable, o la confiabilidad de la data depende de la data dada por este comprador.

 
<ul>
4. ¿Se puede realizar la consulta masivamente?
</ul>
Tal como lo indica el articulo 4 de la resolución 000202 del 31/03/2025, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónico, Para el efecto la DIAN establecerá los mecanismos técnicos y procedimientos para garantizar que el servicio de facilitación de información sea seguro y controlado uno a uno.

 
<ul>
5. ¿Es obligatorio el uso de este servicio?
</ul>
No es obligatorio, es un servicio opcional. Sin embargo, aunque no es mandatorio, su uso mejora la robustez y la eficiencia de la facturación, especialmente en escenarios de facturación a clientes finales

 
<ul>
6. ¿Es importante la concordancia entre el tipo de documento y el número de documento durante la consulta?
</ul>
Sí, es muy importante asegurar que el tipo de identificación registrado sea congruente con el número de identificación de la persona, si se envía un tipo de identificación incorrecto para un número dado (por ejemplo, cédula de ciudadanía para un NIT de empresa), el servicio puede retornar valores incorrectos o incongruentes en el nombre del receptor.

 
<ul>
7. ¿Se puede realizar la consulta por lotes (facturación masiva)?
</ul>
No, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónica. El artículo 4 de la resolución 202 que modifica el articulo 70 de la resolución 165 deja claro que no es posible hacer este proceso, el servicio está diseñado para realizar las consultas de forma uno a uno es decir si se van a generar 100 facturas, se deben realizar 100 consultas individuales. No está estipulado para la facturación por lotes o masiva.

 
<ul>
8. ¿Este servicio de consulta tiene un costo adicional?
</ul>
No, no tiene costo adicional. Es un servicio gratuito implementado directamente por la DIAN, si se trabaja con una casa de software, será esta la encargada de implementar el servicio dentro de su software o ERP.

 
<ul>
 9. ¿Supone este servicio un tiempo adicional de espera para el usuario final al momento de facturar?
</ul>
Según la documentación, es al contrario. El objetivo de este servicio que implementa la DIAN es hacer el proceso de facturación más ágil, al usuario solo se le solicitará el tipo y número de identificación. Al implementar este servicio en el software, automáticamente traerá la información del nombre o correo electrónico, evitando la digitalización manual de estos datos, lo cual puede ser más rápido que pedirlos y digitarlos. El adquiriente o comprador solo tendría que confirmar si el nombre y correo traídos automáticamente son correctos. Esto busca mejorar la eficiencia.

Archivo:Consultaadquirienterest.png

2025-06-06T13:33:15Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-27T15:21:16Z

Eruiz2:

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Para que puedan verificar los tipos de identificación permitidos, les pedimos amablemente que consulten la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]. Allí encontrarán el listado completo de las identificaciones válidas. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

 
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1nrXBJgpdugR9_fK5REsDfiJGNuxyM7h9/view <big>Grabación 08-05-2025 de Sesión Especial API para Consulta para Completar Información de Adquirientes en Factura Electrónica</big>] 
 
 

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}
 

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:
 

URL´s Servicio SOAP

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 

Ambiente de Producción

https://emision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 
 

URL´s Servicio REST

Ambiente DEMO

https://demoemision21-api.thefactoryhka.com.co/api/adquiriente/consulta

Ambiente de Producción

https://emision21-api.thefactoryhka.com.co/api/adquiriente/consulta

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]
 

<div style="text-align: center;">Catálogo de errores de respuesta del servicio web</div>

{| class="wikitable" "style="text-align:center;"

|+ Método ConsultaAdquiriente

! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

 
'''Recomendación:''' Asegúrese que el tipo de documento del adquiriente concuerde con el número de documento ya que de lo contrario retornara valores incorrectos.
 
 

===Preguntas frecuentes===
 

<ul>
1. ¿Qué es el servicio "Consulta Adquiriente" de la DIAN?
</ul>
Es un servicio web implementado por la DIAN que permite consultar el nombre, razón social y correo electrónico de un adquiriente o comprador utilizando únicamente su tipo y número de identificación. Su objetivo principal es facilitar y agilizar la generación de facturas electrónicas, permitiendo completar automáticamente los datos del adquiriente y evitando el ingreso manual, mejorando así la eficiencia en los procesos de facturación.

 
<ul>
2. ¿Cuál es la base normativa para este servicio?
</ul>
Este servicio se fundamenta en la Resolución 202 del 31 de marzo de 2025, la cual modifica los artículos 69 y 70 de la Resolución 165. El artículo 69 establece los datos mínimos exigibles al adquiriente (nombre/razón social, tipo y número de identificación, y correo electrónico) para la expedición de la factura electrónica. El artículo 70 describe el servicio provisto por la DIAN para facilitar la obtención de estos datos. La solicitud mínima de estos datos proviene de la circular externa número 007 del 24 de octubre de 2022, que buscaba evitar la exigencia de requisitos adicionales a los establecidos legalmente para la facturación electrónica.

 
<ul>
3. ¿Qué tan confiable es la data que retorna la DIAN.?
</ul>

El servicio, al recibir el Tipo y Número de identificación, busca en sus registros para completar automáticamente los datos necesarios para la factura electrónica de la siguiente manera:

Adquirente Facturador Electrónico: Si el documento de identificación consultado pertenece a un contribuyente registrado ante la DIAN como facturador electrónico, el sistema retornará el correo electrónico que dicho facturador haya declarado como correo de recepción de documentos electrónicos. Esta información se obtiene directamente de los registros de la DIAN. Data confiable

Adquirente No Facturador con RUT: En caso de que el adquiriente no esté registrado como facturador electrónico, el sistema procederá a verificar la existencia de un correo asociado al RUT. De encontrarse un correo, se mostrará el correo electrónico que figure en dicho registro. Data confiable

Persona Natural No Facturadora sin RUT: Si el adquiriente corresponde a una persona natural que no es facturadora electrónica y no posee un RUT registrado, el sistema realizará una búsqueda retrospectiva de la última factura electrónica emitida a ese número de identificación. El correo electrónico asociado a dicho adquiriente en esa factura será el valor retornado. Cabe destacar que esta información puede ser actualizada. Si el adquiriente modifica su dirección de correo electrónico en una factura posterior, esta actualización se reflejará en la API al día siguiente. Es tan confiable, o la confiabilidad de la data depende de la data dada por este comprador.

 
<ul>
4. ¿Se puede realizar la consulta masivamente?
</ul>
Tal como lo indica el articulo 4 de la resolución 000202 del 31/03/2025, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónico, Para el efecto la DIAN establecerá los mecanismos técnicos y procedimientos para garantizar que el servicio de facilitación de información sea seguro y controlado uno a uno.

 
<ul>
5. ¿Es obligatorio el uso de este servicio?
</ul>
No es obligatorio, es un servicio opcional. Sin embargo, aunque no es mandatorio, su uso mejora la robustez y la eficiencia de la facturación, especialmente en escenarios de facturación a clientes finales

 
<ul>
6. ¿Es importante la concordancia entre el tipo de documento y el número de documento durante la consulta?
</ul>
Sí, es muy importante asegurar que el tipo de identificación registrado sea congruente con el número de identificación de la persona, si se envía un tipo de identificación incorrecto para un número dado (por ejemplo, cédula de ciudadanía para un NIT de empresa), el servicio puede retornar valores incorrectos o incongruentes en el nombre del receptor.

 
<ul>
7. ¿Se puede realizar la consulta por lotes (facturación masiva)?
</ul>
No, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónica. El artículo 4 de la resolución 202 que modifica el articulo 70 de la resolución 165 deja claro que no es posible hacer este proceso, el servicio está diseñado para realizar las consultas de forma uno a uno es decir si se van a generar 100 facturas, se deben realizar 100 consultas individuales. No está estipulado para la facturación por lotes o masiva.

 
<ul>
8. ¿Este servicio de consulta tiene un costo adicional?
</ul>
No, no tiene costo adicional. Es un servicio gratuito implementado directamente por la DIAN, si se trabaja con una casa de software, será esta la encargada de implementar el servicio dentro de su software o ERP.

 
<ul>
 9. ¿Supone este servicio un tiempo adicional de espera para el usuario final al momento de facturar?
</ul>
Según la documentación, es al contrario. El objetivo de este servicio que implementa la DIAN es hacer el proceso de facturación más ágil, al usuario solo se le solicitará el tipo y número de identificación. Al implementar este servicio en el software, automáticamente traerá la información del nombre o correo electrónico, evitando la digitalización manual de estos datos, lo cual puede ser más rápido que pedirlos y digitarlos. El adquiriente o comprador solo tendría que confirmar si el nombre y correo traídos automáticamente son correctos. Esto busca mejorar la eficiencia.

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-27T14:08:32Z

Eruiz2:

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Para que puedan verificar los tipos de identificación permitidos, les pedimos amablemente que consulten la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]. Allí encontrarán el listado completo de las identificaciones válidas. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

 
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1nrXBJgpdugR9_fK5REsDfiJGNuxyM7h9/view <big>Grabación 08-05-2025 de Sesión Especial API para Consulta para Completar Información de Adquirientes en Factura Electrónica</big>] 
 
 

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}
 

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:
 

URL´s Servicio SOAP

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 

Ambiente de Producción

https://emision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 
 

URL´s Servicio REST

Ambiente DEMO

https://demoemision21-api.thefactoryhka.com.co/api/adquiriente/consulta

Ambiente de Producción

https://emision21-api.thefactoryhka.com.co/api/adquiriente/consulta

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]
 

<div style="text-align: center;">Catálogo de errores de respuesta del servicio web</div>

{| class="wikitable" "style="text-align:center;"

|+ Método ConsultaAdquiriente

! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

 
'''Recomendación:''' Asegúrese que el tipo de documento del adquiriente concuerde con el número de documento ya que de lo contrario retornara valores incorrectos.
 
 

Preguntas frecuentes
 

<ul>
<li>¿Qué tan confiable es la data que retorna la DIAN.?</li>
</ul>

El servicio, al recibir el Tipo y Número de identificación, busca en sus registros para completar automáticamente los datos necesarios para la factura electrónica de la siguiente manera:

Adquirente Facturador Electrónico: Si el documento de identificación consultado pertenece a un contribuyente registrado ante la DIAN como facturador electrónico, el sistema retornará el correo electrónico que dicho facturador haya declarado como correo de recepción de documentos electrónicos. Esta información se obtiene directamente de los registros de la DIAN. Data confiable

Adquirente No Facturador con RUT: En caso de que el adquiriente no esté registrado como facturador electrónico, el sistema procederá a verificar la existencia de un correo asociado al RUT. De encontrarse un correo, se mostrará el correo electrónico que figure en dicho registro. Data confiable

Persona Natural No Facturadora sin RUT: Si el adquiriente corresponde a una persona natural que no es facturadora electrónica y no posee un RUT registrado, el sistema realizará una búsqueda retrospectiva de la última factura electrónica emitida a ese número de identificación. El correo electrónico asociado a dicho adquiriente en esa factura será el valor retornado. Cabe destacar que esta información puede ser actualizada. Si el adquiriente modifica su dirección de correo electrónico en una factura posterior, esta actualización se reflejará en la API al día siguiente. Es tan confiable, o la confiabilidad de la data depende de la data dada por este comprador.
 
<ul>
<li>¿Se puede realizar la consulta masivamente?</li>
</ul>
Tal como lo indica el articulo 4 de la resolución 000202 del 31/03/2025, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónico, Para el efecto la DIAN establecerá los mecanismos técnicos y procedimientos para garantizar que el servicio de facilitación de información sea seguro y controlado uno a uno.
 
<ul>
<li>¿Es obligatorio el uso de este servicio?</li>
</ul>
No es obligatorio, es un servicio opcional. Sin embargo, aunque no es mandatorio, su uso mejora la robustez y la eficiencia de la facturación, especialmente en escenarios de facturación a clientes finales
 
<ul>
<li>¿Es importante la concordancia entre el tipo de documento y el número de documento durante la consulta?</li>
</ul>
Sí, es muy importante asegurar que el tipo de identificación registrado sea congruente con el número de identificación de la persona, si se envía un tipo de identificación incorrecto para un número dado (por ejemplo, cédula de ciudadanía para un NIT de empresa), el servicio puede retornar valores incorrectos o incongruentes en el nombre del receptor.
 
<ul>
<li>¿Se puede realizar la consulta por lotes (facturación masiva)?</li>
</ul>
No, en ningún caso se podrá hacer uso masivo o distribución de la información obtenida del servicio de consulta electrónica. El artículo 4 de la resolución 202 que modifica el articulo 70 de la resolución 165 deja claro que no es posible hacer este proceso, el servicio está diseñado para realizar las consultas de forma uno a uno es decir si se van a generar 100 facturas, se deben realizar 100 consultas individuales. No está estipulado para la facturación por lotes o masiva.
 
<ul>
<li>¿Este servicio de consulta tiene un costo adicional?</li>
</ul>
No, no tiene costo adicional. Es un servicio gratuito implementado directamente por la DIAN, si se trabaja con una casa de software, será esta la encargada de implementar el servicio dentro de su software o ERP.
 
<ul>
<li>¿Supone este servicio un tiempo adicional de espera para el usuario final al momento de facturar?</li>
</ul>
Según la documentación, es al contrario. El objetivo de este servicio que implementa la DIAN es hacer el proceso de facturación más ágil, al usuario solo se le solicitará el tipo y número de identificación. Al implementar este servicio en el software, automáticamente traerá la información del nombre o correo electrónico, evitando la digitalización manual de estos datos, lo cual puede ser más rápido que pedirlos y digitarlos. El adquiriente o comprador solo tendría que confirmar si el nombre y correo traídos automáticamente son correctos. Esto busca mejorar la eficiencia.

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-13T13:02:33Z

Eruiz2:

Archivo:Mgdv3.png

2025-05-13T13:00:03Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T22:34:33Z

Eruiz2: /* Método ConsultaAdquiriente */

Archivo:Mgdv2.png

2025-05-12T22:34:24Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T22:26:48Z

Eruiz2: /* Método ConsultaAdquiriente */

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T22:23:56Z

Eruiz2:

Archivo:Mgdv.png

2025-05-12T22:23:48Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T22:18:48Z

Eruiz2: /* Método ConsultaAdquiriente */

Archivo:Imgdv.png

2025-05-12T22:18:41Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T22:08:07Z

Eruiz2:

Archivo:Imgdrive.png

2025-05-12T22:07:41Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-12T21:24:08Z

Eruiz2:

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-09T14:56:37Z

Eruiz2:

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-05-07T19:27:28Z

Eruiz2:

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-04-23T16:44:08Z

Eruiz2: /* Método ConsultaAdquiriente */

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-04-23T14:37:26Z

Eruiz2:

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}
 

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:
 

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 

Ambiente de Producción

https://emision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl
 
 

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]
 

<div style="text-align: center;">Catálogo de errores de respuesta del servicio web</div>

{| class="wikitable" "style="text-align:center;"

|+ Método ConsultaAdquiriente

! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa

2025-04-21T21:56:20Z

Eruiz2:

<includeonly>=</includeonly>==Catálogo de codigos de respuesta del servicio web ==<includeonly>=</includeonly>
En la siguiente sección encontrará información referente a las respuestas del servicio web.

{| class="wikitable" "style="text-align:center;"
|+ Método Enviar
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío Satisfactorio
|Procesado
|200
|El documento se envió correctamente (Síncrono).
|-
|Envío Satisfactorio
|Procesado
|201
|Documento recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Envío Satisfactorio
|Procesado
|207
|El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo
|-
|Envío Satisfactorio
|Procesado
|208
|Documento de contingencia recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Error por Excepciones generales
|Error
|103
|Error de Procesamiento (Debe enviar xml-request para su análisis)
|-
|Error en capa de Validaciones TFHKA
|Error
|109
|Ejm: El campo {nombre del campo} es obligaotrio Ejm: El campo {nombre del campo} debe ser numérico.
Ejm: El cliente No posee Folios Disponibles
(Debe enviar xml-request para su análisis)
|-
|Error por Excepciones XSLT Local (TFHKA)
|Error
|161
|Debe validarse el XML/UBL generado (Debe enviar xml-request para su análisis)
|-
|Error en Validaciones XSLT Local (TFHKA)
|Error
|110
|Ejm: Fatal: [FAR08]- (R) Total de la factura 100.00 diferente de la suma de Total valor bruto + Total Tributos - Anticipos (+/-) Redondeos : 120.00 } (Debe enviar xml-request para su análisis)
|-
|Error Factura ya emitida o se encuentra en TFHKA y DIAN
|Error
|114
|Documento emitido previamente. Documento emitido previamente por otro proveedor tecnológico {NIT del PT}. Ha ocurrido un error al consultar el Documento XML en la DIAN
|-
|Documento rechazo por la DIAN
|Error
|99
|Documento fue rechazado por la DIAN (Debe validarse los motivos de rechazo o reglasValidacionDIAN)
|-
|Envío de Datos
|Error
|111
|La longitud del campo Token [empresa/password] no cumple con el rango permitido. El campo Token [empresa/password] solo debe tener números y letras
|-
|Token invalido
|Error
|101
|El Token del Emisor es inválido. (Debe validarse el ambiente al que corresponden los tokens utilizados y URL’s de conexión)
|-
|Error al parsear el documento
|Error
|112
|Error al extraer la información del documento al comprobante. (Debe enviar xml-request para su análisis)
|-
|Error validaciones incorrectas en los rangos
|Error
|117
|Error. El rango, fecha de la factura o fecha de autorización son inválidos. / Error el número de documento es inválido. (Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de autorización en los rangos
|Error
|118
|Error, el número de autorización o el tipo de documento es inválido. / Error el número de documento es inválido. (Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de Folios
|Error
|119
|No posee folios disponibles.Se debe contactar al nuestro equipo de facturación para adquirir un paquete de transacciones o folios.
|-
|Error validación en rango
|Error
|150
|No existe el rango de numeración. (Debe validarse el tipo de documento y si el rango esta configurado en el portal),
|-
|Error campo Número de Documento
|error
|167
|El campo Número de Documento debe manejar sólo caracteres numéricos (solo para doc Soporte y Nota de Ajuste),
|-
|Error campo Número de Identificación
|error
|168
|El campo Número de Identificación debe manejar sólo caracteres numéricos (solo para doc Soporte y Nota de Ajuste),
|}
'''@IMPORTANTE:''' Ante un código de error diferente a los anteriores por favor enviar el request soap-Envelope del documento al alias integracion_fel_co@thefactoryhka.com exponiendo el caso.

{| class="wikitable" "style="text-align:center;"
|+ Método EstadoDocumento
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retornan datos de la factura.
|-
|Envío Satisfactorio
|Procesado
|207
|El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error al extraer los datos del documento.
|-
|Error al Extraer Datos
|Debe reintentar
|162
|El documento no fue emitido exitosamente, por favor intente nuevamente.
|-
|Error al Extraer Datos
|Error
|163
|El documento se encuentra rechazado por la DIAN.
|-
|Error al Extraer Datos
|Debe reintentar
|164
|El documento está en proceso, por favor consulte nuevamente en unos minutos.
|-
|Error en Validaciones
|error
|166
| El documento indicado no se encuentra asociado a su cuenta se recomienda validar la información definida,
|}

{| class="wikitable" "style="text-align:center;"
|+ Método EnvioCorreo
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se ha enviado el email de manera correcta
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Correo inválido
|Error
|106
|Formato de correo electrónico inválido.
|}
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaPDF
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Se retorna el archivo solicitado
|Procesado
|200
|Se ha enviado el email de manera correcta
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaXML
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}
{| class="wikitable" "style="text-align:center;"
|+ Método GenerarContenedor
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}
{| class="wikitable" "style="text-align:center;"
|+ Método FoliosRestantes
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Procesado
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|}
{| class="wikitable" "style="text-align:center;"
|+ Método CargarAdjuntos
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satifactorio
|Procesado
|200
|Archivo {nombreDelArchivo}{extension} almacenado exitosamente
|-
|Error en carga de archivo
|Error
|107
|Se señaló previamente que para el documento {consecutivo} emitido por {NIT Emisor} ya se habían completado los adjuntos esperados (Quiere decir que ya la propiedad enviar fuen setada en “1” anteriormente).
|-
|Error en Validaciones
|Procesado
|109
|[Sección del Error]El campo {nombre del campo} debe tener un valor del catálogo. [Sección del Error]El campo {nombre del campo} es requerido. [Sección del Error]El campo {nombre del campo} debe ser un {tipo de datos} de {tamaño} {numérico/alfanumérico}.
|}

{| class="wikitable" "style="text-align:center;"
|+ Método ConsultaAdquiriente
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-04-21T21:49:27Z

Eruiz2:

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]
 

<div style="text-align: center;">Catálogo de errores de respuesta del servicio web</div>

{| class="wikitable" "style="text-align:center;"
|+ Método ConsultaAdquiriente
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Se retornan datos del Adquiriente
|-
|Error
|Error al consultar la informacion
|400
|Tipo de identificación inválido
|-
|Error
|Error al consultar la información
|500
|Error al momento de procesar la transacción, información de adquiriente no encontrado
|}

Archivo:Consultaadquiriente.png

2025-04-21T20:33:23Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T20:29:42Z

Eruiz2: /* imagen Método ConsultaAdquiriente */

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|SI
|
: Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
: Rechazo Si se reciben más decimales en los montos a los indicados en este campo
: '''PATH''': No aplica
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
: '''PATH''': /root/cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|SI
|
: Información del adquiriente
: Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
: '''PATH''':/root/cac:AccountingCustomerParty
: (ver detalle en [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + el consecutivo DIAN,
: según la configuración en portal web:
:: Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
:: Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
: Rechazo No se permiten caracteres adicionales como espacios o guiones
: Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
: Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|SI
|
: Información de detalles o productos
: '''PATH''': /root/cac:InvoiceLine
: (ver detalle en [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|SI
|
: Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
: Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
: Rechazo Si la fecha de emisión es posterior a diez días calendario
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha vencimiento de la factura, en formato: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|SI
|
: Información de impuestos generales o globales
: Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
: Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|SI
|
: Moneda o divisa del documento
: Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
: Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|SI
|
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
: Ejemplo: ‘PREF-1123456’
: Rechazo Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''.
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Redondeo aplicado para llegar a totalMonto
: Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (ver detalle en [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NO
|
: Información utilizada como método alternativo para informar conversiones a otras divisas
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (ver detalle en [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Información relacionada con la entrega
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional
: '''PATH''': /root/cac:DeliveryTerms
: (ver detalle en [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Suma de todos los pagos anticipados
: Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
: Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total del valor bruto con tributos
: Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
: Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
: Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
: Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|SI
|
: Número o cantidad de líneas de productos (renglones) presentes en el documento
: Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
: Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|SI
|
: Texto libre para informar la razón del descuento
: '''PATH''': …/cbc:AllowanceChargeReason
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
: Rechazo : Si es Descuento y monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor Base para calcular el descuento o el cargo,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NO
|
: Corresponde al código de actividad económica CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NO
|
: Apellido del adquiriente.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: Permite especifica el medio y los datos de la entrega electrónica del documento
: '''Obligatorio''': Si campo notificar = ‘SI’
: '''PATH''': No definido
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|SI
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección de recepción del adquiriente
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
: Dirección fiscal del adquiriente.
: '''Obligatorio''': Si el adquirente es responsable
: Notificación Si el adquirente es responsable y no fue informada esta clase
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
: (solo se envía un correo en este campo)
: '''PATH''': No aplica nodo
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Información legal del cliente
: Notificación : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Nombre Comercial del adquiriente
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Nota adicional de contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Activa el envío de email al adquirente.
: Valores posibles: “SI” o “NO”
: '''PATH''': No aplica
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Número del Documento o Identificación Fiscal del adquirente
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: Digito de verificación NIT del adquiriente
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|SI
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Segundo nombre del adquiriente.
: '''PATH''': No definido
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono del adquiriente
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de Identificación del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Nota: Para identificar al consumidor final se utiliza el código “13”
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|SI
|
: Identificador de tipo de persona
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}

====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NO
|
: Codigo de Evento
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Duración de Periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Unidad de medida de la duración de periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|SI
|
: Fecha de Vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Condiciones de Pago
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Medio Pago asociado
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|SI
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la multa
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la Penalidad
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo desde
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo hasta
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Porcentaje de Descuento
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje de Pago
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Numero de referencia de Anticipo
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}

====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: Medida de la latitud en grados
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: Medida de la longitud en grados
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la latitud en minutos decimales en formato mm.mm
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la longitud en minutos decimales en formato mm.mm
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la latitud con relación al Ecuador
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la longitud con relación al Ecuador
: '''PATH''': ../cbc:LongitudeDirectionCode
|}

====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tipos de Impuesto
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Información de la Dirección del Responsable de Entrega
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre “para la atención de” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Responsable de la Entrega
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
: Nota de Contacto
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: NIT del transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Digito Verificador
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Prefijo de facturación del Transportista
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Responsabilidad del Transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Telefax de transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono de transportista
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo de Identificación del Transportista
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Dirección fiscal del transportador
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Digito Verificador del NIT del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|email
|Array <String>
| -
|C/C
|
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
: '''Obligatorio''' Cuando canalDeEntrega=’0’
: '''PATH''': No aplica
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|String
| -
|NO
|
: Mensaje
: '''PATH''': No aplica
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
: '''PATH''': No aplica
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Teléfono del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
: '''PATH''': No aplica
|}

====Class.DetalleDeFactura====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad de unidades del producto/servicio facturado
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Información de cargos y descuentos
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Código del fabricante correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Código Identificador del país de origen del artículo o servicio
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del vendedor correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Código del tipo de precio informado
: '''Obligatorio''' Para muestras comerciales (valor = 01)
: Rechazo Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|C/C
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Rechazo Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos por todos los tipos
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Rechazo Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador del NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Tipo de identificación del mandatario
: '''Obligatorio''' Para facturas por mandato
: Notificación Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Marca del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Modelo del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de si el ítem es gratuito o no (sin valor comercial)
: '''Obligatorio''' Para muestras comerciales
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Nombre del fabricante del producto/servicio
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Texto libre para añadir información adicional al artículo
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Valor del artículo o servicio.
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
: '''Obligatorio''' Para muestras comerciales
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Precio total del producto o servicio.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
: '''Obligatorio''' Para uso en las representaciones gráficas
: '''PATH''': No definido
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total de la línea sin impuestos.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
: Rechazo Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Precio Unitario del porducto/servicio
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|SI
|
: Indicador de orden de secuencia (número de línea)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del fabricante correspondiente a una sub-especificación del artículo
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Para Clasificar el tipo de AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|SI
|
: Código de Unidad de medida del producto/servicio facturado
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Cuidado de
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A la atención de
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del bloque
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de la calle
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Adicional para especificar mejor el nombre de la calle
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|SI
|
: Código del departamento
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Obligatorio''' para Emisores y Adquirentes Responsables
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corrección del uso horario correspondiente
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Nombre del departamento
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Un departamento direccionable de una organización
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|SI
|
: Dirección del cliente, sin indicar ciudad ni departamento
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Distrito
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|SI
|
: Identificador del lenguaje utilizado en el nombre del país
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: Coordenadas de la dirección
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del Municipio
: Notificación Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de un Edificio
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de Parcela
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|SI
|
: País del cliente.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Piso
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..40</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
|}

====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: Ejemplo: “Factura de Venta Nacional”
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado.
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.EntregaMercancia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}

====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en el XML
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|}

====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base Imponible sobre la que se calcula el valor del tributo
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de tipo de retención
: '''PATH''': No Definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|SI
|
: Tarifa del tributo.
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
: Rechazo Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|SI
|
: Identificación de la unidad de medida
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Unidad de medida base para el tributo
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Es el valor nominal del tributo por unidad
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo si el elemento unidadMedidaTributo NO es informado.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}

'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.

====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Suma de todos los atributos valorTOTALImp
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Cantidad adicional
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Código adicional
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|codigoInterno2
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Descripción adicional
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha final del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha inicial del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
: Rechazo Por cada nombre debe existir un valor
: '''PATH''': ../cbc:Name
: (Por definir catálogos de campos extensibles a nivel de detalle)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Indicador de orden de secuencia
: '''PATH''': No definido
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
: '''PATH''': No aplica
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del canal del pago
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
: '''Obligatorio''' Si la venta es a crédito
: Rechazo: Si código del método de pago es “2” y no se envía la fecha de vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Código correspondiente al medio de pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identificador o referencia interna del Pago
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Número de días para el pago
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de ransferência o número de cheque
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}

====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Opcional, si informado indicar “No aplica”. Posibles Valores:
: 48: “Impuesto sobre las ventas - IVA”
: 49: “No responsable de IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}

====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del cliente
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Documento Referencia
: '''PATH''': ../cac:DocumentReference
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}

'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Código de Condiciones de Entrega
: '''Obligatorio''' Se es factura de exportación/internacional
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Información donde se detalle la dirección de entrega
: '''PATH''': ../cac:DeliveryLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero Identificación
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
|-
|String
|consecutivoDocumento
|Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|Bool
|esValidoDian
|“true” Si es válido
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaRespuesta
|Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código de respuesta, útil para identificación de errores
|-
|Array
|mensajesValidacion
|Mensajes de validación en caso de notificación o rechazo
|-
|String
|nombre
|Nombre definido por la DIAN
|-
|String
|qr
|Concatenación cadena del código QR (elemento de control)
|-
|Array
|reglasNotificacionDIAN
|Reglas de validación en caso de notificación
|-
|Array
|reglasValidacionDIAN
|Reglas de validación en caso de rechazo
|-
|String
|resultado
|Resultado del consumo del método: Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
|-
|String
|xml
|Archivo XML (tipo AttachedDocument) codificado en Base64
|}
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método '''CargarAdjuntos''') consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro '''adjuntos''' se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
{{clear}}

===Método EstadoDocumento===
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
|-
|String
|acuseComentario
|Comentario informado por el adquiriente al realizar el acuse
|-
|String
|acuseEstatus
|0: Acuse no realizado ; 1: Acuse realizado
|-
|String
|acuseResponsable
|Email del responsable de realizar el acuse
|-
|String
|acuseRespuesta
|0: Respuesta no enviada ; 1: Respuesta enviada
|-
|String
|ambiente
|Tipo de ambiente de generación del documento:
:: “1: ambienteDeProducción”
:: “2: ambienteDePruebas”
|-
|String
|cadenaCodigoQR
|Concatenación cadena del código QR (elemento de control)
|-
|String
|cadenaCufe
|Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
|-
|int
|Codigo
|Indica el estado de la operación retornado por el servicio
|-
|String
|consecutivo
|Consecutivo del Documento TFHKA/DIAN
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|String
|descripcionDocumento
|Identificador del tipo de documento de referencia,
: Ejemplo: “Factura de Venta Nacional”
|-
|String
|descripcionEstatusDocumento
|Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
|-
|String
|entregaMetodoDIAN
|Indica el método de Entrega a la DIAN
: (Síncrono ó Asyncrono), (Individual ó Lote)
|-
|Bool
|esValidoDIAN
|
: “true” Si es válido
: “false” Si no es válido
|-
|String
|estatusDocumento
|Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
|-
|Array <Evento>
|eventos
|Lista de eventos del Documento Electrónico
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Fecha en la que se generó el documento, en formato: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|Histórico de las entregas del documento
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|mensajeDocumento
|Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
|-
|Bool
|poseeAdjuntos
|Indica si el documento posee adjuntos:
: “true” o “false”
|-
|Bool
|poseeRepresentacionGrafica
|Indica si el documento posee representación gráfica:
: “true” o “false”
|-
|Array <String>
|reglasValidacionDIAN
|Mensajes de validación por parte de la DIAN
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Identificador del tipo de documento de referencia
: Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|ambienteDIAN
|Ambiente de generación en la DIAN:
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Código el documento del Application Response (evento)
|-
|String
|comentario
|Comentario del evento
|-
|String
|cufe
|CUFE del documento electronico
|-
|String
|descripcionEvento
|Descripción de uso/origen del evento
|-
|String
|emisorNumeroDocumento
|Número de Identificación del Emisor
|-
|String
|emisorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Emisor
|-
|String
|emisorRazonSocial
|Razón Social del Emisor
|-
|String
|emisorTipoIdentificacion
|Tipo de Identificación del Emisor
|-
|Array <ExtrasEvento>
|extras
|Información extra correspondiente al evento
|-
|String
|fechaEmision
|Fecha de Emisión del Application Response (evento)
|-
|String
|fechaRecepcion
|Fecha de Recepción del Application Response (evento)
|-
|String
|hash
|Hash del documento Application Response
|-
|String
|idPerfilDIAN
|Perfil de la DIAN
|-
|String
|mensaje
|Mensaje de descripción del ApplicationResponse
|-
|String
|nombreArchivoXML
|Nombre del archivo XML
|-
|String
|nota
|Contenido del campo Note del Application Response
|-
|String
|numeroDelEvento
|Consecutivo del Application Response
|-
|String
|receptorNumeroDocumento
|Número de Identificación del Receptor
|-
|String
|receptorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Receptor
|-
|String
|receptorRazonSocial
|Razón Social del Receptor
|-
|String
|receptorTipoIdentificacion
|Tipo de Identificación del Receptor
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUDE del evento:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Identificador del tipo de Evento:
: (Interno/ApplicationResponse)
|-
|String
|versionUBL
|Versión UBL del XML
|}
Y Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|Dirección IP del computador en el cual se realizó el acuse del correo de notificación
|-
|String
|LeidoEstatus
|Estatus del acuse del correo de notificación
|-
|String
|LeidoFecha
|Fecha del acuse del correo de notificación
|-
|String
|canalDeEntrega
|Canal de entrega del documento electrónico
|-
|Array <String>
|email
|Email del receptor del documento electrónico
|-
|String
|entregaEstatus
|Estatus de la entrega:
: ‘0’: Correo no enviado
: ‘200’: Correo enviado
|-
|String
|entregaEstatusDescripcion
|Descripción del Estatus de la entrega
|-
|String
|entregaFecha
|Fecha de la Entrega del documento
|-
|String
|fechaProgramada
|Fecha de la Entrega
|-
|String
|mensajePersonalizado
|Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
|-
|String
|nitProveedorReceptor
|NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
|-
|String
|recepcionEmailComentario
|Comentario de Acuse de Recibo del Cliente
|-
|String
|recepcionEmailEstatus
|Estatus de recepción del Correo Electrónico
: 1: Aceptado
: 2: Rechazado
: 3: En verificación
|-
|String
|recepcionEmailFecha
|Fecha de recepción del Correo Electrónico
|-
|String
|recepcionEmailIPAddress
|Dirección IP de recepción del Correo Electrónico
|-
|String
|telefono
|Para entrega por Whatsapp/Telegram
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
|-
|correo
|Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
|-
|adjuntos
|
: “0”: Realiza el reenvio del correo sin adjuntos
: “1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP.
{{clear}}
===Método DescargaPDF===
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|String
|documento
|Documento PDF codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
{{clear}}
===Método DescargaXML===
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado
|-
|String
|documento
|Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método FoliosRestantes===
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|int
|foliosRestantes
|Cantidad de folios disponibles
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===Método DescargarEventoXML===
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|Documento
|Documento XML (ApplicationResponse) codificado en Base64
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===Método GenerarContenedor===
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Contenedor
|Documento XML (AttachedDocument) codificado en Base64
|-
|String
|Fecha
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método GenerarEvento===
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Objeto con los datos del evento (ApplicationResponse) a generar
|}
Donde Class.DatosEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Indica el código del evento (Por definir catálogo)
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Comentario
|Comentario o descripción del evento
|-
|String
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Información adicional del evento
|}
Donde Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|consecutivoDocumentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|Documento XML (ApplicationResponse) codificado en Base64
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T19:23:51Z

Eruiz2: /* Método ConsultaAdquiriente */

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|SI
|
: Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
: Rechazo Si se reciben más decimales en los montos a los indicados en este campo
: '''PATH''': No aplica
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
: '''PATH''': /root/cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|SI
|
: Información del adquiriente
: Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
: '''PATH''':/root/cac:AccountingCustomerParty
: (ver detalle en [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + el consecutivo DIAN,
: según la configuración en portal web:
:: Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
:: Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
: Rechazo No se permiten caracteres adicionales como espacios o guiones
: Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
: Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|SI
|
: Información de detalles o productos
: '''PATH''': /root/cac:InvoiceLine
: (ver detalle en [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|SI
|
: Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
: Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
: Rechazo Si la fecha de emisión es posterior a diez días calendario
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha vencimiento de la factura, en formato: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|SI
|
: Información de impuestos generales o globales
: Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
: Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|SI
|
: Moneda o divisa del documento
: Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
: Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|SI
|
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
: Ejemplo: ‘PREF-1123456’
: Rechazo Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''.
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Redondeo aplicado para llegar a totalMonto
: Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (ver detalle en [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NO
|
: Información utilizada como método alternativo para informar conversiones a otras divisas
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (ver detalle en [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Información relacionada con la entrega
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional
: '''PATH''': /root/cac:DeliveryTerms
: (ver detalle en [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Suma de todos los pagos anticipados
: Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
: Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total del valor bruto con tributos
: Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
: Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
: Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
: Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|SI
|
: Número o cantidad de líneas de productos (renglones) presentes en el documento
: Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
: Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|SI
|
: Texto libre para informar la razón del descuento
: '''PATH''': …/cbc:AllowanceChargeReason
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
: Rechazo : Si es Descuento y monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor Base para calcular el descuento o el cargo,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NO
|
: Corresponde al código de actividad económica CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NO
|
: Apellido del adquiriente.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: Permite especifica el medio y los datos de la entrega electrónica del documento
: '''Obligatorio''': Si campo notificar = ‘SI’
: '''PATH''': No definido
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|SI
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección de recepción del adquiriente
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
: Dirección fiscal del adquiriente.
: '''Obligatorio''': Si el adquirente es responsable
: Notificación Si el adquirente es responsable y no fue informada esta clase
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
: (solo se envía un correo en este campo)
: '''PATH''': No aplica nodo
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Información legal del cliente
: Notificación : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Nombre Comercial del adquiriente
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Nota adicional de contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Activa el envío de email al adquirente.
: Valores posibles: “SI” o “NO”
: '''PATH''': No aplica
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Número del Documento o Identificación Fiscal del adquirente
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: Digito de verificación NIT del adquiriente
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|SI
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Segundo nombre del adquiriente.
: '''PATH''': No definido
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono del adquiriente
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de Identificación del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Nota: Para identificar al consumidor final se utiliza el código “13”
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|SI
|
: Identificador de tipo de persona
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}

====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NO
|
: Codigo de Evento
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Duración de Periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Unidad de medida de la duración de periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|SI
|
: Fecha de Vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Condiciones de Pago
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Medio Pago asociado
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|SI
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la multa
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la Penalidad
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo desde
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo hasta
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Porcentaje de Descuento
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje de Pago
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Numero de referencia de Anticipo
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}

====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: Medida de la latitud en grados
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: Medida de la longitud en grados
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la latitud en minutos decimales en formato mm.mm
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la longitud en minutos decimales en formato mm.mm
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la latitud con relación al Ecuador
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la longitud con relación al Ecuador
: '''PATH''': ../cbc:LongitudeDirectionCode
|}

====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tipos de Impuesto
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Información de la Dirección del Responsable de Entrega
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre “para la atención de” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Responsable de la Entrega
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
: Nota de Contacto
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: NIT del transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Digito Verificador
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Prefijo de facturación del Transportista
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Responsabilidad del Transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Telefax de transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono de transportista
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo de Identificación del Transportista
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Dirección fiscal del transportador
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Digito Verificador del NIT del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|email
|Array <String>
| -
|C/C
|
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
: '''Obligatorio''' Cuando canalDeEntrega=’0’
: '''PATH''': No aplica
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|String
| -
|NO
|
: Mensaje
: '''PATH''': No aplica
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
: '''PATH''': No aplica
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Teléfono del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
: '''PATH''': No aplica
|}

====Class.DetalleDeFactura====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad de unidades del producto/servicio facturado
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Información de cargos y descuentos
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Código del fabricante correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Código Identificador del país de origen del artículo o servicio
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del vendedor correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Código del tipo de precio informado
: '''Obligatorio''' Para muestras comerciales (valor = 01)
: Rechazo Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|C/C
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Rechazo Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos por todos los tipos
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Rechazo Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador del NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Tipo de identificación del mandatario
: '''Obligatorio''' Para facturas por mandato
: Notificación Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Marca del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Modelo del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de si el ítem es gratuito o no (sin valor comercial)
: '''Obligatorio''' Para muestras comerciales
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Nombre del fabricante del producto/servicio
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Texto libre para añadir información adicional al artículo
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Valor del artículo o servicio.
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
: '''Obligatorio''' Para muestras comerciales
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Precio total del producto o servicio.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
: '''Obligatorio''' Para uso en las representaciones gráficas
: '''PATH''': No definido
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total de la línea sin impuestos.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
: Rechazo Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Precio Unitario del porducto/servicio
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|SI
|
: Indicador de orden de secuencia (número de línea)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del fabricante correspondiente a una sub-especificación del artículo
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Para Clasificar el tipo de AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|SI
|
: Código de Unidad de medida del producto/servicio facturado
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Cuidado de
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A la atención de
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del bloque
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de la calle
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Adicional para especificar mejor el nombre de la calle
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|SI
|
: Código del departamento
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Obligatorio''' para Emisores y Adquirentes Responsables
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corrección del uso horario correspondiente
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Nombre del departamento
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Un departamento direccionable de una organización
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|SI
|
: Dirección del cliente, sin indicar ciudad ni departamento
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Distrito
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|SI
|
: Identificador del lenguaje utilizado en el nombre del país
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: Coordenadas de la dirección
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del Municipio
: Notificación Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de un Edificio
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de Parcela
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|SI
|
: País del cliente.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Piso
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..40</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
|}

====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: Ejemplo: “Factura de Venta Nacional”
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado.
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.EntregaMercancia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}

====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en el XML
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|}

====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base Imponible sobre la que se calcula el valor del tributo
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de tipo de retención
: '''PATH''': No Definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|SI
|
: Tarifa del tributo.
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
: Rechazo Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|SI
|
: Identificación de la unidad de medida
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Unidad de medida base para el tributo
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Es el valor nominal del tributo por unidad
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo si el elemento unidadMedidaTributo NO es informado.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}

'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.

====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Suma de todos los atributos valorTOTALImp
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Cantidad adicional
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Código adicional
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|codigoInterno2
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Descripción adicional
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha final del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha inicial del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
: Rechazo Por cada nombre debe existir un valor
: '''PATH''': ../cbc:Name
: (Por definir catálogos de campos extensibles a nivel de detalle)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Indicador de orden de secuencia
: '''PATH''': No definido
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
: '''PATH''': No aplica
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del canal del pago
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
: '''Obligatorio''' Si la venta es a crédito
: Rechazo: Si código del método de pago es “2” y no se envía la fecha de vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Código correspondiente al medio de pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identificador o referencia interna del Pago
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Número de días para el pago
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de ransferência o número de cheque
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}

====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Opcional, si informado indicar “No aplica”. Posibles Valores:
: 48: “Impuesto sobre las ventas - IVA”
: 49: “No responsable de IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}

====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del cliente
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Documento Referencia
: '''PATH''': ../cac:DocumentReference
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}

'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Código de Condiciones de Entrega
: '''Obligatorio''' Se es factura de exportación/internacional
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Información donde se detalle la dirección de entrega
: '''PATH''': ../cac:DeliveryLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero Identificación
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
|-
|String
|consecutivoDocumento
|Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|Bool
|esValidoDian
|“true” Si es válido
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaRespuesta
|Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código de respuesta, útil para identificación de errores
|-
|Array
|mensajesValidacion
|Mensajes de validación en caso de notificación o rechazo
|-
|String
|nombre
|Nombre definido por la DIAN
|-
|String
|qr
|Concatenación cadena del código QR (elemento de control)
|-
|Array
|reglasNotificacionDIAN
|Reglas de validación en caso de notificación
|-
|Array
|reglasValidacionDIAN
|Reglas de validación en caso de rechazo
|-
|String
|resultado
|Resultado del consumo del método: Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
|-
|String
|xml
|Archivo XML (tipo AttachedDocument) codificado en Base64
|}
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método '''CargarAdjuntos''') consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro '''adjuntos''' se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
{{clear}}

===Método EstadoDocumento===
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
|-
|String
|acuseComentario
|Comentario informado por el adquiriente al realizar el acuse
|-
|String
|acuseEstatus
|0: Acuse no realizado ; 1: Acuse realizado
|-
|String
|acuseResponsable
|Email del responsable de realizar el acuse
|-
|String
|acuseRespuesta
|0: Respuesta no enviada ; 1: Respuesta enviada
|-
|String
|ambiente
|Tipo de ambiente de generación del documento:
:: “1: ambienteDeProducción”
:: “2: ambienteDePruebas”
|-
|String
|cadenaCodigoQR
|Concatenación cadena del código QR (elemento de control)
|-
|String
|cadenaCufe
|Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
|-
|int
|Codigo
|Indica el estado de la operación retornado por el servicio
|-
|String
|consecutivo
|Consecutivo del Documento TFHKA/DIAN
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|String
|descripcionDocumento
|Identificador del tipo de documento de referencia,
: Ejemplo: “Factura de Venta Nacional”
|-
|String
|descripcionEstatusDocumento
|Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
|-
|String
|entregaMetodoDIAN
|Indica el método de Entrega a la DIAN
: (Síncrono ó Asyncrono), (Individual ó Lote)
|-
|Bool
|esValidoDIAN
|
: “true” Si es válido
: “false” Si no es válido
|-
|String
|estatusDocumento
|Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
|-
|Array <Evento>
|eventos
|Lista de eventos del Documento Electrónico
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Fecha en la que se generó el documento, en formato: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|Histórico de las entregas del documento
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|mensajeDocumento
|Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
|-
|Bool
|poseeAdjuntos
|Indica si el documento posee adjuntos:
: “true” o “false”
|-
|Bool
|poseeRepresentacionGrafica
|Indica si el documento posee representación gráfica:
: “true” o “false”
|-
|Array <String>
|reglasValidacionDIAN
|Mensajes de validación por parte de la DIAN
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Identificador del tipo de documento de referencia
: Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|ambienteDIAN
|Ambiente de generación en la DIAN:
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Código el documento del Application Response (evento)
|-
|String
|comentario
|Comentario del evento
|-
|String
|cufe
|CUFE del documento electronico
|-
|String
|descripcionEvento
|Descripción de uso/origen del evento
|-
|String
|emisorNumeroDocumento
|Número de Identificación del Emisor
|-
|String
|emisorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Emisor
|-
|String
|emisorRazonSocial
|Razón Social del Emisor
|-
|String
|emisorTipoIdentificacion
|Tipo de Identificación del Emisor
|-
|Array <ExtrasEvento>
|extras
|Información extra correspondiente al evento
|-
|String
|fechaEmision
|Fecha de Emisión del Application Response (evento)
|-
|String
|fechaRecepcion
|Fecha de Recepción del Application Response (evento)
|-
|String
|hash
|Hash del documento Application Response
|-
|String
|idPerfilDIAN
|Perfil de la DIAN
|-
|String
|mensaje
|Mensaje de descripción del ApplicationResponse
|-
|String
|nombreArchivoXML
|Nombre del archivo XML
|-
|String
|nota
|Contenido del campo Note del Application Response
|-
|String
|numeroDelEvento
|Consecutivo del Application Response
|-
|String
|receptorNumeroDocumento
|Número de Identificación del Receptor
|-
|String
|receptorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Receptor
|-
|String
|receptorRazonSocial
|Razón Social del Receptor
|-
|String
|receptorTipoIdentificacion
|Tipo de Identificación del Receptor
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUDE del evento:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Identificador del tipo de Evento:
: (Interno/ApplicationResponse)
|-
|String
|versionUBL
|Versión UBL del XML
|}
Y Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|Dirección IP del computador en el cual se realizó el acuse del correo de notificación
|-
|String
|LeidoEstatus
|Estatus del acuse del correo de notificación
|-
|String
|LeidoFecha
|Fecha del acuse del correo de notificación
|-
|String
|canalDeEntrega
|Canal de entrega del documento electrónico
|-
|Array <String>
|email
|Email del receptor del documento electrónico
|-
|String
|entregaEstatus
|Estatus de la entrega:
: ‘0’: Correo no enviado
: ‘200’: Correo enviado
|-
|String
|entregaEstatusDescripcion
|Descripción del Estatus de la entrega
|-
|String
|entregaFecha
|Fecha de la Entrega del documento
|-
|String
|fechaProgramada
|Fecha de la Entrega
|-
|String
|mensajePersonalizado
|Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
|-
|String
|nitProveedorReceptor
|NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
|-
|String
|recepcionEmailComentario
|Comentario de Acuse de Recibo del Cliente
|-
|String
|recepcionEmailEstatus
|Estatus de recepción del Correo Electrónico
: 1: Aceptado
: 2: Rechazado
: 3: En verificación
|-
|String
|recepcionEmailFecha
|Fecha de recepción del Correo Electrónico
|-
|String
|recepcionEmailIPAddress
|Dirección IP de recepción del Correo Electrónico
|-
|String
|telefono
|Para entrega por Whatsapp/Telegram
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
|-
|correo
|Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
|-
|adjuntos
|
: “0”: Realiza el reenvio del correo sin adjuntos
: “1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP.
{{clear}}
===Método DescargaPDF===
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|String
|documento
|Documento PDF codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
{{clear}}
===Método DescargaXML===
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado
|-
|String
|documento
|Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método FoliosRestantes===
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|int
|foliosRestantes
|Cantidad de folios disponibles
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===Método DescargarEventoXML===
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|Documento
|Documento XML (ApplicationResponse) codificado en Base64
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===Método GenerarContenedor===
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Contenedor
|Documento XML (AttachedDocument) codificado en Base64
|-
|String
|Fecha
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método GenerarEvento===
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Objeto con los datos del evento (ApplicationResponse) a generar
|}
Donde Class.DatosEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Indica el código del evento (Por definir catálogo)
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Comentario
|Comentario o descripción del evento
|-
|String
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Información adicional del evento
|}
Donde Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|consecutivoDocumentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|Documento XML (ApplicationResponse) codificado en Base64
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|}

{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T17:54:25Z

Eruiz2: /* Método */

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|SI
|
: Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
: Rechazo Si se reciben más decimales en los montos a los indicados en este campo
: '''PATH''': No aplica
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
: '''PATH''': /root/cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|SI
|
: Información del adquiriente
: Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
: '''PATH''':/root/cac:AccountingCustomerParty
: (ver detalle en [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + el consecutivo DIAN,
: según la configuración en portal web:
:: Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
:: Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
: Rechazo No se permiten caracteres adicionales como espacios o guiones
: Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
: Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|SI
|
: Información de detalles o productos
: '''PATH''': /root/cac:InvoiceLine
: (ver detalle en [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|SI
|
: Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
: Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
: Rechazo Si la fecha de emisión es posterior a diez días calendario
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha vencimiento de la factura, en formato: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|SI
|
: Información de impuestos generales o globales
: Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
: Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|SI
|
: Moneda o divisa del documento
: Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
: Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|SI
|
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
: Ejemplo: ‘PREF-1123456’
: Rechazo Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''.
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Redondeo aplicado para llegar a totalMonto
: Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (ver detalle en [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NO
|
: Información utilizada como método alternativo para informar conversiones a otras divisas
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (ver detalle en [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Información relacionada con la entrega
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional
: '''PATH''': /root/cac:DeliveryTerms
: (ver detalle en [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Suma de todos los pagos anticipados
: Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
: Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total del valor bruto con tributos
: Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
: Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
: Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
: Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|SI
|
: Número o cantidad de líneas de productos (renglones) presentes en el documento
: Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
: Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|SI
|
: Texto libre para informar la razón del descuento
: '''PATH''': …/cbc:AllowanceChargeReason
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
: Rechazo : Si es Descuento y monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor Base para calcular el descuento o el cargo,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NO
|
: Corresponde al código de actividad económica CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NO
|
: Apellido del adquiriente.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: Permite especifica el medio y los datos de la entrega electrónica del documento
: '''Obligatorio''': Si campo notificar = ‘SI’
: '''PATH''': No definido
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|SI
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección de recepción del adquiriente
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
: Dirección fiscal del adquiriente.
: '''Obligatorio''': Si el adquirente es responsable
: Notificación Si el adquirente es responsable y no fue informada esta clase
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
: (solo se envía un correo en este campo)
: '''PATH''': No aplica nodo
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Información legal del cliente
: Notificación : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Nombre Comercial del adquiriente
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Nota adicional de contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Activa el envío de email al adquirente.
: Valores posibles: “SI” o “NO”
: '''PATH''': No aplica
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Número del Documento o Identificación Fiscal del adquirente
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: Digito de verificación NIT del adquiriente
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|SI
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Segundo nombre del adquiriente.
: '''PATH''': No definido
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono del adquiriente
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de Identificación del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Nota: Para identificar al consumidor final se utiliza el código “13”
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|SI
|
: Identificador de tipo de persona
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}

====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NO
|
: Codigo de Evento
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Duración de Periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Unidad de medida de la duración de periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|SI
|
: Fecha de Vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Condiciones de Pago
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Medio Pago asociado
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|SI
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la multa
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la Penalidad
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo desde
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo hasta
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Porcentaje de Descuento
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje de Pago
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Numero de referencia de Anticipo
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}

====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: Medida de la latitud en grados
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: Medida de la longitud en grados
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la latitud en minutos decimales en formato mm.mm
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la longitud en minutos decimales en formato mm.mm
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la latitud con relación al Ecuador
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la longitud con relación al Ecuador
: '''PATH''': ../cbc:LongitudeDirectionCode
|}

====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tipos de Impuesto
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Información de la Dirección del Responsable de Entrega
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre “para la atención de” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Responsable de la Entrega
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
: Nota de Contacto
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: NIT del transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Digito Verificador
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Prefijo de facturación del Transportista
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Responsabilidad del Transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Telefax de transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono de transportista
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo de Identificación del Transportista
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Dirección fiscal del transportador
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Digito Verificador del NIT del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|email
|Array <String>
| -
|C/C
|
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
: '''Obligatorio''' Cuando canalDeEntrega=’0’
: '''PATH''': No aplica
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|String
| -
|NO
|
: Mensaje
: '''PATH''': No aplica
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
: '''PATH''': No aplica
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Teléfono del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
: '''PATH''': No aplica
|}

====Class.DetalleDeFactura====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad de unidades del producto/servicio facturado
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Información de cargos y descuentos
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Código del fabricante correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Código Identificador del país de origen del artículo o servicio
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del vendedor correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Código del tipo de precio informado
: '''Obligatorio''' Para muestras comerciales (valor = 01)
: Rechazo Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|C/C
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Rechazo Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos por todos los tipos
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Rechazo Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador del NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Tipo de identificación del mandatario
: '''Obligatorio''' Para facturas por mandato
: Notificación Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Marca del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Modelo del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de si el ítem es gratuito o no (sin valor comercial)
: '''Obligatorio''' Para muestras comerciales
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Nombre del fabricante del producto/servicio
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Texto libre para añadir información adicional al artículo
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Valor del artículo o servicio.
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
: '''Obligatorio''' Para muestras comerciales
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Precio total del producto o servicio.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
: '''Obligatorio''' Para uso en las representaciones gráficas
: '''PATH''': No definido
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total de la línea sin impuestos.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
: Rechazo Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Precio Unitario del porducto/servicio
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|SI
|
: Indicador de orden de secuencia (número de línea)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del fabricante correspondiente a una sub-especificación del artículo
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Para Clasificar el tipo de AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|SI
|
: Código de Unidad de medida del producto/servicio facturado
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Cuidado de
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A la atención de
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del bloque
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de la calle
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Adicional para especificar mejor el nombre de la calle
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|SI
|
: Código del departamento
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Obligatorio''' para Emisores y Adquirentes Responsables
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corrección del uso horario correspondiente
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Nombre del departamento
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Un departamento direccionable de una organización
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|SI
|
: Dirección del cliente, sin indicar ciudad ni departamento
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Distrito
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|SI
|
: Identificador del lenguaje utilizado en el nombre del país
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: Coordenadas de la dirección
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del Municipio
: Notificación Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de un Edificio
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de Parcela
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|SI
|
: País del cliente.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Piso
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..40</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
|}

====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: Ejemplo: “Factura de Venta Nacional”
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado.
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.EntregaMercancia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}

====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en el XML
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|}

====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base Imponible sobre la que se calcula el valor del tributo
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de tipo de retención
: '''PATH''': No Definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|SI
|
: Tarifa del tributo.
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
: Rechazo Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|SI
|
: Identificación de la unidad de medida
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Unidad de medida base para el tributo
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Es el valor nominal del tributo por unidad
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo si el elemento unidadMedidaTributo NO es informado.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}

'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.

====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Suma de todos los atributos valorTOTALImp
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Cantidad adicional
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Código adicional
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|codigoInterno2
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Descripción adicional
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha final del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha inicial del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
: Rechazo Por cada nombre debe existir un valor
: '''PATH''': ../cbc:Name
: (Por definir catálogos de campos extensibles a nivel de detalle)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Indicador de orden de secuencia
: '''PATH''': No definido
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
: '''PATH''': No aplica
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del canal del pago
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
: '''Obligatorio''' Si la venta es a crédito
: Rechazo: Si código del método de pago es “2” y no se envía la fecha de vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Código correspondiente al medio de pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identificador o referencia interna del Pago
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Número de días para el pago
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de ransferência o número de cheque
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}

====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Opcional, si informado indicar “No aplica”. Posibles Valores:
: 48: “Impuesto sobre las ventas - IVA”
: 49: “No responsable de IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}

====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del cliente
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Documento Referencia
: '''PATH''': ../cac:DocumentReference
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}

'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Código de Condiciones de Entrega
: '''Obligatorio''' Se es factura de exportación/internacional
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Información donde se detalle la dirección de entrega
: '''PATH''': ../cac:DeliveryLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero Identificación
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
|-
|String
|consecutivoDocumento
|Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|Bool
|esValidoDian
|“true” Si es válido
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaRespuesta
|Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código de respuesta, útil para identificación de errores
|-
|Array
|mensajesValidacion
|Mensajes de validación en caso de notificación o rechazo
|-
|String
|nombre
|Nombre definido por la DIAN
|-
|String
|qr
|Concatenación cadena del código QR (elemento de control)
|-
|Array
|reglasNotificacionDIAN
|Reglas de validación en caso de notificación
|-
|Array
|reglasValidacionDIAN
|Reglas de validación en caso de rechazo
|-
|String
|resultado
|Resultado del consumo del método: Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
|-
|String
|xml
|Archivo XML (tipo AttachedDocument) codificado en Base64
|}
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método '''CargarAdjuntos''') consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro '''adjuntos''' se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
{{clear}}

===Método EstadoDocumento===
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
|-
|String
|acuseComentario
|Comentario informado por el adquiriente al realizar el acuse
|-
|String
|acuseEstatus
|0: Acuse no realizado ; 1: Acuse realizado
|-
|String
|acuseResponsable
|Email del responsable de realizar el acuse
|-
|String
|acuseRespuesta
|0: Respuesta no enviada ; 1: Respuesta enviada
|-
|String
|ambiente
|Tipo de ambiente de generación del documento:
:: “1: ambienteDeProducción”
:: “2: ambienteDePruebas”
|-
|String
|cadenaCodigoQR
|Concatenación cadena del código QR (elemento de control)
|-
|String
|cadenaCufe
|Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
|-
|int
|Codigo
|Indica el estado de la operación retornado por el servicio
|-
|String
|consecutivo
|Consecutivo del Documento TFHKA/DIAN
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|String
|descripcionDocumento
|Identificador del tipo de documento de referencia,
: Ejemplo: “Factura de Venta Nacional”
|-
|String
|descripcionEstatusDocumento
|Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
|-
|String
|entregaMetodoDIAN
|Indica el método de Entrega a la DIAN
: (Síncrono ó Asyncrono), (Individual ó Lote)
|-
|Bool
|esValidoDIAN
|
: “true” Si es válido
: “false” Si no es válido
|-
|String
|estatusDocumento
|Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
|-
|Array <Evento>
|eventos
|Lista de eventos del Documento Electrónico
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Fecha en la que se generó el documento, en formato: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|Histórico de las entregas del documento
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|mensajeDocumento
|Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
|-
|Bool
|poseeAdjuntos
|Indica si el documento posee adjuntos:
: “true” o “false”
|-
|Bool
|poseeRepresentacionGrafica
|Indica si el documento posee representación gráfica:
: “true” o “false”
|-
|Array <String>
|reglasValidacionDIAN
|Mensajes de validación por parte de la DIAN
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Identificador del tipo de documento de referencia
: Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|ambienteDIAN
|Ambiente de generación en la DIAN:
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Código el documento del Application Response (evento)
|-
|String
|comentario
|Comentario del evento
|-
|String
|cufe
|CUFE del documento electronico
|-
|String
|descripcionEvento
|Descripción de uso/origen del evento
|-
|String
|emisorNumeroDocumento
|Número de Identificación del Emisor
|-
|String
|emisorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Emisor
|-
|String
|emisorRazonSocial
|Razón Social del Emisor
|-
|String
|emisorTipoIdentificacion
|Tipo de Identificación del Emisor
|-
|Array <ExtrasEvento>
|extras
|Información extra correspondiente al evento
|-
|String
|fechaEmision
|Fecha de Emisión del Application Response (evento)
|-
|String
|fechaRecepcion
|Fecha de Recepción del Application Response (evento)
|-
|String
|hash
|Hash del documento Application Response
|-
|String
|idPerfilDIAN
|Perfil de la DIAN
|-
|String
|mensaje
|Mensaje de descripción del ApplicationResponse
|-
|String
|nombreArchivoXML
|Nombre del archivo XML
|-
|String
|nota
|Contenido del campo Note del Application Response
|-
|String
|numeroDelEvento
|Consecutivo del Application Response
|-
|String
|receptorNumeroDocumento
|Número de Identificación del Receptor
|-
|String
|receptorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Receptor
|-
|String
|receptorRazonSocial
|Razón Social del Receptor
|-
|String
|receptorTipoIdentificacion
|Tipo de Identificación del Receptor
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUDE del evento:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Identificador del tipo de Evento:
: (Interno/ApplicationResponse)
|-
|String
|versionUBL
|Versión UBL del XML
|}
Y Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|Dirección IP del computador en el cual se realizó el acuse del correo de notificación
|-
|String
|LeidoEstatus
|Estatus del acuse del correo de notificación
|-
|String
|LeidoFecha
|Fecha del acuse del correo de notificación
|-
|String
|canalDeEntrega
|Canal de entrega del documento electrónico
|-
|Array <String>
|email
|Email del receptor del documento electrónico
|-
|String
|entregaEstatus
|Estatus de la entrega:
: ‘0’: Correo no enviado
: ‘200’: Correo enviado
|-
|String
|entregaEstatusDescripcion
|Descripción del Estatus de la entrega
|-
|String
|entregaFecha
|Fecha de la Entrega del documento
|-
|String
|fechaProgramada
|Fecha de la Entrega
|-
|String
|mensajePersonalizado
|Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
|-
|String
|nitProveedorReceptor
|NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
|-
|String
|recepcionEmailComentario
|Comentario de Acuse de Recibo del Cliente
|-
|String
|recepcionEmailEstatus
|Estatus de recepción del Correo Electrónico
: 1: Aceptado
: 2: Rechazado
: 3: En verificación
|-
|String
|recepcionEmailFecha
|Fecha de recepción del Correo Electrónico
|-
|String
|recepcionEmailIPAddress
|Dirección IP de recepción del Correo Electrónico
|-
|String
|telefono
|Para entrega por Whatsapp/Telegram
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
|-
|correo
|Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
|-
|adjuntos
|
: “0”: Realiza el reenvio del correo sin adjuntos
: “1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP.
{{clear}}
===Método DescargaPDF===
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|String
|documento
|Documento PDF codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
{{clear}}
===Método DescargaXML===
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado
|-
|String
|documento
|Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método FoliosRestantes===
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|int
|foliosRestantes
|Cantidad de folios disponibles
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===Método DescargarEventoXML===
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|Documento
|Documento XML (ApplicationResponse) codificado en Base64
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===Método GenerarContenedor===
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Contenedor
|Documento XML (AttachedDocument) codificado en Base64
|-
|String
|Fecha
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método GenerarEvento===
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Objeto con los datos del evento (ApplicationResponse) a generar
|}
Donde Class.DatosEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Indica el código del evento (Por definir catálogo)
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Comentario
|Comentario o descripción del evento
|-
|String
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Información adicional del evento
|}
Donde Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|consecutivoDocumentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|Documento XML (ApplicationResponse) codificado en Base64
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

===Método ConsultaAdquiriente===

Este método permite a los facturadores completar fácilmente los datos del adquiriente o comprador. El comprador solo tendrá que indicar su tipo y número de documento, con esta información, el método tarea automáticamente los datos necesarios para generar la factura, como su nombre y correo electrónico, sin necesidad de ingresarlos manualmente.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|}

Índice del Manual de Integración Directa

2025-04-21T17:49:49Z

Eruiz2:

[[Category:Manuales|I]]
__NOTOC__
[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalidades - Indice Manual Integración Directa|Generalidades]]==<includeonly>=</includeonly>
# [[Generalidades - Indice Manual Integración Directa#Historial|Historial de versiones]]
# [[Generalidades - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
# [[Generalidades - Indice Manual Integración Directa#Descripción general|Descripción general]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA Factura?|¿Qué es The Factory HKA Factura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es HKA Integración?|¿Qué es HKA Integración?]]
## [[Generalidades - Indice Manual Integración Directa#Funcionalidades|Funcionalidades]]
## [[Generalidades - Indice Manual Integración Directa#La integración directa|La integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Esquemas de integración directa para Factura Electrónica TFHKA|Esquemas de integración directa para Factura Electrónica TFHKA]]
# [[Generalidades - Indice Manual Integración Directa#Esquema de operación de la factura electrónica con validación previa|Esquema de operación de la factura electrónica con validación previa]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Generalidades - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Generalidades - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Generalidades - Indice Manual Integración Directa#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Generalidades - Indice Manual Integración Directa#Web services TFHKA con validación previa|Web services TFHKA con validación previa]]

<includeonly>=</includeonly>==[[Etapas para la implementación de la integración]]==<includeonly>=</includeonly>
# [[Etapas para la implementación de la integración#Etapas y actividades|Etapas y actividades]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa|Métodos Servicio Emisión Web TFHKA]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DetalleDeFactura|Class.DetalleDeFactura]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.EntregaMercancia|Class.EntregaMercancia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoLegalDocumentos|Método EstadoLegalDocumentos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoCertificado|Método EstadoCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método ConsultaAdquiriente|Método ConsultaAdquiriente]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método servicio Eliminar Adjuntos web soap|Método servicio Eliminar Adjuntos web soap]]


# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa|Generación De Notas Con Y Sin Referencia A Documento Electrónico]]==<includeonly>=</includeonly>
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras para manejo de descripción del impuesto ZZ|Uso de campos extras para manejo de descripción del impuesto ZZ]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T17:07:24Z

Eruiz2: /* Método ConsultaClienteDian */

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|SI
|
: Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
: Rechazo Si se reciben más decimales en los montos a los indicados en este campo
: '''PATH''': No aplica
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
: '''PATH''': /root/cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|SI
|
: Información del adquiriente
: Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
: '''PATH''':/root/cac:AccountingCustomerParty
: (ver detalle en [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + el consecutivo DIAN,
: según la configuración en portal web:
:: Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
:: Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
: Rechazo No se permiten caracteres adicionales como espacios o guiones
: Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
: Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|SI
|
: Información de detalles o productos
: '''PATH''': /root/cac:InvoiceLine
: (ver detalle en [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|SI
|
: Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
: Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
: Rechazo Si la fecha de emisión es posterior a diez días calendario
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha vencimiento de la factura, en formato: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|SI
|
: Información de impuestos generales o globales
: Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
: Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|SI
|
: Moneda o divisa del documento
: Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
: Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|SI
|
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
: Ejemplo: ‘PREF-1123456’
: Rechazo Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''.
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Redondeo aplicado para llegar a totalMonto
: Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (ver detalle en [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NO
|
: Información utilizada como método alternativo para informar conversiones a otras divisas
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (ver detalle en [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Información relacionada con la entrega
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional
: '''PATH''': /root/cac:DeliveryTerms
: (ver detalle en [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Suma de todos los pagos anticipados
: Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
: Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total del valor bruto con tributos
: Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
: Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
: Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
: Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|SI
|
: Número o cantidad de líneas de productos (renglones) presentes en el documento
: Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
: Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|SI
|
: Texto libre para informar la razón del descuento
: '''PATH''': …/cbc:AllowanceChargeReason
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
: Rechazo : Si es Descuento y monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor Base para calcular el descuento o el cargo,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NO
|
: Corresponde al código de actividad económica CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NO
|
: Apellido del adquiriente.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: Permite especifica el medio y los datos de la entrega electrónica del documento
: '''Obligatorio''': Si campo notificar = ‘SI’
: '''PATH''': No definido
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|SI
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección de recepción del adquiriente
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
: Dirección fiscal del adquiriente.
: '''Obligatorio''': Si el adquirente es responsable
: Notificación Si el adquirente es responsable y no fue informada esta clase
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
: (solo se envía un correo en este campo)
: '''PATH''': No aplica nodo
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Información legal del cliente
: Notificación : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Nombre Comercial del adquiriente
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Nota adicional de contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Activa el envío de email al adquirente.
: Valores posibles: “SI” o “NO”
: '''PATH''': No aplica
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Número del Documento o Identificación Fiscal del adquirente
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: Digito de verificación NIT del adquiriente
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|SI
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Segundo nombre del adquiriente.
: '''PATH''': No definido
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono del adquiriente
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de Identificación del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Nota: Para identificar al consumidor final se utiliza el código “13”
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|SI
|
: Identificador de tipo de persona
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}

====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NO
|
: Codigo de Evento
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Duración de Periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Unidad de medida de la duración de periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|SI
|
: Fecha de Vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Condiciones de Pago
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Medio Pago asociado
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|SI
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la multa
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la Penalidad
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo desde
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo hasta
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Porcentaje de Descuento
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje de Pago
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Numero de referencia de Anticipo
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}

====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: Medida de la latitud en grados
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: Medida de la longitud en grados
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la latitud en minutos decimales en formato mm.mm
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la longitud en minutos decimales en formato mm.mm
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la latitud con relación al Ecuador
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la longitud con relación al Ecuador
: '''PATH''': ../cbc:LongitudeDirectionCode
|}

====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tipos de Impuesto
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Información de la Dirección del Responsable de Entrega
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre “para la atención de” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Responsable de la Entrega
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
: Nota de Contacto
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: NIT del transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Digito Verificador
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Prefijo de facturación del Transportista
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Responsabilidad del Transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Telefax de transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono de transportista
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo de Identificación del Transportista
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Dirección fiscal del transportador
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Digito Verificador del NIT del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|email
|Array <String>
| -
|C/C
|
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
: '''Obligatorio''' Cuando canalDeEntrega=’0’
: '''PATH''': No aplica
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|String
| -
|NO
|
: Mensaje
: '''PATH''': No aplica
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
: '''PATH''': No aplica
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Teléfono del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
: '''PATH''': No aplica
|}

====Class.DetalleDeFactura====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad de unidades del producto/servicio facturado
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Información de cargos y descuentos
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Código del fabricante correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Código Identificador del país de origen del artículo o servicio
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del vendedor correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Código del tipo de precio informado
: '''Obligatorio''' Para muestras comerciales (valor = 01)
: Rechazo Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|C/C
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Rechazo Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos por todos los tipos
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Rechazo Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador del NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Tipo de identificación del mandatario
: '''Obligatorio''' Para facturas por mandato
: Notificación Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Marca del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Modelo del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de si el ítem es gratuito o no (sin valor comercial)
: '''Obligatorio''' Para muestras comerciales
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Nombre del fabricante del producto/servicio
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Texto libre para añadir información adicional al artículo
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Valor del artículo o servicio.
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
: '''Obligatorio''' Para muestras comerciales
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Precio total del producto o servicio.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
: '''Obligatorio''' Para uso en las representaciones gráficas
: '''PATH''': No definido
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total de la línea sin impuestos.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
: Rechazo Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Precio Unitario del porducto/servicio
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|SI
|
: Indicador de orden de secuencia (número de línea)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del fabricante correspondiente a una sub-especificación del artículo
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Para Clasificar el tipo de AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|SI
|
: Código de Unidad de medida del producto/servicio facturado
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Cuidado de
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A la atención de
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del bloque
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de la calle
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Adicional para especificar mejor el nombre de la calle
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|SI
|
: Código del departamento
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Obligatorio''' para Emisores y Adquirentes Responsables
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corrección del uso horario correspondiente
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Nombre del departamento
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Un departamento direccionable de una organización
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|SI
|
: Dirección del cliente, sin indicar ciudad ni departamento
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Distrito
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|SI
|
: Identificador del lenguaje utilizado en el nombre del país
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: Coordenadas de la dirección
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del Municipio
: Notificación Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de un Edificio
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de Parcela
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|SI
|
: País del cliente.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Piso
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..40</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
|}

====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: Ejemplo: “Factura de Venta Nacional”
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado.
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.EntregaMercancia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}

====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en el XML
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|}

====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base Imponible sobre la que se calcula el valor del tributo
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de tipo de retención
: '''PATH''': No Definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|SI
|
: Tarifa del tributo.
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
: Rechazo Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|SI
|
: Identificación de la unidad de medida
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Unidad de medida base para el tributo
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Es el valor nominal del tributo por unidad
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo si el elemento unidadMedidaTributo NO es informado.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}

'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.

====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Suma de todos los atributos valorTOTALImp
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Cantidad adicional
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Código adicional
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|codigoInterno2
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Descripción adicional
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha final del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha inicial del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
: Rechazo Por cada nombre debe existir un valor
: '''PATH''': ../cbc:Name
: (Por definir catálogos de campos extensibles a nivel de detalle)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Indicador de orden de secuencia
: '''PATH''': No definido
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
: '''PATH''': No aplica
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del canal del pago
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
: '''Obligatorio''' Si la venta es a crédito
: Rechazo: Si código del método de pago es “2” y no se envía la fecha de vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Código correspondiente al medio de pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identificador o referencia interna del Pago
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Número de días para el pago
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de ransferência o número de cheque
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}

====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Opcional, si informado indicar “No aplica”. Posibles Valores:
: 48: “Impuesto sobre las ventas - IVA”
: 49: “No responsable de IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}

====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del cliente
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Documento Referencia
: '''PATH''': ../cac:DocumentReference
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}

'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Código de Condiciones de Entrega
: '''Obligatorio''' Se es factura de exportación/internacional
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Información donde se detalle la dirección de entrega
: '''PATH''': ../cac:DeliveryLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero Identificación
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
|-
|String
|consecutivoDocumento
|Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|Bool
|esValidoDian
|“true” Si es válido
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaRespuesta
|Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código de respuesta, útil para identificación de errores
|-
|Array
|mensajesValidacion
|Mensajes de validación en caso de notificación o rechazo
|-
|String
|nombre
|Nombre definido por la DIAN
|-
|String
|qr
|Concatenación cadena del código QR (elemento de control)
|-
|Array
|reglasNotificacionDIAN
|Reglas de validación en caso de notificación
|-
|Array
|reglasValidacionDIAN
|Reglas de validación en caso de rechazo
|-
|String
|resultado
|Resultado del consumo del método: Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
|-
|String
|xml
|Archivo XML (tipo AttachedDocument) codificado en Base64
|}
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método '''CargarAdjuntos''') consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro '''adjuntos''' se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
{{clear}}

===Método EstadoDocumento===
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
|-
|String
|acuseComentario
|Comentario informado por el adquiriente al realizar el acuse
|-
|String
|acuseEstatus
|0: Acuse no realizado ; 1: Acuse realizado
|-
|String
|acuseResponsable
|Email del responsable de realizar el acuse
|-
|String
|acuseRespuesta
|0: Respuesta no enviada ; 1: Respuesta enviada
|-
|String
|ambiente
|Tipo de ambiente de generación del documento:
:: “1: ambienteDeProducción”
:: “2: ambienteDePruebas”
|-
|String
|cadenaCodigoQR
|Concatenación cadena del código QR (elemento de control)
|-
|String
|cadenaCufe
|Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
|-
|int
|Codigo
|Indica el estado de la operación retornado por el servicio
|-
|String
|consecutivo
|Consecutivo del Documento TFHKA/DIAN
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|String
|descripcionDocumento
|Identificador del tipo de documento de referencia,
: Ejemplo: “Factura de Venta Nacional”
|-
|String
|descripcionEstatusDocumento
|Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
|-
|String
|entregaMetodoDIAN
|Indica el método de Entrega a la DIAN
: (Síncrono ó Asyncrono), (Individual ó Lote)
|-
|Bool
|esValidoDIAN
|
: “true” Si es válido
: “false” Si no es válido
|-
|String
|estatusDocumento
|Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
|-
|Array <Evento>
|eventos
|Lista de eventos del Documento Electrónico
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Fecha en la que se generó el documento, en formato: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|Histórico de las entregas del documento
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|mensajeDocumento
|Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
|-
|Bool
|poseeAdjuntos
|Indica si el documento posee adjuntos:
: “true” o “false”
|-
|Bool
|poseeRepresentacionGrafica
|Indica si el documento posee representación gráfica:
: “true” o “false”
|-
|Array <String>
|reglasValidacionDIAN
|Mensajes de validación por parte de la DIAN
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Identificador del tipo de documento de referencia
: Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|ambienteDIAN
|Ambiente de generación en la DIAN:
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Código el documento del Application Response (evento)
|-
|String
|comentario
|Comentario del evento
|-
|String
|cufe
|CUFE del documento electronico
|-
|String
|descripcionEvento
|Descripción de uso/origen del evento
|-
|String
|emisorNumeroDocumento
|Número de Identificación del Emisor
|-
|String
|emisorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Emisor
|-
|String
|emisorRazonSocial
|Razón Social del Emisor
|-
|String
|emisorTipoIdentificacion
|Tipo de Identificación del Emisor
|-
|Array <ExtrasEvento>
|extras
|Información extra correspondiente al evento
|-
|String
|fechaEmision
|Fecha de Emisión del Application Response (evento)
|-
|String
|fechaRecepcion
|Fecha de Recepción del Application Response (evento)
|-
|String
|hash
|Hash del documento Application Response
|-
|String
|idPerfilDIAN
|Perfil de la DIAN
|-
|String
|mensaje
|Mensaje de descripción del ApplicationResponse
|-
|String
|nombreArchivoXML
|Nombre del archivo XML
|-
|String
|nota
|Contenido del campo Note del Application Response
|-
|String
|numeroDelEvento
|Consecutivo del Application Response
|-
|String
|receptorNumeroDocumento
|Número de Identificación del Receptor
|-
|String
|receptorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Receptor
|-
|String
|receptorRazonSocial
|Razón Social del Receptor
|-
|String
|receptorTipoIdentificacion
|Tipo de Identificación del Receptor
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUDE del evento:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Identificador del tipo de Evento:
: (Interno/ApplicationResponse)
|-
|String
|versionUBL
|Versión UBL del XML
|}
Y Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|Dirección IP del computador en el cual se realizó el acuse del correo de notificación
|-
|String
|LeidoEstatus
|Estatus del acuse del correo de notificación
|-
|String
|LeidoFecha
|Fecha del acuse del correo de notificación
|-
|String
|canalDeEntrega
|Canal de entrega del documento electrónico
|-
|Array <String>
|email
|Email del receptor del documento electrónico
|-
|String
|entregaEstatus
|Estatus de la entrega:
: ‘0’: Correo no enviado
: ‘200’: Correo enviado
|-
|String
|entregaEstatusDescripcion
|Descripción del Estatus de la entrega
|-
|String
|entregaFecha
|Fecha de la Entrega del documento
|-
|String
|fechaProgramada
|Fecha de la Entrega
|-
|String
|mensajePersonalizado
|Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
|-
|String
|nitProveedorReceptor
|NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
|-
|String
|recepcionEmailComentario
|Comentario de Acuse de Recibo del Cliente
|-
|String
|recepcionEmailEstatus
|Estatus de recepción del Correo Electrónico
: 1: Aceptado
: 2: Rechazado
: 3: En verificación
|-
|String
|recepcionEmailFecha
|Fecha de recepción del Correo Electrónico
|-
|String
|recepcionEmailIPAddress
|Dirección IP de recepción del Correo Electrónico
|-
|String
|telefono
|Para entrega por Whatsapp/Telegram
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
|-
|correo
|Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
|-
|adjuntos
|
: “0”: Realiza el reenvio del correo sin adjuntos
: “1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP.
{{clear}}
===Método DescargaPDF===
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|String
|documento
|Documento PDF codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
{{clear}}
===Método DescargaXML===
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado
|-
|String
|documento
|Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método FoliosRestantes===
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|int
|foliosRestantes
|Cantidad de folios disponibles
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===Método DescargarEventoXML===
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|Documento
|Documento XML (ApplicationResponse) codificado en Base64
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===Método GenerarContenedor===
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Contenedor
|Documento XML (AttachedDocument) codificado en Base64
|-
|String
|Fecha
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método GenerarEvento===
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Objeto con los datos del evento (ApplicationResponse) a generar
|}
Donde Class.DatosEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Indica el código del evento (Por definir catálogo)
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Comentario
|Comentario o descripción del evento
|-
|String
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Información adicional del evento
|}
Donde Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|consecutivoDocumentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|Documento XML (ApplicationResponse) codificado en Base64
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

===Método ConsultaClienteDian===

Este método permite a los facturadores completar fácilmente los datos del adquiriente o comprador. El comprador solo tendrá que indicar su tipo y número de documento, con esta información, el método tarea automáticamente los datos necesarios para generar la factura, como su nombre y correo electrónico, sin necesidad de ingresarlos manualmente.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|TipoIdentificacion
|Tipo de Identificación del adquiriente,
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID/@sch
emeName
|-
|String
|NúmeroIdentificacion
|Número de Identificación del adquiriente,
/Invoice/cac:TaxRepresentativeParty/cac:PartyIdentification/cbc:ID
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Correo electrónico
|Correo electrónico del adquiriente o comprador
|-
|String
|Nombre o razón social
|Nombre o razón social del adquiriente o comprador
|-
|}

Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa

2025-04-21T16:48:01Z

Eruiz2:

<includeonly>=</includeonly>==Método Servicio Emisión Web TFHKA==<includeonly>=</includeonly>
Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Formato
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| A || Carácter alfabético
|-
| N || Carácter numérico
|-
| AN || Carácter alfanumérico
|-
| <nowiki> A|3 </nowiki> || 3 caracteres alfabéticos (longitud fija)
|-
| <nowiki> N|3 </nowiki> || 3 caracteres numéricos (longitud fija)
|-
| <nowiki> AN|3 </nowiki> || 3 caracteres alfanuméricos (longitud fija)
|-
| <nowiki> A|..3 </nowiki> || Hasta 3 caracteres alfabéticos (longitud variable)
|-
| <nowiki> N|..3 </nowiki> || Hasta 3 caracteres numéricos (longitud variable)
|-
| <nowiki> AN|..3 </nowiki> || Hasta 3 caracteres alfanuméricos (longitud variable)
|-
| <nowiki> N|2..6 </nowiki> || Entre 2 y 6 caracteres numéricos (longitud variable)
|-
| INT32 || Entero. (Valor Máximo: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Obligatorio
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| SI || Si es obligatorio para la DIAN
|-
| NO || No es obligatorio para la DIAN
|-
| C/C || Es requerido cuando corresponda (o bajo cierta condición por el modelo de negocio del cliente)
|}
{{clear}}

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|SI
|
: Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
: Rechazo Si se reciben más decimales en los montos a los indicados en este campo
: '''PATH''': No aplica
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
: '''PATH''': /root/cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|SI
|
: Información del adquiriente
: Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
: '''PATH''':/root/cac:AccountingCustomerParty
: (ver detalle en [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + el consecutivo DIAN,
: según la configuración en portal web:
:: Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
:: Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
: Rechazo No se permiten caracteres adicionales como espacios o guiones
: Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
: Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|SI
|
: Información de detalles o productos
: '''PATH''': /root/cac:InvoiceLine
: (ver detalle en [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|SI
|
: Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
: Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
: Rechazo Si la fecha de emisión es posterior a diez días calendario
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha vencimiento de la factura, en formato: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|SI
|
: Información de impuestos generales o globales
: Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
: Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|SI
|
: Moneda o divisa del documento
: Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
: Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|SI
|
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
: Ejemplo: ‘PREF-1123456’
: Rechazo Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''.
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Redondeo aplicado para llegar a totalMonto
: Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (ver detalle en [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NO
|
: Información utilizada como método alternativo para informar conversiones a otras divisas
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (ver detalle en [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Información relacionada con la entrega
: '''Obligatorio''' Si tipoDocumento es de exportación/internacional
: '''PATH''': /root/cac:DeliveryTerms
: (ver detalle en [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Suma de todos los pagos anticipados
: Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
: Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total del valor bruto con tributos
: Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
: Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
: Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
: Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|SI
|
: Número o cantidad de líneas de productos (renglones) presentes en el documento
: Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
: Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|SI
|
: Texto libre para informar la razón del descuento
: '''PATH''': …/cbc:AllowanceChargeReason
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
: Rechazo : Si es Descuento y monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor Base para calcular el descuento o el cargo,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NO
|
: Corresponde al código de actividad económica CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NO
|
: Apellido del adquiriente.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: Permite especifica el medio y los datos de la entrega electrónica del documento
: '''Obligatorio''': Si campo notificar = ‘SI’
: '''PATH''': No definido
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|SI
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección de recepción del adquiriente
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
: Dirección fiscal del adquiriente.
: '''Obligatorio''': Si el adquirente es responsable
: Notificación Si el adquirente es responsable y no fue informada esta clase
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
: (solo se envía un correo en este campo)
: '''PATH''': No aplica nodo
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Información legal del cliente
: Notificación : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Nombre Comercial del adquiriente
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Nota adicional de contacto
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Activa el envío de email al adquirente.
: Valores posibles: “SI” o “NO”
: '''PATH''': No aplica
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Número del Documento o Identificación Fiscal del adquirente
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: Digito de verificación NIT del adquiriente
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|SI
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Segundo nombre del adquiriente.
: '''PATH''': No definido
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono del adquiriente
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de Identificación del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Nota: Para identificar al consumidor final se utiliza el código “13”
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|SI
|
: Identificador de tipo de persona
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}

====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NO
|
: Codigo de Evento
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Duración de Periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Unidad de medida de la duración de periodo
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|SI
|
: Fecha de Vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Condiciones de Pago
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Medio Pago asociado
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|SI
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la multa
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monto de la Penalidad
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo desde
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Periodo hasta
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Porcentaje de Descuento
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje de Pago
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Numero de referencia de Anticipo
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}

====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: Medida de la latitud en grados
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: Medida de la longitud en grados
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la latitud en minutos decimales en formato mm.mm
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Medida de la longitud en minutos decimales en formato mm.mm
: Rechazo Unidad superior a 60 minutos
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la latitud con relación al Ecuador
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sentido de medida de la longitud con relación al Ecuador
: '''PATH''': ../cbc:LongitudeDirectionCode
|}

====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tipos de Impuesto
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Información de la Dirección del Responsable de Entrega
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Correo Electrónico
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre “para la atención de” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Responsable de la Entrega
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
: Nota de Contacto
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: NIT del transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Digito Verificador
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Prefijo de facturación del Transportista
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Responsabilidad del Transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Telefax de transportista
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Teléfono de transportista
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo de Identificación del Transportista
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Dirección fiscal del transportador
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Digito Verificador del NIT del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Tipo documento del transportador
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|email
|Array <String>
| -
|C/C
|
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
: '''Obligatorio''' Cuando canalDeEntrega=’0’
: '''PATH''': No aplica
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|String
| -
|NO
|
: Mensaje
: '''PATH''': No aplica
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
: '''PATH''': No aplica
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Teléfono del Destinatario
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
: '''PATH''': No aplica
|}

====Class.DetalleDeFactura====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad de unidades del producto/servicio facturado
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Información de cargos y descuentos
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Código del fabricante correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Código Identificador del país de origen del artículo o servicio
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del vendedor correspondiente al artículo
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Código del tipo de precio informado
: '''Obligatorio''' Para muestras comerciales (valor = 01)
: Rechazo Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|C/C
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Rechazo Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|SI
|
: Sumatoria de los impuestos por todos los tipos
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
: Rechazo Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador del NIT del mandatario
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Tipo de identificación del mandatario
: '''Obligatorio''' Para facturas por mandato
: Notificación Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Marca del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Modelo del artículo.
: '''Obligatorio''' Si es factura internacional
: Notificación Si tipoDocumento = “02” y este elemento no fue informado
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de si el ítem es gratuito o no (sin valor comercial)
: '''Obligatorio''' Para muestras comerciales
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Nombre del fabricante del producto/servicio
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Texto libre para añadir información adicional al artículo
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Valor del artículo o servicio.
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
: '''Obligatorio''' Para muestras comerciales
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Precio total del producto o servicio.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
: '''Obligatorio''' Para uso en las representaciones gráficas
: '''PATH''': No definido
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor total de la línea sin impuestos.
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
: Rechazo Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Precio Unitario del porducto/servicio
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|SI
|
: Indicador de orden de secuencia (número de línea)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del fabricante correspondiente a una sub-especificación del artículo
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Para Clasificar el tipo de AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|SI
|
: Código de Unidad de medida del producto/servicio facturado
: Notificación Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Cuidado de
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A la atención de
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del bloque
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de la calle
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Adicional para especificar mejor el nombre de la calle
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|SI
|
: Código del departamento
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Obligatorio''' para Emisores y Adquirentes Responsables
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corrección del uso horario correspondiente
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|SI
|
: Nombre del departamento
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Un departamento direccionable de una organización
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|SI
|
: Dirección del cliente, sin indicar ciudad ni departamento
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Distrito
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|SI
|
: Identificador del lenguaje utilizado en el nombre del país
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: Coordenadas de la dirección
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|SI
|
: Código del Municipio
: Notificación Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de un Edificio
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de Parcela
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|SI
|
: País del cliente.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Piso
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..40</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
|}

====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Código o motivo del Documento
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: Rechazo Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|SI
|
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE o CUDE del documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Descripción de la naturaleza de la corrección
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Fin de Validez
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de Inicio de Validez
: '''PATH''': No definido
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenación del prefijo y el número del documento referenciado
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: Algoritmo del tipo de CUFE.
: “CUFE-SHA384” ó “CUDE-SHA384”
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción del tipo de documento referenciado,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: Ejemplo: “Factura de Venta Nacional”
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado.
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.EntregaMercancia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rechazo si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}

====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en el XML
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|}

====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|SI
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base Imponible sobre la que se calcula el valor del tributo
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicador de tipo de retención
: '''PATH''': No Definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|SI
|
: Tarifa del tributo.
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
: Rechazo Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|SI
|
: Identificación de la unidad de medida
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Unidad de medida base para el tributo
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Es el valor nominal del tributo por unidad
: '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
: Rechazo si el elemento unidadMedidaTributo NO es informado.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}

'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.

====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Suma de todos los atributos valorTOTALImp
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Cantidad adicional
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: Código adicional
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|codigoInterno2
|String
| -
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: Descripción adicional
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha final del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha inicial del período
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
: Rechazo Por cada nombre debe existir un valor
: '''PATH''': ../cbc:Name
: (Por definir catálogos de campos extensibles a nivel de detalle)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Indicador de orden de secuencia
: '''PATH''': No definido
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
: '''PATH''': No aplica
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del canal del pago
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Opcional sin uso por ahora
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
: '''Obligatorio''' Si la venta es a crédito
: Rechazo: Si código del método de pago es “2” y no se envía la fecha de vencimiento
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Código correspondiente al medio de pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre del Banco o Entidad Financiera
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identificador o referencia interna del Pago
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Número de días para el pago
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Número de ransferência o número de cheque
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}

====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Opcional, si informado indicar “No aplica”. Posibles Valores:
: 48: “Impuesto sobre las ventas - IVA”
: 49: “No responsable de IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}

====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Código del cliente
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Documento Referencia
: '''PATH''': ../cac:DocumentReference
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}

'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: Para indicar tipo de operacion a traves de la cual se realizó el recaudo en los escenarios de acreditación o reporte
: '''PATH''': Por definir
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria de la divisa extranjera para el cambio.
: Debe ser 1.00
: Rechazo Si trae valor diferente a 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|SI
|
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Indicador de Tasa de Cambio
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda destino del documento.
: Rechazo Si el contenido de este elemento no es ‘COP’
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|SI
|
: Código de moneda base del documento
: Rechazo Si el contenido de este elemento no corresponde al estándar ISO-4217
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Operador de Calculo
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
: Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
: '''PATH''': ../cbc:CalculationRate
|}

====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Informaciones relacionadas con un cargo o un descuento
: '''PATH''': ../cac:AllowanceCharge
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Código de Condiciones de Entrega
: '''Obligatorio''' Se es factura de exportación/internacional
: Rechazo: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Información donde se detalle la dirección de entrega
: '''PATH''': ../cac:DeliveryLocation
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Numero Identificación
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Monto
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Identificador del tributo
: Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
|-
|String
|consecutivoDocumento
|Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|Bool
|esValidoDian
|“true” Si es válido
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaRespuesta
|Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código de respuesta, útil para identificación de errores
|-
|Array
|mensajesValidacion
|Mensajes de validación en caso de notificación o rechazo
|-
|String
|nombre
|Nombre definido por la DIAN
|-
|String
|qr
|Concatenación cadena del código QR (elemento de control)
|-
|Array
|reglasNotificacionDIAN
|Reglas de validación en caso de notificación
|-
|Array
|reglasValidacionDIAN
|Reglas de validación en caso de rechazo
|-
|String
|resultado
|Resultado del consumo del método: Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
|-
|String
|xml
|Archivo XML (tipo AttachedDocument) codificado en Base64
|}
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método '''CargarAdjuntos''') consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro '''adjuntos''' se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
{{clear}}

===Método EstadoDocumento===
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
|-
|String
|acuseComentario
|Comentario informado por el adquiriente al realizar el acuse
|-
|String
|acuseEstatus
|0: Acuse no realizado ; 1: Acuse realizado
|-
|String
|acuseResponsable
|Email del responsable de realizar el acuse
|-
|String
|acuseRespuesta
|0: Respuesta no enviada ; 1: Respuesta enviada
|-
|String
|ambiente
|Tipo de ambiente de generación del documento:
:: “1: ambienteDeProducción”
:: “2: ambienteDePruebas”
|-
|String
|cadenaCodigoQR
|Concatenación cadena del código QR (elemento de control)
|-
|String
|cadenaCufe
|Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
|-
|int
|Codigo
|Indica el estado de la operación retornado por el servicio
|-
|String
|consecutivo
|Consecutivo del Documento TFHKA/DIAN
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|String
|descripcionDocumento
|Identificador del tipo de documento de referencia,
: Ejemplo: “Factura de Venta Nacional”
|-
|String
|descripcionEstatusDocumento
|Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
|-
|String
|entregaMetodoDIAN
|Indica el método de Entrega a la DIAN
: (Síncrono ó Asyncrono), (Individual ó Lote)
|-
|Bool
|esValidoDIAN
|
: “true” Si es válido
: “false” Si no es válido
|-
|String
|estatusDocumento
|Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
|-
|Array <Evento>
|eventos
|Lista de eventos del Documento Electrónico
|-
|String
|fechaAceptacionDIAN
|Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Fecha en la que se generó el documento, en formato: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|Histórico de las entregas del documento
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|mensajeDocumento
|Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
|-
|Bool
|poseeAdjuntos
|Indica si el documento posee adjuntos:
: “true” o “false”
|-
|Bool
|poseeRepresentacionGrafica
|Indica si el documento posee representación gráfica:
: “true” o “false”
|-
|Array <String>
|reglasValidacionDIAN
|Mensajes de validación por parte de la DIAN
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Identificador del tipo de documento de referencia
: Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|ambienteDIAN
|Ambiente de generación en la DIAN:
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Código el documento del Application Response (evento)
|-
|String
|comentario
|Comentario del evento
|-
|String
|cufe
|CUFE del documento electronico
|-
|String
|descripcionEvento
|Descripción de uso/origen del evento
|-
|String
|emisorNumeroDocumento
|Número de Identificación del Emisor
|-
|String
|emisorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Emisor
|-
|String
|emisorRazonSocial
|Razón Social del Emisor
|-
|String
|emisorTipoIdentificacion
|Tipo de Identificación del Emisor
|-
|Array <ExtrasEvento>
|extras
|Información extra correspondiente al evento
|-
|String
|fechaEmision
|Fecha de Emisión del Application Response (evento)
|-
|String
|fechaRecepcion
|Fecha de Recepción del Application Response (evento)
|-
|String
|hash
|Hash del documento Application Response
|-
|String
|idPerfilDIAN
|Perfil de la DIAN
|-
|String
|mensaje
|Mensaje de descripción del ApplicationResponse
|-
|String
|nombreArchivoXML
|Nombre del archivo XML
|-
|String
|nota
|Contenido del campo Note del Application Response
|-
|String
|numeroDelEvento
|Consecutivo del Application Response
|-
|String
|receptorNumeroDocumento
|Número de Identificación del Receptor
|-
|String
|receptorNumeroDocumentoDV
|Dígito Verificador del Número de Documento del Receptor
|-
|String
|receptorRazonSocial
|Razón Social del Receptor
|-
|String
|receptorTipoIdentificacion
|Tipo de Identificación del Receptor
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUDE del evento:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Identificador del tipo de Evento:
: (Interno/ApplicationResponse)
|-
|String
|versionUBL
|Versión UBL del XML
|}
Y Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|Dirección IP del computador en el cual se realizó el acuse del correo de notificación
|-
|String
|LeidoEstatus
|Estatus del acuse del correo de notificación
|-
|String
|LeidoFecha
|Fecha del acuse del correo de notificación
|-
|String
|canalDeEntrega
|Canal de entrega del documento electrónico
|-
|Array <String>
|email
|Email del receptor del documento electrónico
|-
|String
|entregaEstatus
|Estatus de la entrega:
: ‘0’: Correo no enviado
: ‘200’: Correo enviado
|-
|String
|entregaEstatusDescripcion
|Descripción del Estatus de la entrega
|-
|String
|entregaFecha
|Fecha de la Entrega del documento
|-
|String
|fechaProgramada
|Fecha de la Entrega
|-
|String
|mensajePersonalizado
|Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
|-
|String
|nitProveedorReceptor
|NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
|-
|String
|recepcionEmailComentario
|Comentario de Acuse de Recibo del Cliente
|-
|String
|recepcionEmailEstatus
|Estatus de recepción del Correo Electrónico
: 1: Aceptado
: 2: Rechazado
: 3: En verificación
|-
|String
|recepcionEmailFecha
|Fecha de recepción del Correo Electrónico
|-
|String
|recepcionEmailIPAddress
|Dirección IP de recepción del Correo Electrónico
|-
|String
|telefono
|Para entrega por Whatsapp/Telegram
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}
===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
|-
|correo
|Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
|-
|adjuntos
|
: “0”: Realiza el reenvio del correo sin adjuntos
: “1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP.
{{clear}}
===Método DescargaPDF===
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado.
|-
|String
|documento
|Documento PDF codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
{{clear}}
===Método DescargaXML===
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|cufe
|“Código Único de Factura Electrónica” correspondiente al documento consultado
|-
|String
|documento
|Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método FoliosRestantes===
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|int
|foliosRestantes
|Cantidad de folios disponibles
|-
|String
|mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===Método DescargarEventoXML===
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|Documento
|Documento XML (ApplicationResponse) codificado en Base64
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===Método GenerarContenedor===
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Contenedor
|Documento XML (AttachedDocument) codificado en Base64
|-
|String
|Fecha
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}
===Método GenerarEvento===
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Objeto con los datos del evento (ApplicationResponse) a generar
|}
Donde Class.DatosEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Indica el código del evento (Por definir catálogo)
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Comentario
|Comentario o descripción del evento
|-
|String
|Documento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Información adicional del evento
|}
Donde Class.ExtrasEvento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|consecutivoDocumentoEvento
|Consecutivo del evento (ApplicationResponse)
|-
|String
|Cufe
|CUFE del evento (ApplicationResponse)
|-
|String
|fechaRespuesta
|Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Código de detección de errores
|-
|String
|Mensaje
|Este mensaje está asociado al codigo, útil para identificación de errores.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|Algoritmo utilizado para calcular CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|Documento XML (ApplicationResponse) codificado en Base64
|}
{{clear}}

===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

===Método ConsultaClienteDian===

Este método permite a los facturadores completar fácilmente los datos del adquiriente o comprador. El comprador solo tendrá que indicar su tipo y número de documento, con esta información, el método tarea automáticamente los datos necesarios para generar la factura, como su nombre y correo electrónico, sin necesidad de ingresarlos manualmente.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|Tipo de documento
|Tipo de documento del adquiriente,
/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID/@sch
emeName
|-
|String
|Número de documento
|Número de documento del adquiriente,
/Invoice/cac:TaxRepresentativeParty/cac:PartyIdentification/cbc:ID
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Correo electrónico
|Correo electrónico del adquiriente o comprador
|-
|String
|Nombre o razón social
|Nombre o razón social del adquiriente o comprador
|-
|}

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T15:56:11Z

Eruiz2:

Índice del Manual de Integración Directa

2025-04-21T15:51:27Z

Eruiz2: adición metodo ConsultaClienteDian

[[Category:Manuales|I]]
__NOTOC__
[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalidades - Indice Manual Integración Directa|Generalidades]]==<includeonly>=</includeonly>
# [[Generalidades - Indice Manual Integración Directa#Historial|Historial de versiones]]
# [[Generalidades - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
# [[Generalidades - Indice Manual Integración Directa#Descripción general|Descripción general]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA Factura?|¿Qué es The Factory HKA Factura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es HKA Integración?|¿Qué es HKA Integración?]]
## [[Generalidades - Indice Manual Integración Directa#Funcionalidades|Funcionalidades]]
## [[Generalidades - Indice Manual Integración Directa#La integración directa|La integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Esquemas de integración directa para Factura Electrónica TFHKA|Esquemas de integración directa para Factura Electrónica TFHKA]]
# [[Generalidades - Indice Manual Integración Directa#Esquema de operación de la factura electrónica con validación previa|Esquema de operación de la factura electrónica con validación previa]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Generalidades - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Generalidades - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Generalidades - Indice Manual Integración Directa#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Generalidades - Indice Manual Integración Directa#Web services TFHKA con validación previa|Web services TFHKA con validación previa]]

<includeonly>=</includeonly>==[[Etapas para la implementación de la integración]]==<includeonly>=</includeonly>
# [[Etapas para la implementación de la integración#Etapas y actividades|Etapas y actividades]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa|Métodos Servicio Emisión Web TFHKA]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DetalleDeFactura|Class.DetalleDeFactura]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.EntregaMercancia|Class.EntregaMercancia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoLegalDocumentos|Método EstadoLegalDocumentos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoCertificado|Método EstadoCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método ConsultaClienteDian|Método ConsultaClienteDian]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método servicio Eliminar Adjuntos web soap|Método servicio Eliminar Adjuntos web soap]]


# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa|Generación De Notas Con Y Sin Referencia A Documento Electrónico]]==<includeonly>=</includeonly>
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras para manejo de descripción del impuesto ZZ|Uso de campos extras para manejo de descripción del impuesto ZZ]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa

2025-04-10T16:53:30Z

Eruiz2:

<includeonly>=</includeonly>==Tablas de códigos de propiedades para emisión de documentos==<includeonly>=</includeonly>
En la siguiente sección encontrará información referente a las diferentes tablas de códigos de propiedades definidas por la DIAN en el anexo técnico.
==Tabla 1==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Documentos
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.1.3. Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
! style="color:white;background:#2F5496; text-align:center;"|Uso
|- valign="center"
|-
|01
|Factura electrónica de Venta
|rowspan="4"|Tipos de factura
|-
|02
|Factura electrónica de Venta - exportación
|-
|03
|Documento electrónico de transmisión - tipo 03
|-
|04
|Factura electrónica de Venta - tipo 04
|-
|91
|Nota Crédito
|rowspan="2"|Exclusivo en referencias a documentos (elementos DocumentReference)
|-
|92
|Nota Débito
|-
|05
|Documento Soporte en adquisiciones a No Obligados a Facturar
|rowspan="2"|Exclusivo para Documento Soporte en adquisiciones a No Obligados a Facturar
|-
|95
|Nota de Ajuste Documento Documento Soporte en adquisiciones a No Obligados a Facturar
|-
|96
|Eventos (ApplicationResponse)
|}
|}

==Tabla 2==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Operación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.1.5. Tipos de operación
Para Facturas:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
|09
|AIU
|-
|10
|Estandar*
|-
|11
|Mandatos
|-
|12
|Transporte**
|-
|14
|Notarios
|-
|15
|Compra Divisas
|-
|16
|Venta Divisas
|}
Nota: (*) Valor por default
 
Nota: (**) Valor correspondiente a las operaciones efectuadas por el sector transporte de carga
Tipos de Operación Salud
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|-
|SS-Reporte
|-
|SS-SinAporte
|}
Nota: La explicación y vigencia de los tipos de operación para el sector salud se informará en http://url.minsalud.gov.co/facturacion-electronica una vez que el Ministerio de Salud informe a todos los actores regulados por ellos.
Para Notas Crédito:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
|20
|Nota Crédito que referencia una factura electrónica*
|-
|22
|Nota Crédito sin referencia a facturas*.
|-
|}
Nota: (*) El valor por default es 20, lo anterior quiere decir que si no se informa un valor, se asume que es 20 y aplicarán el conjunto de validaciones correspondiente. (*)Preferible para uso de notas rebate o de descuentos condicionados. Notas tipo 22 no tienen validación de rechazo. Objeto de control posterior.
Para Notas Débito:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
|30
|Nota Débito que referencia una factura electrónica*
|-
|32
|Nota Débito sin referencia a facturas*.
|-
|}
Nota: El valor por default es 30, lo anterior quiere decir que si no se informara un valor se sume 30 y aplicarán el conjunto de validaciones correspondiente. Notas tipo 32 y 33 no tienen validación de rechazo. Objeto control posterior.

'''@IMPORTANTE:''' Las notas tipo 22 y 32 no tienen validación de rechazo. (Objeto de control Posterior).
 

Documento Soporte en adquisiciones a No Obligados a Facturar:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
|10
|Residente
|-
|11
|No Residente
|-
|}
Nota: Conforme a la Normativa vigente,debe tenerse en cuenta lo que se indica paara el concepto de residente fiscal en Colombia y no residente fiscal en Colombia.
|}

==Tabla 3==
{| class="wikitable" style="width: 100%;"
|+ Tipos de identificación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.1. Documento de identificación (Tipo de Identificador Fiscal):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|11
|Registro civil
|-
|12
|Tarjeta de identidad
|-
|13
|Cedula de ciudadanía
|-
|21
|Tarjeta de extranjería
|-
|22
|Cédula de extranjería
|-
|31
|NIT
|-
|41
|Pasaporte
|-
|42
|Documento de identificación extranjero
|-
|47
|PEP (Permiso Especial de Permanencia)
|-
|48
|PPT (Permiso Protección Temporal) Nuevo tipo de identificación de anexo 1.9
|-
|50
|NIT de otro país
|-
|91
|NUIP*
|}
|}
'''@IMPORTANTE:''' (*) Deberá utilizarse solamente para el adquirente, debido a que este tipo de documento no pertenece a los tipos de documento en la base de datos del RUT.

==Tabla 4==
{| class="wikitable" style="width: 100%;"
|+ Código de descuento
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.9. Códigos de descuento
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|0
|Descuento no condicionado
|-
|1
|Descuento Condicionado
|}
|}
==Tabla 5==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Persona
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|1
|Persona Jurídica y asimiladas
|-
|2
|Persona Natural y asimiladas
|}
|}
==Tabla 6==
{| class="wikitable" style="width: 100%;"
|+ Unidades de Medida
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.6. Unidades de Cantidad: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|04
|spray pequeño
|BIL
|trillón de dólares
|HUR
|hora
|-
|05
|levantar
|BJ
|cangilón
|HY
|cien yardas
|-
|08
|Lote calor
|BK
|cesta
|IA
|pulgada libra
|-
|10
|grupo
|BL
|bala
|IC
|contar por pulgada
|-
|11
|equipar
|BLD
|barril seco
|IE
|persona
|-
|13
|ración
|BLL
|barril (EE.UU.)(petróleo, etc.)
|IF
|pulgadas de agua
|-
|14
|disparo
|BO
|botella
|II
|columna pulgada
|-
|15
|palo
|BP
|cien pies de tabla
|IL
|pulgada por minuto
|-
|16
|tambor de ciento quince kg
|BQL
|becquerel
|IM
|impresión
|-
|17
|tambor de cien libras
|BR
|bar
|INH
|pulgada
|}
|}
'''@IMPORTANTE:''' Esta catálogo es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.

==Tabla 7==
{| class="wikitable" style="width: 100%;"
|+ Códigos para precios de referencia
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.10. Lista de coódigos para precios de referencia
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|1
|Valor comercial
|-
|2
|Valor en Inventarios
|-
|3
|Otro valor
|}
|}

==Tabla 8==
{| class="wikitable" style="width: 100%;"
|+ Códigos para productos y servicios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.5 Productos @schemeID, @schemeName, @schemeAgencyID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|Utilizar
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Compra Eficiente: utilizar contenido de la columna "Código"
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Números Globales de Identificación de Productos - GTIN
* Ver 8.2
* Cuando hay menos de 14 números en una estructura de datos (por ejemplo, GTIN8), los números se deben justificar a la derecha en un campo de 14 dígitos rellenado con cerros en las posiciones ubicadas más a la izquierda.
|-
|020
|Partida Arancelarias
|195
|style="text-align:left;"|Partida arancelaria
|-
|999
|Estándar de adopción del contribuyente
|
|style="text-align:left;"|
* El valor en el atributo @schemeName no será validado
* El atributo @schemeAgencyID no debe ser utilizado
|}
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo '''codigoTipoPrecio'''
|}
'''@IMPORTANTE:''' Para mayor información del código para productos y servicios hacer referencia a la sección del Anexo correspondiente.
==Tabla 9==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de crédito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.4 Concepto de Corrección para Notas crédito cac DiscrepancyResponse cbc ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|1
|style="text-align:left;"|Devolución parcial de los bienes y/o no aceptación parcial del servicio
|-
|2
|style="text-align:left;"|Anulación de factura electrónica
|-
|3
|style="text-align:left;"|Rebaja o descuento parcial o total
|-
|4
|style="text-align:left;"|Ajuste de precio
|-
|5
|style="text-align:left;"|Descuento comercial por pronto pago
|-
|6
|style="text-align:left;"|Descuento comercial por volumen de ventas
|}
|}

==Tabla 10==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de débito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.5. Concepto de Corrección para Notas débito cac DiscrepancyResponsecbc ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|1
|style="text-align:left;"|Intereses
|-
|2
|style="text-align:left;"|Gastos por cobrar
|-
|3
|style="text-align:left;"|Cambio del valor
|-
|4
|style="text-align:left;"|Otros
|}
|}
==Tabla 11==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.2 Tributos cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Impuesto de Valor Agregado
|-
|02
|IC
|style="text-align:left;"|Impuesto al Consumo
|-
|03
|ICA
|style="text-align:left;"|Impuesto de Industria, Comercio y Aviso
|-
|04
|INC
|style="text-align:left;"|Impuesto Nacional al Consumo
|-
|05
|ReteIVA
|style="text-align:left;"|Retención sobre el IVA
|-
|06
|ReteRenta
|style="text-align:left;"|Retención sobre Renta
|-
|07
|ReteICA
|style="text-align:left;"|Retención sobre el ICA
|-
|08
|IC Porcentual
|style="text-align:left;"|Impuesto al Consumo de Bolsa Plastica
|-
|20
|FtoHorticultura
|style="text-align:left;"|Cuota de Fomento Hortifrutícula
|-
|21
|Timbre
|style="text-align:left;"|Impuesto de Timbre
|-
|22
|INC Bolsas
|style="text-align:left;"|Impuesto Nacional al Consumo de Bolsa Plástica
|-
|23
|INCarbono
|style="text-align:left;"|Impuesto Nacional al Carbono
|-
|24
|INCombustibles
|style="text-align:left;"|Impuesto Nacional a los Combustibles
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Sobretasa a los combustibles
|-
|26
|Sordicom
|style="text-align:left;"|Contribución minoristas (Combustibles)
|-
|30
|IC Datos
|style="text-align:left;"|Impuesto al Consumo de Datos
|-
|32
|ICL
|style="text-align:left;"|Impuesto al Consumo de Licores
|-
|33
|INPP
|style="text-align:left;"|Impuesto nacional productos plásticos
|-
|34
|IBUA
|style="text-align:left;"|Impuesto a las bebidas ultraprocesadas azucaradas****
|-
|35
|ICUI
|style="text-align:left;"|Impuesto a los productos comestibles ultraprocesados industrialmente y/o con alto contenido de azúcares añadidos, sodio o grasas saturadas
|-
|36
|ADV
|style="text-align:left;"|AD VALOREM
|-
|ZZ*
|Nombre de la figura tributaria**
|style="text-align:left;"|Otros tributos, tasas, contribuciones, y similares
|}
Nota (*): En los casos que no se cuente con el tributo expresado en el listado de este numeral, el código ZZ debe ser utilizado para informar el tributo, tasas, contribuciones o similares y el contribuyente debe indicar la información correspondiente que aplique
 
Nota (**): El nombre de la figura tributaria es asignado por el facturador y no será causal de rechazo
 
Nota (***): Para el calculo del impuesto ICA y la retención ReteICA, el porcentaje de estos se debe informar con dos (2) decimales y su operación debe ser dividida por cien (100) y a su ves el producto de esta operación deberá ser dividido nuevamente por diez (10) y este seria el valor a informar en el XML
 
Nota (****): Para el calculo del impuesto IBUA, la operacion se realiza entre los valores de los campos (PerUnitAmount*BaseUnitMeasure) con dos (2) decimales y su resultado debe ser dividido por cien (100) y este seria el valor para informar en el elemento (TaxAmount) del XML
 
Nota (*****): Para el cálculo del impuesto ICUI, la operación se realiza entre los valores de los campos (Percent * TaxableAmount) con dos (2) decimales y su resultado debe ser dividido por cien (100) y este sería el valor para informar en el elemento (TaxAmount) del XML
|}

==Tabla 12==
{| class="wikitable" style="width: 100%;"
|+ Tarifas por Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.11 Tablas de tarifas por Impuesto
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Impuesto que reporta
! style="color:white;background:#2F5496; text-align:center;"|Valores posibles para el campo cbc:Percent
la tarifa a informar dependerá del aspecto tributario del impuesto reportado
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|Tarifa
| 
|-
| Concepto|| Tarifa || (cbc:Percent)||  
|-
| Excento|| 0.00 ||  |
|-
| Bienes/Servicios al 5|| 5.00 ||  |
|-
| Contratos firmados con el estado antes de ley 1819|| 16.00 ||  
|-
| Tarifa general|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|Tarifa
| 
|-
| Concepto           || (cbc:Percent)||  
|-
| Tarifa especial|| 2.00 ||  
|-
| Tarifa especial|| 4.00 ||  |
|-
| Tarifa general|| 8.00 ||  |
|-
| Tarifa especial|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|}
|}
@IMPORTANTE: Este catálogo '''tarifas por Impuesto''' es más extenso, para mayor información hacer referencia a la [https://docs.google.com/spreadsheets/d/1EymupijUW6O1-si4bdfU-JjvS0x3gOFv/edit?usp=sharing&ouid=112467690378401473732&rtpof=true&sd=true tabla referenciada 13.3.11 Tablas de tarifas por Impuesto]

==Tabla 13==
{| class="wikitable" style="width: 100%;"
|+ Medios de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.4.2. Medios de Pago PaymentMeansCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|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
|Desembolso Crédito plus (CCD+)
|-
|4
|Reversión débito de demanda ACH
|42
|Consiganción bancaria
|-
|5
|Reversión crédito de demanda ACH
|43
|Desembolso Débito plus (CCD+)
|-
|6
|Crédito de demanda ACH
|44
|Nota cambiaria
|-
|7
|Débito de demanda ACH
|45
|Transferencia Crédito Bancario
|-
|ZZZ
|Otro
|46
|Transferencia Débito Interbancario
|-
|9
|Clearing Nacional o Regional
|47
|Transferencia Débito Bancaria
|-
|10
|Efectivo
|48
|Tarjeta Crédito
|-
|11
|Reversión Crédito Ahorro
|49
|Tarjeta Débito
|-
|12
|Reversión Débito Ahorro
|50
|Postgiro
|-
|13
|Crédito Ahorro
|51
|Telex estándar bancario francés
|-
|14
|Débito Ahorro
|52
|Pago comercial urgente
|-
|15
|Bookentry Crédito
|53
|Pago Tesorería Urgente
|-
|16
|Bookentry Débito
|60
|Nota promisoria
|-
|17
|Desembolso Crédito (CCD)
|61
|Nota promisoria firmada por el acreedor
|-
|18
|Desembolso (CCD) débito
|62
|Nota promisoria firmada por el acreedor, avalada por elbanco
|-
|19
|Crédito Pago negocio corporativo (CTP)
|63
|Nota promisoria firmada por el acreedor, avalada por untercero
|-
|20
|Cheque
|64
|Nota promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Nota promisoria firmada por un banco avalada por otrobanco
|-
|22
|Proyecto bancario certificado
|66
|Nota promisoria firmada
|-
|23
|Cheque bancario de gerencia
|67
|Nota promisoria firmada por un tercero avalada por unbanco
|-
|24
|Nota cambiaria esperando aceptación
|70
|Retiro de nota por el por el acreedor
|-
|25
|Cheque certificado
|71
|Bonos
|-
|26
|Cheque Local
|72
|Vales
|-
|27
|Débito Pago Neogcio Corporativo (CTP)
|74
|Retiro de nota por el por el acreedor sobre un banco
|-
|28
|Crédito Negocio Intercambio Corporativo (CTX)
|75
|Retiro de nota por el acreedor, avalada por otro banco
|-
|29
|Débito Negocio Intercambio Corporativo (CTX)
|76
|Retiro de nota por el acreedor, sobre un banco avalada porun tercero
|-
|30
|Transferecia Crédito
|77
|Retiro de una nota por el acreedor sobre un tercero
|-
|31
|Transferencia Débito
|78
|Retiro de una nota por el acreedor sobre un terceroavalada por un banco
|-
|32
|Desembolso Crédito plus(CCD+)
|91
|Nota bancaria tranferible
|-
|33
|Desembolso Débito plus(CCD+)
|92
|Cheque local traferible
|-
|34
|Pago y depósito pre acordado (PPD)
|93
|Giro referenciado
|-
|35
|Desembolso Crédito(CCD)
|94
|Giro urgente
|-
|36
|Desembolso Drédito(CCD)
|95
|Giro formato abierto
|-
|37
|Pago Negocio Corporativo Ahorros Crédito (CTP)
|96
|Método de pago solicitado no usuado
|-
|38
|Pago Neogcio Corporativo Ahorros Débito (CTP)
|97
|Clearing entre partners
|-
|}
|}

==Tabla 14==
{| class="wikitable" style="width: 100%;"
|+ Forma ó Metodo de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.4.1. Formas de Pago cbc PaymentMeans ID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|1
|Contado
|-
|2
|Crédito
|}
|}

==Tabla 15==
{| class="wikitable" style="width: 100%;"
|+ Condiciones de entrega (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.3.7. Condiciones de entrega (INCOTERMS)-LossRiskResponsibilityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|CFR
|Costo y flete
|-
|CIF
|Costo, flete y seguro
|-
|CIP
|Transporte y Seguro Pagados hasta
|-
|CPT
|Transporte Pagado Hasta
|-
|DAP
|Entregado en un Lugar
|-
|DAT
|Entregado en Terminal
|-
|DDP
|Entregado con Pago de Derechos
|-
|EXW
|En Fábrica
|-
|FAS
|Franco al costado del buque
|-
|FCA
|Franco transportista
|-
|FOB
|Franco a bordo
|}
|}

==Tabla 16==
{| class="wikitable" style="width: 100%;"
|+ Departamentos (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.4.2. Departamentos ISO 3166-2CO CountrySubentity, CountrySubentityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}

==Tabla 17==
{| class="wikitable" style="width: 100%;"
|+ Responsabilidades fiscales
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.7.1 Responsabilidades fiscales
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|0-13
|Gran contribuyente
|-
|0-15
|Autorretenedor
|-
|0-23
|Agente de retención en el impuesto sobre las ventas
|-
|0-47
|Régimen Simple de Tributación – SIMPLE
|-
|R-99-PN
|No Aplica - Otros
|}
|}

==Tabla 18==
{| class="wikitable" style="width: 100%;"
|+ Detalles tributarios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.2.6.2 Tributos
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|01
|IVA
|-
|04
|INC
|-
|ZA
|IVA e INC
|-
|ZZ
|No Aplica
|}
|}

==Tabla 19==
{| class="wikitable" style="width: 100%;"
|+ Municipios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.9 01-11-2023 - 13.4.3 Municipios: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código Departamento
! style="color:white;background:#2F5496; text-align:center;"|Código Municipio
! style="color:white;background:#2F5496; text-align:center;"|Nombre Departamento
! style="color:white;background:#2F5496; text-align:center;"|Nombre Municipio
|- valign="center"
|-
|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
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANTE:''' Este catálogo '''municipios''' es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.

==Tabla 20==
{| class="wikitable" style="width: 100%;"
|+ Zona Postal
|- valign="center"
|colspan="2"|Anexo 1.9-01-11-2023 - 13.4.4 Códigos_Postales cbc:PostalZone 
En Colombia el código postal consta de 6 dígitos (ejemplo: 578986) que señalan inicialmente la posición geográfica, seguida por la de encaminamiento y finalmente la que nos ubica dentro del área postal, así:

'''Departamentos Nacionales''' 
Los dos primeros dígitos representan a los departamentos nacionales, utilizando la codificación vigente Dane. Los códigos menores de 10 deben iniciar con un cero a la izquierda.

'''Zonas postales departamentales de encaminamiento''' 
La tercera y cuarta posición definen las zonas postales de encaminamiento para facilitar la clasificación a través del Código Postal: El 00 queda reservado para la capital del departamento. Del 01 al 89 permite dividir cada departamento hasta en 89 zonas de encaminamiento postal.

'''Distrito postales por municipio o localidad''' 
Las dos últimas posiciones del Código Postal Nacional permiten asignar cien distritos postales a cada una de las diez zonas postales creadas en cada departamento. Es decir, se pueden asignar hasta mil distritos distintos en cada departamento, para un total de treinta y tres mil a nivel nacional.
|}
@IMPORTANTE: Para mayor información hacer referencia a la sección del Anexo correspondiente.

==Tabla 21==
{| class="wikitable" style="width: 100%;"
|+Referencia a Documentos no Tributarios
|- valign="center"
|colspan="2"|'''Anexo 1.8 - 13.1.4. Referencia a documentos no tributarios: cbc:DocumentTypeCode''' 
Este elemento se refiere al'''xpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode'''. Estos documentos representan acciones comerciales y mercantiles que amparan o soportan transaccionesrelacionadas con este documento electrónico.

Los documentos electrónicos XML adoptados por la DIAN no deben incluirse en este fragmento ya que
estos documentos no contienen las identificaciones estándar como CUFE o CUDE.

Al tratarse de una orden de entrega se debe utilizar el grupo de elemento '''OrderReference''', al informar mas de una se debe disponer del grupo AdditionalDocumentReference.
Este campo de este grupo de información es opcional para referenciar temas comerciales a voluntad del
facturador electrónico, por tanto, los códigos son asignados por esté.
|}

<center>'''TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS DEL SECTOR SALUD'''</center>
==Tabla 22==
{| class="wikitable" style="width: 100%;"
|+ Tipo Documento Identificacion- Sector Salud
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Abv
! style="color:white;background:#2F5496; text-align:center;"|Tipo Documento de Identificación
|- valign="center"
|-
|CC
|Cédula de ciudadanía
|-
|CE
|Cédula de extranjería
|-
|CD
|Carnet Diplomático
|-
|PA
|Pasaporte
|-
|SC
|Salvoconducto
|-
|PE
|Permiso especial de permanencia
|-
|RC
|Registro civil
|-
|TI
|Tarjeta de Identidad
|-
|CN
|Certificado de nacido vivo
|-
|AS
|Adulto Sin Identificar
|-
|MS
|Menor sin Identificar
|-
|DE
|Documento Extranjero
|-
|SI
|Sin Identificación
|-
|NI
|Número de identificación tributario NIT
|-
|NV
|Certificado nacido vivo
|-
|PT
|Permiso por protección temporal
|}
|}

==Tabla 23==
{| class="wikitable" style="width: 100%;"
|+ Tipo Usuario - Sector Salud
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Tipo de usuario
|- valign="center"
|-
|01
|Contributivo cotizante
|-
|02
|Contributivo beneficiario
|-
|03
|Contributivo adicional
|-
|04
|Subsidiado
|-
|05
|Sin régimen
|-
|06
|Especiales o de Excepción cotizante
|-
|07
|Especiales o de Excepción beneficiario
|-
|08
|Particular
|-
|09
|Tomador/Amparado ARL
|-
|10
|Tomador/Amparado SOAT
|-
|11
|Tomador/Amparado Planes voluntarios de salud
|}
|}
==Tabla 24==
{| class="wikitable" style="width: 100%;"
|+ Modalidades de Pago- Sector Salud
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Modalidades de Pago
|- valign="center"
|-
|01
|Pago individual por caso / Conjunto integral de atenciones / Paquete / Canasta
|-
|02
|Pago global prospectivo
|-
|03
|Pago por capitación
|-
|04
|Pago por evento
|-
|05
|Otra Modalidad Especifica
|-
|}
|}

==Tabla 25==
{| class="wikitable" style="width: 100%;"
|+ Cobertura o Plan de Beneficios - Sector Salud
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Cobertura o plan de servicios
|- valign="center"
|-
|01
|Plan de beneficios en salud financiado con UPC
|-
|02
|Presupuesto máximo
|-
|03
|Prima EPS / EOC, no asegurados SOAT
|-
|04
|Cobertura Póliza SOAT
|-
|05
|Cobertura ARL
|-
|06
|Cobertura ADRES
|-
|07
|Cobertura Salud Pública
|-
|08
|Cobertura entidad territorial, recursos de oferta
|-
|09
|Urgencias población migrante
|-
|10
|Plan complementario en salud
|-
|11
|Plan medicina prepagada
|-
|12
|Otra pólizas en salud
|-
|13
|Cobertura Régimen Especial o Excepción
|-
|14
|Cobertura Fondo Nacional de Salud de las Personas Privadas de la Libertad
|-
|15
|Particular
|}
|}
==Tabla 26==
{| class="wikitable" style="width: 100%;"
|+ Conceptos de Recaudo
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|Copago
|-
|02
|Cuota Moderadora
|-
|03
|Cuota de recuperación
|-
|04
|Pagos compartidos en planes voluntarios de salud
|-
|05
|Anticipos
|}
|}

==Tabla 27==
{| class="wikitable" style="width: 100%;"
|+ Tipos Escenarios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|1
|Registro del Concepto de recaudo al paciente
|-
|2
|Registro del Concepto de acreditación a la EPS
|-
|3
|Registro de operaciones sin acreditación a la EPS
|-
|4
|Emisión de FEL sin recaudo previo
|}
|}

==Tabla 28==
{| class="wikitable" style="width: 100%;"
|+ Campos de Datos Adicionales
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Etiqueta
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|1
|CODIGO_PRESTADOR
|Código asignado en el Sistema General de Seguridad Social en Salud (SGSSS) a los prestadores de servicios de salud que estén en el Registro Especial de Prestadores de Servicios de Salud (REPS) o el código asignado por el Ministerio de Salud y Protección Social para los laboratorios de salud pública.
|-
|2
|TIPO_DOCUMENTO_IDENTIFICACION
|Tipo de identificación del usuario
:[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
|-
|3
|NUMERO_DOCUMENTO_IDENTIFICACION
|Registro del número de documento de identificaicón de acuerdo al tipo de documento del usuario
|-
|4
|PRIMER_APELLIDO
|Primer apellido del usuario de acuerdo a lo especificado en el documento de identificación.
|-
|5
|SEGUNDO_APELLIDO
|Segundo apellido del usuario de acuerdo a lo especificado en el documento de identificación.
|-
|6
|PRIMER_NOMBRE
|Primer nombre del usuario de acuerdo a lo especificado en el documento de identificación
|-
|7
|SEGUNDO_NOMBRE
|Segundo nombre del usuario de acuerdo a lo especificado en el documento de identificación
|-
|8
|TIPO_USUARIO
|Registro de la condición de afiliación o relacionamiento de la persona frente a la cobertura o plan de beneficios.
:[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
|-
|9
|MODALIDAD_CONTRATACION
|Registro de la modalidad de contratación y pago pactada objeto de facturación. Obligatorio.
:[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
|
|-
|10
|COBERTURA_PLAN_BENEFICIOS
|Registro de la entidad responsable de financiar la cobertura oplan de beneficios. Obligatorio.
:[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
|-
|11
|NUMERO_AUTORIZACION
|Obligatorio: Cuando exista el número de la autorización de respuesta o el número de la solicitud según sea el caso. Para el caso de urgencias, SOAT y ARL va vacío
|-
|12
|NUMERO_MIPRES
|Asignado por MIPRES
|-
|13
|NUMERO_ENTREGA_MIPRES
|Asignado por MIPRES
|-
|14
|NUMERO_CONTRATO
|Número de contrato objeto de facturación
|-
|15
|NUMERO_POLIZA
|Número de póliza SOAT o de planes voluntarios de salud. Obligatorio: Cuando se trate de atenciones SOAT o planes voluntarios de salud. Se diligencia cuando se trata de atenciones por accidente de tránsito o por atención como particular por una póliza de salud
|-
|16
|COPAGO
|Valor efectivamente pagado por el usuario y recaudado por el prestador de servicios
|-
|17
|CUOTA_MODERADORA
|Valor efectivamente pagado por el usuario y recaudado por el prestador de servicios
|-
|18
|CUOTA_RECUPERACION
|Valor efectivamente pagado por el usuario y recaudado por el prestador de servicios
|-
|19
|PAGOS_COMPARTIDOS
|Valor efectivamente pagado por el usuario y recaudado por el prestador de servicios
|}
|}

==Tabla 29==
{| class="wikitable" style="width: 100%;"
|+ Tipos de operación salud
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Tipos de operación Salud Resolución 058:2020 de la Contaduría General de la Nación finvoiceicbc:CustomizationlD Definición
|- valign="center"
|-
|SS-CUFE
|Acreditación. Este documento incluye referencia(s) de Factura Electrónica de Venta (tipo 01 o 04) que comprueba el recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación,
como recursos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. - Activa el Método de
cálculo del Sector Salud.
|-
|SS-CUDE
|Acreditación. Este documento incluye referencia(s) de Factura -de contingencia (tipos 03) que reconoce valores recaudados correspondientes a Cuotas Moderadoras, Copagos o Cuotas de
Recuperación, como ingresos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. -
Activa el Método de cálculo del Sector Salud.
|-
|SS-POS
|Acreditación. Este documento incluye referencia(s) de Documento Equivalente de Venta POS que comprueba el recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación, como
recursos a favor de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. - Activa el Método de
cálculo del Sector Salud. Observación: Los valores recaudados a favor de terceros por el operador del sistema de salud mediante los comprobantes del Sistema POS serán automatizados por la DIAN, y deberán reportarse cada vez que se cierra una caja de recaudo. La DIAN expedirá la reglamentación técnica e informática pertinente.
|-
|SS-SNum
|Acreditación. Este documento incluye referencia(s)) de Factura Talonario que comprueba él recaudo de Cuotas Moderadores, Copagos o Cuotas de Recuperación, como recursos a favor
de terceros, los cuales son acreditados a la presente Factura Electrónica de Venta con destino a la aseguradora que aparece como adquiriente. - Activa el Método de cálculo del Sector Salud.
|-
|SS-Recaudo
|Recaudación. Comprobante de recaudo de Cuotas Moderadores, Copagos o Cuotas de Recuperación, como recursos a favor de terceros. - No Activa el Método de cálculo del Sector
Salud.
|-
|SS-Reporte
|Reporte. Este documento reporta referencia(s) de diversa índole que comprueban recaudo de Cuotas Moderadoras, Copagos o Cuotas de Recuperación, a las cuales ya se les dio
tratamiento contable. - No Activa el Método de cálculo del Sector Salud.
|-
|SS-SinAporte
|Reporte. Sin aporte ni recaudo en dinero por parte de los afiliados del régimen contributivo por concepto de Cuotas Moderadoras, Copagos o Cuotas de Recuperación. - No Activa el Método
de cálculo del Sector Salud.
|}
|}

Tips Urls de documento equivalente Integración

2025-04-08T17:34:32Z

Eruiz2: Página creada con «<includeonly>=</includeonly>== URL´s Servicio de integración para HKA documento equivalente Demo==<includeonly>=</includeonly> A continuación documentamos las versiones de URL establecidas por The Factory HKA Colombia para el uso de su web service en el ambiente Demo, para que realice toda clase de pruebas funcionales. ===Demo=== *URL:[https://demoapi-de.thefactoryhka.com.co https://demoapi-de.thefactor…»

<includeonly>=</includeonly>== URL´s Servicio de integración para HKA documento equivalente Demo==<includeonly>=</includeonly>
 
A continuación documentamos las versiones de URL establecidas por The Factory HKA Colombia para el uso de su web service en el ambiente Demo, para que realice toda clase de pruebas funcionales.
 
===Demo===
*URL:[https://demoapi-de.thefactoryhka.com.co https://demoapi-de.thefactoryhka.com.co]
 
<includeonly>=</includeonly>== URL´s Servicio de integración para HKA documento equivalente Producción ==<includeonly>=</includeonly>
 
A continuación documentamos las versiones de URL establecidas por The Factory HKA Colombia para el uso de su web service en el ambiente de Producción, para que realice el proceso de generación de documentos equivalentes directamente la DIAN.
 
===Producción===
*URL:[https://api-de.thefactoryhka.com.co https://api-de.thefactoryhka.com.co]

Sección para clientes de Integración

2025-04-08T17:21:04Z

Eruiz2:

[[Archivo:Tfhka-co.png|sinmarco|derecha]]
Bienvenido a la sección para clientes de integración donde podrá encontrar información tal como preguntas frecuentes y manuales útiles en el proceso de integración para el correcto manejo del Web Service, encontrara información segmentada por Factura Electrónica y Nómina Electrónica entre otros.
 

* [[Pasos que debe seguir para integrar Factura a través de Casa de Software]]
* [[Pasos que debe seguir para integrar Nómina a través de Casa de Software]]
* [[Canales de Comunicación]]
* [[Canal de Notificaciones Técnicas Telegram]]

 
[[File:HKAFactura 3.png|200px]]
 

* [[Índice del Manual de Integración Directa]]

* [[Direct Integration Manual Index - Electronic Invoice]]
* [[Facturación Electrónica bajo Resoluciones DIAN]]
* '''[[Herramientas Alternativas de Integración Facturación]]'''
* '''[[Servicio Gestión Contribuyentes]]'''
* [[Representaciones Gráficas en el proceso de Emisión]]
* [[Reglas de Rechazo DIAN - Integración]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]
* [[Tips Urls de Emisión]]

 
[[File:HKANomina 3.png|200px]]
 

* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* '''[[Herramientas Alternativas de Integración Nómina]]'''
* [[Nómina Electrónica según Concepto Unificado DIAN 0106 – 19 agosto 2022 ]]
* [[Preguntas Frecuentes de Integración Nómina Electrónica]]
* [[Tips Urls de Emisión Nómina Electrónica]]

 
[[File:HKARecepcion 3.png|260px]]
 

* [[Índice del Manual de Integración Directa HKA Recepción]]
* [[HKA Reception Direct Integration Manual Index]]
* [[Preguntas Frecuentes de Integración Recepción Electrónica]]
* [[Tips Urls de Recepción Integración]]

 
[[File:HKAEquivalente1.png|260px]]
 
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]]
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]]
* [[Tips Urls de documento equivalente Integración]]
 
 
 

<big>Artículos de Interés:</big>
* [[HKA TIPS]]
* [[Consideraciones Url Versión 4]]
* [[Recomendaciones para integraciones ante escenarios de intermitencia o Timeouts DIAN]]
* [[Manejo de SoapUI para pruebas en Demo]]
* [[Manejo de Postman para pruebas en Demo]]
* [[Campo extra para informar el Fabricante de Software]]
* [[Recomendaciones en la implementación de la factura electronica]]
* [[Politicas de seguridad de la información para aliados de The Factory HKA]]

 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 
{{clear}}

Contingencia de factura electrónica un aliado para su negocio

2025-03-18T15:04:01Z

Eruiz2: /* Puntos clave en el portal de emisión de facturación electrónica en contingencia 03 */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 03===

Generación de la Factura de Contingencia 03
 

En situaciones donde el facturador electrónico experimenta indisponibilidad del servicio informático de la DIAN, ya sea por fallas en la conectividad con sus sistemas o interrupciones en la plataforma de validación, la normativa permite la emisión de Facturas de Contingencia con código 03. Este documento es válido para respaldar la operación comercial mientras persiste la contingencia y está regulado por la DIAN, garantizando la continuidad de las transacciones.

 
Estado de la factura en el portal de emisión
 

Una vez que se genera la Factura de Contingencia 03, esta debe ser transmitida a la DIAN en cuanto el servicio informático se restablezca. Durante el proceso de envío y hasta que se reciba la respuesta oficial de validación, el estado de la factura en el portal de emisión se mostrará como "EN PROCESO". Este estado indica que la factura ha sido generada, pero aún no ha sido aprobada o rechazada por la DIAN.

<div style="text-align: center;">Documento en proceso</div>
[[Archivo:contingencia03proceso.png|800px|sinmarco|center|Ejemplo documento en proceso]]

Estatus final de la factura

Una vez que la DIAN complete el proceso de validación, la Factura de Contingencia 03 cambiará su estado en el portal de emisión:

 
Si la DIAN aprueba la factura, su estado se actualizará, lo que confirma su validez dentro del sistema de facturación electrónica.
 
<div style="text-align: center;">Documento Aceptado</div>
[[Archivo:contingencia03aceptada.png|800px|sinmarco|center|Ejemplo documento Aceptado]]

 
Si la DIAN rechaza la factura, el estado cambiará a "RECHAZADA", lo que indicará que el documento no ha sido aceptado y requerirá la corrección de los errores identificados para su correcta reemisión.
 
<div style="text-align: center;">Documento rechazado</div>
[[Archivo:contingenciaRechazado03.png|800px|sinmarco|center|Ejemplo documento rechazado]]

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

<div style="text-align: center;">Documento emitido correctamente</div>

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento aceptado]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 

<div style="text-align: center;">Documento en proceso</div>

[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 

<div style="text-align: center;">Documento rechazado</div>

[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Diferencias entre la Contingencia 03 y la Contingencia 04 en la Facturación Electrónica===

En el marco normativo de la DIAN, se han definido distintos tipos de contingencias que permiten a los facturadores electrónicos continuar con sus operaciones en caso de eventos que impidan la emisión y transmisión de facturas en condiciones normales. Entre ellas, destacan la Contingencia 03 y la Contingencia 04, que tienen diferencias clave en cuanto a su aplicación, causales y procedimiento de validación.

Contingencia 03 – Fallas Tecnológicas del Facturador Electrónico

Causal: Se activa cuando el inconveniente no proviene de la DIAN, sino de problemas en el software de facturación del contribuyente, fallas en su conectividad a internet o errores en su infraestructura tecnológica.

Emisión del documento: El facturador genera una Factura de Contingencia con código 03, que le permite continuar facturando mientras soluciona el problema técnico.

Contingencia 04 – Indisponibilidad del Servicio Informático de la DIAN

Causal: Se presenta cuando la plataforma de validación de la DIAN está inoperativa, impidiendo la recepción y validación de las facturas electrónicas.

Emisión del documento: En este caso, el facturador debe emitir una Factura de Contingencia con código 04, la cual es un documento válido y reconocido por la DIAN mientras su sistema informático se restablece.

Archivo:ContingenciaRechazado03.png

2025-03-18T15:03:01Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Contingencia de factura electrónica un aliado para su negocio

2025-03-18T14:00:17Z

Eruiz2: /* Puntos clave en el portal de emisión de facturación electrónica en contingencia 03 */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 03===

Generación de la Factura de Contingencia 03
 

En situaciones donde el facturador electrónico experimenta indisponibilidad del servicio informático de la DIAN, ya sea por fallas en la conectividad con sus sistemas o interrupciones en la plataforma de validación, la normativa permite la emisión de Facturas de Contingencia con código 03. Este documento es válido para respaldar la operación comercial mientras persiste la contingencia y está regulado por la DIAN, garantizando la continuidad de las transacciones.

 
Estado de la factura en el portal de emisión
 

Una vez que se genera la Factura de Contingencia 03, esta debe ser transmitida a la DIAN en cuanto el servicio informático se restablezca. Durante el proceso de envío y hasta que se reciba la respuesta oficial de validación, el estado de la factura en el portal de emisión se mostrará como "EN PROCESO". Este estado indica que la factura ha sido generada, pero aún no ha sido aprobada o rechazada por la DIAN.

<div style="text-align: center;">Documento en proceso</div>
[[Archivo:contingencia03proceso.png|800px|sinmarco|center|Ejemplo documento en proceso]]

Estatus final de la factura

Una vez que la DIAN complete el proceso de validación, la Factura de Contingencia 03 cambiará su estado en el portal de emisión:

 
Si la DIAN aprueba la factura, su estado se actualizará, lo que confirma su validez dentro del sistema de facturación electrónica.
 
<div style="text-align: center;">Documento Aceptado</div>
[[Archivo:contingencia03aceptada.png|800px|sinmarco|center|Ejemplo documento Aceptado]]

 
Si la DIAN rechaza la factura, el estado cambiará a "RECHAZADA", lo que indicará que el documento no ha sido aceptado y requerirá la corrección de los errores identificados para su correcta reemisión.

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

<div style="text-align: center;">Documento emitido correctamente</div>

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento emitido correctamente]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 

<div style="text-align: center;">Documento en proceso</div>

[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 

<div style="text-align: center;">Documento Rechazado</div>

[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Diferencias entre la Contingencia 03 y la Contingencia 04 en la Facturación Electrónica===

En el marco normativo de la DIAN, se han definido distintos tipos de contingencias que permiten a los facturadores electrónicos continuar con sus operaciones en caso de eventos que impidan la emisión y transmisión de facturas en condiciones normales. Entre ellas, destacan la Contingencia 03 y la Contingencia 04, que tienen diferencias clave en cuanto a su aplicación, causales y procedimiento de validación.

Contingencia 03 – Fallas Tecnológicas del Facturador Electrónico

Causal: Se activa cuando el inconveniente no proviene de la DIAN, sino de problemas en el software de facturación del contribuyente, fallas en su conectividad a internet o errores en su infraestructura tecnológica.

Emisión del documento: El facturador genera una Factura de Contingencia con código 03, que le permite continuar facturando mientras soluciona el problema técnico.

Contingencia 04 – Indisponibilidad del Servicio Informático de la DIAN

Causal: Se presenta cuando la plataforma de validación de la DIAN está inoperativa, impidiendo la recepción y validación de las facturas electrónicas.

Emisión del documento: En este caso, el facturador debe emitir una Factura de Contingencia con código 04, la cual es un documento válido y reconocido por la DIAN mientras su sistema informático se restablece.

Archivo:Contingencia03proceso.png

2025-02-28T15:39:36Z

Eruiz2:

Contingencia de factura electrónica un aliado para su negocio

2025-02-28T15:39:07Z

Eruiz2: /* Puntos clave en el portal de emisión de facturación electrónica en contingencia 03 */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 03===

Generación de la Factura de Contingencia 03
 

En situaciones donde el facturador electrónico experimenta indisponibilidad del servicio informático de la DIAN, ya sea por fallas en la conectividad con sus sistemas o interrupciones en la plataforma de validación, la normativa permite la emisión de Facturas de Contingencia con código 03. Este documento es válido para respaldar la operación comercial mientras persiste la contingencia y está regulado por la DIAN, garantizando la continuidad de las transacciones.

 
Estado de la factura en el portal de emisión
 

Una vez que se genera la Factura de Contingencia 03, esta debe ser transmitida a la DIAN en cuanto el servicio informático se restablezca. Durante el proceso de envío y hasta que se reciba la respuesta oficial de validación, el estado de la factura en el portal de emisión se mostrará como "EN PROCESO". Este estado indica que la factura ha sido generada, pero aún no ha sido aprobada o rechazada por la DIAN.

[[Archivo:contingencia03proceso.png|800px|sinmarco|center|Ejemplo documento en proceso]]

Estatus final de la factura

Una vez que la DIAN complete el proceso de validación, la Factura de Contingencia 03 cambiará su estado en el portal de emisión:

 
Si la DIAN aprueba la factura, su estado se actualizará, lo que confirma su validez dentro del sistema de facturación electrónica.
[[Archivo:contingencia03aceptada.png|800px|sinmarco|center|Ejemplo documento Aceptado]]

 
Si la DIAN rechaza la factura, el estado cambiará a "RECHAZADA", lo que indicará que el documento no ha sido aceptado y requerirá la corrección de los errores identificados para su correcta reemisión.

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento emitido correctamente]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 
[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 
[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Diferencias entre la Contingencia 03 y la Contingencia 04 en la Facturación Electrónica===

En el marco normativo de la DIAN, se han definido distintos tipos de contingencias que permiten a los facturadores electrónicos continuar con sus operaciones en caso de eventos que impidan la emisión y transmisión de facturas en condiciones normales. Entre ellas, destacan la Contingencia 03 y la Contingencia 04, que tienen diferencias clave en cuanto a su aplicación, causales y procedimiento de validación.

Contingencia 03 – Fallas Tecnológicas del Facturador Electrónico

Causal: Se activa cuando el inconveniente no proviene de la DIAN, sino de problemas en el software de facturación del contribuyente, fallas en su conectividad a internet o errores en su infraestructura tecnológica.

Emisión del documento: El facturador genera una Factura de Contingencia con código 03, que le permite continuar facturando mientras soluciona el problema técnico.

Contingencia 04 – Indisponibilidad del Servicio Informático de la DIAN

Causal: Se presenta cuando la plataforma de validación de la DIAN está inoperativa, impidiendo la recepción y validación de las facturas electrónicas.

Emisión del documento: En este caso, el facturador debe emitir una Factura de Contingencia con código 04, la cual es un documento válido y reconocido por la DIAN mientras su sistema informático se restablece.

Archivo:Contingencia03aceptada.png

2025-02-28T15:38:16Z

Eruiz2:

Contingencia de factura electrónica un aliado para su negocio

2025-02-13T15:43:26Z

Eruiz2: /* Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 03===

Generación de la Factura de Contingencia 03
 

En situaciones donde el facturador electrónico experimenta indisponibilidad del servicio informático de la DIAN, ya sea por fallas en la conectividad con sus sistemas o interrupciones en la plataforma de validación, la normativa permite la emisión de Facturas de Contingencia con código 03. Este documento es válido para respaldar la operación comercial mientras persiste la contingencia y está regulado por la DIAN, garantizando la continuidad de las transacciones.

 
Estado de la factura en el portal de emisión
 

Una vez que se genera la Factura de Contingencia 03, esta debe ser transmitida a la DIAN en cuanto el servicio informático se restablezca. Durante el proceso de envío y hasta que se reciba la respuesta oficial de validación, el estado de la factura en el portal de emisión se mostrará como "EN PROCESO". Este estado indica que la factura ha sido generada, pero aún no ha sido aprobada o rechazada por la DIAN.

Estatus final de la factura

Una vez que la DIAN complete el proceso de validación, la Factura de Contingencia 03 cambiará su estado en el portal de emisión:

 
Si la DIAN aprueba la factura, su estado se actualizará, lo que confirma su validez dentro del sistema de facturación electrónica.
 
Si la DIAN rechaza la factura, el estado cambiará a "RECHAZADA", lo que indicará que el documento no ha sido aceptado y requerirá la corrección de los errores identificados para su correcta reemisión.

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento emitido correctamente]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 
[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 
[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Diferencias entre la Contingencia 03 y la Contingencia 04 en la Facturación Electrónica===

En el marco normativo de la DIAN, se han definido distintos tipos de contingencias que permiten a los facturadores electrónicos continuar con sus operaciones en caso de eventos que impidan la emisión y transmisión de facturas en condiciones normales. Entre ellas, destacan la Contingencia 03 y la Contingencia 04, que tienen diferencias clave en cuanto a su aplicación, causales y procedimiento de validación.

Contingencia 03 – Fallas Tecnológicas del Facturador Electrónico

Causal: Se activa cuando el inconveniente no proviene de la DIAN, sino de problemas en el software de facturación del contribuyente, fallas en su conectividad a internet o errores en su infraestructura tecnológica.

Emisión del documento: El facturador genera una Factura de Contingencia con código 03, que le permite continuar facturando mientras soluciona el problema técnico.

Contingencia 04 – Indisponibilidad del Servicio Informático de la DIAN

Causal: Se presenta cuando la plataforma de validación de la DIAN está inoperativa, impidiendo la recepción y validación de las facturas electrónicas.

Emisión del documento: En este caso, el facturador debe emitir una Factura de Contingencia con código 04, la cual es un documento válido y reconocido por la DIAN mientras su sistema informático se restablece.

Contingencia de factura electrónica un aliado para su negocio

2025-02-13T15:35:54Z

Eruiz2: /* Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 03===

Generación de la Factura de Contingencia 03
 

En situaciones donde el facturador electrónico experimenta indisponibilidad del servicio informático de la DIAN, ya sea por fallas en la conectividad con sus sistemas o interrupciones en la plataforma de validación, la normativa permite la emisión de Facturas de Contingencia con código 03. Este documento es válido para respaldar la operación comercial mientras persiste la contingencia y está regulado por la DIAN, garantizando la continuidad de las transacciones.

 
Estado de la factura en el portal de emisión
 

Una vez que se genera la Factura de Contingencia 03, esta debe ser transmitida a la DIAN en cuanto el servicio informático se restablezca. Durante el proceso de envío y hasta que se reciba la respuesta oficial de validación, el estado de la factura en el portal de emisión se mostrará como "EN PROCESO". Este estado indica que la factura ha sido generada, pero aún no ha sido aprobada o rechazada por la DIAN.

Estatus final de la factura

Una vez que la DIAN complete el proceso de validación, la Factura de Contingencia 03 cambiará su estado en el portal de emisión:

 
Si la DIAN aprueba la factura, su estado se actualizará, lo que confirma su validez dentro del sistema de facturación electrónica.
 
Si la DIAN rechaza la factura, el estado cambiará a "RECHAZADA", lo que indicará que el documento no ha sido aceptado y requerirá la corrección de los errores identificados para su correcta reemisión.

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento emitido correctamente]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 
[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 
[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, permitiendo a los contribuyentes emitir facturas electrónicas de manera temporal sin validación previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal mientras la DIAN procesa el documento. No se requiere ninguna acción adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la plataforma pero aparecen en las novedades de rechazados, estos están en proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a que el proceso de validación de la DIAN se complete antes de intentar nuevos reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01 Regla:
 Ocurre cuando el documento electrónico (Invoice) enviado por inconvenientes tecnológicos por parte de la DIAN no corresponde a un período de contingencia establecido por la misma.
 Mensaje: La hora y fecha de firmado del documento electrónico debe corresponder al periodo de contingencia establecido por la DIAN. Estos serán procesados automáticamente por la DIAN durante el período post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo de procesamiento puede variar según el volumen de documentos en el sistema, como máximo tenemos 48 horas siguientes a la superación del inconveniente tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.

Contingencia de factura electrónica un aliado para su negocio

2025-02-04T15:02:24Z

Eruiz2: /* Puntos clave en el portal de emisión de facturación electrónica en contingencia 04 */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios, tenga en cuenta que el documento quedará emitido como contingencia 04 y no cambiará a factura de venta 01
 

[[Archivo:ContingenciaAceptada.png|800px|sinmarco|center|Documento emitido correctamente]]

 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 
[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 
[[Archivo:ContingenciaRechazado.png|800px|sinmarco|center|Documento Rechazado]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, permitiendo a los contribuyentes emitir facturas electrónicas de manera temporal sin validación previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal mientras la DIAN procesa el documento. No se requiere ninguna acción adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la plataforma pero aparecen en las novedades de rechazados, estos están en proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a que el proceso de validación de la DIAN se complete antes de intentar nuevos reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01 Regla:
 Ocurre cuando el documento electrónico (Invoice) enviado por inconvenientes tecnológicos por parte de la DIAN no corresponde a un período de contingencia establecido por la misma.
 Mensaje: La hora y fecha de firmado del documento electrónico debe corresponder al periodo de contingencia establecido por la DIAN. Estos serán procesados automáticamente por la DIAN durante el período post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo de procesamiento puede variar según el volumen de documentos en el sistema, como máximo tenemos 48 horas siguientes a la superación del inconveniente tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.

Archivo:ContingenciaRechazado.png

2025-02-04T15:02:18Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ContingenciaAceptada.png

2025-02-04T15:02:17Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Contingencia de factura electrónica un aliado para su negocio

2025-02-04T14:26:46Z

Eruiz2: /* Contingencia tipo 04 */

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

===Puntos clave en el portal de emisión de facturación electrónica en contingencia 04===

Emisión de la factura de contingencia
 

Cuando se presenta una contingencia tecnológica que impide la generación y transmisión de la factura electrónica de venta en tiempo real a la DIAN, el contribuyente puede emitir una Factura de Contingencia con código 04. Este documento es plenamente válido y reconocido por la DIAN para respaldar la operación comercial y garantizar la continuidad de las transacciones en estos escenarios.
 

Estado de la factura en el portal de emisión
 

Una vez generada la Factura de Contingencia 04, esta es transmitida a la DIAN para su validación. Mientras el proceso de envío y recepción de respuesta está en curso, el sistema reflejará el estado "EN PROCESO", lo que indica que la factura aún no ha sido aprobada ni rechazada por la DIAN. Durante este tiempo, el contribuyente debe estar atento a la actualización del estado del documento.
 
[[Archivo:contingencia04proceso.png|800px|sinmarco|center|Documento en proceso]]
 

Estatus final de la factura
 

Luego de que la DIAN realice la validación correspondiente, la factura de contingencia tomará el estatus definitivo en el portal de emisión. Si la validación es exitosa, el documento se vera reflejado en el sistema como emitido correctamente, lo que indica que la factura ha sido aceptada y es completamente válida dentro del sistema de facturación electrónica. En caso de que la DIAN rechace la factura, esta tomará el estado documento rechazado, lo que obligará al emisor a realizar las correcciones necesarias y generar un nuevo documento conforme a la normativa vigente.
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, permitiendo a los contribuyentes emitir facturas electrónicas de manera temporal sin validación previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal mientras la DIAN procesa el documento. No se requiere ninguna acción adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la plataforma pero aparecen en las novedades de rechazados, estos están en proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a que el proceso de validación de la DIAN se complete antes de intentar nuevos reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01 Regla:
 Ocurre cuando el documento electrónico (Invoice) enviado por inconvenientes tecnológicos por parte de la DIAN no corresponde a un período de contingencia establecido por la misma.
 Mensaje: La hora y fecha de firmado del documento electrónico debe corresponder al periodo de contingencia establecido por la DIAN. Estos serán procesados automáticamente por la DIAN durante el período post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo de procesamiento puede variar según el volumen de documentos en el sistema, como máximo tenemos 48 horas siguientes a la superación del inconveniente tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.

Archivo:Contingencia04proceso.png

2025-02-04T14:25:50Z

Eruiz2: Archivo subido con MsUpload

Archivo subido con MsUpload

Contingencia de factura electrónica un aliado para su negocio

2025-01-17T14:14:04Z

Eruiz2: ajustes finales

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, permitiendo a los contribuyentes emitir facturas electrónicas de manera temporal sin validación previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal mientras la DIAN procesa el documento. No se requiere ninguna acción adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la plataforma pero aparecen en las novedades de rechazados, estos están en proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a que el proceso de validación de la DIAN se complete antes de intentar nuevos reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01 Regla:
 Ocurre cuando el documento electrónico (Invoice) enviado por inconvenientes tecnológicos por parte de la DIAN no corresponde a un período de contingencia establecido por la misma.
 Mensaje: La hora y fecha de firmado del documento electrónico debe corresponder al periodo de contingencia establecido por la DIAN. Estos serán procesados automáticamente por la DIAN durante el período post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo de procesamiento puede variar según el volumen de documentos en el sistema, como máximo tenemos 48 horas siguientes a la superación del inconveniente tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.

Contingencia de factura electrónica un aliado para su negocio

2025-01-17T13:53:38Z

Eruiz2: ajuste

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]] para consultar el estado de sus facturas emitidas durante la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con
validación previa de la DIAN queda fuera de línea, permitiendo a los
contribuyentes emitir facturas electrónicas de manera temporal sin validación
previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el método EstadoDocumento
o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para
confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal
mientras la DIAN procesa el documento. No se requiere ninguna acción
adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo
específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la
plataforma pero aparecen en las novedades de rechazados, estos están en
proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a
que el proceso de validación de la DIAN se complete antes de intentar nuevos
reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean
aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01
Regla: Ocurre cuando el documento electrónico (Invoice) enviado por
inconvenientes tecnológicos por parte de la DIAN no corresponde a un período
de contingencia establecido por la misma.
Mensaje: La hora y fecha de firmado del documento electrónico debe
corresponder al periodo de contingencia establecido por la DIAN.
Estos serán procesados automáticamente por la DIAN durante el período
post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN,
contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo
de procesamiento puede variar según el volumen de documentos en el sistema,
como máximo tenemos 48 horas siguientes a la superación del inconveniente
tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de
validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.

Contingencia de factura electrónica un aliado para su negocio

2025-01-17T13:35:04Z

Eruiz2: ajuste

<includeonly>=</includeonly>==Contingencia de factura electrónica un aliado para su negocio==<includeonly>=</includeonly>
Mira el siguiente enlace:
[[Archivo:Yt2.png|izquierda|]]
[https://www.youtube.com/watch?v=1uyxgK0GlWY <big>Un análisis de la resolución 165, contingencia y temas relacionados de la mano de nuestro especialista Carlos García:</big>] 
 
La contingencia de Factura Electrónica es un aliado para la operación de nuestros clientes. En el marco de la entrada en vigencia de la obligatoriedad a
partir del 1 de febrero de 2024 para la adopción del anexo técnico de factura electrónica de venta versión 1.9, en el cual se tiene establecido entre sus
principales cambios que "La fecha de generación y la fecha de la firma de la factura electrónica debe ser el mismo día" se ha eliminado la regla de 10 días
posterior e inferior a la fecha.
Por lo antes mencionado, va a ser clave que como aliados y casas de software se tengan implementados los procedimientos de facturación en escenarios de
contingencia total o parcial bajo la premisa de máximo esfuerzo de validación ante la DIAN con esquemas auditables. Y su vez el tener procesos bien implementados
para la contingencia de Facturación Electrónica va a ser un gran aliado a la hora que se presenten intermitencias o timeouts en el servicio de la DIAN,
interrupción del servicio de internet o ante intermitencias en la plataforma de emisión de facturas electrónicas de The Factory HKA Colombia. Sobre todo
en los puntos de ventas tengamos procedimientos que garanticen que las operaciones continúen y no se detengan. En tal sentido los invitamos a estudiar el
material o contenido que se presenta a continuación:

[[Archivo:contingencia01.png|800px|sinmarco|centro|contingencia01]]

 

Analizando el alcance que pueden tener los escenarios de contingencia de nuestros clientes podemos hablar de dos tipos de alcance:
===Tipos de Contingencia Facturador Electrónico (Tipo 03)===

====Contingencia Total====

Es lo que se tiene establecido en el anexo técnico 1.9 y está alineado con esquemas B2B, ahora con la masificación de la factura electrónica no es tan sencillo aplicarlo. Eventos fuera de la operación normal,
hacking, como ejemplo lo recientemente ocurrido con los hechos de hackeo a nubes privadas que generaron total indisponbilidad impidiendo el proceso de facturación electrónica.

====Contingencia Parcial====
Es una sugerencia de Procedimiento TFHKA bajo la premisa de “Máximo Esfuerzo de Validación ante la DIAN” con Esquemas Auditables. En la regulación no se presentan esquemas aplicables a este tipo de contingencia
es más alineado a esquemas B2C.

=====Contingencia Total Facturador Electrónico (Tipo 03) – Anexo Técnico 1.9=====

Corresponde al esquema que se tiene establecido en el anexo técnico 1.9.

Los inconvenientes tecnológicos por parte del facturador electrónico implican que esté tenga en cuenta lo siguiente:
• Por el tiempo en que dure la contingencia expedir factura de venta de talonario o de papel, la cual se podrá generar para su expedición de forma manual o autógrafa o a través de sistemas informáticos electrónicos
• El facturador electrónico deberá generar una carta declarando el inconveniente tecnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía o quien haga de sus veces y remitirla al
correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente:
o Asunto: Nit de la empresa separado con un guión el digito de verificación; Nombre de la empresa.
o Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal o quien haga de sus veces.
o Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
▪ Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar el inconveniente tecnológico o superación de este.
▪ Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.

• Una vez el facturador electrónico superé el inconveniente tecnológico deberá proceder a generar, transmitir, expedir y recibir sus documentos e instrumentos electrónicos de manera habitual.
• Se deberá transcribir la información mediante el documento electrónico de transmisión de cada una de las facturas de venta de talonario o papel expedidas en el tiempo que duró la contingencia, al momento de transmitir
la DIAN está informará las notificaciones y/o rechazos a que haya lugar sobre estás, las cuales deberán expedir dentro de las 48 horas siguientes al momento en que se supera el inconveniente.
• El envío de los instrumentos electrónicos debe realizarse a través del método SendBillSync.

Se informa que los documentos CreditNote, DebitNote y ApplicationResponse no tienen esquemas de contingencia, por tanto, el facturador no deberá usar la numeración de contingencia para estos documentos, sino la numeración establecida
por el facturador para estos. Dicho lo anterior se deberán generar, transmitir, validar y expedir los documentos según se establece el presente anexo cuando los inconvenientes tecnológicos presentados por parte del facturador electrónico
estén superados.

[[Archivo:contingencia02.png|800px|sinmarco|centro|contingencia02]]

'''Declaración Contingencia Total Facturador Electrónico (Tipo 03)'''

A continuación se presentan ejemplos de Inicio y Finalización de Declaración Contingencia Total Facturador Electrónico.

[[Archivo:contingencia03.png|800px|sinmarco|centro|contingencia03]]
 
=====Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03)=====
A continuación se presenta ejemplo de Solicitud Aprobación Contingencia Parcial Facturador Electrónico (Tipo 03), este tipo de esquemas no se encuentra en la regulación actual pero es el esquema que algunos de nuestros aliados han
implementado y los cuales han superado procesos de auditorías por parte de la DIAN. Y es la recomendación que damos por experiencia. Esta solicitud la debe elaborar la empresa emisora en el momento que vaya a masificar su facturación
electrónica, es un ejemplo o referencia, cada contribuyente debe adecuarla a sus procesos y operación. Debe quedar debidamente resguardado y bajo esquemas de documentación propias de Sistemas de Gestión de la empresa de ser posible.
Se recomienda que al momento de generarse la necesidad de entrar en contingencia parcial haya una aprobación o autorización por parte de un supervisor o persona designada por la empresa, y que quede trazabilidad del inicio y fin de la
contingencia, con la finalidad que pueda ser auditado posteriormente. No debe estar en potestad de un cajero o agente de punto de venta el entrar en contingencia tipo 03. Se busca garantizar que la operación y ventas no se detengan.

[[Archivo:solicitudAprobacion1.png|800px|sinmarco|centro|solicitudAprobacion1]]
 
[[Archivo:contingencia05.png|800px|sinmarco|centro|contingencia05]]

 
A continuación se presentan los gráficos de cómo pueden presentarse las contingencias parciales.
 
======Escenario 1 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia06.png|800px|sinmarco|centro|contingencia06]]
 
En la generación se tienen los datos que va a tener en el futuro la factura, aún no se tiene la factura electrónica.
Intento de transmisión, se envían los datos de lo que va a tener la factura para que con base a las validaciones de la DIAN si se convierta en factura electrónica de venta, hasta que la DIAN no lo valide no se tiene la factura electrónica.
Expedición, es entregar la factura con la validación de la DIAN. Bajo un esquema de contingencia voy a tener generación, en la generación los datos deben estar almacenados en una base de datos (disco duro, nube, sistema POS, RAM-ROM de un
celular) para tener la posibilidad de reconstruir la transacción en caso de contingencia, sobre todo en contingencias parciales.
En el escenario 1 se hacen dos intentos cada uno de 1 minuto y después del segundo se toma la decisión de expedirlo sin validación de la DIAN. La contingencia va ir sin validación pero cumpliendo con los requisitos de la factura de venta
de talonario papel, tiene una fecha de expedición, independientemente de que se transmita o no ya al adquirente le sirve esa factura para deducción de costos y gastos. La responsabilidad queda de parte del facturador electrónico, y puede
estar expuesto a sanciones por no transmitir en debida forma en los tiempos establecidos, es decir, 48 horas contadas a partir de haber salido de la contingencia. Después de la expedición se debe hacer la transmisión de los documentos.

======Escenario 2 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia07.png|800px|sinmarco|centro|contingencia07]]

======Escenario 3 Contingencia Parcial con base en Ejemplo en Solicitud======

[[Archivo:contingencia08.png|800px|sinmarco|centro|contingencia08]]
 
Estamos en rutas de venta y se llega a un sitio donde no hay internet, las transacciones se van almacenando en el dispositivo móvil, se hace el intento de transmitir y no se puede transmitir, se entrega la factura contingencia de talonario
papel y cuando se llega a una zona de cobertura ya se tiene en el sistema la posibilidad de empezar a transmitirla. Es recomendable mantener una copia física de la transacción para tener respaldo en caso de robo o extravío del dispositivo
móvil.

===Conciliación===

Ante escenarios de estados indeterminados de transacciones electrónicas que pueden ser origen de documentos emitidos en contingencia, es necesario realizar el último esfuerzo de conciliar el estado definitivo de los mismos, ejemplos:
1. Transacción validada por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se debe anular con una nota crédito referenciada.
 
[[Archivo:conciliación.png|800px|sinmarco|centro|conciliación]]
 
2. Transacción en estado de error por la DIAN después del lapso de tiempo especificado para la expedición de una factura electrónica de contingencia. Esta transacción se puede consultar por API y no se puede ver por el portal de la DIAN.
Se debe dejar registrado el intento de anulación de la transacción así no se logre.
 
[[Archivo:conciliacion01.png|800px|sinmarco|centro|conciliacion01]]
 
3.En la documentación técnica de TFHKA de estatus indeterminados pueden ver escenarios adicionales y sugerencias de manejo.
 
[[Archivo:conciliacion03.png|800px|sinmarco|centro|conciliacion03]]
 
Documentos con estatus indeterminado en HKAFactura, En esta sección de la felcowiki puede encontrar información acerca de que es, porque ocurre y como solucionar los estatus indeterminados en la emisión de facturas.

[[Canal de Notificaciones Técnicas Telegram]]

[[Documentos con estatus indeterminado en HKAFactura]]

'''Datos Origen de conciliación:'''
 
#Reporte del Portal DIAN “Facturando Electrónicamente” (Emisión / Recepción).
#Reporte de documentos desde los portales de TFHKA.
#Reporte de documentos desde los Sistemas de Facturación – ERP´s.
 
[[Archivo:conciliacion04.png|800px|sinmarco|centro|conciliacion04]]
 
'''Requisitos de las facturas de talonario o papel'''
A continuación se muestran los requisitos que deben cumplir las facturas de talonario o papel según lo establecido en el artículo 12 de la resolución DIAN 000165 de 01-11-2023.
 
[[Archivo:requisitos.png|800px|sinmarco|centro|requisitos]]
 
===Las facturas de Talonario o Papel deben incluir código QR si se expiden a través de Sistemas Informáticos & el código QR debe incluir CUFE===

En el numeral 14 del artículo 12 de de la resolución DIAN 000165 de 01-11-2023.indica que El Código de respuesta rápida -Código QR-, en caso de que la factura de venta de talonario o de papel se genere a través de sistemas
informáticos electrónicos.

[[Archivo:facturasTalonario.png|800px|sinmarco|centro|facturaTalonario]]

'''Generación del CUFE'''

[[Archivo:cufe.png|800px|sinmarco|centro|cufe]]

'''Ejemplo - Generación del CUFE'''

[[Archivo:ejemploCufe.png|800px|sinmarco|centro|ejemploCufe]]
 

===Contingencia tipo 04===

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.

 

¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN).
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
<ul>
<li>Código: 207 </li>
 
<li>Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 
<li>Contendrá CUFE</li>
 
<li>EsvalidoDIAN: false</li>
</ul>

 
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 

 Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
 
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 

Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 
 
¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?
 

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

===Proceso de contingencia tipo 04===

 1. Activación de la contingencia:
 Se activa cuando el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, impidiendo la validación de las facturas electrónicas.
 
 2. Emisión de facturas: 
 Durante la contingencia, se emitieron facturas electrónicas bajo la modalidad de contingencia tipo 04, cumpliendo con los requisitos establecidos por la DIAN.
 
 3. Transmisión posterior:
 Una vez superada la contingencia, las facturas generadas bajo esta modalidad deben ser transmitidas a la DIAN dentro de las 48 horas siguientes.
 
 4. Principales aspectos a tener en cuenta en facturación en modalidad de
contingencia tipo 04.
 En el caso de las integraciones para controlar
adecuadamente la respuesta del servicio en estos escenarios, se detalla a
continuación la información que contendrá el response:
 
 ● Código: 207.
 ● Mensaje: "El documento se generó como Documento Electrónico de
Contingencia Tipo 04, estamos a la espera de que termine la contingencia en
la DIAN para entregarlo."
 ● Contendrá CUFE
 ● EsvalidoDIAN: false
 ● Representación Gráfica: Debe estar denominada Factura Electrónica de
Venta Tipo 04.
 
===Próximos pasos===
Verificación del estado de las facturas: Recomendamos utilizar el [[#Método EstadoDocumento|Método EstadoDocumento]]
para consultar el estado de sus facturas emitidas durante
la contingencia.
 
 No reenviar documentos: No es necesario reenviar las facturas emitidas
durante la contingencia. Estas serán procesadas y validadas dentro del plazo
establecido.
 
 Atención a posibles rechazos: En algunos casos, las facturas pueden
mostrar un estado de "rechazado" temporalmente. Sugerimos esperar las 48
horas correspondientes para confirmar su estado definitivo.

===Preguntas frecuentes===

 1. ¿Qué es la contingencia tipo 04?
 
Es una medida que se activa cuando el sistema de Factura Electrónica con
validación previa de la DIAN queda fuera de línea, permitiendo a los
contribuyentes emitir facturas electrónicas de manera temporal sin validación
previa.
 
 2. ¿Cómo sé si mi factura emitida en contingencia fue aceptada?
 
Puede verificar el estado de su factura utilizando el método EstadoDocumento
o consultando el portal de emisión de TFHKA.
 
 3. ¿Qué debo hacer si mi factura aparece como "rechazada"?
 
Le recomendamos esperar las 48 horas posteriores a la transmisión para
confirmar el estado definitivo de la factura. Si después de este tiempo la factura
sigue rechazada, por favor contacte a nuestro equipo de soporte.
 
 4. Documentos con código 207
 
Si sus documentos aparecen con código 207, este es un estado temporal
mientras la DIAN procesa el documento. No se requiere ninguna acción
adicional.
 
 5. Documentos rechazados sin motivo explícito
 
Los documentos de contingencia que aparecen rechazados sin motivo
específico están en proceso de validación. No requieren acción inmediata.
 
 6. Documentos no visibles en plataforma
 
Si los documentos generados durante la contingencia no son visibles en la
plataforma pero aparecen en las novedades de rechazados, estos están en
proceso de sincronización con los sistemas de la DIAN.
 
 7. Error de reenvío a correos de clientes
 
Si al intentar reenviar facturas aparece un mensaje de fallo, por favor espere a
que el proceso de validación de la DIAN se complete antes de intentar nuevos
reenvíos. Los correos de notificación se enviarán a los adquirentes una vez sean
aprobados y autorizados por la DIAN.
 
 8. Documentos con código de error 99 (regla CTG01)
 
Para documentos con error 99 relacionados con la regla CTG01
Regla: Ocurre cuando el documento electrónico (Invoice) enviado por
inconvenientes tecnológicos por parte de la DIAN no corresponde a un período
de contingencia establecido por la misma.
Mensaje: La hora y fecha de firmado del documento electrónico debe
corresponder al periodo de contingencia establecido por la DIAN.
Estos serán procesados automáticamente por la DIAN durante el período
post-contingencia, es decir, tendremos 48 horas para transmitirlas a la DIAN,
contadas a partir de que se detecte que el servicio de la DIAN esté activo.
 
 9. Estado de procesamiento DIAN
 
Los documentos están siendo procesados gradualmente por la DIAN. El tiempo
de procesamiento puede variar según el volumen de documentos en el sistema,
como máximo tenemos 48 horas siguientes a la superación del inconveniente
tecnológico.
 
====Importante====
● Mantener la calma y evite acciones que puedan interferir con el proceso de
validación.
 ● No realice reenvíos masivos de documentos.
 ● Esperar las actualizaciones automáticas del sistema.
 
 Recuerden que en este escenario, hay una indisponibilidad total en la DIAN, y mientras no sea superado el inconveniente no se realizan transmisiones (allí pueden encontrar documentos rechazados hasta que se realice la transmisión), sin embargo nosotros como proveedor tecnológico nos encargamos de transmitir los documentos en los tiempos establecidos (lapso de 48 horas) una vez la DIAN supera su inconveniente, en el pleno cumplimiento de la norma.