Nettoyer un fichier clients par SIRET

Nettoyer un fichier clients par SIRET, c'est rattacher chaque ligne à son entreprise : SIREN (les neuf premiers chiffres du SIRET), SIRET du siège, état et numéro de TVA. Sociétés cessées, doublons et SIREN à clé fausse sont signalés. Sans coder : notre modèle Google Sheets ou l'écran de dépôt.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/identite/lot

Sans coder : le modèle Google Sheets ou l'écran de dépôt

Deux façons de compléter votre fichier sans écrire de code, par la même route, /v1/identite/lot. Chacune lit dans vos colonnes le SIREN, le SIRET, le numéro de TVA français, ou le nom et le code postal de chaque ligne, n'envoie que cela, et ajoute à droite ses propres colonnes, toutes préfixées sirenic_ : la résolution, le SIREN, le SIRET du siège, l'état, le numéro de TVA et son statut au VIES, les doublons sur tout le fichier et les lignes à revoir. Chaque appel envoie au plus les lignes qu'un appel gratuit admet ; au-delà du quota gratuit du mois, il se paie sur vos crédits. Une ligne complétée ne repart jamais au complètement, sauf si son entrée change.

• Le modèle Google Sheets. Ouvrez votre fichier dans Google Sheets, puis Extensions, Apps Script : remplacez le contenu de Code.gs par le code du modèle, enregistrez et rechargez le classeur. Dans le menu Sirenic : « Saisir ma clé » (la clé est gardée hors des cellules), puis « Compléter le fichier ». Le mode d'emploi dit chaque colonne et chaque erreur. Pas encore de clé : créer un compte.
• L'écran de dépôt. Dans votre compte, l'onglet Fichier clients lit un CSV ou un classeur .xlsx dans votre navigateur : n'en sortent que le SIREN, le SIRET, le numéro de TVA, ou le nom et le code postal de chaque ligne. Le plan dit les appels et le coût avant le premier appel, rien ne part sans votre clic, et le fichier complété revient en CSV ; l'écran dit lui-même la taille au plus d'un fichier, en lignes et en mégaoctets. Pas encore de compte : le créer.
• Les deux proposent ensuite « Ce qui a changé depuis ma dernière passe » : les lignes résolues repartent avec la date de leur dernière lecture (section « Ce qui a changé depuis votre dernière passe », plus bas).

Ce que Claude appelle, et ce qu'il lit

« Enrichis et nettoie ma base CRM : SIREN, TVA, adresse, cessés et doublons. » Une base CRM vieillit sans bruit : des sociétés cessent leur activité, d'autres déménagent, et la même entreprise finit saisie deux fois. Quelles fiches désignent une société cessée, ou la même société deux fois ? Et pour les autres, quels sont le SIREN, l'adresse du siège et le numéro de TVA ? Avant une campagne, collez l'export des comptes dans Claude et posez la question : chaque fiche revient à son rang, les cessées et les doublons signalés, et un nom ambigu revient avec ses candidats plutôt qu'avec un choix fait à votre place.

Claude lit l'export et en tire une ligne par fiche : le SIREN, le SIRET, le numéro de TVA français, ou le couple nom et code postal quand la ligne n'a pas d'identifiant. Il appelle l'outil get_french_company_identity_batch, qui sert la route /v1/identite/lot, de 2 à 150 lignes par appel de l'outil (la route en prend 300 : un lot plein passe en 2 appels de l'outil). Pour chaque ligne, la réponse donne :

• les cessées : l'état au répertoire Sirene, actif ou cesse, et pour une société cessée la date de cessation quand elle est publiée ; son numéro de TVA n'est pas soumis au VIES (non_verifie, entreprise_cessee) ;
• les doublons : une ligne qui désigne une entreprise déjà vue plus haut, par son SIREN, le SIRET de l'un de ses établissements, sa TVA ou son nom, porte doublon_de, le rang de la première ; la tête du lot compte les doublons ;
• pour une ligne résolue : le SIREN, le SIRET du siège, la dénomination, l'adresse du siège, le numéro de TVA et son statut au VIES (valide, invalide, indisponible, non_verifie) ;
• la résolution, en liste fermée (resolu, a_confirmer, introuvable, siren_invalide, siren_inconnu, non_diffusible) ; un nom ambigu revient a_confirmer avec au plus 5 candidats classés par score ;
• le rang de la ligne et ce qui a été lu ; le nom saisi n'est jamais recopié.

