Diferencia entre revisiones de «Manual de usuario LAYOUT ARCHIVO PLANO»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Línea 1: Línea 1:
−
# [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Historial|Historial de versiones]]
+
<includeonly>=</includeonly>== Historial de Versiones  ==<includeonly>=</includeonly>
−
# [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
+
<br />
−
# [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Descripción General|Descripción General]]
+
{| class="wikitable" style="margin: auto;"
−
# [[Manual de usuario LAYOUT ARCHIVO PLANO - 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]]
+
|-
−
## [[Manual de usuario LAYOUT ARCHIVO PLANO - 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?]]
+
! style="background:#e9e9e9; text-align:center;"|Versión
−
## [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
+
! style="background:#e9e9e9; text-align:center;"|Fecha lanzamiento
−
## [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
+
! style="background:#e9e9e9; text-align:center;"|Descripción
−
## [[Manual de usuario LAYOUT ARCHIVO PLANO - 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]]
+
|- valign="center"
−
## [[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
+
| 1.0
 +
| 20/06/19
 +
| Versión Inicial 1.0
 +
|-
 +
| 1.1
 +
| 08/07/19
 +
| Actualización del Objeto
 +
|-
 +
| 1.2
 +
| 18/07/19
 +
| Modificación Línea 02K Orden de Compra
 +
|-
 +
| 1.3
 +
| 29/07/19
 +
| Cambio en Id Destinatario (obligatoriedad) y ajustes menores
 +
|-
 +
| 1.4
 +
| 04/2020
 +
| Actualizaciones en base al Anexo Técnico 1.8, extras, tablas de códigos, cambio del nombre del documento, entre otros.
 +
|-
 +
| 1.5
 +
| 05/2021
 +
| Actualizaciones en base al Anexo Técnico V1.8 de la Resolución 000012. Campos Sector Salud. Tablas de códigos.
 +
|-
 +
|}
 +
<br />
 +
<includeonly>=</includeonly>==Cómo obtener soporte==<includeonly>=</includeonly>
 +
<br />
 +
*Soporte de 1er nivel:
 +
::Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
 +
*Soporte de 2do nivel:
 +
::Soporte resolución remota de incidencias en el sistema en horario 5x8
 +
::::Escriba  a [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]
  
