Guide · Équateur · Consultation par RUC

API de données d'entreprises d'Équateur : consultez une société par RUC

Un client saisit un RUC équatorien ou les premières lettres d'une raison sociale, et votre formulaire complète le nom, la forme juridique, le statut, le canton et le code d'activité CIIU à partir de la liste de la Superintendencia de Compañías, Valores y Seguros (SCVS), jointe au registre fiscal du Servicio de Rentas Internas (SRI). Une seule clé et la même structure de réponse que dans les autres pays couverts par l'API.

Ce que vous obtenez, et ce que vous n'obtenez pas

Fiches de sociétés de la liste des compagnies de la Superintendencia de Compañías, Valores y Seguros (SCVS), l'annuaire du Ranking de Compañías, réécrit chaque jour, jointe par le RUC au Catastro RUC du Servicio de Rentas Internas (SRI), les données ouvertes de l'administration fiscale, un instantané mensuel de fin de mois : raison sociale, forme juridique, statut, canton et province, date de début d'activité et code d'activité CIIU. Seules les sociétés de la liste de la SCVS, sous ses neuf formes : 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 et anónima de desarrollo agropecuario. Les associations ou consortiums et toute personne physique ne sont jamais servis, et les banques, les assureurs, les coopératives et les entreprises publiques, que d'autres autorités supervisent, ne figurent pas dans la liste.

Le RUC (Registro Único de Contribuyentes), de 13 chiffres, est le numéro de la société et en même temps son numéro fiscal : il n'y a pas de numéro de TVA distinct et une recherche par vat est refusée. Les sources n'ont pas d'adresse postale (la ville est le canton et la région la province de l'établissement principal ; la paroisse est dans registry_details), ni capital social, dirigeants, associés, actionnaires ou contacts.

Le statut est celui du RUC de la société auprès du SRI : actif, suspendu ou radié (PASIVO, un RUC annulé et non une dissolution judiciaire). La liste de la SCVS n'a ni statut de dissolution ni statut de liquidation : une société en liquidation se lit donc dans la mention légale « en liquidación » de son nom (company_name sans la mention ; name_as_registered conserve le nom publié). Une société que le fichier du SRI ne liste pas encore, par exemple une société inscrite depuis le dernier instantané, est servie sans statut (status null et local_status unknown ; en liquidation si son nom porte la mention), sans date de début ni activité tant qu'un instantané ne l'inclut pas. founding_date et registration_date sont le début d'activité au SRI, non la date de constitution ; dissolution_date est la date à laquelle le RUC annulé a été suspendu. Le code d'activité est la CIIU Rév. 4 avec l'extension nationale de l'Équateur (schéma EC-CIIU-4, une lettre et six chiffres), avec son titre en espagnol ; la classe NACE Rév. 2, ou seulement la division NACE, en est dérivée par la CITI Rév. 4 (ISIC) là où les tables officielles le permettent, et nace_derived l'indique. L'âge de l'entreprise est compté depuis le début d'activité.

L'appel

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

# par nom, pour un champ avec saisie semi-automatique
curl -H "Authorization: Bearer rk_live_..." "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=corporacion%20favorita&country=EC"

# une liste de 100 au plus en un appel, chaque élément compte comme une requête
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 recherche renvoie l'id de la fiche ; passez-le au endpoint de détail, GET /companies/ suivi de l'id. Une recherche ou une fiche de société coûte 1 crédit.

Ce que contient une fiche équatorienne

