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

Anular factura

Anula ante la SAT una factura certificada.

Requisitos

  • Solo pueden anularse facturas en estado CERTIFIED.
  • El body es obligatorio: requiere motivo y fecha_anulacion con offset horario de Guatemala (-06:00).
POST
/v1/invoices/{id}/cancel

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