QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Api

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.
GET
/v1/receptores/cui/{cui}

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

cui*string

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"
}