Champ	Ce qu'il contient pour l'Équateur
company_number	Le RUC, de 13 chiffres, par exemple `1790016919001`.
company_name	La raison sociale telle que la liste la Superintendencia, sans la mention « en liquidación » ; `registry_details.name_as_registered` conserve le nom publié.
legal_form	L'une des neuf formes de sociétés de la liste.
status	Actif, suspendu ou radié (l'état du RUC auprès du SRI) ou en liquidation (la mention du nom). Une société que le fichier du SRI ne liste pas encore est servie sans statut (`status` null et `local_status` `unknown`).
founding_date, registration_date, dissolution_date	Le début d'activité au SRI, qui n'est pas la date de constitution, et la date à laquelle un RUC annulé a été suspendu.
city, region	Le canton et la province de l'établissement principal ; la paroisse est dans `registry_details`. Pas d'adresse postale.
activity_code, activity_code_scheme, activity_description	La CIIU Rév. 4 avec l'extension nationale de l'Équateur, schéma `EC-CIIU-4`, et son titre en espagnol ; la classe NACE en est dérivée et `nace_derived` l'indique.

Événements de changement au registre et surveillance

L'Équateur a des événements de changement au registre et la surveillance des sociétés dès son lancement. Un événement est écrit quand le nom, le statut, la forme juridique ou le canton (la ville) d'une société change dans les données du registre, et il est daté du jour où le changement y apparaît pour la première fois ; il n'y a pas d'événements antérieurs au lancement de l'Équateur, et les premiers arrivent avec le prochain instantané mensuel du SRI, publié vers le 1er. Les sources n'ont ni adresse postale ni capital social : il n'y a donc pas d'événements d'adresse ni de capital. Les alertes de surveillance se déclenchent sur un changement de statut, une dissolution, une correspondance de sanctions et ces événements, par les mêmes endpoints de surveillance que dans les autres pays. La première fois qu'une société surveillée obtient un statut, une alerte de statut est déclenchée. Un appel d'événements coûte 2 crédits.

Ce que l'Équateur ne fournit pas

Dirigeants, associés, actionnaires et contacts. Ils ne figurent pas dans les sources.
Adresse postale et capital social. Les sources donnent le canton, la province et la paroisse, pas la rue, et aucun capital social.
Numéro de TVA. Le RUC est le numéro fiscal ; aucun numéro de TVA n'est fourni et une recherche par vat est refusée.
États financiers et avis d'insolvabilité. Ils ne sont pas servis ; l'Équateur n'est pas l'un des seize marchés d'insolvabilité, et une liquidation ou l'annulation d'un RUC se voient dans le statut.
Associations ou consortiums, personnes physiques, banques, assureurs, coopératives et entreprises publiques. Ils ne sont jamais servis ou ne figurent pas dans la liste, donc la recherche de l'un d'eux ne renvoie rien même s'il existe.

Questions fréquentes

Comment consulter une société équatorienne par RUC depuis une API ?
Appelez GET /companies/search?company_number=1790016919001&country=EC. Le RUC a 13 chiffres, un troisième chiffre 9 (société privée) ou 6 (publique) et finit par 001. Une valeur de 12 chiffres est lue avec le zéro de la province rétabli. Une valeur qui n'a pas cette forme, ou dont le troisième chiffre est de 0 à 5 (le RUC d'une personne physique), donne une erreur de validation 400. Le chiffre de contrôle n'est qu'un repère.

Quelles sociétés équatoriennes sont incluses ?
Les sociétés de la liste de la Superintendencia de Compañías, Valores y Seguros, sous ses neuf formes : 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 et anónima de desarrollo agropecuario. Les associations ou consortiums et toute personne physique ne sont jamais servis, et les banques, les assureurs, les coopératives et les entreprises publiques, que d'autres autorités supervisent, ne figurent pas dans la liste.

Que signifie le statut ?
C'est l'état du RUC de la société auprès du SRI : actif, suspendu ou radié (PASIVO), ce qui n'est pas une dissolution judiciaire. Une société en liquidation se lit dans la mention « en liquidación » de son nom. Une société que le fichier du SRI ne liste pas encore est servie sans statut (status null et local_status unknown).

Quel code d'activité est fourni ?
La CIIU Rév. 4 avec l'extension nationale de l'Équateur (schéma EC-CIIU-4, une lettre et six chiffres), avec son titre en espagnol. La classe NACE Rév. 2, ou seulement sa division, en est dérivée par la CITI Rév. 4 (ISIC) là où les tables officielles le permettent, et nace_derived l'indique.

Qu'est-ce que la date de début ?
Le début d'activité au SRI, qui n'est pas la date de constitution. La date de dissolution d'une société dont le RUC est annulé est la date à laquelle ce RUC a été suspendu.

Les dirigeants, l'adresse ou le numéro de TVA sont-ils inclus ?
Non. Il n'y a ni dirigeants, associés, actionnaires ou contacts, ni adresse postale (seulement le canton et la province), ni capital social. Le RUC est le numéro fiscal : il n'y a donc pas de numéro de TVA distinct et une recherche par vat est refusée.

À quelle fréquence les données sont-elles mises à jour ?
Chaque mois : le SRI publie son instantané de fin de mois vers le 1er, et la liste de la Superintendencia est réécrite chaque jour.

Y a-t-il des événements de changement au registre et une surveillance ?
Oui, dès le lancement de l'Équateur : changements de nom, de statut, de forme juridique et de canton, et surveillance avec POST /monitor. Il n'y a pas d'événements antérieurs au lancement, et les premiers arrivent avec le prochain instantané mensuel du SRI.

Démarrez votre essai gratuit de 14 jours Lire la documentation