Bienvenido a QAPI Docs
Documentación oficial del middleware de Facturación Electrónica en Línea (FEL) para Guatemala.
Bienvenido a QAPI
QAPI no es un certificador SAT
QAPI es un middleware: conecta tu software con un certificador autorizado por la SAT, gestionado por QAPI. Solo necesitas una API key y enviar JSON — sin XMLs, sin certificados digitales, sin contratos ni integraciones por certificador.
Único requisito fiscal: el NIT emisor habilitado como emisor FEL
Para emitir DTEs con validez fiscal en el entorno live, el NIT emisor de la cuenta debe estar habilitado como emisor FEL ante la SAT: el de tu negocio si facturas para ti, o el de tu cliente si integras para terceros (SaaS, POS) — en ese caso el trámite le corresponde al dueño del negocio. Es gratuito y por una sola vez en Agencia Virtual. QAPI se encarga de todo lo demás. En el entorno de pruebas no necesitas nada: emite desde el primer minuto.
QAPI es el middleware de Facturación Electrónica en Línea (FEL) para Guatemala. Actúa como intermediario entre tu software y el certificador autorizado ante la SAT, abstrayendo toda la complejidad del proceso.
¿Por qué QAPI?
- Una sola integración — la relación con el certificador la gestionamos nosotros.
- JSON simple — envías un objeto de factura, recibes el UUID SAT y el PDF.
- Entornos separados —
test(mock, sin cuota) vslive(certificador real). - Multi-emisor — un proyecto por cada NIT que factura, con su cuota, su webhook y sus API keys.
- Consulta de receptores — valida NIT (SAT) y CUI (RENAP) antes de emitir.
- Errores descriptivos — formato RFC 7807 con links a esta documentación.
Infraestructura de certificación
QAPI certifica sobre la infraestructura de Totaldoc, la plataforma de Grupo CDS, S.A. — certificador autorizado por la SAT para el régimen FEL de Guatemala. La alianza es directa: firma, certificación, anulación, representación gráfica (PDF) y consultas al padrón corren sobre sus servicios.
Para vos eso es transparente: no firmas contratos con el certificador, no gestionas sus credenciales ni sus formatos — QAPI administra esa relación de punta a punta. Emites con tu API key y recibes el UUID de autorización SAT.
| Operación | Cobertura |
|---|---|
Emisión de DTEs (FACT, FPEQ) | Firma + certificación ante la SAT |
| Anulación | El PDF se re-emite con la marca "ANULADO" |
| Representación gráfica | PDF oficial por cada DTE certificado |
| Consulta de NIT / CUI | Padrón SAT y RENAP para validar receptores |
Por dónde empezar
Introducción
Modelo de negocio, glosario FEL/DTE/SAT y cómo funciona el middleware.
Autenticación
API keys (qapi_test_ / qapi_live_), JWT, dual-auth y scopes.
Primer DTE en 5 min
Del registro al DTE certificado ante la SAT, paso a paso con código real.
Emitir Factura
Ciclo completo: construir el request, emitir y hacer polling de estado.
Profundizar
Proyectos multi-emisor
Un NIT emisor por proyecto: cuotas repartibles, perfil fiscal GEN/PEQ, webhooks y keys propias.
Las 14 Validaciones
Reglas que toda factura pasa antes de llegar al certificador — con ejemplos de cada una.
Webhooks
Recibí certified/failed/cancelled en tu servidor, con firma HMAC-SHA256.
Manejo de errores
RFC 7807 Problem Details: cómo leer type, detail e invalid_params.