Diferencia entre revisiones de «Sección para clientes de Integració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 19 ediciones intermedias de 9 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 13: | Línea 343: | ||
* [[Índice del Manual de Integración Directa]] | * [[Índice del Manual de Integración Directa]] | ||
* [[Direct Integration Manual Index - Electronic Bill]] | <!-- ** [[Direct Integration Manual Index - Electronic Bill]]--> | ||
* [[ | * [[Direct Integration Manual Index - Electronic Invoice]] | ||
* <u>'''[[ | * <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 43: | 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> | ||
[[File:ArticulosInteresIntegracion.png|260px]] | |||
<br> | |||
* [[HKA TIPS]] | * [[HKA TIPS]] | ||
* [[Consideraciones Url Versión 4]] | * [[Consideraciones Url Versión 4]] | ||
| Línea 54: | 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.
