QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Referencia

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"
  }
}

En esta página