Guía · Ecuador · Consulta por RUC

API de datos de empresas de Ecuador: consulte una sociedad por RUC

Un cliente escribe un RUC ecuatoriano o las primeras letras de una razón social, y su formulario completa el nombre, la forma jurídica, el estado, el cantón y el código de actividad CIIU a partir del listado de la Superintendencia de Compañías, Valores y Seguros (SCVS), unido con el registro tributario del Servicio de Rentas Internas (SRI). Una sola clave y la misma estructura de respuesta que en los demás países que cubre la API.

Qué obtiene y qué no

Registros de sociedades del listado de compañías de la Superintendencia de Compañías, Valores y Seguros (SCVS), el directorio del Ranking de Compañías, que se reescribe cada día, unido por el RUC con el Catastro RUC del Servicio de Rentas Internas (SRI), los datos abiertos del organismo tributario, una instantánea mensual de fin de mes: razón social, forma jurídica, estado, cantón y provincia, fecha de inicio de actividades y código de actividad CIIU. Solo las sociedades del listado de la SCVS, en sus nueve formas: anónima, sociedad por acciones simplificada, responsabilidad limitada, sucursal extranjera, economía mixta, anónima en predios rústicos, anónima multinacional andina, comandita por acciones y anónima de desarrollo agropecuario. Las asociaciones o consorcios y toda persona natural nunca se sirven, y los bancos, las aseguradoras, las cooperativas y las empresas públicas, que supervisan otros organismos, no están en el listado.

El RUC (Registro Único de Contribuyentes), de 13 dígitos, es el número de la sociedad y a la vez su número tributario: no hay un número de IVA aparte y una búsqueda por vat se rechaza. Las fuentes no traen dirección postal (la ciudad es el cantón y la región la provincia del establecimiento principal; la parroquia está en registry_details), capital social, administradores, socios, accionistas ni contactos.

El estado es el del RUC de la sociedad ante el SRI: activo, suspendido o cancelado (PASIVO, un RUC cancelado y no una disolución judicial). La lista de la SCVS no trae un estado de disolución ni de liquidación, así que una sociedad en liquidación se lee de la marca legal «en liquidación» de su nombre (company_name sin la marca; name_as_registered conserva el nombre publicado). Una sociedad que el archivo del SRI todavía no lista, por ejemplo una inscrita desde la última instantánea, se sirve sin estado (status null y local_status unknown; en liquidación, si su nombre lleva la marca), y sin fecha de inicio ni actividad hasta que una instantánea la incluya. founding_date y registration_date son el inicio de actividades en el SRI, no la fecha de constitución; dissolution_date es la fecha en que se suspendió el RUC cancelado. El código de actividad es el CIIU Rev. 4 con la extensión nacional de Ecuador (esquema EC-CIIU-4, una letra y seis dígitos), con su título en castellano; la clase NACE Rev. 2, o solo la división NACE, se deriva de él a través de la ISIC Rev. 4 cuando las tablas oficiales lo permiten, y nace_derived lo marca. La edad de la empresa se cuenta desde el inicio de actividades.

La llamada

# por RUC (13 dígitos)
curl -H "Authorization: Bearer rk_live_..." "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=1790016919001&country=EC"

# por nombre, para un campo con autocompletado
curl -H "Authorization: Bearer rk_live_..." "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=corporacion%20favorita&country=EC"

# una lista de hasta 100 en una llamada, cada elemento cuenta como una solicitud
curl -X POST "https://api.prometiam.com/functions/v1/risk-api/companies/lookup" -H "Authorization: Bearer rk_live_..." -H "Content-Type: application/json" -d '{"items":[{"country":"EC","company_number":"1790016919001"}]}'

La búsqueda devuelve el id del registro; páselo al endpoint de detalle, GET /companies/ seguido del id. Una búsqueda o un registro de sociedad cuesta 1 crédito.

Qué contiene un registro ecuatoriano

Campo	Qué contiene para Ecuador
company_number	El RUC, de 13 dígitos, por ejemplo `1790016919001`.
company_name	La razón social tal como la lista la Superintendencia, sin la marca «en liquidación»; `registry_details.name_as_registered` conserva el nombre publicado.
legal_form	Una de las nueve formas societarias del listado.
status	Activo, suspendido o cancelado (el estado del RUC ante el SRI) o en liquidación (la marca del nombre). Una sociedad que el archivo del SRI todavía no lista se sirve sin estado (`status` null y `local_status` `unknown`).
founding_date, registration_date, dissolution_date	El inicio de actividades en el SRI, que no es la fecha de constitución, y la fecha en que se suspendió un RUC cancelado.
city, region	El cantón y la provincia del establecimiento principal; la parroquia está en `registry_details`. No hay dirección postal.
activity_code, activity_code_scheme, activity_description	El CIIU Rev. 4 con la extensión nacional de Ecuador, esquema `EC-CIIU-4`, y su título en castellano; la clase NACE se deriva de él y `nace_derived` lo marca.

Eventos de cambio en el registro y monitoreo