La route dit quelle ligne double quelle autre et quelle société a cessé ; elle ne touche pas à votre CRM. La fusion et l'archivage restent les vôtres.

Un export de cinq lignes

Cinq lignes neutres, une par forme d'entrée, tirées de notre jeu de référence de sociétés : la deuxième double la première (un autre établissement de la même société), la troisième désigne une société cessée, la dernière est un nom inventé. Aucune donnée de client.

Ce qui revient a été relevé le 09/10/2026 par notre clé de test, dans Claude, sur le stock Sirene du 01/10/2026 ; le statut VIES est celui du moment de l'appel, ou d'une vérification de moins d'une heure gardée en cache. Ces cinq lignes tiennent dans les 100 lignes gratuites du mois d'un compte vérifié ; hors du gratuit, elles coûtent 0,015 €.

Les limites, mesurées

• La TVA est vérifiée en direct au VIES, ligne par ligne, une à la fois : aux heures ouvrées, le VIES sert un verdict toutes les 4 à 5 s et refuse la concurrence ; avant la vérification en pipeline, un lot plein n'a vérifié que 15 de ses 262 lignes résolues ; avec elle, hors heures ouvrées (23:51 UTC), 105 de ses 265 ; mesures du 08/10/2026. Une ligne dont la vérification n'a pu partir à temps le dit (non_verifie, budget_vies_epuise) : relancez ces lignes dans un lot plus petit, ou hors des heures ouvrées.
• Le lot dispose de 60 s, dont 40 s pour retrouver les noms. Une ligne par nom dont une étape de l'index n'a pu être servie (délai dépassé, ou aucun index pour la servir) le dit (etages_abandonnes) et n'est jamais resolu ; la tête du lot les compte. Sur le lot plein de 300 noms du 08/10/2026 (23:51 UTC), 9 lignes sur 300 l'ont dit.
• La date de cessation se lit en direct, pour les seules lignes cessées ; quand elle manque, la ligne dit pourquoi : non_publiee, source_indisponible ou budget_lot_epuise.
• De 2 à 300 lignes par appel ; la ligne de requête est bornée à 11 000 octets, soit 300 SIREN ou environ 148 noms de 63 caractères ; au-delà, un refus requete_trop_large ; au-delà d'environ 16 Ko, un 431 sans corps ; ni l'un ni l'autre n'est facturé.

Ce qui a changé depuis votre dernière passe

