Diferencia entre revisiones de «Sección para clientes de Integración»
Sin resumen de edición |
Se actualizó la parte inicial de la pagina de seccion de integración para cliente donde se agregó qué hacemos, cómo contactarnos (correo, teléfonos, whatsapp, sesiones grupales) y principales métodos o APIS por producto (Factura, nómina, rece |
||
| (No se muestran 13 ediciones intermedias de 8 usuarios) | |||
| Línea 1: | Línea 1: | ||
{| style="width:100%; border:1px solid #d0d7e1; border-radius:10px; background-color:#ffffff; box-shadow:0 1px 3px rgba(0,0,0,0.08);" | |||
Bienvenido a | |- | ||
| style="vertical-align:top; padding:20px;" | | |||
<div style="font-size:1.9em; font-weight:bold; color:#003366;"> | |||
Integración – The Factory HKA Colombia | |||
</div> | |||
<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;"> | |||
Bienvenido a <b>Integración</b> de <b>The Factory HKA Colombia</b>, el espacio diseñado para brindar una experiencia técnica clara, eficiente y centralizada para nuestros clientes y aliados. | |||
<br><br> | <br><br> | ||
Aquí encontrará la documentación completa para la integración de los servicios de <b>Factura Electrónica</b>, <b>Nómina Electrónica</b>, <b>Recepción Electrónica</b> y <b>Documentos Equivalentes</b>, incluyendo manuales, APIs, herramientas y recomendaciones para el cumplimiento de las resoluciones DIAN vigentes. | |||
</div> | |||
<div style="background:linear-gradient(90deg, #0073e6 0%, #0099ff 100%); color:#fff; padding:12px 18px; border-radius:6px; font-weight:bold; font-size:1.05em;"> | |||
Acceso rápido:</span> Consulte las secciones de pasos de integración, canales de comunicación y ejemplos de APIs según su tipo de documento electrónico. | |||
</div> | |||
| style="width:140px; text-align:center; vertical-align:middle; background-color:#f7f9fc; border-left:1px solid #e0e6ef; padding:15px;" | | |||
[[Archivo:Tfhka-co.png|140px|center|sinmarco]] | |||
|} | |||
{| style="width:100%; border:none; background-color:#ffffff; padding:2px;" | |||
|- | |||
| style="vertical-align:top; padding:18px 5px;" | | |||
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-bottom:8px;"> | |||
¿Qué hacemos? | |||
</div> | |||
<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;"> | |||
En <b>The Factory HKA Colombia</b> ofrecemos soluciones tecnológicas que optimizan la <b>emisión, recepción y gestión de documentos electrónicos</b> requeridos por la DIAN. | |||
Nuestros servicios web (APIs) están orientados a empresas, desarrolladores y casas de software que buscan integraciones seguras, escalables y de alta disponibilidad. | |||
</div> | |||
<div style="background-color:#f4f9fc; border-left:6px solid #0073e6; border-radius:4px; padding:12px; color:#003366; font-size:1.05em; margin-bottom:15px;"> | |||
<b>Servicios principales:</b><br> | |||
• Facturación Electrónica con validación previa ante la DIAN.<br> | |||
• Nómina Electrónica con soporte para documentos individuales y masivos.<br> | |||
• Recepción de Documentos Electrónicos con trazabilidad y respuesta.<br> | |||
• Emisión de Documentos Equivalentes conforme a la Resolución 000165 del 2023. | |||
</div> | |||
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;"> | |||
¿Cómo contactarnos? | |||
</div> | |||
<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;"> | |||
Si necesita soporte técnico o acompañamiento durante su proceso de integración, puede comunicarse a través de los siguientes canales: | |||
</div> | |||
<table style="width:100%; border-collapse:collapse; font-size:1.02em; color:#333;"> | |||
<tr style="background-color:#eef4fb; text-align:left;"> | |||
<th style="padding:8px; border:1px solid #cfd7e0; width:25%;">Canal</th> | |||
<th style="padding:8px; border:1px solid #cfd7e0;">Información de contacto</th> | |||
</tr> | |||
<tr> | |||
<td style="padding:8px; border:1px solid #cfd7e0;"> | |||
[[File:icono-correo-electronico.png|20px]] <b>Correo electrónico</b> | |||
</td> | |||
<td style="padding:8px; border:1px solid #cfd7e0;">integracion_fel_co@thefactoryhka.com</td> | |||
</tr> | |||
<tr style="background-color:#f8fafd;"> | |||
<td style="padding:8px; border:1px solid #cfd7e0;"> | |||
[[File:icono-telefono.png|20px]] <b>Teléfonos</b> | |||
</td> | |||
<td style="padding:8px; border:1px solid #cfd7e0;">Opción 5, luego Opción 1 <br> | |||
+57 317 668 7663 | +57 (601) 390 95 39 </td> | |||
</tr> | |||
<tr> | |||
<td style="padding:8px; border:1px solid #cfd7e0;"> | |||
[[File:icono-whatsapp.png|20px]] <b>WhatsApp</b> | |||
</td> | |||
<td style="padding:8px; border:1px solid #cfd7e0;">Escríbanos al canal de soporte técnico https://wa.me/573163192251</td> | |||
</tr> | |||
<tr style="background-color:#f8fafd;"> | |||
<td style="padding:8px; border:1px solid #cfd7e0;"> | |||
[[File:icono-sesiones-grupales.png|20px]] <b>Sesiones grupales de integración</b> | |||
</td> | |||
<td style="padding:8px; border:1px solid #cfd7e0;">Martes y jueves de 08:30 a.m. a 10:00 a.m. (hora Colombia).<br>https://meet.google.com/fzo-xmyc-duk</td> | |||
</tr> | |||
</table> | |||
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;"> | |||
Principales métodos o APIs por producto | |||
</div> | |||
<div style="font-size:1.02em; color:#444; line-height:1.6; margin-bottom:10px;"> | |||
La siguiente tabla presenta los métodos principales de integración por producto. | |||
Cada servicio dispone de endpoints para <b>emisión, validación, consulta, descarga y gestión</b> de documentos conforme a los estándares DIAN. | |||
</div> | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Factura Electrónica - SOAP | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | FEL | |||
| SOAP | |||
| | |||
'''FacturaElectronica - Enviar'''<br/> | |||
<small>Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, garantizando el cumplimiento normativo mediante la verificación integral de todos los requisitos técnicos y legales exigidos por la autoridad tributaria colombiana.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL | |||
| SOAP | |||
| | |||
'''FacturaElectronica - EstadoDocumento'''<br/> | |||
<small>Consulta del estado de tramitación de documentos ante la DIAN, proporcionando información en tiempo real sobre la validación y aceptación definitiva.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | FEL | |||
| SOAP | |||
| | |||
'''FacturaElectronica - DescargaPDF'''<br/> | |||
<small>Generación automática de la representación gráfica en PDF según especificaciones DIAN, lista para distribución comercial conforme a los estándares requeridos.</small> | |||
| GET | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL | |||
| SOAP | |||
| | |||
'''FacturaElectronica - EnvioCorreo'''<br/> | |||
<small>Envío automatizado de facturas electrónicas a los destinatarios con PDF y XML técnico, asegurando entrega completa y trazable.</small> | |||
| POST | |||
|} | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Factura Electrónica - REST | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | FEL | |||
| REST | |||
| | |||
'''Api/documentos/enviar'''<br/> | |||
<small>Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, con verificación completa de los requisitos técnicos y legales.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL | |||
| REST | |||
| | |||
'''Api/documentos/EstadoDocumento'''<br/> | |||
<small>Consulta en tiempo real del estado del documento y validación ante la DIAN, mostrando incidencias o aceptación definitiva.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | FEL | |||
| REST | |||
| | |||
'''Api/documentos/DescargaPDF'''<br/> | |||
<small>Generación automática del PDF representativo del documento, conforme a los estándares de presentación exigidos.</small> | |||
| GET | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL | |||
| REST | |||
| | |||
'''FacturaElectronica - EnvioCorreo'''<br/> | |||
<small>Distribución electrónica automatizada de facturas a clientes, incluyendo PDF y XML técnico.</small> | |||
| POST | |||
|} | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Nómina Electrónica - SOAP | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| SOAP | |||
| | |||
'''NominaElectronica - Enviar'''<br/> | |||
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| SOAP | |||
| | |||
'''NominaElectronica - ConsultarDocumento'''<br/> | |||
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| SOAP | |||
| | |||
'''NominaElectronica - EnviarCorreo'''<br/> | |||
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small> | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| SOAP | |||
| | |||
'''NominaElectronica - ConsultarFolios'''<br/> | |||
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small> | |||
| GET | |||
|} | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Nómina Electrónica - REST | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| REST | |||
| | |||
'''Api/documentos/Enviar'''<br/> | |||
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| REST | |||
| | |||
'''Api/documentos/ConsultarDocumento'''<br/> | |||
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| REST | |||
| | |||
'''Api/documentos/EnviarCorreo'''<br/> | |||
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small> | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina | |||
| REST | |||
| | |||
'''Api/documentos/ConsultarFolios'''<br/> | |||
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small> | |||
| GET | |||
|} | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Recepción Electrónica | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion | |||
| SOAP | |||
| | |||
'''Recepcion - ReporteStatus'''<br/> | |||
<small>Procesa documentos recibidos de proveedores, validando autenticidad e integridad para integración contable.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion | |||
| SOAP | |||
| | |||
'''Recepcion - EstadoDocumento'''<br/> | |||
<small>Consulta del estado y trazabilidad de documentos recibidos ante la DIAN.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion | |||
| SOAP | |||
| | |||
'''Recepcion - Respuesta'''<br/> | |||
<small>Gestión formal de aceptación o rechazo de documentos recibidos, registrando eventos ante la DIAN.</small> | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion | |||
| SOAP | |||
| | |||
'''Recepcion - RepresentacionGrafica'''<br/> | |||
<small>Descarga y generación de PDFs de documentos recibidos conforme a los estándares DIAN.</small> | |||
| GET | |||
|} | |||
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;"> | |||
Documentos Equivalentes | |||
</div> | |||
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;" | |||
|- | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción | |||
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente | |||
| REST | |||
| | |||
'''Equivalente - EnviarRequest'''<br/> | |||
<small>Envío de documentos equivalentes electrónicos a la DIAN, cumpliendo con las validaciones oficiales.</small><br/> | |||
'''Entornos:''' Demo / Producción | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente | |||
| REST | |||
| | |||
'''Equivalente - GenerarContenedor'''<br/> | |||
<small>Genera contenedores de información estructurados según los requisitos técnicos de la DIAN.</small> | |||
| GET | |||
|- | |||
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente | |||
| REST | |||
| | |||
'''Equivalente - DescargaPDF'''<br/> | |||
<small>Generación de representaciones gráficas PDF para documentos equivalentes conforme a la normativa vigente.</small> | |||
| POST | |||
|- | |||
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente | |||
| REST | |||
| | |||
'''Equivalente - EstadoDocumento'''<br/> | |||
<small>Consulta del estado de validación y trazabilidad de documentos equivalentes ante la DIAN.</small> | |||
| POST | |||
|} | |||
|} | |||
<br> | <br> | ||
[[File:HKAFactura 3.png|200px]] | [[File:HKAFactura 3.png|200px]] | ||
| Línea 15: | Línea 345: | ||
<!-- ** [[Direct Integration Manual Index - Electronic Bill]]--> | <!-- ** [[Direct Integration Manual Index - Electronic Bill]]--> | ||
* [[Direct Integration Manual Index - Electronic Invoice]] | * [[Direct Integration Manual Index - Electronic Invoice]] | ||
* [[Facturación Electrónica bajo Resoluciones DIAN]] | * <u>'''[[Facturación Electrónica bajo Resoluciones DIAN]]'''</u> | ||
* [[Herramientas Alternativas de Integración Facturación]] | |||
* <u>'''[[Servicio Gestión Contribuyentes]]'''</u> | * <u>'''[[Servicio Gestión Contribuyentes]]'''</u> | ||
* [[Representaciones Gráficas en el proceso de Emisión]] | * [[Representaciones Gráficas en el proceso de Emisión]] | ||
| Línea 44: | Línea 374: | ||
* [[Tips Urls de Recepción Integración]] | * [[Tips Urls de Recepción Integración]] | ||
<br> | |||
[[File:HKAEquivalente1.png|260px]] | |||
<br> | |||
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]] | |||
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]] | |||
* [[Preguntas Frecuentes de Integración Documento Equivalente Electrónico]] | |||
* [[Tips Urls de documento equivalente Integración]] | |||
<br> | |||
<br> | |||
<br> | <br> | ||
<br> | <br> | ||
[[File:ArticulosInteresIntegracion.png|260px]] | |||
<br> | <br> | ||
* [[HKA TIPS]] | * [[HKA TIPS]] | ||
* [[Consideraciones Url Versión 4]] | * [[Consideraciones Url Versión 4]] | ||
| Línea 61: | Línea 397: | ||
* [[Recomendaciones en la implementación de la factura electronica]] | * [[Recomendaciones en la implementación de la factura electronica]] | ||
* [[Politicas de seguridad de la información para aliados de The Factory HKA]] | * [[Politicas de seguridad de la información para aliados de The Factory HKA]] | ||
* [[Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web]] | |||
<br> | <br> | ||
Revisión actual - 22:03 18 nov 2025
|
¿Qué hacemos? En The Factory HKA Colombia ofrecemos soluciones tecnológicas que optimizan la emisión, recepción y gestión de documentos electrónicos requeridos por la DIAN. Nuestros servicios web (APIs) están orientados a empresas, desarrolladores y casas de software que buscan integraciones seguras, escalables y de alta disponibilidad. Servicios principales: ¿Cómo contactarnos? Si necesita soporte técnico o acompañamiento durante su proceso de integración, puede comunicarse a través de los siguientes canales:
Principales métodos o APIs por producto La siguiente tabla presenta los métodos principales de integración por producto. Cada servicio dispone de endpoints para emisión, validación, consulta, descarga y gestión de documentos conforme a los estándares DIAN. Factura Electrónica - SOAP
Factura Electrónica - REST
Nómina Electrónica - SOAP
Nómina Electrónica - REST
Recepción Electrónica
Documentos Equivalentes
|
- Í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
- Í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
- Í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
- Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos
- Requisitos minimos de las Representaciones grafica para documento equivalente
- Preguntas Frecuentes de Integración Documento Equivalente Electrónico
- Tips Urls de documento equivalente Integración
- 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
- Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web

Copyright © 2016 The Factory HKA. Todos los derechos reservados.
