Api
Anular factura
Anula ante la SAT una factura certificada.
Requisitos
- Solo pueden anularse facturas en estado
CERTIFIED. - El body es obligatorio: requiere
motivoyfecha_anulacioncon offset horario de Guatemala (-06:00).
Autorización
ApiKeyAuth AutorizaciónBearer <token>
API key con prefijo qapi_test_ (Sandbox) o qapi_live_ (producción), enviada en el header Authorization: Bearer <api_key>. Se genera en el dashboard, dentro de cada proyecto.
Va en: header
Parámetros de ruta
id*string
Cuerpo del request
application/json
Definiciones de TypeScript
Usá el tipo request body en TypeScript.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
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/integrity-check-failed",
"title": "INTEGRITY_CHECK_FAILED",
"status": 400,
"detail": "El hash SHA-256 del cuerpo no coincide con el header X-Content-SHA256",
"instance": "/v1/invoices"
}{
"type": "https://docs.dtevia.com.gt/errors/invalid-api-key",
"title": "INVALID_API_KEY",
"status": 401,
"detail": "API key inválida o revocada",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel"
}{
"type": "https://docs.dtevia.com.gt/errors/forbidden",
"title": "FORBIDDEN",
"status": 403,
"detail": "Tu API key no tiene el scope requerido para esta operación: invoices:write",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel"
}{
"type": "https://docs.dtevia.com.gt/errors/not-found",
"title": "NOT_FOUND",
"status": 404,
"detail": "Factura no encontrado",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel"
}{
"type": "https://docs.dtevia.com.gt/errors/invalid-status",
"title": "INVALID_STATUS",
"status": 409,
"detail": "Solo se pueden anular facturas CERTIFIED. Estado actual: FAILED",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel"
}{
"type": "https://docs.dtevia.com.gt/errors/payload-too-large",
"title": "PAYLOAD_TOO_LARGE",
"status": 413,
"detail": "El cuerpo del request excede el límite de 1024KB",
"instance": "/v1/invoices",
"context": {
"max_bytes": 1048576
}
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel",
"invalid_params": [
{
"field": "motivo",
"message": "El motivo de anulación es obligatorio"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/rate-limited",
"title": "RATE_LIMITED",
"status": 429,
"detail": "Límite de requests excedido. Reintentar en 60s",
"instance": "/v1/invoices"
}{
"type": "https://docs.dtevia.com.gt/errors/internal-error",
"title": "INTERNAL_ERROR",
"status": 500,
"detail": "Error interno del servidor",
"instance": "/v1/invoices"
}{
"type": "https://docs.dtevia.com.gt/errors/certifier-error",
"title": "CERTIFIER_ERROR",
"status": 502,
"detail": "Error al anular la factura en el certificador",
"instance": "/v1/invoices/inv_V1StGXR8_Z5jdHi6/cancel"
}