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

INVALID_API_KEY (401)

La API key enviada no existe o fue revocada.

HTTP 401 Unauthorized

La API key en el header Authorization tiene el formato correcto, pero QAPI no la reconoce como una key activa.

Ejemplo

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

Causas comunes

  • La key fue copiada incorrectamente (espacios, caracteres faltantes)
  • La key fue revocada o regenerada desde el dashboard: la anterior deja de funcionar al instante
  • El proyecto de la key fue archivado o eliminado: en los dos casos se revocan todas sus keys. Si lo restaurás, generá una key nueva

Una key test SÍ funciona contra POST /v1/invoices

No hace falta el endpoint /v1/sandbox/invoices para usar una key qapi_test_* — funciona igual contra POST /v1/invoices (así arranca la guía Primer DTE en 5 minutos). El entorno lo define el prefijo de la key, no el endpoint. /v1/sandbox/invoices es un camino aparte, pensado para el Playground, no un requisito para usar una key de test.

Cómo resolverlo

  1. Verificá que la key empiece con qapi_live_ (live) o qapi_test_ (test)
  2. Confirmá que la key esté activa en el dashboard de QAPI — si la regeneraste, actualizá tu .env con la nueva
  3. Copiala de nuevo desde el dashboard si no estás seguro de que esté completa

En esta página