resolve_companies
Rapprochement EN LOT de fiches mal identifiées (CRM, tableur, export CSV) vers leur SIREN.
À utiliser pour une LISTE de sociétés à identifier ("retrouve les SIREN de ces 200 clients"). Pour UNE société cherchée par son nom, search_companies, qui rend des résultats classés ; celui-ci rend une décision, et refuse de trancher quand il n'est pas sûr.
Chaque fiche revient avec un status :
resolved : SIREN certain.
review : plusieurs candidats plausibles ou nom trop générique ; les candidats sont retournés et le choix revient à l'utilisateur.
no_match : aucune correspondance.
reason explique un review : ambiguous_candidates, weak_name_overlap, shared_domain (site partagé par un réseau ; domain_company_count dit combien de sociétés, fournir un nom ou un code postal), missing_name, invalid_domain, domain_no_match, lookup_failed (panne à rejouer, PAS une absence de correspondance).
Conseils : domain (domaine ou URL) résout seul quand il désigne une seule société. Le code postal double quasiment le taux de rapprochement. Un mot en trop dans le nom ("Carrefour Massy") nuit plus qu'un nom tronqué. Un siren, siret ou numéro de TVA français est résolu sans recherche.
COÛT : 1 appel de quota par fiche soumise, quelle que soit sa forme.
Retourne results[] (ordre d'entrée, avec l'id fourni) et summary{total, resolved, review, no_match}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| records | Yes | Fiches à rapprocher, 200 maximum par appel | |
| shared_domain | No | Domaine porté par plusieurs sociétés : review (défaut) rend les candidats ; head rapproche vers la maison mère (groupe dominant, sinon plus gros CA), method=domain_head, confiance basse. Réserver aux colonnes d'enseignes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes | ||
| summary | Yes | ||
| _user_plan | No | ||
| _credits_remaining | No | ||
| _quota_remaining_month | No | ||
| _quota_remaining_today | No |