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

SUBSCRIPTION_INACTIVE (403)

Tu plan no está activo, así que la emisión live está pausada. Renovalo y se reactiva sola — el sandbox sigue disponible.

HTTP 403 Forbidden

Intentaste emitir un DTE en modo live con un plan que no está activo: diste de baja la suscripción y el período que pagaste ya terminó, o los cobros fallaron y la suscripción se dio de baja sola.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/subscription-inactive",
  "title": "SUBSCRIPTION_INACTIVE",
  "status": 403,
  "detail": "Tu plan no está activo, así que la emisión en modo real está pausada. Renová tu plan desde Plan y facturación y se reactiva enseguida. El Sandbox sigue disponible.",
  "context": { "plan": "starter" }
}

Qué significa

Tres cosas lo distinguen de los demás errores que bloquean la emisión live:

  • Se revierte solo. Renovás el plan y la emisión live vuelve enseguida, con el cobro confirmado. No hay que esperar un trámite ni pedirle nada a nadie.
  • El sandbox no se corta. POST /v1/sandbox/invoices y las API keys qapi_test_... siguen funcionando igual que siempre.
  • No tenés que solicitar ninguna habilitación. Tu emisor sigue habilitado: lo que falta es el plan. Si lo que faltara fuera la habilitación del NIT, el error sería EMISOR_NOT_PROVISIONED (409).

Tampoco perdés nada: tu cuenta, tus proyectos, tus API keys y tu historial quedan intactos, y los DTEs que ya certificaste siguen siendo válidos ante la SAT.

Cómo resolverlo

  1. Andá al dashboard de QAPI → Configuración → Plan y facturación.
  2. Renová tu plan y completá el checkout.
  3. Reintentá la emisión: se reactiva con el cobro confirmado.

Mientras tanto podés seguir desarrollando en sandbox, que no requiere plan activo.

Ver Planes y facturación para el ciclo completo de la suscripción: mora, baja, reactivación y reembolsos.

En esta página