Manual de usuario LAYOUT ARCHIVO PLANO - Indice Manual Integración Directa

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda

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_-_Indice_Manual_Integración_Directa&oldid=3915»