Diferencia entre revisiones de «Sección para clientes de Integración»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Fpinto (discusión | contribs.)
Sin resumen de edición
Amurillo (discusión | contribs.)
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 102 ediciones intermedias de 15 usuarios)
Línea 1: Línea 1:
[[Category:Manuales]]
{| style="width:100%; border:1px solid #d0d7e1; border-radius:10px; background-color:#ffffff; box-shadow:0 1px 3px rgba(0,0,0,0.08);"
__NOTOC__
|-
<includeonly>=</includeonly>==[[Manual de Integración Directa - Sección para clientes de Integración|1 Manual de Integración Directa]]==<includeonly>=</includeonly>
| style="vertical-align:top; padding:20px;" |
# [[Manual de Integración Directa - Sección para clientes de Integración#Historial|Historial de versiones]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Cómo obtener soporte|Cómo obtener soporte]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Descripción general|Descripción general]]
## [[Manual de Integración Directa - Sección para clientes de Integración#¿Qué es The Factory HKA-DFACTURE?|¿Qué es The Factory HKA-DFACTURE?]]
## [[Manual de Integración Directa - Sección para clientes de Integración#¿Qué es The Factory HKA-Dfactura?|¿Qué es The Factory HKA-Dfactura?]]
## [[Manual de Integración Directa - Sección para clientes de Integración#¿Qué es Dintegración?|¿Qué es Dintegración?]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Funcionalidades|Funcionalidades]]
## [[Manual de Integración Directa - Sección para clientes de Integración#La integración directa|La integración directa]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
# [[Manual de Integración Directa - Sección para clientes de Integración#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 Integración Directa - Sección para clientes de Integración#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Manual de Integración Directa - Sección para clientes de Integración#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Web services soap con validación previa|Web services soap con validación previa]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Método Servicio Emisión Web Soap|Métodos Servicio Emisión Web Soap]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método Enviar|Método Enviar]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.FacturaGeneral|Class.FacturaGeneral]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Anticipos|Class.Anticipos]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Autorizado|Class.Autorizado]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.CargosDescuentos|Class.CargosDescuentos]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Cliente|Class.Cliente]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.CondicionPago|Class.CondicionPago]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.FacturaDetalle|Class.FacturaDetalle]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Destinatario|Class.Destinatario]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Entrega|Class.Entrega]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Extras|Class.Extras]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Extensible|Class.Extensible]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.FacturaImpuestos|Class.FacturaImpuestos]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.ImpuestosTotales|Class.ImpuestosTotales]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.MediosDePago|Class.MediosDePago]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.OrdenDeCompra|Class.OrdenDeCompra]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.TasaDeCambio|Class.TasaDeCambio]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.TerminosEntrega|Class.TerminosEntrega]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Direccion|Class.Direccion]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Coordenadas|Class.Coordenadas]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Tributos|Class.Tributos]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.Obligaciones|Class.Obligaciones]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.DatosTransportistas|Class.DatosTransportistas]]
### [[Manual de Integración Directa - Sección para clientes de Integración#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método EstadoDocumento|Método EstadoDocumento]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método EnvioCorreo|Método EnvioCorreo]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método DescargaPDF|Método DescargaPDF]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método DescargaXML|Método DescargaXML]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método FoliosRestantes|Método FoliosRestantes]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método CargarCertificado|Método CargarCertificado]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método DescargarEventoXML|Método DescargarEventoXML]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método GenerarContenedor|Método GenerarContenedor]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método GenerarEvento|Método GenerarEvento]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Métodos servicio adjuntos web soap|Métodos servicio adjuntos web soap]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Métodos servicio reportes web soap|Métodos servicio reportes web soap]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método “DescargarReporte”|Método “DescargarReporte”]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método “ProgramarReporte”|Método “ProgramarReporte”]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Uso de campos extras|Uso de campos extras]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Generacion de notas con y sin referencia a documento|Generacion de notas con y sin referencia a documento]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Notas de crédito y débito que afecten a facturas emitidas en validación posterior|Notas de crédito y débito que afecten a facturas emitidas en validación posterior]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Transmisión de documentos de contingencia tipo 03 (atribuible al emisor)|Transmisión de documentos de contingencia tipo 03 (atribuible al emisor)]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Radicar documentos eletrónicos en plataformas de recepción|Radicar documentos eletrónicos en plataformas de recepción]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Ambiente de habilitación|Ambiente de habilitación]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Tablas de códigos de propiedades para emisión de documentos|Tablas de códigos de propiedades para emisión de documentos]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 1|Tabla 1]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 2|Tabla 2]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 3|Tabla 3]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 4|Tabla 4]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 5|Tabla 5]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 6|Tabla 6]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 7|Tabla 7]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 8|Tabla 8]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 9|Tabla 9]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 10|Tabla 10]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 11|Tabla 11]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 12|Tabla 12]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 13|Tabla 13]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 14|Tabla 14]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 15|Tabla 15]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 16|Tabla 16]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 17|Tabla 17]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 18|Tabla 18]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 19|Tabla 19]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 20|Tabla 20]]
## [[Manual de Integración Directa - Sección para clientes de Integración#Tabla 21|Tabla 21]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Catálogo de errores de respuesta del servicio web|Catálogo de errores de respuesta del servicio web]]
# [[Manual de Integración Directa - Sección para clientes de Integración#Preguntas Frecuentes|Preguntas Frecuentes]]
{{clear}}


<includeonly>=</includeonly>==[[Manual de Integración Indirecta - Sección para clientes de Integración|2 Manual de Integración Indirecta]]==<includeonly>=</includeonly>
<div style="font-size:1.9em; font-weight:bold; color:#003366;">
# [[Manual de Integración Indirecta - Sección para clientes de Integración#Primer Punto|Primer Punto]]
Integración – The Factory HKA Colombia
# [[Manual de Integración Indirecta - Sección para clientes de Integración#Segundo Punto|Segundo Punto]]
</div>
# [[Manual de Integración Indirecta - Sección para clientes de Integración#Preguntas Frecuentes|Preguntas Frecuentes]]
{{clear}}


<includeonly>=</includeonly>==[[Inicio - Portal DRecepción Validación Previa|3 Inicio]]==<includeonly>=</includeonly>
<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
# [[Inicio - Portal DRecepción Validación Previa#Cambiar funcionalidad (Emisión/Recepción) desde la sesión del usuario Emisor.|Cambiar funcionalidad (Emisión/Recepción) desde la sesión del usuario Emisor.]]
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.
# [[Inicio - Portal DRecepción Validación Previa#Estructura de la interfaz de usuario Receptor|Estructura de la interfaz de usuario Receptor]]
<br><br>
{{clear}}
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>


<includeonly>=</includeonly>==[[Configuración por Catálogos - Portal DRecepción Validación Previa|4 Configuración por Catálogos]]==<includeonly>=</includeonly>
<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;">
# [[Configuración por Catálogos - Portal DRecepción Validación Previa#Registrar Proveedores|Registrar Proveedores]]
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.
# [[Configuración por Catálogos - Portal DRecepción Validación Previa#Registrar estatus|Registrar estatus]]
</div>
# [[Configuración por Catálogos - Portal DRecepción Validación Previa#Asociación de metadatos|Asociación de metadatos]]
{{clear}}


<includeonly>=</includeonly>==[[Comprobantes electrónicos - Portal DRecepción Validación Previa|5 Comprobantes electrónicos]]==<includeonly>=</includeonly>
# [[Comprobantes electrónicos - Portal DRecepción Validación Previa#Carga de comprobantes electrónicos Usuario Receptor (UR)|Carga de comprobantes electrónicos Usuario Receptor (UR)]]
# [[Comprobantes electrónicos_-_Portal_DRecepción_Validación_Previa#Comprobantes cargados|Comprobantes cargados]]
# [[Comprobantes electrónicos_-_Portal_DRecepción_Validación_Previa#Gestión de Comprobantes|Gestión de Comprobantes]]
{{clear}}


<includeonly>=</includeonly>==[[Configuración - Portal DRecepción Validación Previa|6 Configuración]]==<includeonly>=</includeonly>
| style="width:140px; text-align:center; vertical-align:middle; background-color:#f7f9fc; border-left:1px solid #e0e6ef; padding:15px;" |
# [[Configuración - Portal DRecepción Validación Previa#Configuraciones de Anexo|Configuraciones de Anexo]]
[[Archivo:Tfhka-co.png|140px|center|sinmarco]]
# [[Configuración - Portal DRecepción Validación Previa#Vincular proveedores y Metadatos|Vincular proveedores y Metadatos]]
|}
# [[Configuración - Portal DRecepción Validación Previa#Registrar Usuarios (Interno receptor)|Registrar Usuarios (Interno receptor)]]
{{clear}}


