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
- Verificá que la key empiece con
qapi_live_(live) oqapi_test_(test) - Confirmá que la key esté activa en el dashboard de QAPI — si la regeneraste, actualizá
tu
.envcon la nueva - Copiala de nuevo desde el dashboard si no estás seguro de que esté completa