Generalidades - Índice Manual Integración Recepción Electrónica

Historial de versiones

Versión	Fecha lanzamiento	Descripción
0	12/01/22	versión inicial

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

Para Sesiones:

Sesiones Soporte

Manejo de métodos en soap. Dirigido a: Agencias Comerciales – Casas de Software Aliadas - Clientes Finales

Horario: Martes y Jueves a partir de las 8:30 AM

Enlace Sesiones de Soporte

Sesiones Área Integración

Solución Casos de Integración

Dirigido a: Clientes que realicen desarrollos de Software para integrarse con TFHKA, Casas de Software Aliadas

Horario: Martes y Jueves a partir de las 8:30 AM

Enlace Sesiones Integración

Descripción general

En el presente documento se describe el proceso de integración entre el modelo de recepción electrónica de acuerdo a las actualizaciones normativas y técnicas proveniente de la DIAN y/o controles propios en nuestro modelo de integración.

Para el desarrollo de éste documento, se tomó como referencia los Anexos técnicos V1.8 (vigente) (liberado en octubre de 2019 por la DIAN).

Nota: No todas las funcionalidades, catalogos y escenarios de recepción referentes al Anexo Técnico V1.8 están habilitados por la DIAN.

¿Qué es The Factory HKA-RECEPCIÓN?

Es una plataforma de recepción electrónica, diseñada para dar cumplimiento a la legislación vigente en Colombia y ofrecer valores agregados mediante servicios complementarios.

¿Qué es Dintegración?

Es un producto dirigido al integrador y está conformado por los siguientes componentes:

• Manuales de integración.
• Bolsa de horas de soporte vía email y/o tele-conferencias.
• Credenciales para ambiente de pruebas (DEMO) y productivo.

Funcionalidades

La plataforma The Factory HKA-DRECEPCIÓN permite recepción, consulta, visualización y descarga de los siguientes documentos en formato XML. Adicionalmente, la plataforma permite consultar el estatus del Acuse de Recibo por parte del adquirente, estatus del documento por parte de la DIAN.

La integración directa

La integración es una actividad esencial para la puesta en marcha de la recepción electrónica en un Sistema de Facturación o Software Administrativo (ERP) y se realizará sólo una vez. Esta actividad consiste en enlazar dos plataformas con tecnologías distintas con el objetivo de transmitir los datos necesarios para la construcción de los documentos y el seguimiento exitoso del ciclo de vida.

En el caso de la integración directa, la comunicación se conecta directamente al Web Service, lo cual tiene como ventaja el control total del ciclo de vida del documento electrónico, desde el origen de los datos, pasando por el proceso de transmisión hasta su entrega, acuse de recibo y validación. Esta forma de integración permite reaccionar de un modo más rápido y eficiente ante errores o inconsistencias que se presenten en el proceso.

La integración directa es un proceso exclusivo entre el software integrado y la plataforma The Factory HKA-DFACTURE.

@Importante: No es necesario implementar integración adicional ante la DIAN, ya que se cuenta con la funcionalidad completa de seguimiento del estatus del documento.

Esquema de integración directa para Factura Electrónica SOAP URL

Contamos con un web service SOAP para pruebas en el cual se hacen validaciones iniciales frent ala DIAN, esto permite que puedan ir validando la estructura del objeto Factura y origen de datos propuesto por TFHKA.

URL Ambiente DEMO (ambiente de pruebas en el cual las emisiones no son transmitidas a la DIAN):

[http://demorecepcion21.thefactoryhka.com.co/ReceptorWS.svc?wsdl ] --> Servicio Expuesto

URL Ambiente Productivo (ambiente en el cual se realizan las emisiones correspondientes al set de habilitación y posteriormente la emisión de documentos en operación):

[https://recepcion21.thefactoryhka.com.co/ReceptorWS.svc?wsdl ] --> Servicio Emisión (HTTP)

@IMPORTANTE:La url del servicio SOAP en producción solo esta funcional bajo el protocolo https.

NOTA: Si no pueden acceder a dicha configuración en el interfaz del sistema, por favor, comunicarse con su casa de software o desarrollador del ERP con el fin de que puedan validar lo anteriormente descrito. De no solventarse el inconveniente con lo mencionado, por favor, enviar un correo al área de integración integracion_fel_co@thefactoryhka.com con la siguiente información:

• Request enviado al WS.
• Captura de la configuración realizada en el sistema donde se visualice la información de las URL y tokens indicada.