« Qu'est-ce qui a changé chez ces clients depuis ma dernière passe ? » Avec depuis (un jour passé ou aujourd'hui), chaque ligne resolu porte aussi changements : ce qui a changé pour sa société depuis cette date, lu par le moteur des nouveautés dans le BODACC et les stocks locaux (décisions des tribunaux de commerce, marchés publics français, établissements, cessation, agréments, listes de sanctions, certifications RGE, représentants d'intérêts). La ligne dit le verdict (nouveautes, rien_de_nouveau ou lecture_incomplete), les totaux par type, les trois derniers faits, la fenêtre réellement lue et lecture_complete ; une ligne non résolue ou non diffusible dit pourquoi elle n'en porte pas (motif_sans_changements).

• Prix : 0,01 € la ligne avec depuis au lieu de 0,003 €, toute ligne au prix de l'appel ; le quota gratuit des comptes vérifiés vaut avec ou sans depuis.
• L'outil get_french_company_identity_batch en lit 20 lignes par appel avec depuis (la route en prend 300) ; le lot dispose alors de 90 s.
• Une panne du BODACC sur une ligne y est dite (lecture_complete faux, le bloc nommé dans blocs_incomplets) ; un lot dont aucune ligne n'a pu lire le BODACC est refusé, sans facturation.
• Les marchés publics européens et la propriété industrielle ne sont pas lus dans le lot : la route /v1/entreprise/{siren}/nouveautes les lit, une société à la fois. Les dirigeants ne sont jamais servis.

Ce que la route ne fait pas

Elle n'ajoute aucun contact : ni adresse électronique, ni téléphone, ni contact nominatif ; ces données ne sont pas dans les registres officiels. Elle ne modifie rien dans votre CRM. Elle ne contrôle pas l'établissement d'un SIRET : elle en lit le SIREN, ses neuf premiers chiffres, et rend l'état de l'entreprise et le SIRET de son siège. Elle ne choisit jamais entre deux homonymes. Un entrepreneur individuel n'est jamais servi comme candidat, et sa ligne par SIREN revient sans nom ni adresse.

Ce que coûte un nettoyage

Un compte vérifié a 100 lignes gratuites par mois sur le lot, hors de ses 150 appels gratuits, aucun crédit débité : les cinq lignes de l'exemple n'y coûtent rien. Un lot qui dépasse le reste du mois se paie en entier. Au-delà, ou hors du gratuit, le lot est facturé 0,003 € par ligne, doublons compris : 0,015 € pour les cinq lignes de l'exemple, 0,90 € pour un lot plein de 300 lignes, en crédits prépayés (leur recharge par carte n'est pas encore ouverte), ou en x402 pour le même montant en USDC ou en EURC. Un lot refusé ou indisponible n'est jamais facturé.

Le même lot, sans assistant

Les cinq lignes de l'exemple, encodées comme l'outil MCP les encode ; la clé d'API est lue dans la variable SIRENIC_KEY.

# Les cinq lignes de l'exemple, de 2 à 300 par appel
curl "https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3B55203253400711%3BFR48056200454%3BAIR+LIQUIDE+CO2+EUROPE%7C75007%3BQXZJW+VKPRT%7C33000" \
  -H "X-Api-Key: $SIRENIC_KEY"

# En MCP, sur le connecteur https://api.sirenic.eu/mcp/connecteur (méthode tools/call),
# la clé en en-tête Authorization: Bearer $SIRENIC_KEY, ou la connexion OAuth de Claude
{"name": "get_french_company_identity_batch", "arguments": {"lignes": ["552032534", "55203253400711", "FR48056200454", "AIR LIQUIDE CO2 EUROPE|75007", "QXZJW VKPRT|33000"]}}

Comment on paie

Chaque route se paie à l'appel, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit ; /v1/identite/lot a 100 lignes gratuites par mois, au-delà sur ses crédits. En x402, le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.

Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.

Un appel, de bout en bout

# Client x402 (npm) : le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes utilisées et prix

Questions fréquentes

Mes fiches n'ont qu'un nom et une ville : ça marche ?

Il faut le code postal du siège : la résolution par nom se fait à ce code postal. Sans lui, passez d'abord par la recherche par nom (0,002 €, dans les appels gratuits du mois), qui rend un indice de confiance, puis envoyez au lot les SIREN retrouvés.

Comment un doublon est-il repéré ?

Deux lignes qui désignent la même entreprise, quelle que soit leur forme (SIREN, SIRET d'un établissement, TVA, nom) : la seconde porte doublon_de, et seule la première porte le détail. Deux établissements d'une même société sont donc un doublon pour la route : à vous de dire s'ils sont deux comptes.

Ma base sert aussi à facturer ?

La même route y répond avec la même réponse : la page « Préparer sa base clients à la facture électronique » part de la question d'avant la première facture électronique.

Passer à l'action

La première étape est gratuite et vous montre exactement ce que vous achèteriez, sans compte ni clé ; un compte, avec sa clé d'API, ouvre ensuite le quota gratuit ; /v1/identite/lot a 100 lignes gratuites par mois, au-delà sur ses crédits.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/identite/lot Lire la référence de la route Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur

À lire ensuite

• Préparer sa base clients à la facture électronique
• Construire une liste de prospection B2B
• Surveiller un portefeuille de clients ou de fournisseurs

OpenAPI · llms.txt · Catalogue complet des routes et prix