−
[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#GENERACÍON DEL ARCHIVO PLANO (TXT)|GENERACÍON DEL ARCHIVO PLANO (TXT)]]
 
  
−
[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#ESTRUCTURA GENERAL DEL ARCHIVO PLANO (TXT)|ESTRUCTURA GENERAL DEL ARCHIVO PLANO (TXT)]]
+
:Para consultas referente a configuraciones y errores en el Portal:
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Datos generales del adquiriente -> (Identificador 01)|Datos generales del adquiriente -> (Identificador 01)]]
+
* soporte_fel_co@thefactoryhka.com
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Destinatario -> (Identificador 01A)|Destinatario -> (Identificador 01A)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Detalles Tributarios del Adquiriente -> (Identificador 01B)|Detalles Tributarios del Adquiriente -> (Identificador 01B)]]
+
:Para consultas referente a configuraciones de ERP, casa de software e integración:
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección del Adquiriente -> (Identificador 01C)|Dirección del Adquiriente -> (Identificador 01C)]]
+
* integracion_fel_co@thefactoryhka.com
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización del Adquiriente -> (Identificador 01C1)|Localización del Adquiriente -> (Identificador 01C1)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección Fiscal del Adquiriente -> (Identificador 01D)|Dirección Fiscal del Adquiriente -> (Identificador 01D)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización Fiscal del Adquiriente -> (Identificador 01D1)|Localización Fiscal del Adquiriente -> (Identificador 01D1) (TXT)]]
+
'''Lineas de atención telefónica:'''
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Información Legal del Adquiriente -> (Identificador 01E)|Información Legal del Adquiriente -> (Identificador 01E)]]
+
* '''MASTER''' +57 (1) 746.08.12
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Responsabilidades RUT del Adquiriente -> (Identificador 01F)|Responsabilidades RUT del Adquiriente -> (Identificador 01F)]]
+
*        +57 (1) 508.8990
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Datos generales del documento -> (Identificador 02)|Datos generales del documento -> (Identificador 02)]]
+
*        +57 (1) 517.6795
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Anticipos -> (Identificador 02A)|Anticipos -> (Identificador 02A)]]
+
*        +57 (1) 517.6796
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Autorizado -> (Identificador 02B)|Autorizado -> (Identificador 02B)]]
+
*        +57 (1) 311.3063
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección del Autorizado -> (Identificador 02B1)|Dirección del Autorizado -> (Identificador 02B1))]]
+
** '''Soporte Técnico''' → Opción 2
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización del Autorizado -> (Identificador 02B1A)|Localización del Autorizado -> (Identificador 02B1A)]]
+
** '''Integración ''' → Opción 5 Luego Opción 1
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Cargos y Descuentos -> (Identificador 02C)|Cargos y Descuentos -> (Identificador 02C)]]
+
<br />
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Condición de Pago -> (Identificador 02D)|Condición de Pago -> (Identificador 02D)]]
+
<includeonly>=</includeonly>== Descripción General==<includeonly>=</includeonly>
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Documentos Referenciados -> (Identificador 02E)|Documentos Referenciados -> (Identificador 02E)]]
+
<br />
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Entrega de Mercancía (Delivery) -> (Identificador 02F)|Entrega de Mercancía (Delivery) -> (Identificador 02F)]]
+
En éste documento está orientado a la descripción del layout del archivo de texto plano (.txt), el cual es utilizado en los modelos de integración a través de algunas de las siguientes herramientas:
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Datos del Transportista (Delivery) -> (Identificador 02F1)|Datos del Transportista (Delivery) -> (Identificador 02F1)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Detalles Tributarios del Transportista -> (Identificador 02F1A)|Detalles Tributarios del Transportista -> (Identificador 02F1A)]]
+
* Conector Indirecto HKA AutoFact (Versión TXT)
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización Responsable De Entrega -> (Identificador 02F1B1)|Localización Responsable De Entrega -> (Identificador 02F1B1)]]
+
* API para integración directa IntTfhkaFel
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Responsabilidades RUT del Transportista -> (Identificador 02F1C)|Responsabilidades RUT del Transportista -> (Identificador 02F1C)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección Del Transportador -> (Identificador 02F1D)|Dirección Del Transportador -> (Identificador 02F1D)]]
+
<includeonly>=</includeonly>==Esquema de operación de la factura electrónica con validación previa==<includeonly>=</includeonly>
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización Del Trasportador -> (Identificador 02F1D1)|Localización Del Trasportador -> (Identificador 02F1D1)]]
+
<br />
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección De Despacho -> (Identificador 02F2)|Dirección De Despacho -> (Identificador 02F2)]]
+
===¿Qué es la Facturación Electrónica con Validación Previa?===
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización De Despacho -> (Identificador 02F2A)|Localización De Despacho -> (Identificador 02F2A))]]
+
<br />
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección De Entrega -> (Identificador 02F3)|Dirección De Entrega -> (Identificador 02F3)]]
+
La Facturación Electrónica (FEL) es un esquema de operación que permite emitir documentos de respaldo de las operaciones comerciales entre contribuyentes en formato digital en lugar de papel, permite la aplicación de control fiscal durante el proceso, y tiene validez legal para el ente tributario designado por el gobierno del país.
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización De Entrega -> (Identificador 02F3A)|Localización De Entrega -> (Identificador 02F3A)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Impuestos Generales -> (Identificador 02G)|Impuestos Generales -> (Identificador 02G)]]
+
A partir de septiembre de 2019, se tiene previsto que una factura electrónica solo será válida cuando se haya validado previamente su contenido a través de la DIAN o a través de un proveedor autorizado por la administración de impuestos.
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Impuestos Totales -> (Identificador 02H)|Impuestos Totales -> (Identificador 02H)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Información Adicional -> (Identificador 02I)|Información Adicional -> (Identificador 02I)]]
+
La validación previa se encuentra establecida en la ley 1943 de 2018, conocida como Ley de Financiamiento. El artículo 16 de esta Ley modifica el artículo 616-1 del Estatuto Tributario, en su parágrafo primero consagra que:
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Medios De Pago -> (Identificador 02J)|Medios De Pago -> (Identificador 02J)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Orden De Compra -> (Identificador 02K)|Orden De Compra -> (Identificador 02K)]]
+
“Todas las facturas electrónicas para su reconocimiento tributario deberán ser validadas previo a su expedición, por la DIAN o por un proveedor autorizado por esta. La factura electrónica solo se entenderá expedida cuando sea validad y entregada al adquiriente. (…)”
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Tasa De Cambio -> (Identificador 02L)|Tasa De Cambio -> (Identificador 02L)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Tasa De Cambio Alternativa -> (Identificador 02M)|Tasa De Cambio Alternativa -> (Identificador 02M)]]
+
En el modelo de facturación electrónica con validación previa se utilizarán 5 tipos de documentos:
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Términos De Entrega -> (Identificador 02N)|Términos De Entrega -> (Identificador 02N)]]
+
*Invoice (Factura)
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Cargos y Descuentos de Entrega -> (Identificador 02N1)|Cargos y Descuentos de Entrega -> (Identificador 02N1)]]
+
*CreditNote (Nota Crédito)  
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Dirección De Entrega -> (Identificador 02N2)|Dirección De Entrega -> (Identificador 02N2)]]
+
*DebitNote (Nota Débito)
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Localización De Entrega -> (Identificador 02N2A)|Localización De Entrega -> (Identificador 02N2A)]]
+
*ApplicationResponse (Evento): Ocurrencia relacionada con un Documento Electrónico, generada por una persona o entidad relacionada con el documento (DIAN, Emisor, Adquiriente), este documento también contiene una firma electrónica.
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Detalles del Documento -> (Identificador 03)|Detalles del Documento -> (Identificador 03)]]
+
*AttachedDocument (Contenedor de Documentos): La estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha.
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Extras del Documento -> (Identificador 04)|Extras del Documento -> (Identificador 04)]]
+
{{clear}}
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Parámetro adjuntos -> (Identificador 05)|Parámetro adjuntos -> (Identificador 05)]]
+
<br />
−
[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#PARA EMISIONES DE DOCUMENTOS DEL SECTOR SALUD|PARA EMISIONES DE DOCUMENTOS DEL SECTOR SALUD]]
+
===¿Quiénes participan en este esquema?===
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Datos del Beneficiario del Servicio de Salud -> (Identificador SSBenef)|Datos del Beneficiario del Servicio de Salud -> (Identificador SSBenef)]]
+
<br />
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Campos De Datos Generales Del Sector Salud: -> (Identificador SSCG)|Campos De Datos Generales Del Sector Salud: -> (Identificador SSCG)]]
+
'''El Ente Tributario (DIAN):''' Es una institución pública, nombrada por el gobierno para recaudar, controlar y regular todo lo relacionado con los tributos. Es el que tiene el derecho de aceptar y autorizar un documento electrónico. En Colombia, es la DIAN (Dirección de Impuestos y Aduanas Nacionales).
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Campos Generales Del Sector Salud: -> (Identificador SSalud)|Campos Generales Del Sector Salud: -> (Identificador SSalud)]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#Extras Del Sector Salud -> (Identificador SSextras)|Extras Del Sector Salud -> (Identificador SSextras)]]
+
'''El Emisor o Contribuyente:''' Es una persona natural o jurídica que posee un registro de información fiscal único y legal ante el ente tributario (NIT: Número de Identificación Tributario) y está bajo la obligación de emitir documentos para respaldar sus transacciones comerciales. El emisor adquiere el Sistema de Facturación o Software administrativo ERP para simplificar y potenciar sus labores y hace uso de él para interactuar con la plataforma de facturación electrónica.
−
[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS|TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS]]
+
 
−
#[[Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa#TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS DEL SECTOR SALUD|TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS DEL SECTOR SALUD]]
+
'''El Proveedor Tecnológico:''' Es un ente privado autorizado por la DIAN para prestar servicios relacionados con el esquema de Facturación Electrónica: construcción del XML, control de secuenciales, firmado, control de cambio normativo, procesamiento, almacenamiento y consulta. The Factory HKA Colombia es su proveedor tecnológico.
 +
 
 +
'''El Adquiriente:''' Es la persona que da origen a una transacción comercial mediante la compra de un producto o servicio, y que finalmente, opta por recibir su documento electrónico vía email.
 +
 
 +
'''La Autoridad de Certificación:''' Es un ente público o privado habilitado por el Ente Tributario para expedir certificados electrónicos conforme a la ley y a las normas asociadas. En Colombia, hay varias autoridades acreditadas para expedir certificados electrónicos para facturación electrónica, entre ellas ANDES SCD.
 +
{{clear}}
 +
<br />
 +
