Tipos de DTE
Los 12 tipos de Documento Tributario Electrónico soportados por QAPI y cuáles están actualmente implementados.
Tipos de DTE
QAPI soporta los 12 tipos de Documento Tributario Electrónico definidos por la SAT Guatemala.
Actualmente están implementados FACT (Régimen General) y FPEQ (Pequeño Contribuyente) —
el resto devuelve 501 NOT_IMPLEMENTED.
FACT y FPEQ disponibles hoy
Si intentas emitir cualquier tipo distinto a FACT o FPEQ, recibirás un error
501 NOT_IMPLEMENTED. Los demás tipos se irán habilitando según la demanda.
El emisor define el tipo (modo live)
La afiliación IVA configurada en tu emisor (cuenta o proyecto) determina qué documento
puede emitir en live: GEN emite FACT y PEQ emite FPEQ. Se configura en el
dashboard al crear el proyecto (o en Configuración → Empresa para el emisor de la cuenta).
Tabla de tipos
| Tipo | Documento | Estado |
|---|---|---|
FACT | Factura — documento estándar de venta de bienes o servicios | Implementado |
FPEQ | Factura Pequeño Contribuyente — emisores con afiliación IVA PEQ. No lleva IVA explícito | Implementado |
FCAM | Factura Cambiaria — factura que además funciona como título de crédito, con abonos y vencimientos. (Cualquier DTE puede emitirse en USD vía el campo moneda — eso no requiere FCAM) | Próximamente |
NCRE | Nota de Crédito — ajuste negativo o devolución. Requiere referencia_dte_origen | Próximamente |
NDEB | Nota de Débito — ajuste positivo a una factura existente. Requiere referencia_dte_origen | Próximamente |
RECI | Recibo — comprobante de pago sin impuestos | Próximamente |
FESP | Factura Especial — para pagos a contribuyentes no registrados | Próximamente |
FCAP | Factura de Pequeño Contribuyente Agropecuario | Próximamente |
RDON | Recibo por Donación | Próximamente |
NABN | Nota de Abono — documento de descuento parcial | Próximamente |
FACA | Factura de Contribuyente Agropecuario | Próximamente |
FCCA | Factura Cambiaria de Contribuyente Agropecuario | Próximamente |
Reglas especiales por tipo
FPEQ — Pequeño Contribuyente
- El emisor debe tener
afiliacion_iva: "PEQ"(en live, además, debe coincidir con la afiliación configurada del emisor — un emisor GEN no puede emitir FPEQ ni viceversa) - Los items no llevan IVA — envía el impuesto con
monto_gravable: 0ymonto_impuesto: 0 - La validación 13 rechaza cualquier
monto_impuesto > 0 - El total del item es
precio_unitario × cantidad − descuento(sin gross-up de IVA) - La frase estándar es tipo 3, escenario 1 ("No genera derecho a crédito fiscal")
NCRE y NDEB — Notas de Crédito/Débito
- Requieren el campo
referencia_dte_origencon el UUID de la factura original - La validación 11 rechaza estas notas sin ese campo
- La factura referenciada debe existir en el mismo tenant
FCAM, FCAP, FACA, FCCA — Variantes agropecuarias/cambiarias
- Siguen la misma estructura que
FACTcon campos adicionales según la SAT - Documentación completa se publicará al habilitarlos
El campo tipo_dte en el request
{
"tipo_dte": "FACT",
...
}El valor debe ser exactamente uno de los 12 códigos en mayúsculas. Cualquier otro valor
devuelve 422 VALIDATION_ERROR con invalid_params indicando el campo tipo_dte.