Uso del sandbox hoy
Devuelve cuántas pruebas hiciste hoy (hora de Guatemala, UTC-6) por tipo de DTE, junto con el límite diario de tu plan.
Authorization
ApiKeyAuth API key con prefijo qapi_live_ o qapi_test_, o JWT (access_token) obtenido vía POST /v1/auth/login. QAPI detecta el tipo automáticamente por el prefijo del token.
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/sandbox/usage"{
"date": "2026-06-09",
"usage": {
"FACT": 3
},
"limit_per_type": 20,
"total_today": 3
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}Emitir factura de prueba
Crea una factura de prueba usando siempre el certificador MOCK, sin importar el certificador del tenant. Sin costo ni validez tributaria. Aplica las mismas 14 validaciones que producción. La respuesta incluye `links.self` apuntando a `GET /v1/invoices/{id}` — las facturas de sandbox **se consultan y anulan por los endpoints normales de Facturas**, no existe un GET/cancel bajo /v1/sandbox. Diferencias vs producción: no dispara webhooks, no consume cuota del plan, `referencia_interna` se prefija con "[SANDBOX]", y aplica un límite diario por tipo de DTE según tu plan (starter/business: 20, enterprise: 50).
Consultar NIT en SAT
Consulta los datos de un contribuyente en el padrón de SAT (vía el certificador) para pre-llenar o validar el receptor antes de emitir. Requiere scope `invoices:read` (API key) o JWT. Si el servicio de consulta no está configurado en el ambiente, responde 503 LOOKUP_UNAVAILABLE — tratalo como opcional: siempre podés enviar el nombre del receptor manualmente.