# 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.

## 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](https://api.sirenic.eu/modeles/fichier-clients-pret.gs), 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](https://api.sirenic.eu/modeles/fichier-clients-pret-mode-d-emploi.txt) dit chaque colonne et chaque erreur. Pas encore de clé : [créer un compte](https://api.sirenic.eu/compte?utm_source=template&utm_campaign=tableur-sheets).
- **L'écran de dépôt.** Dans votre compte, l'onglet [Fichier clients](https://api.sirenic.eu/compte/fichier) 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](https://api.sirenic.eu/compte?utm_source=template&utm_campaign=ecran-fichier).
- 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 €.

| 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 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](https://api.sirenic.eu/openapi.json) et le [llms.txt](https://api.sirenic.eu/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 € · 0,01 € (avec depuis) / entité | [exemple gratuit](https://api.sirenic.eu/exemples/identite-lot.json) | Identité en lot pour les fichiers clients et les bases CRM françaises : 2 à 300 lignes (SIREN, SIRET, numéro de TVA français ou 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 contrôlé en direct au VIES (indisponible ou budget_vies_epuise, jamais un faux invalide), doublons. 0,003 € par ligne, 0,90 € au plus ; avec depuis (les changements depuis une date) 0,01 €, 3,00 € au plus. |
| `/v1/entreprise/{siren}/facturation-prep` | 0,02 € | [exemple gratuit](https://api.sirenic.eu/exemples/entreprise-siren-facturation-prep.json) | 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](https://api.sirenic.eu/exemples/tva-verifier-numero.json) | 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 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 « Nettoyer un fichier clients par SIRET » part de la question d'avant une campagne, sociétés cessées et doublons.

## Passer à l'action

- [Voir une réponse réelle (gratuit)](https://api.sirenic.eu/exemples/identite-lot.json)
- [Obtenir le devis de /v1/identite/lot](https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3BHERMES%20INTERNATIONAL%7C75008)
- [Lire la référence de la route](https://api.sirenic.eu/api)
- [Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur](https://api.sirenic.eu/compte?utm_source=recherche&utm_campaign=referencement)

## À lire ensuite

- [Nettoyer un fichier clients par SIRET](https://api.sirenic.eu/cas-usage/nettoyer-fichier-clients-par-siret)
- [Préparer son référentiel fournisseurs pour la facturation électronique](https://api.sirenic.eu/cas-usage/facturation-electronique-preparer-son-referentiel)
- [Vérifier un numéro de TVA intracommunautaire](https://api.sirenic.eu/cas-usage/verifier-numero-tva-intracommunautaire-vies-api-appel)


---

[Accueil](https://api.sirenic.eu/) · [Offres](https://api.sirenic.eu/offres) · [Articles](https://api.sirenic.eu/articles) · [Routes](https://api.sirenic.eu/api) · [À propos](https://api.sirenic.eu/a-propos) · [Mentions légales](https://api.sirenic.eu/mentions-legales) · [Confidentialité](https://api.sirenic.eu/confidentialite)