Mettez votre base clients au niveau de la facture électronique
« Voici mon export clients, complète et corrige SIREN, SIRET et TVA. » Avec la facture électronique, le SIREN du client devient une mention obligatoire, et les factures sont acheminées par SIREN et SIRET. Mes clients sont-ils tous identifiés comme la facture l'exige ? Lesquels ont un SIREN faux, absent ou périmé, ou un numéro de TVA qui ne passe pas ? Collez votre export clients dans Claude, tel qu'il sort de votre logiciel, et posez la question : chaque ligne revient à son rang, complétée et vérifiée, et rien n'est choisi à votre place.
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/identite/lot
Ce que Claude appelle, et ce qu'il lit
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 :
- le rang de la ligne dans votre fichier et ce qui a été lu :
siren,siret,tvaounom_cp; le nom saisi n'est jamais recopié ; - la résolution, en liste fermée :
resolu,a_confirmer,introuvable,siren_invalide,siren_inconnu,non_diffusible; - pour une ligne résolue : le SIREN, le SIRET du siège, la dénomination, l'état (
actifoucesse, avec la date de cessation quand elle est publiée) et l'adresse du siège ; - la TVA : le numéro calculé depuis le SIREN et son statut au VIES au moment de l'appel,
valide,invalide,indisponibleounon_verifie; un VIES qui ne répond pas donneindisponible, jamaisinvalide; - un nom ambigu revient
a_confirmeravec au plus 5 candidats classés par score ; une ligne qui désigne une entreprise déjà vue plus haut portedoublon_de, le rang de la première.
Un nom n'est résolu que si une seule entreprise porte ce nom (dénomination, nom usuel ou sigle) à ce code postal, toutes les étapes de l'index lues. Sinon la ligne revient à confirmer, avec ses candidats, ou introuvable : jamais un choix silencieux.
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 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. Ces cinq lignes tiennent dans un appel du quota gratuit d'un compte vérifié ; hors quota, elles coûtent 0,015 €.
| Ligne | Ce qu'elle porte | Ce qui revient |
|---|---|---|
| 1 | 552032534, un SIREN | resolu, actif, SIRET du siège, numéro de TVA valide au VIES |
| 2 | 55203253400711, le SIRET d'un autre établissement de la même société | resolu, doublon_de 1 |
| 3 | FR48056200454, un numéro de TVA | resolu, cesse (cessation du 05/11/2012), TVA non_verifie (entreprise_cessee) |
| 4 | AIR LIQUIDE CO2 EUROPE et 75007, un nom et un code postal | resolu sur le SIREN 662027374, actif, SIRET du siège, numéro de TVA valide au VIES |
| 5 | QXZJW VKPRT et 33000, un nom inventé | introuvable |
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 lue à temps le dit (
etages_abandonnes) et n'est jamaisresolu; 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_indisponibleoubudget_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 que la route ne fait pas
Elle ne crée ni ne vérifie aucune inscription à l'annuaire de la facturation électronique : Sirenic n'est pas une plateforme agréée, la route prépare votre base, elle n'émet aucune facture. Elle ne choisit jamais entre deux homonymes. Un nom de personne physique n'est jamais résolu : un entrepreneur individuel n'est pas servi comme candidat, et sa ligne par SIREN revient sans nom ni adresse.
Ce que coûte un export
Jusqu'à 50 lignes par appel, le lot entre dans le quota gratuit des comptes vérifiés : un des 150 appels gratuits du mois, aucun crédit débité, et les cinq lignes de l'exemple n'y coûtent rien. Au-delà de 50 lignes, ou hors quota, 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, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. 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, sur 105 routes sur 121 (la grille dit lesquelles), 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
| Route | Prix | Exemple | Ce qu'elle rend |
|---|---|---|---|
/v1/identite/lot | 0,003 € / entité | exemple gratuit | Identité en lot pour les fichiers clients et les bases CRM françaises : 2 à 300 lignes par appel, chacune un SIREN, un SIRET, un numéro de TVA français ou un couple nom|code postal, dans l'ordre du fichier. Par ligne : résolution (resolu, a_confirmer avec jusqu'à 5 candidats classés, introuvable, siren_invalide, siren_inconnu, non_diffusible), SIREN, SIRET du siège, état et date de cessation, adresse, numéro de TVA vérifié en direct au VIES (indisponible ou budget_vies_epuise, jamais un faux invalide), doublons signalés. Les noms saisis ne sont jamais recopiés. 0,003 € par ligne, 0,90 € au plus. |
/v1/entreprise/{siren}/facturation-prep | 0,02 € | exemple gratuit | Entrée en relation fournisseur : PRÉPAREZ une facture électronique française conforme à l'obligation de facturation électronique de septembre 2026 (réception obligatoire pour toute entreprise assujettie à la TVA ; émission par étapes, GE/ETI en 2026, PME en 2027) : dénomination et forme juridique, statut, numéro de TVA intracommunautaire calculé (avec le pointeur VIES), établissements (SIRET) avec leurs adresses, code NAF, dates d'obligation indicatives. Préparation uniquement - Sirenic n'est pas une plateforme agréée (PDP), n'accède jamais à l'annuaire central et n'émet ni ne route jamais de factures. |
/v1/tva/verifier/{numero} | 0,003 € | exemple gratuit | Validation de TVA européenne contre le service officiel VIES : validez n'importe quel numéro de TVA intracommunautaire (tous les États membres) pour la conformité et la due diligence. Ce contrôle d'identifiant fiscal est le volet fiscal de « vérifier un fournisseur avant paiement », et un contrôle exigé par l'obligation de facturation électronique de septembre 2026 en France. Renvoie un statut valide/invalide/indisponible avec l'identifiant de consultation VIES comme preuve. Nom et adresse servis seulement au titulaire que la forme de son numéro ou le registre de son pays prouve personne morale ; sinon omis, comptés dans ecartes. |
Sirenic n'est pas une plateforme de dématérialisation partenaire (PDP), n'accède jamais à l'annuaire central, et n'émet, ne transmet ni ne route aucune facture.
Questions fréquentes
Mon export n'a que des raisons sociales : ça marche ?
Oui, avec le code postal du siège : écrivez la ligne nom|code postal. La règle, cas par cas : une seule entreprise trouvée à ce code postal, toutes les étapes de l'index lues, personne morale dont la fiche est publique et dont la dénomination, la dénomination usuelle ou le sigle est le nom saisi, nettoyé : resolu ; la même entreprise seule, sous un autre nom : a_confirmer, cette entreprise en candidat unique ; plusieurs entreprises trouvées, ou des entreprises trouvées avec une étape de l'index non lue à temps, ou trouvées seulement en tolérant les fautes de frappe : a_confirmer, avec, en candidats, les personnes morales trouvées dont la fiche est publique ; une seule entreprise trouvée, qui n'est pas une personne morale dont la fiche est publique : a_confirmer, sans candidat servi ; aucune entreprise trouvée : introuvable, avec les étapes de l'index non lues, s'il y en a. Mesuré le 08/10/2026 : deux noms saisis avec leur code postal sont revenus a_confirmer, chacun avec une seule entreprise trouvée sous un autre nom, en candidat unique ; aucun SIREN choisi. Sur des noms souvent ambigus, l'outil conseille 50 lignes par appel : chaque ligne à confirmer porte ses candidats.
Et l'annuaire de la facturation électronique ?
La route ne le lit pas et n'y inscrit rien : il est réservé aux plateformes agréées. Elle vous donne le SIREN et le SIRET du siège, les identifiants par lesquels les factures sont acheminées ; pour préparer une facture client par client, voyez la préparation de facture au tableau des routes.
Mon équipe commerciale a la même base dans son CRM ?
La même route y répond, avec la même réponse : la page « Enrichissez et nettoyez votre CRM » part de la question d'avant une campagne, sociétés cessées et doublons.
Passer à l'action
Aucun compte à créer, aucune clé à demander : la première étape est gratuite et vous montre exactement ce que vous achèteriez.
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