Ecuador tiene eventos de cambio en el registro y monitoreo de sociedades desde su lanzamiento. Se escribe un evento cuando cambian el nombre, el estado, la forma jurídica o el cantón (la ciudad) de una sociedad en los datos del registro, y se fecha cuando el cambio aparece por primera vez allí; no hay eventos anteriores al lanzamiento de Ecuador, y los primeros llegan con la próxima instantánea mensual del SRI, publicada alrededor del día 1. Las fuentes no traen dirección postal ni capital social, así que no hay eventos de dirección ni de capital. Las alertas de monitoreo saltan por cambio de estado, disolución, coincidencia de sanciones y estos eventos, con los mismos endpoints de monitoreo que en los demás países. La primera vez que una sociedad monitoreada obtiene un estado, se genera una alerta de estado. Una llamada de eventos cuesta 2 créditos.

Qué no incluye Ecuador

Administradores, socios, accionistas y contactos. No están en las fuentes.
Dirección postal y capital social. Las fuentes traen el cantón, la provincia y la parroquia, no la calle, y no traen capital social.
Número de IVA. El RUC es el número tributario; no se entrega un número de IVA y una búsqueda por vat se rechaza.
Estados financieros y avisos de insolvencia. No se sirven; Ecuador no es uno de los dieciséis mercados de insolvencia, y una liquidación o la cancelación de un RUC se ven en el estado.
Asociaciones o consorcios, personas naturales, bancos, aseguradoras, cooperativas y empresas públicas. Nunca se sirven o no están en el listado, así que la consulta de una de ellas no devuelve nada aunque exista.

Preguntas frecuentes

¿Cómo consulto una sociedad ecuatoriana por RUC desde una API?
Llame a GET /companies/search?company_number=1790016919001&country=EC. El RUC tiene 13 dígitos, un tercer dígito 9 (sociedad privada) o 6 (pública) y termina en 001. Un valor de 12 dígitos se lee con el cero de la provincia restituido. Un valor sin esa forma, o con un tercer dígito de 0 a 5 (el RUC de una persona natural), da un error de validación 400. El dígito verificador es solo una guía.

¿Qué sociedades ecuatorianas se incluyen?
Las sociedades del listado de la Superintendencia de Compañías, Valores y Seguros, en sus nueve formas: anónima, sociedad por acciones simplificada, responsabilidad limitada, sucursal extranjera, economía mixta, anónima en predios rústicos, anónima multinacional andina, comandita por acciones y anónima de desarrollo agropecuario. Las asociaciones o consorcios y toda persona natural nunca se sirven, y los bancos, las aseguradoras, las cooperativas y las empresas públicas, que supervisan otros organismos, no están en el listado.

¿Qué significa el estado?
Es el estado del RUC de la sociedad ante el SRI: activo, suspendido o cancelado (PASIVO), que no es una disolución judicial. Una sociedad en liquidación se lee de la marca «en liquidación» de su nombre. Una sociedad que el archivo del SRI todavía no lista se sirve sin estado (status null y local_status unknown).

¿Qué código de actividad trae?
El CIIU Rev. 4 con la extensión nacional de Ecuador (esquema EC-CIIU-4, una letra y seis dígitos), con su título en castellano. La clase NACE Rev. 2, o solo su división, se deriva a través de la ISIC Rev. 4 cuando las tablas oficiales lo permiten, y nace_derived lo marca.

¿Qué es la fecha de inicio?
El inicio de actividades en el SRI, que no es la fecha de constitución. La fecha de disolución de una sociedad con el RUC cancelado es la fecha en que se suspendió ese RUC.

¿Incluye administradores, dirección o número de IVA?
No. No hay administradores, socios, accionistas ni contactos, ni dirección postal (solo el cantón y la provincia), ni capital social. El RUC es el número tributario, así que no hay un número de IVA aparte y una búsqueda por vat se rechaza.

¿Cada cuánto se actualiza?
Mensualmente: el SRI publica su instantánea de fin de mes alrededor del día 1, y el listado de la Superintendencia se reescribe cada día.

¿Hay eventos de cambio en el registro y monitoreo?
Sí, desde el lanzamiento de Ecuador: cambios de nombre, estado, forma jurídica y cantón, y monitoreo con POST /monitor. No hay eventos anteriores al lanzamiento, y los primeros llegan con la próxima instantánea mensual del SRI.

Empiece su prueba gratuita de 14 días Leer la documentación

Relacionado

Fuentes oficiales: Ranking de Compañías, Superintendencia de Compañías, Valores y Seguros y Datos abiertos, Servicio de Rentas Internas.

Contains data from the Superintendencia de Companias, Valores y Seguros (SCVS) of Ecuador, company directory of the Ranking de Companias (https://appscvsmovil.supercias.gob.ec/ranking/), and from the Servicio de Rentas Internas (SRI) of Ecuador, Catastro RUC open data (https://www.sri.gob.ec/datos-abiertos), which the SRI publishes under a Creative Commons Attribution (CC BY) licence. Adapted by Prometiam (joined on the RUC, status derived); not an official register extract.