===Ventajas de la Facturación Electrónica===
 +
<br />
 +
El esquema de Facturación Electrónica es ventajoso porque es:
 +
*Íntegro: Garantiza que la información contenida está protegida y no puede ser alterada.
 +
*Auténtico: Permite verificar la identidad del emisor del documento.
 +
*Legal: Este esquema está implementado y aceptado bajo el marco de la Ley.
 +
*Práctico: Elimina la infraestructura para el manejo, envío y almacenamiento de soportes físicos, y permite la impresión.
 +
*Eficiente: Se basa 100% en plataforma electrónica, lo cual hace que el manejo, envío, búsqueda y almacenamiento sea más rápido y práctico.
 +
{{clear}}
 +
<br />
 +
===Proceso de la Facturación Electrónica con Validación Previa===
 +
<br />
 +
# El Adquiriente da origen a una transacción mediante la compra de un producto o servicio.
 +
# El Emisor o Contribuyente carga los datos mediante la UI (User Interface) de su ERP.
 +
# El Emisor o Contribuyente visualiza los timbres disponibles en la UI de su ERP.
 +
# El ERP construye el objeto y lo expone directamente a la plataforma DFACTURE mediante el método correspondiente del Web Service.
 +
# La plataforma The Factory HKA – DFACTURE:
 +
#* Valida las credenciales de acceso del Contribuyente.
 +
#* Valida la estructura del objeto que envía el ERP.
 +
#* Valida el contenido del objeto que envía el ERP.
 +
#* Asigna el CUFE (Código único de Factura Electrónica) al documento.
 +
#* Construye el XML del documento según normativa DIAN.
 +
#* Firma el documento con el Certificado Digital del Contribuyente.
 +
#* Opcional: Genera una representación impresa en PDF según normativa DIAN.
 +
#* Almacena la información en Base de Datos (Conservación).
 +
#* Envía el XML a la DIAN para validación.
 +
#* Espera respuesta de la DIAN con resultado de la validación.
 +
#* Envía el XML y PDF al email proporcionado por el Adquiriente.
 +
#* Responde a la solicitud del ERP indicando que la operación fue satisfactoria.
 +
# Opcionalmente, el ERP puede enviar el XML y PDF al adquiriente.
 +
# Opcionalmente, el ERP puede descargar el XML y PDF para propósito interno.
 +
# El Adquiriente recibe el XML y el PDF (vía email).
 +
# El Adquiriente tiene hasta 72 horas para dar Acuse de Recibo del documento, después de lo cual se considerará una aceptación tácita (este proceso aún no está definido totalmente por la DIAN).
 +
# El Emisor o Contribuyente visualiza el estatus del acuse de recibo del Adquiriente en la UI de su ERP.
 +
 
 +
 
 +
<center>'''Proceso de Facturación Electrónica con Validación Previa'''</center>
 +
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|centro|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]
 +
 
 +
'''@Importante:''' Para ambientes de desarrollo con limitaciones para consumir Web Services SOAP de manera directa, The Factory HKA Colombia pone a disposición API’s simplificando al integrador éste proceso.
 +
{{clear}}
 +
<br />
 +
<includeonly>=</includeonly>==Características del proceso con Validación Previa==<includeonly>=</includeonly>
 +
<br />
 +
# En una etapa inicial, por única vez, el emisor debe registrarse y la plataforma debe ser configurada directamente desde el portal The Factory HKA-Dfactura.
 +
# La plataforma opera bajo un modelo comercial de timbres o folios. Los timbres corresponden a un paquete de operaciones que el contribuyente contrata bajo un acuerdo comercial con The Factory HKA Colombia, y le da derecho a un determinado número de transacciones. El ERP puede consultar al Web Service de THE FACTORY HKA – DFACTURE los timbres disponibles.
 +
# Para que el documento sea considerado factura electrónica, se requiere validación de la DIAN para su posterior envío al Adquiriente por parte de Dfactura.
 +
# En caso de que el documento no sea válido exitosamente ante la DIAN, éste deberá ser corregido y reexpedido.
 +
# El ERP puede consumir el Web Service para descargar XML y PDF si desea un respaldo alterno u ofrecer funcionalidad de consulta offline.
 +
# El ERP opcionalmente puede decidir si enviar el XML y PDF al Adquiriente bajo su estructura.
 +
# El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del Acuse de Recibo por parte del Adquiriente.  Éste se actualiza de forma asincrónica.
 +
# El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del documento por parte de la DIAN.  Éste se actualiza de forma asincrónica.
 +
# El ERP refleja en su UI los resultados de sus consultas y operaciones con la plataforma. Sin embargo, el Emisor o Contribuyente puede hacer seguimiento o revisión a la vista de su ERP accediendo al portal The Factory HKA-Dfactura, ya que las operaciones realizadas en el Web Service se reflejan en el portal.
 +
 
 +
<center>'''Diagrama de componentes y dependencias del sistema de facturación electrónica'''</center>
 +
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]
 +
 
 +
La Figura anterior muestra la forma en la que el Software de Facturación (ERP) se integra y hace uso de las funcionalidades de facturación electrónica de la plataforma The Factory HKA – DFACTURE, interactuando con los elementos externos (el emisor, el Adquiriente y la DIAN) mediante las dependencias disponibles, pueden verse las funciones que cada sistema debe realizar.
 +
{{clear}}
 +
<br />
 +
<includeonly>=</includeonly>== Generación del archivo Plano (TXT) ==<includeonly>=</includeonly>
 +
<br />
 +
Para construir el archivo plano (txt), se deben utilizar los campos declarados más adelante en las tablas de configuración en el orden especificado y separados por un pipe “|”. En caso de que los campos no tengan valor alguno deberá el contenido entre pipe estar vacíos (sin espacios en blanco como recomendación, Ejemplo: ||).
 +
 
 +
Los campos a incorporar en el archivo plano (txt) deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:
 +
