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.
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
Path Parameters
NIT a consultar: solo dígitos con K final opcional.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/receptores/nit/1514318"{
"nit": "1514318",
"nombre": "EMPRESA EJEMPLO, SOCIEDAD ANONIMA",
"direccion": "Ciudad"
}{
"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"
}
]
}{
"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"
}
]
}{
"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"
}
]
}{
"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"
}
]
}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.
Consultar CUI en RENAP
Consulta los datos de una persona por CUI/DPI en RENAP (vía el certificador), incluyendo el indicador de fallecido. Requiere scope `invoices:read` (API key) o JWT. Si el servicio de consulta no está configurado en el ambiente, responde 503 LOOKUP_UNAVAILABLE.