Anular factura
Anula una factura certificada ante la SAT. Solo facturas en estado `CERTIFIED` pueden anularse. El body es obligatorio: requiere `motivo` y `fecha_anulacion` con offset de Guatemala (-06:00).
Authorization
ApiKeyAuth API key con prefijo qapi_live_ o qapi_test_, o JWT (access_token) obtenido vía POST /v1/auth/login. QAPI detecta el tipo automáticamente por el prefijo del token.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel" \ -H "Content-Type: application/json" \ -d '{ "motivo": "Error en datos del receptor", "fecha_anulacion": "2026-06-09T10:30:00-06:00" }'{
"id": "inv_V1StGXR8_Z5jdHi6",
"status": "CANCELLED",
"cancelled_at": "2019-08-24T14:15:22Z"
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}Obtener factura
Devuelve el estado actual de una factura (incluye las creadas vía Sandbox). Los campos presentes dependen del estado: uuid_sat/serie/numero_dte/pdf_url/certified_at solo en CERTIFIED; error_code/error_message solo en FAILED; cancelled_at solo en CANCELLED.
PDF de la factura
Redirige (302) a la representación gráfica de la factura provista por el certificador. Disponible para facturas CERTIFIED y también CANCELLED (el DTE anulado conserva su PDF, re-renderizado por el certificador con la marca ANULADO). En entorno test/sandbox (MOCK) el destino no resuelve a un PDF real — la factura de prueba se ve y descarga con el visualizador integrado del dashboard (botón "Ver factura").