Valida la estructura de un RUC peruano: 11 digitos, prefijo vigente y digito verificador segun el algoritmo modulo 11 de SUNAT.

Es una comprobacion aritmetica y offline: NO consulta ninguna base de datos. Un RUC valido aqui puede aun asi no existir en SUNAT o estar de baja; para eso usa consultar_ruc.

Consulta un RUC en el Padron Reducido local: razon social, estado del contribuyente, condicion de domicilio, ubigeo y direccion fiscal.

Requiere haber construido el indice con python scripts/ingest.py. La consulta es local: el RUC no se envia a ningun servicio externo.

Busca contribuyentes cuya razon social coincida con texto.

Por defecto busca por PREFIJO, resuelto como un rango sobre el indice (milisegundos). Para buscar por subcadena antepone '%' al texto (p. ej. '%ANDES'), pero eso recorre los ~18 millones de registros y puede tardar decenas de segundos. La comparacion ignora mayusculas y minusculas.

Devuelve la procedencia del indice local: URL de origen, checksum SHA-256 del ZIP, fecha de publicacion de SUNAT, fecha de ingesta y numero de registros.

Sirve para saber que tan actualizado esta el dato antes de confiar en el.