Integración Facturatech - Nómina Electrónica

Información General

La integración con Facturatech permite a Dataemunáh cumplir con la obligación legal de emisión de nómina electrónica establecida por la DIAN, garantizando el procesamiento seguro, trazable y normativo de los documentos de pago.

Proveedor Autorizado

Facturatech S.A.S.
Autorizado por DIAN mediante Resolución 000013 del 11/02/2021

Cliente

Conectera, Fábrica de Tecnologías
Implementando para sistema Dataemunáh

Normativa

Resolución DIAN 000013/2021
Emisión obligatoria hasta el día 10 hábil del mes siguiente

Stack Técnico

PHP 5.2.3 | Zend Framework 1.12
Integración vía SOAP + XML

Objetivos de la Integración

Emisión Automatizada
Generar y enviar documentos de nómina electrónica desde Dataemunáh de forma automática y masiva.
Cumplimiento Normativo
Garantizar el cumplimiento de la Resolución DIAN 000013/2021 en estructura, firma digital y plazos de emisión.
Trazabilidad Completa
Registrar cada operación con logs detallados, estados y documentos descargables (XML/PDF).
Escalabilidad
Procesar hasta 3000+ nóminas mensuales respetando las limitaciones de rate limiting del API.
Experiencia de Usuario
Proveer interfaz clara para monitoreo, consulta de estados y descarga de documentos firmados.

Arquitectura del Sistema

Endpoints Disponibles

uploadDocument Envía el XML de nómina para validación y firma

documentStatus Consulta el estado de procesamiento

downloadXML Descarga el XML firmado por la DIAN

downloadPDF Obtiene la representación gráfica

downloadCUNE Recupera el Código Único de Nómina

Flujo de Procesamiento

29107663

Limitaciones del Servicio

Impacto en Procesamiento Masivo

Dado que cada nómina requiere 2 peticiones (upload + status):

Capacidad Real

10 nóminas cada 10 segundos
Máximo teórico: 3,600 nóminas/hora

Tiempo para 3000 empleados

~50 minutos
(300 ciclos × 10 segundos)

Recomendación

Sistema de cola inteligente
Con control de velocidad y reintentos

Margen de Seguridad

2,400 nóminas/hora
Considerando errores y reintentos

Estado de las Pruebas

Endpoint	Estado	Tiempo Respuesta	Observaciones
uploadDocument	OK	~308 ms - 952ms	Validación de estructura correcta
documentStatus	OK	~518 ms- 950ms	Polling funcional
downloadXML	OK	~143 ms- 620ms	XML con firma DIAN
downloadPDF	OK	~780 ms - 2s	Plantilla genérica aplicada
downloadCUNE	OK	~151 ms	CUNE generado correctamente

Documentación Técnica

Autenticación Credenciales, ambientes y configuración de acceso

Estructura XML Nodos, tipos de datos y validaciones

Pruebas en Sandbox Evidencias, casos de prueba y resultados

Implementación Código ejemplo, cliente SOAP y sistema de cola

Limitaciones Base de datos, logging y monitoreo