<includeonly>=</includeonly>==[[Usuario Proveedor (UP) - Portal DRecepción Validación Previa|7 Usuario Proveedor (UP)]]==<includeonly>=</includeonly>
{| style="width:100%; border:none; background-color:#ffffff; padding:2px;"
# [[Usuario Proveedor (UP) - Portal DRecepción Validación Previa#Usuario Proveedor (UP)|Usuario Proveedor (UP)]]
|-
# [[Usuario Proveedor (UP) - Portal DRecepción Validación Previa#Ingreso al Sistema para Usuario Proveedor (UP)|Ingreso al Sistema para Usuario Proveedor (UP)]]
| style="vertical-align:top; padding:18px 5px;" |
# [[Usuario Proveedor (UP) - Portal DRecepción Validación Previa#Carga de comprobantes electrónicos Usuario Proveedor (UP)|Carga de comprobantes electrónicos Usuario Proveedor (UP)]]
# [[Usuario Proveedor (UP) - Portal DRecepción Validación Previa#Comprobantes cargados (UP)|Comprobantes cargados (UP)]]
{{clear}}


<includeonly>=</includeonly>==[[Configuración (UP) - Portal DRecepción Validación Previa|8 Configuración (UP)]]==<includeonly>=</includeonly>
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-bottom:8px;">
# [[Configuración - Portal DRecepción Validación Previa#Configuraciones usuario proveedor (UP)|Configuraciones usuario proveedor (UP)]]
¿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>
[[File:HKAFactura 3.png|200px]]
<br>
 
* [[Índice del Manual de Integración Directa]]
<!-- ** [[Direct Integration Manual Index - Electronic Bill]]-->
* [[Direct Integration Manual Index - Electronic Invoice]]
* <u>'''[[Facturación Electrónica bajo Resoluciones DIAN]]'''</u>
* [[Herramientas Alternativas de Integración Facturación]]
* <u>'''[[Servicio Gestión Contribuyentes]]'''</u>
* [[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]]
 
<br>
[[File:HKANomina 3.png|200px]]
<br>
 
* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* <u>'''[[Herramientas Alternativas de Integración Nómina]]'''</u>
* [[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]]
 
<br>
[[File:HKARecepcion 3.png|260px]]
<br>
 
* [[Í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]]
 
 
<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>
[[File:ArticulosInteresIntegracion.png|260px]]
<br>
* [[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]]
<br>
 
 
<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>
 
 
 
<br>
{{clear}}
{{clear}}
<!--
<!--
-->
-->

Revisión actual - 22:03 18 nov 2025

Integración – The Factory HKA Colombia

Bienvenido a Integración de The Factory HKA Colombia, el espacio diseñado para brindar una experiencia técnica clara, eficiente y centralizada para nuestros clientes y aliados.

Aquí encontrará la documentación completa para la integración de los servicios de Factura Electrónica, Nómina Electrónica, Recepción Electrónica y Documentos Equivalentes, incluyendo manuales, APIs, herramientas y recomendaciones para el cumplimiento de las resoluciones DIAN vigentes.

Acceso rápido: Consulte las secciones de pasos de integración, canales de comunicación y ejemplos de APIs según su tipo de documento electrónico.


¿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:
• Facturación Electrónica con validación previa ante la DIAN.
• Nómina Electrónica con soporte para documentos individuales y masivos.
• Recepción de Documentos Electrónicos con trazabilidad y respuesta.
• Emisión de Documentos Equivalentes conforme a la Resolución 000165 del 2023.

¿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:

Canal Información de contacto

Correo electrónico

integracion_fel_co@thefactoryhka.com

Teléfonos

Opción 5, luego Opción 1
+57 317 668 7663 | +57 (601) 390 95 39

WhatsApp

Escríbanos al canal de soporte técnico https://wa.me/573163192251

Sesiones grupales de integración

Martes y jueves de 08:30 a.m. a 10:00 a.m. (hora Colombia).
https://meet.google.com/fzo-xmyc-duk

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

Producto Servicio Descripción Método
FEL SOAP

FacturaElectronica - Enviar
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.
Entornos: Demo / Producción

POST
FEL SOAP

FacturaElectronica - EstadoDocumento
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.

GET
FEL SOAP

FacturaElectronica - DescargaPDF
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.

GET
FEL SOAP

FacturaElectronica - EnvioCorreo
Envío automatizado de facturas electrónicas a los destinatarios con PDF y XML técnico, asegurando entrega completa y trazable.

POST

Factura Electrónica - REST

Producto Servicio Descripción Método
FEL REST

Api/documentos/enviar
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.
Entornos: Demo / Producción

POST
FEL REST

Api/documentos/EstadoDocumento
Consulta en tiempo real del estado del documento y validación ante la DIAN, mostrando incidencias o aceptación definitiva.

GET
FEL REST

Api/documentos/DescargaPDF
Generación automática del PDF representativo del documento, conforme a los estándares de presentación exigidos.

GET
FEL REST

FacturaElectronica - EnvioCorreo
Distribución electrónica automatizada de facturas a clientes, incluyendo PDF y XML técnico.

POST

Nómina Electrónica - SOAP

Producto Servicio Descripción Método
Nomina SOAP

NominaElectronica - Enviar
Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.
Entornos: Demo / Producción

POST
Nomina SOAP

NominaElectronica - ConsultarDocumento
Consulta del estado de tramitación y validación de nóminas electrónicas.

GET
Nomina SOAP

NominaElectronica - EnviarCorreo
Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.

POST
Nomina SOAP

NominaElectronica - ConsultarFolios
Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.

GET

Nómina Electrónica - REST

Producto Servicio Descripción Método
Nomina REST

Api/documentos/Enviar
Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.
Entornos: Demo / Producción

POST
Nomina REST

Api/documentos/ConsultarDocumento
Consulta del estado de tramitación y validación de nóminas electrónicas.

GET
Nomina REST

Api/documentos/EnviarCorreo
Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.

POST
Nomina REST

Api/documentos/ConsultarFolios
Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.

GET

Recepción Electrónica

Producto Servicio Descripción Método
Recepcion SOAP

Recepcion - ReporteStatus
Procesa documentos recibidos de proveedores, validando autenticidad e integridad para integración contable.
Entornos: Demo / Producción

POST
Recepcion SOAP

Recepcion - EstadoDocumento
Consulta del estado y trazabilidad de documentos recibidos ante la DIAN.

GET
Recepcion SOAP

Recepcion - Respuesta
Gestión formal de aceptación o rechazo de documentos recibidos, registrando eventos ante la DIAN.

POST
Recepcion SOAP

Recepcion - RepresentacionGrafica
Descarga y generación de PDFs de documentos recibidos conforme a los estándares DIAN.

GET

Documentos Equivalentes

Producto Servicio Descripción Método
Doc Equivalente REST

Equivalente - EnviarRequest
Envío de documentos equivalentes electrónicos a la DIAN, cumpliendo con las validaciones oficiales.
Entornos: Demo / Producción

POST
Doc Equivalente REST

Equivalente - GenerarContenedor
Genera contenedores de información estructurados según los requisitos técnicos de la DIAN.

GET
Doc Equivalente REST

Equivalente - DescargaPDF
Generación de representaciones gráficas PDF para documentos equivalentes conforme a la normativa vigente.

POST
Doc Equivalente REST

Equivalente - EstadoDocumento
Consulta del estado de validación y trazabilidad de documentos equivalentes ante la DIAN.

POST

















Copyright
Copyright
THE FACTORY HKA COLOMBIA

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