Para integrar FEL con tu ERP en Guatemala en 2026 necesitas cuatro piezas: un PAC autorizado por SAT, certificado digital de firma del emisor, XML según esquema SAT vigente, y un patrón de cola asíncrona con retry. Nunca bloquees al usuario esperando timbrado: va en cola, se notifica cuando está listo. En una red de franquicias cliente nuestra unificamos los datos legacy en un data lake y montamos sobre él la integración FEL completa con reportería SAT integrada.
¿Qué es FEL y por qué importa la integración técnica?
FEL es Factura Electrónica en Línea, el régimen de facturación electrónica obligatorio en Guatemala según el Acuerdo de Directorio de SAT vigente. Toda empresa que facture en Guatemala debe emitir FEL conectándose a un PAC (Proveedor Autorizado de Certificación) autorizado por SAT.
La integración técnica importa porque: si el ERP emite mal, el cliente no recibe factura; si SAT rechaza, hay que reponer en plazo; si el PAC se cae, las ventas se atoran. Una integración FEL mediocre te genera fricción operativa diaria. Una integración seria es invisible.
PACs autorizados SAT Guatemala 2026
Los PACs más usados en 2026 son:
| PAC | API | Costo por timbre (USD) | Notas |
|---|---|---|---|
| INFILE | REST | 0.05 a 0.12 | Más usado, buen SLA |
| MEGAPRINT | SOAP + REST | 0.06 a 0.15 | Robusto, soporte 24/7 |
| GUATEFACTURAS | REST | 0.05 a 0.10 | Económico, SLA medio |
| FACTURASGT | REST | 0.08 a 0.20 | Boutique, premium |
| G4S | REST | 0.07 a 0.14 | Multinacional, estable |
La elección depende de volumen, SLA contractual y costos. Para una distribuidora con 500 a 5,000 facturas al mes, INFILE o GUATEFACTURAS son los más comunes.
Flujo técnico estándar de emisión FEL
El flujo de emisión paso a paso:
- ERP arma XML: estructura según esquema SAT vigente (DTE versión 0.1 o 0.2 según el momento). Datos del emisor (NIT, dirección, régimen), datos del receptor, líneas de venta, impuestos, totales.
- Firma con certificado: el ERP firma el XML con el certificado digital del emisor (PKCS12 entregado por SAT). Sin firma válida, el PAC rechaza.
- Envío al PAC: POST al endpoint del PAC con el XML firmado. Headers de autenticación según el PAC.
- PAC valida y timbra: el PAC valida el esquema, las reglas SAT (NIT existente, montos coherentes, régimen correcto), y si pasa, lo timbra. Devuelve el XML firmado por el PAC más UUID (autorización SAT).
- ERP persiste: guarda XML firmado, UUID, fecha de autorización. Es la prueba legal.
- Genera PDF: con UUID visible, QR code SAT, datos del cliente.
- Entrega al cliente: email, descarga, app, según canal.
- Reporta a SAT: cada 24 horas vía SAR (Sistema de Anulación y Reposición) o ya queda registrado al timbrar (depende del PAC y el régimen).
El flujo completo en condiciones normales dura entre 1 y 5 segundos. En degradación del PAC, hasta 30 segundos. Nunca bloquees al usuario esperando.
Patrón asíncrono con cola y retry
El patrón estable en producción:
Usuario cierra venta en ERP
└─ ERP arma factura y la marca como "pending FEL"
└─ Job asíncrono pickea de cola
├─ Llama al PAC con timeout 30s
├─ Si OK: persiste UUID, genera PDF, marca "facturada"
├─ Si error: retry con backoff (1s, 2s, 4s, 8s, 16s)
└─ Si supera 5 retries: marca "FEL pendiente" + notifica equipo
Usuario ve la factura como "procesando" durante 5 a 30 segundos máximo en condiciones normales. Tu equipo se entera por dashboard si algo se atora. Reconciliación nocturna asegura que no haya facturas perdidas.
Errores comunes que salen caros
- Bloquear al usuario esperando timbrado: cuando el PAC tiene degradación, tu caja se atora 30 segundos por venta. Mata operación.
- No tener fallback PAC: si tu único PAC se cae 2 horas en un sábado, pierdes ventas. Volumen alto justifica conexión dual.
- No reconciliar: pensar que todo se timbró cuando un porcentaje quedó en error silencioso. Suma auditoría nocturna que verifique cada venta del día vs facturas timbradas.
- Manejar mal el certificado vencido: el certificado del emisor vence cada 2 años. Sin alerta de vencimiento, despiertas un lunes sin poder facturar.
- NIT inválido del receptor: SAT rechaza si el NIT no existe en padrón. Valida el NIT contra padrón SAT antes de armar la factura.
El caso real: FEL dentro de plataforma multi-tenant
En la red de franquicias que mencionamos al inicio construimos un data lake unificado Bronze/Silver/Gold con tablas normalizadas, migración de las tablas legacy, políticas de seguridad por fila y roles por persona. Sobre ese data lake montamos integración FEL con PAC autorizado, reportería SAT por franquicia, y reconciliación nocturna.
Resultado: cada franquicia quedó operando con FEL integrado en 12 semanas, con la migración verificada fila por fila. La parte de FEL se entregó como módulo dentro del proyecto.
¿Cuándo conviene construir vs comprar integración FEL?
Comprar conector: cuando tu ERP es estándar (SAP B1, Odoo, CONTPAQi) y existe addon FEL certificado del proveedor. Al costo del conector se suma el timbre por factura.
Construir a medida: cuando tu ERP es a medida, tu operación es multi-tenant con varias razones sociales, o necesitas lógica de negocio compleja sobre las facturas (descuentos especiales, multi-moneda, comisiones cruzadas). El costo depende del alcance de la integración.
Próximos pasos
Si tu ERP es estándar y el conector FEL del proveedor cubre tus reglas, eso primero. Si tu operación tiene multi-tenant, multi-régimen o lógica de descuentos compleja, agenda una llamada sobre tu operación.
- MAGIA Core si quieres ERP a medida con FEL integrado nativo en 12 semanas, también para redes de franquicias con FEL por unidad y reportería SAT consolidada.
El código, los datos y el dominio quedan a tu nombre.