Objeto Factura
Esquema completo del request POST /v1/invoices con todos los campos, tipos y restricciones.
Esquema completo del body para POST /v1/invoices y POST /v1/sandbox/invoices: los mismos
campos, tipos y límites con los que el API valida cada factura.
Los campos numero_acceso y gran_total son calculados por QAPI y nunca deben enviarse.
Si los incluís, son ignorados y reemplazados por los valores calculados.
Cabecera de la factura
Campos raíz
Propiedad
Tipo
Partes involucradas
Emisor
Propiedad
Tipo
Receptor
Propiedad
Tipo
Dirección
Aplica tanto para emisor.direccion como para receptor.direccion:
Propiedad
Tipo
Líneas de la factura
Frase
Propiedad
Tipo
Item
Propiedad
Tipo
precio_unitario siempre sin IVA
El campo precio_unitario debe ser el precio antes de IVA. QAPI valida que
monto_gravable = precio_unitario × cantidad − descuento y que
monto_impuesto = monto_gravable × 0.12 (±0.01 cada una). Si enviás el precio con IVA
incluido, el monto_gravable no cuadra y falla la validación 7b; si forzás que cuadre, el
IVA se cobra dos veces.
Impuesto
Propiedad
Tipo
Complementos por tipo de DTE
Cada uno se exige solo en su tipo y se rechaza con 422 en los demás. Los ejemplos
completos por tipo están en Tipos de DTE.
ReferenciaNota — NCRE, NDEB
Propiedad
Tipo
Abono — FCAM, FCAP
Propiedad
Tipo
Retenciones — FESP
Propiedad
Tipo
La suma de lo retenido no puede superar el total del documento.
ExportacionInfo — con exportacion: true
Propiedad
Tipo
Campos calculados por QAPI (no enviar)
Ejemplo completo
La fecha_emision es ilustrativa: al enviarlo, usá la fecha y hora actual de Guatemala (ver
validación 10).
{
"tipo_dte": "FACT",
"moneda": "GTQ",
"fecha_emision": "2026-06-08T10:00:00-06:00",
"emisor": {
"nit": "12345678",
"nombre": "Mi Empresa S.A.",
"nombre_comercial": "Mi Empresa",
"codigo_establecimiento": 1,
"afiliacion_iva": "GEN",
"direccion": {
"calle": "6a Avenida 1-36 Zona 1",
"municipio": "Guatemala",
"departamento": "Guatemala",
"codigo_postal": "01001",
"pais": "GT"
},
"correo": "facturacion@miempresa.com"
},
"receptor": {
"id": "CF",
"tipo_id": "NIT",
"nombre": "Consumidor Final"
},
"frases": [
{ "tipo_frase": 1, "codigo_escenario": 1 }
],
"items": [
{
"tipo": "S",
"cantidad": 1,
"unidad_medida": "UND",
"descripcion": "Servicio de consultoría",
"precio_unitario": 100.00,
"descuento": 0,
"impuestos": [
{
"nombre": "IVA",
"codigo_unidad_gravable": 1,
"monto_gravable": 100.00,
"monto_impuesto": 12.00
}
]
}
],
"metadata": {
"referencia_interna": "ORD-2026-001",
"cliente_id": "cli_xyz"
}
}