<br />
 +
{| class="wikitable" style="margin: auto;"
 +
|-
 +
! style="background:#e9e9e9; text-align:center;"|Formato
 +
! style="background:#e9e9e9; text-align:center;"|Descripcion
 +
|- valign="center"
 +
| A
 +
| Carácter alfabético
 +
|-
 +
| N
 +
| Carácter numérico
 +
|-
 +
| AN
 +
| Carácter alfanumérico
 +
|-
 +
| A|3
 +
| 3 caracteres alfabéticos (longitud fija)
 +
|-
 +
| N|3
 +
| 3 caracteres numéricos(longitud fija)
 +
|-
 +
| AN|3
 +
| 3 caracteres alfanuméricos (longitud fija)
 +
|-
 +
| A|..3
 +
| Hasta 3 caracteres alfabéticos(longitud variable)
 +
|-
 +
| N|..3
 +
| Hasta 3 caracteres numéricos(longitud variable)
 +
|-
 +
| AN|..3
 +
| Hasta 3 caracteres alfanuméricos (longitud variable)
 +
|-
 +
| N|..8|5.2
 +
| Hasta 8 caracteres numéricos, conformados por (hasta) 5 enteros y dos decimales separados por punto
 +
|-
 +
| N|2..6
 +
| Entre 2 y 6 caracteres numéricos (longitud variable)
 +
|-
 +
| INT32
 +
| Entero.('''Valor Máximo: 2,147,483,647)
 +
|-
 +
|}
 +
<br />
 +
{| class="wikitable" style="margin: auto;"
 +
|-
 +
! style="background:#e9e9e9; text-align:center;"|Requerido
 +
! style="background:#e9e9e9; text-align:center;"|Descripcion
 +
|- 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)
 +
|-
 +
|}
 +
<br />
 +
<includeonly>=</includeonly>== Estructura General del Archivo Plano (TXT) ==<includeonly>=</includeonly>
 +
<br />
 +
En las siguientes tablas, se detalla el layout del archivo planto (txt) para el modelo de facturación electrónica con validación previa.
 +
<br />
 +
{| class="wikitable" style="margin: auto;"
 +
|-
 +
! style="background:#e9e9e9; text-align:center;"|Descripción general del identificador
 +
! style="background:#e9e9e9; text-align:center;"|Requerido
 +
|- valign="center"
 +
| '''01''' "DATOS GENERALES DEL ADQUIRIENTE"
 +
| SI
 +
|-
 +
| '''01A''' "DESTINATARIO" (Repetible)
 +
| SI
 +
|-
 +
| '''01B''' "DETALLES TRIBUTARIOS DEL ADQUIRIENTE" (Repetible)  
 +
| SI
 +
|-
 +
| '''01C''' "DIRECCION DEL ADQUIRIENTE"
 +
| C/C
 +
|-
 +
| '''01C1''' "LOCALIZACION DEL ADQUIRIENTE" (Repetible)
 +
| NO
 +
|-
 +
| '''01D''' "DIRECCION FISCAL DEL ADQUIRIENTE"
 +
| C/C
 +
|-
 +
| '''01D1''' "LOCALIZACION FISCAL DEL ADQUIRIENTE" (Repetible)
 +
| NO
 +
|-
 +
| '''01E''' "INFORMACION LEGAL DEL ADQUIRIENTE"
 +
| C/C
 +
|-
 +
| '''01F''' "RESPONSABILIDADES RUT DEL ADQUIRIENTE" (Repetible)
 +
| SI
 +
|-
 +
| '''02''' "DATOS GENERALES DEL DOCUMENTO"
 +
| SI
 +
|-
 +
| '''02A''' "ANTICIPOS" (Repetible)
 +
| NO
 +
|-
 +
| '''02B''' "AUTORIZADO"
 +
| NO
 +
|-
 +
| '''02B1''' "DIRECCION DEL AUTORIZADO"
 +
| NO
 +
|-
 +
| '''02B1A''' "LOCALIZACION DEL AUTORIZADO" (Repetible)
 +
| NO
 +
|-
 +
| '''02C''' "CARGOS Y DESCUENTOS" (Repetible)
 +
| NO
 +
|-
 +
| '''02D''' "CONDICION DE PAGO" (Repetible)
 +
| NO
 +
|-
 +
| '''02E''' "DOCUMENTOS REFERENCIADOS" (Repetible)
 +
| C/C
 +
|-
 +
| '''02F''' "ENTREGA DE MERCANCIA (DELIVERY)"
 +
| NO
 +
|-
 +
| '''02F1''' "DATOS DEL TRANSPORTISTA"
 +
| NO
 +
|-
 +
| '''02F1A''' "DETALLES TRIBUTARIOS DEL TRANSPORTISTA" (Repetible)
 +
| NO
 +
|-
 +
| '''02F1B''' "DIRECCION RESPONSABLE DE ENTREGA"
 +
| NO
 +
|-
 +
| '''02F1B1''' "LOCALIZACION RESPONSABLE DE ENTREGA" (Repetible)
 +
| NO
 +
|-
 +
| '''02F1C''' "RESPONSABILIDADES RUT DEL TRANSPORTISTA"  (Repetible)
 +
| NO
 +
|-
 +
| '''02F1D''' "DIRECCION DEL TRANSPORTADOR"
 +
| NO
 +
|-
 +
| '''02F1D1''' "LOCALIZACION DEL TRANSPORTADOR" (Repetible)
 +
| NO
 +
|-
 +
| '''02F2''' "DIRECCION DE DESPACHO"
 +
| NO
 +
|-
 +
| '''02F2A''' "LOCALIZACION DE DESPACHO" (Repetible)
 +
| NO
 +
|-
 +
| '''02F3''' "DIRECCION DE ENTREGA"
 +
| NO
 +
|-
 +
| '''02F3A''' "LOCALIZACION DE ENTREGA" (Repetible)
 +
| NO
 +
|-
 +
| '''02G''' "IMPUESTOS GENERALES" (Repetible)
 +
| SI
 +
|-
 +
| '''02H''' "IMPUESTOS TOTALES" (Repetible)
 +
| SI
 +
|-
 +
| '''02I''' "INFORMACION ADICIONAL" (Repetible)
 +
| NO
 +
|-
 +
| '''02J''' "MEDIOS DE PAGO" (Repetible)
 +
| SI
 +
|-
 +
| '''02K''' "ORDEN DE COMPRA" (Repetible)
 +
| NO
 +
|-
 +
| '''02L''' "TASA DE CAMBIO"
 +
| C/C
 +
|-
 +
| '''02M''' "TASA DE CAMBIO ALTERNATIVA"
 +
| NO
 +
|-
 +
| '''02N''' "TERMINOS DE ENTREGA"
 +
| C/C
 +
|-
 +
| '''02N1''' "CARGOS Y DESCUENTOS TERM. DE ENTREGA" (Repetible)
 +
| NO
 +
|-
 +
| '''02N2''' "DIRECCION DE ENTREGA"
 +
| NO
 +
|-
 +
| '''02N2A''' "LOCALIZACION DE ENTREGA" (Repetible)
 +
| NO
 +
|-
 +
| '''03''' "CONCEPTOS O DETALLES DE PRODUCTOS" (Repetible)
 +
| SI
 +
|-
 +
| '''04''' "EXTRAS DEL DOCUMENTO" (Repetible)
 +
| NO
 +
|-
 +
| '''SSCG''' "CAMPOS DE DATOS ADICIONALES DEL SECTOR SALUD"
 +
| C/C
 +
|-
 +
| '''SSNenef''' "INFORMACIÓN DEL BENEFICIARIO DEL SERVICIO DE SALUD"
 +
| C/C
 +
|-
 +
| '''SSalud''' "CAMPOS GENERALES DE SECTOR SALUD"
 +
| C/C
 +
|-
 +
| '''SSextras''' "EXTRAS DEL SECTOR SALUD"
 +
| C/C
 +
|-
 +
| '''05''' "PARAMETRO DE ADJUNTOS" (0, 1, 10 U 11)
 +
| SI
 +
|-
 +
|}
 +
<br />
 +
 
 +
Los identificadores resaltados en color azul, corresponden a la información a ser reportada al momento de emitir un documento del '''Sector  Salud'''. Estos documentos <u><font color="red">sólo podrán ser emitidos a través de la Versión 4 del Servicio de Emisión.</font></u>
 +
<br />
 +
 
 +
===Datos generales del adquiriente -> (Identificador 01)===
 +
<br />
 +
Contiene 20 campos y 19 pipes (|):
 +
<center><pre>Identificador|nombreRazonSocial|tipoPersona|segundoNombre|apellido|numeroDocumento|tipoIdentificacion|email|telefono|
 +
notificar|actividadEconomicaCIIU|nombreComercial|nombreContacto|nota|numeroIdentificacionDV|telefax|
 +
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor</pre></center>
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|3</nowiki>
 +
|SI
 +
|
 +
: Identificador de línea. Valor fijo: “01”
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|nombreRazonSocial
 +
|<nowiki>AN|5..450</nowiki>
 +
|SI
 +
|
 +
: Nombre o Razón Social del adquirente
 +
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:RegistrationName 
 +
|-
 +
|3
 +
|tipoPersona
 +
|<nowiki>N|1</nowiki>
 +
|SI
 +
|
 +
: Identificador de tipo de persona
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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
 +
|-
 +
|4
 +
|segundoNombre
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Segundo nombre del adquiriente.
 +
: '''PATH''': No definido 
 +
|-
 +
|5
 +
|apellido
 +
|<nowiki>AN|…50</nowiki>
 +
|NO
 +
|
 +
: Apellido del adquiriente.
 +
: '''PATH''': No definido
 +
|-
 +
|6
 +
|numeroDocumento
 +
|<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
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
 +
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span> : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
 +
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
 +
|-
 +
|7
 +
|tipoIdentificacion
 +
|<nowiki>N|2</nowiki>
 +
|SI
 +
|
 +
: Tipo de Identificación del adquiriente
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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]]
 +
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span>: Para identificar al consumidor final se utiliza el código “13”
 +
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
 +
|-
 +
|8
 +
|email
 +
|<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
 +
|-
 +
|9
 +
|telefono
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Teléfono del adquiriente
 +
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
 +
|-
 +
|10
 +
|notificar
 +
|<nowiki>AN|2</nowiki>
 +
|SI
 +
|
 +
: Activa el envío de email al adquirente.
 +
: Valores posibles: “SI” o “NO”
 +
: '''PATH''': No aplica
 +
|-
 +
|11
 +
|actividadEconomicaCIIU
 +
|<nowiki>AN|…4</nowiki>
 +
|NO
 +
|
 +
: Corresponde al código de actividad económica CIIU
 +
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
 +
|-
 +
|12
 +
|nombreComercial
 +
|<nowiki>AN|…4</nowiki>
 +
|NO
 +
|
 +
: Nombre Comercial del adquiriente
 +
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
 +
: '''PATH''': /cac:Party/cac:PartyName
 +
|-
 +
|13
 +
|nombreContacto
 +
|<nowiki>AN|5..450</nowiki>
 +
|NO
 +
|
 +
: Nombre de Contacto
 +
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
 +
|-
 +
|14
 +
|nota
 +
|<nowiki>AN|..450</nowiki>
 +
|NO
 +
|
 +
: Nota adicional de contacto
 +
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
 +
|-
 +
|15
 +
|numeroIdentificacionDV
 +
|<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
 +
|-
 +
|16
 +
|telefax
 +
|<nowiki>N|..20</nowiki>
 +
|NO
 +
|
 +
: Telefax
 +
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
 +
|-
 +
|17
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|18
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si
 +
los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|19
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|-
 +
|19
 +
|Extensible1.valor
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Valor del campo a agregar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<br />
 +
===Destinatario -> (Identificador 01A)===
 +
<br />
 +
Contiene 11 campos y 10 pipes (|):
 +
<center><pre>Identificador|canalDeEntrega|email|fechaProgramada|mensajeProgramado|nitProveedorReceptor|telefono|
 +
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor</pre></center>
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|3</nowiki>
 +
|SI
 +
|
 +
: Identificador de línea(Repetible). Valor fijo: “01A”
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|canalDeEntrega
 +
| -
 +
|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
 +
|-
 +
|3
 +
|email
 +
|<nowiki>AN|..50</nowiki>
 +
|C/C
 +
|
 +
:Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico
 +
:Permite enviar múltiples destinatarios separados por el carácter coma (‘,’ máximo 5)
 +
: '''PATH''': No aplica
 +
|-
 +
|4
 +
|fechaProgramada
 +
|<nowiki>AN|19</nowiki>
 +
|NO
 +
|
 +
: Fecha programada
 +
: '''PATH''': No aplica 
 +
|-
 +
|5
 +
|mensajeProgramado
 +
| -
 +
|NO
 +
|
 +
: Mensaje
 +
: '''PATH''': No aplica
 +
|-
 +
|6
 +
|nitProveedorReceptor
 +
|<nowiki>N|..12</nowiki>
 +
|C/C
 +
|
 +
: NIT del Destinatario
 +
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
 +
: '''PATH''': No aplica
 +
|-
 +
|7
 +
|telefono
 +
|<nowiki>AN|..20</nowiki>
 +
|C/C
 +
|
 +
: Teléfono del Destinatario
 +
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
 +
: '''PATH''': No aplica
 +
|-
 +
|8
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|9
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|10
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|-
 +
|11
 +
|Extensible1.valor
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Valor del campo a agregar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<br />
 +
===Detalles Tributarios del Adquiriente -> (Identificador 01B)===
 +
<br />
 +
Contiene 6 campos y 5 pipes (|):
 +
<center><pre>Identificador|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor</pre></center>
 +
 
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|3</nowiki>
 +
|SI
 +
|
 +
: Identificador de línea (Repetible). Valor fijo: “01B”
 +
:'''Obligatorio''': Si adquiriente es responsable
 +
:<span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el adquirente es responsable, el NIT debe estar activo en el RUT
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|codigoImpuesto
 +
|<nowiki>AN|2</nowiki>
 +
|SI
 +
|
 +
: Identificador del tributo 
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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   
 +
|-
 +
|3
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|4
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|5
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|-
 +
|6
 +
|Extensible1.valor
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Valor del campo a agregar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<br />

Revisión del 15:34 28 dic 2021

Historial de Versiones


Versión Fecha lanzamiento Descripción
1.0 20/06/19 Versión Inicial 1.0
1.1 08/07/19 Actualización del Objeto
1.2 18/07/19 Modificación Línea 02K Orden de Compra
1.3 29/07/19 Cambio en Id Destinatario (obligatoriedad) y ajustes menores
1.4 04/2020 Actualizaciones en base al Anexo Técnico 1.8, extras, tablas de códigos, cambio del nombre del documento, entre otros.
1.5 05/2021 Actualizaciones en base al Anexo Técnico V1.8 de la Resolución 000012. Campos Sector Salud. Tablas de códigos.


Cómo obtener soporte


  • Soporte de 1er nivel:
Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
  • Soporte de 2do nivel:
Soporte resolución remota de incidencias en el sistema en horario 5x8
Escriba a soporte@thefactoryhka.com.co


Para consultas referente a configuraciones y errores en el Portal:
  • soporte_fel_co@thefactoryhka.com
Para consultas referente a configuraciones de ERP, casa de software e integración:
  • integracion_fel_co@thefactoryhka.com


Lineas de atención telefónica:

  • MASTER +57 (1) 746.08.12
  • +57 (1) 508.8990
  • +57 (1) 517.6795
  • +57 (1) 517.6796
  • +57 (1) 311.3063
    • Soporte Técnico → Opción 2
    • Integración → Opción 5 Luego Opción 1


Descripción General


En éste documento está orientado a la descripción del layout del archivo de texto plano (.txt), el cual es utilizado en los modelos de integración a través de algunas de las siguientes herramientas:

  • Conector Indirecto HKA AutoFact (Versión TXT)
  • API para integración directa IntTfhkaFel

Esquema de operación de la factura electrónica con validación previa


¿Qué es la Facturación Electrónica con Validación Previa?


La Facturación Electrónica (FEL) es un esquema de operación que permite emitir documentos de respaldo de las operaciones comerciales entre contribuyentes en formato digital en lugar de papel, permite la aplicación de control fiscal durante el proceso, y tiene validez legal para el ente tributario designado por el gobierno del país.

A partir de septiembre de 2019, se tiene previsto que una factura electrónica solo será válida cuando se haya validado previamente su contenido a través de la DIAN o a través de un proveedor autorizado por la administración de impuestos.

La validación previa se encuentra establecida en la ley 1943 de 2018, conocida como Ley de Financiamiento. El artículo 16 de esta Ley modifica el artículo 616-1 del Estatuto Tributario, en su parágrafo primero consagra que:

“Todas las facturas electrónicas para su reconocimiento tributario deberán ser validadas previo a su expedición, por la DIAN o por un proveedor autorizado por esta. La factura electrónica solo se entenderá expedida cuando sea validad y entregada al adquiriente. (…)”

En el modelo de facturación electrónica con validación previa se utilizarán 5 tipos de documentos:

  • Invoice (Factura)
  • CreditNote (Nota Crédito)
  • DebitNote (Nota Débito)
  • ApplicationResponse (Evento): Ocurrencia relacionada con un Documento Electrónico, generada por una persona o entidad relacionada con el documento (DIAN, Emisor, Adquiriente), este documento también contiene una firma electrónica.
  • AttachedDocument (Contenedor de Documentos): La estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha.


¿Quiénes participan en este esquema?


El Ente Tributario (DIAN): Es una institución pública, nombrada por el gobierno para recaudar, controlar y regular todo lo relacionado con los tributos. Es el que tiene el derecho de aceptar y autorizar un documento electrónico. En Colombia, es la DIAN (Dirección de Impuestos y Aduanas Nacionales).

El Emisor o Contribuyente: Es una persona natural o jurídica que posee un registro de información fiscal único y legal ante el ente tributario (NIT: Número de Identificación Tributario) y está bajo la obligación de emitir documentos para respaldar sus transacciones comerciales. El emisor adquiere el Sistema de Facturación o Software administrativo ERP para simplificar y potenciar sus labores y hace uso de él para interactuar con la plataforma de facturación electrónica.

El Proveedor Tecnológico: Es un ente privado autorizado por la DIAN para prestar servicios relacionados con el esquema de Facturación Electrónica: construcción del XML, control de secuenciales, firmado, control de cambio normativo, procesamiento, almacenamiento y consulta. The Factory HKA Colombia es su proveedor tecnológico.

El Adquiriente: Es la persona que da origen a una transacción comercial mediante la compra de un producto o servicio, y que finalmente, opta por recibir su documento electrónico vía email.

La Autoridad de Certificación: Es un ente público o privado habilitado por el Ente Tributario para expedir certificados electrónicos conforme a la ley y a las normas asociadas. En Colombia, hay varias autoridades acreditadas para expedir certificados electrónicos para facturación electrónica, entre ellas ANDES SCD.


Ventajas de la Facturación Electrónica


El esquema de Facturación Electrónica es ventajoso porque es:

  • Íntegro: Garantiza que la información contenida está protegida y no puede ser alterada.
  • Auténtico: Permite verificar la identidad del emisor del documento.
  • Legal: Este esquema está implementado y aceptado bajo el marco de la Ley.
  • Práctico: Elimina la infraestructura para el manejo, envío y almacenamiento de soportes físicos, y permite la impresión.
  • Eficiente: Se basa 100% en plataforma electrónica, lo cual hace que el manejo, envío, búsqueda y almacenamiento sea más rápido y práctico.


Proceso de la Facturación Electrónica con Validación Previa


  1. El Adquiriente da origen a una transacción mediante la compra de un producto o servicio.
  2. El Emisor o Contribuyente carga los datos mediante la UI (User Interface) de su ERP.
  3. El Emisor o Contribuyente visualiza los timbres disponibles en la UI de su ERP.
  4. El ERP construye el objeto y lo expone directamente a la plataforma DFACTURE mediante el método correspondiente del Web Service.
  5. La plataforma The Factory HKA – DFACTURE:
    • Valida las credenciales de acceso del Contribuyente.
    • Valida la estructura del objeto que envía el ERP.
    • Valida el contenido del objeto que envía el ERP.
    • Asigna el CUFE (Código único de Factura Electrónica) al documento.
    • Construye el XML del documento según normativa DIAN.
    • Firma el documento con el Certificado Digital del Contribuyente.
    • Opcional: Genera una representación impresa en PDF según normativa DIAN.
    • Almacena la información en Base de Datos (Conservación).
    • Envía el XML a la DIAN para validación.
    • Espera respuesta de la DIAN con resultado de la validación.
    • Envía el XML y PDF al email proporcionado por el Adquiriente.
    • Responde a la solicitud del ERP indicando que la operación fue satisfactoria.
  6. Opcionalmente, el ERP puede enviar el XML y PDF al adquiriente.
  7. Opcionalmente, el ERP puede descargar el XML y PDF para propósito interno.
  8. El Adquiriente recibe el XML y el PDF (vía email).
  9. El Adquiriente tiene hasta 72 horas para dar Acuse de Recibo del documento, después de lo cual se considerará una aceptación tácita (este proceso aún no está definido totalmente por la DIAN).
  10. El Emisor o Contribuyente visualiza el estatus del acuse de recibo del Adquiriente en la UI de su ERP.


Proceso de Facturación Electrónica con Validación Previa
Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)

@Importante: Para ambientes de desarrollo con limitaciones para consumir Web Services SOAP de manera directa, The Factory HKA Colombia pone a disposición API’s simplificando al integrador éste proceso.


Características del proceso con Validación Previa


  1. En una etapa inicial, por única vez, el emisor debe registrarse y la plataforma debe ser configurada directamente desde el portal The Factory HKA-Dfactura.
  2. La plataforma opera bajo un modelo comercial de timbres o folios. Los timbres corresponden a un paquete de operaciones que el contribuyente contrata bajo un acuerdo comercial con The Factory HKA Colombia, y le da derecho a un determinado número de transacciones. El ERP puede consultar al Web Service de THE FACTORY HKA – DFACTURE los timbres disponibles.
  3. Para que el documento sea considerado factura electrónica, se requiere validación de la DIAN para su posterior envío al Adquiriente por parte de Dfactura.
  4. En caso de que el documento no sea válido exitosamente ante la DIAN, éste deberá ser corregido y reexpedido.
  5. El ERP puede consumir el Web Service para descargar XML y PDF si desea un respaldo alterno u ofrecer funcionalidad de consulta offline.
  6. El ERP opcionalmente puede decidir si enviar el XML y PDF al Adquiriente bajo su estructura.
  7. El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del Acuse de Recibo por parte del Adquiriente. Éste se actualiza de forma asincrónica.
  8. El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del documento por parte de la DIAN. Éste se actualiza de forma asincrónica.
  9. El ERP refleja en su UI los resultados de sus consultas y operaciones con la plataforma. Sin embargo, el Emisor o Contribuyente puede hacer seguimiento o revisión a la vista de su ERP accediendo al portal The Factory HKA-Dfactura, ya que las operaciones realizadas en el Web Service se reflejan en el portal.
Diagrama de componentes y dependencias del sistema de facturación electrónica
DIAGRAMA COMPONENTES

La Figura anterior muestra la forma en la que el Software de Facturación (ERP) se integra y hace uso de las funcionalidades de facturación electrónica de la plataforma The Factory HKA – DFACTURE, interactuando con los elementos externos (el emisor, el Adquiriente y la DIAN) mediante las dependencias disponibles, pueden verse las funciones que cada sistema debe realizar.


Generación del archivo Plano (TXT)


Para construir el archivo plano (txt), se deben utilizar los campos declarados más adelante en las tablas de configuración en el orden especificado y separados por un pipe “|”. En caso de que los campos no tengan valor alguno deberá el contenido entre pipe estar vacíos (sin espacios en blanco como recomendación, Ejemplo: ||).

Los campos a incorporar en el archivo plano (txt) deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

Formato Descripcion
A Carácter alfabético
N Carácter numérico
AN Carácter alfanumérico
3 3 caracteres alfabéticos (longitud fija)
3 3 caracteres numéricos(longitud fija)
3 3 caracteres alfanuméricos (longitud fija)
..3 Hasta 3 caracteres alfabéticos(longitud variable)
..3 Hasta 3 caracteres numéricos(longitud variable)
..3 Hasta 3 caracteres alfanuméricos (longitud variable)
..8|5.2 Hasta 8 caracteres numéricos, conformados por (hasta) 5 enteros y dos decimales separados por punto
2..6 Entre 2 y 6 caracteres numéricos (longitud variable)
INT32 Entero.(Valor Máximo: 2,147,483,647)


Requerido Descripcion
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)


Estructura General del Archivo Plano (TXT)


En las siguientes tablas, se detalla el layout del archivo planto (txt) para el modelo de facturación electrónica con validación previa.

Descripción general del identificador Requerido
01 "DATOS GENERALES DEL ADQUIRIENTE" SI
01A "DESTINATARIO" (Repetible) SI
01B "DETALLES TRIBUTARIOS DEL ADQUIRIENTE" (Repetible) SI
01C "DIRECCION DEL ADQUIRIENTE" C/C
01C1 "LOCALIZACION DEL ADQUIRIENTE" (Repetible) NO
01D "DIRECCION FISCAL DEL ADQUIRIENTE" C/C
01D1 "LOCALIZACION FISCAL DEL ADQUIRIENTE" (Repetible) NO
01E "INFORMACION LEGAL DEL ADQUIRIENTE" C/C
01F "RESPONSABILIDADES RUT DEL ADQUIRIENTE" (Repetible) SI
02 "DATOS GENERALES DEL DOCUMENTO" SI
02A "ANTICIPOS" (Repetible) NO
02B "AUTORIZADO" NO
02B1 "DIRECCION DEL AUTORIZADO" NO
02B1A "LOCALIZACION DEL AUTORIZADO" (Repetible) NO
02C "CARGOS Y DESCUENTOS" (Repetible) NO
02D "CONDICION DE PAGO" (Repetible) NO
02E "DOCUMENTOS REFERENCIADOS" (Repetible) C/C
02F "ENTREGA DE MERCANCIA (DELIVERY)" NO
02F1 "DATOS DEL TRANSPORTISTA" NO
02F1A "DETALLES TRIBUTARIOS DEL TRANSPORTISTA" (Repetible) NO
02F1B "DIRECCION RESPONSABLE DE ENTREGA" NO
02F1B1 "LOCALIZACION RESPONSABLE DE ENTREGA" (Repetible) NO
02F1C "RESPONSABILIDADES RUT DEL TRANSPORTISTA" (Repetible) NO
02F1D "DIRECCION DEL TRANSPORTADOR" NO
02F1D1 "LOCALIZACION DEL TRANSPORTADOR" (Repetible) NO
02F2 "DIRECCION DE DESPACHO" NO
02F2A "LOCALIZACION DE DESPACHO" (Repetible) NO
02F3 "DIRECCION DE ENTREGA" NO
02F3A "LOCALIZACION DE ENTREGA" (Repetible) NO
02G "IMPUESTOS GENERALES" (Repetible) SI
02H "IMPUESTOS TOTALES" (Repetible) SI
02I "INFORMACION ADICIONAL" (Repetible) NO
02J "MEDIOS DE PAGO" (Repetible) SI
02K "ORDEN DE COMPRA" (Repetible) NO
02L "TASA DE CAMBIO" C/C
02M "TASA DE CAMBIO ALTERNATIVA" NO
02N "TERMINOS DE ENTREGA" C/C
02N1 "CARGOS Y DESCUENTOS TERM. DE ENTREGA" (Repetible) NO
02N2 "DIRECCION DE ENTREGA" NO
02N2A "LOCALIZACION DE ENTREGA" (Repetible) NO
03 "CONCEPTOS O DETALLES DE PRODUCTOS" (Repetible) SI
04 "EXTRAS DEL DOCUMENTO" (Repetible) NO
SSCG "CAMPOS DE DATOS ADICIONALES DEL SECTOR SALUD" C/C
SSNenef "INFORMACIÓN DEL BENEFICIARIO DEL SERVICIO DE SALUD" C/C
SSalud "CAMPOS GENERALES DE SECTOR SALUD" C/C
SSextras "EXTRAS DEL SECTOR SALUD" C/C
05 "PARAMETRO DE ADJUNTOS" (0, 1, 10 U 11) SI


Los identificadores resaltados en color azul, corresponden a la información a ser reportada al momento de emitir un documento del Sector Salud. Estos documentos sólo podrán ser emitidos a través de la Versión 4 del Servicio de Emisión.

Datos generales del adquiriente -> (Identificador 01)


Contiene 20 campos y 19 pipes (|): 

Identificador|nombreRazonSocial|tipoPersona|segundoNombre|apellido|numeroDocumento|tipoIdentificacion|email|telefono|
notificar|actividadEconomicaCIIU|nombreComercial|nombreContacto|nota|numeroIdentificacionDV|telefax|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “01”
PATH: No Aplica
2 nombreRazonSocial AN|5..450 SI
Nombre o Razón Social del adquirente
PATH: ../cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
3 tipoPersona N|1 SI
Identificador de tipo de persona
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 5
PATH: …/cbc:AdditionalAccountID
4 segundoNombre AN|..50 NO
Segundo nombre del adquiriente.
PATH: No definido
5 apellido AN|…50 NO
Apellido del adquiriente.
PATH: No definido
6 numeroDocumento AN|..12 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
7 tipoIdentificacion N|2 SI
Tipo de Identificación del adquiriente
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 3
Nota: Para identificar al consumidor final se utiliza el código “13”
PATH: ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
8 email AN|..50 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
9 telefono AN|..20 NO
Teléfono del adquiriente
PATH: …/cac:Party/cac:Contact/cbc:Telephone
10 notificar AN|2 SI
Activa el envío de email al adquirente.
Valores posibles: “SI” o “NO”
PATH: No aplica
11 actividadEconomicaCIIU AN|…4 NO
Corresponde al código de actividad económica CIIU
PATH: .. /cac:Party/cbc:IndustryClassificationCode
12 nombreComercial AN|…4 NO
Nombre Comercial del adquiriente
Obligatorio Si en la Rep. Gráfica se mostrará el nombre comercial
PATH: /cac:Party/cac:PartyName
13 nombreContacto AN|5..450 NO
Nombre de Contacto
PATH: ../cac:Party/cac:Contact/cbc:Name
14 nota AN|..450 NO
Nota adicional de contacto
PATH: ../cac:Party/cac:Contact/cbc:Note
15 numeroIdentificacionDV AN|..2 C/C
Digito de verificación NIT del adquiriente
Obligatorio: Si tipoIndentificacion = 31, debe ser informado
PATH:
../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
16 telefax N|..20 NO
Telefax
PATH: ../cac:Party/cac:Contact/cbc:Telefax
17 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
18 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
19 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
19 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Destinatario -> (Identificador 01A)


Contiene 11 campos y 10 pipes (|): 

Identificador|canalDeEntrega|email|fechaProgramada|mensajeProgramado|nitProveedorReceptor|telefono|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea(Repetible). Valor fijo: “01A”
PATH: No Aplica
2 canalDeEntrega - 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
3 email AN|..50 C/C
Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico
Permite enviar múltiples destinatarios separados por el carácter coma (‘,’ máximo 5)
PATH: No aplica
4 fechaProgramada AN|19 NO
Fecha programada
PATH: No aplica
5 mensajeProgramado - NO
Mensaje
PATH: No aplica
6 nitProveedorReceptor N|..12 C/C
NIT del Destinatario
Obligatorio Cuando canalDeEntrega=’1’ ó ‘2’
PATH: No aplica
7 telefono AN|..20 C/C
Teléfono del Destinatario
Obligatorio Cuando canalDeEntrega=’3’ ó ‘4’
PATH: No aplica
8 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
9 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
10 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
11 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Detalles Tributarios del Adquiriente -> (Identificador 01B)


Contiene 6 campos y 5 pipes (|): 

Identificador|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “01B”
Obligatorio: Si adquiriente es responsable
Notificación Si el adquirente es responsable, el NIT debe estar activo en el RUT
PATH: No Aplica
2 codigoImpuesto AN|2 SI
Identificador del tributo
Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la Tabla 11
PATH: ../cbc:ID
3 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
4 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
5 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
6 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Obtenido de «http://felcowiki.thefactoryhka.com.co/index.php?title=Manual_de_usuario_LAYOUT_ARCHIVO_PLANO&oldid=2271»