Api
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.
Consideraciones
- Requiere una API key con el scope
invoices:read. - 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.
Autorización
ApiKeyAuth AutorizaciónBearer <token>
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
Parámetros de ruta
nit*string
NIT a consultar: solo dígitos con K final opcional.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
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/invalid-api-key",
"title": "INVALID_API_KEY",
"status": 401,
"detail": "API key inválida o revocada",
"instance": "/v1/receptores/nit/1514318"
}{
"type": "https://docs.dtevia.com.gt/errors/forbidden",
"title": "FORBIDDEN",
"status": 403,
"detail": "Tu API key no tiene el scope requerido para esta operación: invoices:read",
"instance": "/v1/receptores/nit/1514318"
}{
"type": "https://docs.dtevia.com.gt/errors/not-found",
"title": "NOT_FOUND",
"status": 404,
"detail": "NIT no encontrado",
"instance": "/v1/receptores/nit/1514318"
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/receptores/nit/1514318",
"invalid_params": [
{
"field": "nit",
"message": "NIT inválido: solo dígitos con K final opcional (ej. 1514318 o 9876543K)"
}
]
}{
"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"
}{
"type": "https://docs.dtevia.com.gt/errors/bad-gateway",
"title": "BAD_GATEWAY",
"status": 502,
"detail": "La consulta al certificador falló",
"instance": "/v1/receptores/nit/1514318"
}{
"type": "https://docs.dtevia.com.gt/errors/lookup-unavailable",
"title": "LOOKUP_UNAVAILABLE",
"status": 503,
"detail": "La consulta de NIT/CUI no está disponible en este ambiente",
"instance": "/v1/receptores/nit/1514318"
}{
"type": "https://docs.dtevia.com.gt/errors/certifier-timeout",
"title": "CERTIFIER_TIMEOUT",
"status": 504,
"detail": "El certificador no respondió a tiempo",
"instance": "/v1/receptores/nit/1514318"
}