Préparer sa base clients à la facture électronique

Avec la facture électronique, le SIREN du client devient une mention obligatoire. Préparer sa base, c'est retrouver pour chaque client son SIREN, le SIRET du siège, son état et son numéro de TVA avec son statut au VIES, doublons 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

« Voici mon export clients, complète et corrige SIREN, SIRET et TVA. » Les factures électroniques 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.

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, tva ou nom_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 (actif ou cesse, 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, ou d'une vérification de moins d'une heure gardée en cache (valide, invalide, indisponible ou non_verifie) ; un VIES qui ne répond pas donne indisponible, jamais invalide ;
• un nom ambigu revient a_confirmer avec au plus 5 candidats classés par score ; une ligne qui désigne une entreprise déjà vue plus haut porte doublon_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, 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 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 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 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

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

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 « Nettoyer un fichier clients par SIRET » part de la question d'avant une campagne, sociétés cessées et doublons.

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

• Nettoyer un fichier clients par SIRET
• Préparer son référentiel fournisseurs pour la facturation électronique
• Vérifier un numéro de TVA intracommunautaire

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