Consultar CUI en RENAP
Consulta los datos de una persona por CUI/DPI en RENAP (vía el certificador), incluyendo el indicador de persona fallecida.
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.
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
Parámetros de ruta
CUI/DPI a consultar: exactamente 13 dígitos.
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/cui/2059473012005"{
"cui": "2059473012005",
"nombre": "JUAN PEREZ LOPEZ",
"direccion": "CIUDAD",
"fallecido": false
}{
"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/cui/2985231120101"
}{
"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/cui/2985231120101"
}{
"type": "https://docs.dtevia.com.gt/errors/not-found",
"title": "NOT_FOUND",
"status": 404,
"detail": "CUI no encontrado",
"instance": "/v1/receptores/cui/2985231120101"
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/receptores/cui/2985231120101",
"invalid_params": [
{
"field": "cui",
"message": "CUI inválido: deben ser exactamente 13 dígitos"
}
]
}{
"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/cui/2985231120101"
}{
"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/cui/2985231120101"
}{
"type": "https://docs.dtevia.com.gt/errors/certifier-timeout",
"title": "CERTIFIER_TIMEOUT",
"status": 504,
"detail": "El certificador no respondió a tiempo",
"instance": "/v1/receptores/cui/2985231120101"
}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.
Historial del sandbox (hoy)
Devuelve las facturas de prueba creadas hoy (hora de Guatemala), de la más reciente a la más antigua. Para el detalle completo de una factura usá GET /v1/invoices/{id}.