catalogos

Validación de RUC contra el catastro del SRI

Veredicto SIEMPRE 200: valido (estructura y dígito verificador; el RUC de sociedad privada se valida solo por estructura, como hace el SRI), encontrado (consta en el catastro) y, si consta, el contribuyente con razón social, estado, régimen mapeado (GENERAL | RIMPE_EMPRENDEDOR | RIMPE_NEGOCIO_POPULAR) y crudo (regimenSri), tipo de contribuyente, actividad económica (descripción, no CIIU), dirección, obligadoContabilidad, contribuyenteEspecial y agenteRetencion, más advertencias (RUC suspendido, fantasma o con transacciones inexistentes). Resiliente: caché de 24 h y, si el SRI no responde, sirve la última copia (hasta 7 días, fuente: "cache" y degradado: true si venció su frescura); sin copia responde degradado: true con motivo. Nunca 404 ni 503. Alcanzable con API key (roles emisor, contador o lector).

get/sri/ruc/{ruc}

Request

  • Base URL: https://contadeo.com/api
  • URL: https://contadeo.com/api/sri/ruc/{ruc}
  • Auth: HTTP bearer

Path parameters

rucstring required

RUC de 13 dígitos. Para una cédula, consulta cédula + 001.

Response

Veredicto de validación

rucstring required
validoboolean required
encontradoboolean required
motivostring
degradadoboolean
fuente'sri' | 'cache'
consultadoAtstring date-time required
advertenciasstring[] required

Changes

No recorded changes to this operation across all 2 revisions of this API.