Uso del sandbox hoy
Devuelve el consumo de pruebas del día (hora de Guatemala, UTC-6) desglosado por tipo de DTE, junto con el límite diario del plan.
Autorización
ApiKeyAuth 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
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/sandbox/usage"{
"date": "2026-06-09",
"usage": {
"FACT": 3
},
"limit_per_type": 30,
"total_today": 3
}{
"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/sandbox/usage"
}{
"type": "https://docs.dtevia.com.gt/errors/email-not-verified",
"title": "EMAIL_NOT_VERIFIED",
"status": 403,
"detail": "Confirmá el correo de tu cuenta para usar Facturas y Sandbox.",
"instance": "/v1/sandbox/usage"
}{
"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"
}Emitir factura de prueba
Crea una factura de prueba usando siempre el certificador MOCK, sin importar el certificador del tenant. No tiene costo ni validez tributaria, y aplica las mismas 21 validaciones que producción.
Consultar NIT en SAT
Consulta los datos de un contribuyente en el padrón de la SAT (vía el certificador), para pre-llenar o validar el receptor antes de emitir.