Sirenic : le fichier clients prêt, modèle Google Sheets
Version 2026-11-12. In English: https://api.sirenic.eu/modeles/fichier-clients-pret-instructions.txt

CE QUE FAIT LE MODÈLE
Il complète chaque ligne de votre fichier clients par le lot d'identité de Sirenic (/v1/identite/lot) : SIREN, SIRET du siège, état de l'entreprise et date de cessation, numéro de TVA contrôlé au VIES, doublons sur tout le fichier. Il ne lit que les colonnes d'entrée ci-dessous, et n'envoie que la ligne lue de chaque client.

INSTALLER, UNE FOIS PAR CLASSEUR
1. Ouvrez votre fichier dans Google Sheets ; la première ligne porte les titres des colonnes.
2. Extensions > Apps Script : remplacez le contenu du fichier Code.gs par le code servi à https://api.sirenic.eu/modeles/fichier-clients-pret.gs, puis enregistrez.
3. Rechargez le classeur : le menu Sirenic apparaît. Au premier lancement, Google demande votre autorisation : le modèle lit et écrit ce classeur seul, et appelle https://api.sirenic.eu.
4. Sirenic > Saisir ma clé : collez votre clé (elle commence par srn_live_). Elle est gardée dans les propriétés du script pour votre seul compte Google, jamais dans une cellule. Un éditeur du classeur peut modifier le script : ne collez votre clé que dans un classeur dont vous connaissez les éditeurs, de préférence une clé à part pour le modèle, révocable depuis votre compte. Sirenic > Oublier ma clé la retire.
Pas encore de clé : https://api.sirenic.eu/compte?utm_source=template&utm_campaign=tableur-sheets

LES COLONNES LUES (le titre de la première ligne, lu sans casse ni accents, tout signe autre qu'une lettre ou un chiffre lu comme _ : « N° SIREN » se lit n_siren)
- SIREN : siren, n_siren, no_siren, num_siren, numero_siren, siren_client
- SIRET : siret, n_siret, no_siret, num_siret, numero_siret, siret_client
- numéro de TVA français : tva, n_tva, no_tva, num_tva, numero_tva, numero_de_tva, tva_intracommunautaire, n_tva_intracommunautaire, vat, vat_number, vat_id
- nom : denomination, raison_sociale, societe, entreprise, company_name, legal_name, company, nom_client, nom, name, client
- code postal : code_postal, cp, codepostal, postcode, postal_code, zip, zip_code
- adresse : adresse, adresse_postale, adresse_complete, address, postal_address, street_address
Pour chaque entrée, la colonne au titre le plus précis l'emporte, quelle que soit sa place (dans l'ordre des listes ci-dessus : denomination ou raison_sociale avant nom) ; une colonne nom ou name à côté d'une colonne de prénom (prenom, prenoms, first_name, firstname, given_name) est le nom d'un contact : elle n'est jamais envoyée.
Chaque ligne part par son SIREN s'il est rempli, sinon par son SIRET, sinon par son numéro de TVA français, sinon par son nom et son code postal ; sans code postal, le modèle prend le dernier code postal à cinq chiffres de la colonne d'adresse. Une valeur présente mais illisible n'est jamais remplacée par la colonne suivante : la ligne est marquée entree_illisible. Un SIREN, un SIRET ou un code postal dont le tableur a retiré les zéros de tête les retrouve.

LES COLONNES AJOUTÉES PAR SIRENIC (à droite du fichier)
Chaque titre commence par sirenic_ et se lit tel quel, à la lettre près : une de vos colonnes (« État », « A revoir », « Résolution ») n'est jamais prise pour une colonne de Sirenic, ni remplie, ni écrasée ; une colonne qui porte exactement l'un de ces titres est remplie par Sirenic. Une colonne manquante est ajoutée à droite.
- sirenic_statut : l'état de la ligne : complete, a_completer (rien d'envoyable), entree_illisible, ligne_trop_longue, a_verifier (une réponse sans lignes lisibles, qui a pu être débitée : la ligne ne repart pas seule), ou non_envoyee_<raison> quand le passage s'est arrêté avant elle
- sirenic_resolution : la résolution de la route (resolu, a_confirmer, introuvable, siren_invalide, siren_inconnu, non_diffusible)
- sirenic_siren : le SIREN retenu
- sirenic_siret_siege : le SIRET du siège
- sirenic_denomination : la dénomination, pour une personne morale en diffusion totale seulement
- sirenic_etat : l'état de l'entreprise (actif, cesse)
- sirenic_date_cessation : la date de cessation d'une entreprise cessée
- sirenic_tva : le numéro de TVA intracommunautaire calculé
- sirenic_tva_vies : son contrôle au VIES (valide, invalide, indisponible, non_verifie), avec le motif d'un numéro non contrôlé
- sirenic_candidats : pour une ligne a_confirmer, les personnes morales proposées : SIREN, dénomination et score
- sirenic_doublon_de : le numéro de la ligne plus haute qui porte le même SIREN, sur tout le fichier
- sirenic_a_revoir : les raisons de revoir la ligne (liste ci-dessous), vide sinon
- sirenic_date_lecture : le jour (UTC) de la dernière lecture de l'identité
- sirenic_ligne_envoyee : la ligne envoyée, telle que le modèle l'a lue dans vos colonnes : elle dit si l'entrée a changé depuis (comparée sans la casse, les accents ni les blancs)
- sirenic_requete : le numéro de requête de l'appel qui a servi la ligne, celui de la colonne numero_requete du journal
- sirenic_changements_depuis : la date depuis laquelle les changements ont été lus
- sirenic_changements_verdict : le verdict de la relecture (nouveautes, rien_de_nouveau, lecture_incomplete, ligne_non_resolue, non_diffusible, budget_lot_epuise)
- sirenic_changements_nombre : le nombre de changements
- sirenic_changements_derniers : les plus récents : date et type
- sirenic_date_relecture : le jour (UTC) depuis lequel la prochaine relecture lit les changements : celui de la dernière relecture complète, ou la date de départ gardée d'une relecture incomplète

LA COLONNE sirenic_a_revoir
- entree_illisible : une valeur présente mais illisible (SIREN, SIRET, TVA, nom ou code postal) : rien n'est envoyé pour la ligne
- ligne_trop_longue : la ligne lue (le nom surtout) est trop longue pour l'adresse d'un appel de Google : rien n'est envoyé ; raccourcissez le nom
- code_postal_manquant : un nom sans code postal, ni dans sa colonne ni dans l'adresse
- nom_manquant : un code postal ou une adresse sans nom
- non_envoyee : le passage s'est arrêté avant la ligne : relancez-le
- reponse_a_verifier : le service a répondu sans lignes lisibles : l'appel a pu être débité (journal, numéro dans sirenic_requete) ; la ligne ne repart pas seule : effacez sa cellule sirenic_statut (pour une relecture, ce code) pour la renvoyer, elle se paiera à nouveau
- feuille_changee : la feuille a changé pendant le passage : le résultat déjà reçu pour la même entrée a été posé sur cette ligne ; vérifiez-la
- introuvable : aucune entreprise trouvée
- a_confirmer : plusieurs entreprises possibles : voir sirenic_candidats
- siren_invalide : la clé du SIREN est fausse
- siren_inconnu : SIREN absent du stock Sirene servi
- non_diffusible : ni nom ni adresse servis (entrepreneur individuel, ou unité non diffusible) ; SIREN, SIRET du siège, état et TVA le sont
- recherche_partielle : une partie de la recherche n'a pas pu être lue : pour relire la ligne, effacez sa cellule sirenic_statut puis relancez Compléter ; elle se paie à nouveau
- cessee : l'entreprise est cessée
- tva_invalide : le VIES dit le numéro de TVA invalide
- tva_non_verifiee : le numéro de TVA n'a pas pu être contrôlé au VIES
- doublon : même SIREN qu'une ligne plus haute (sirenic_doublon_de)
- a_change : des changements depuis la dernière passe
- changements_incomplets : la relecture n'a pas tout lu : sa date de départ est gardée, la prochaine relecture, un autre jour (UTC), relit toute la période
Sirenic > Lignes à revoir pose un filtre sur cette colonne.

COMPLÉTER LE FICHIER
Sirenic > Compléter le fichier. Chaque appel envoie au plus le nombre de lignes qu'un appel gratuit admet, lu sur https://api.sirenic.eu au début de chaque passage : avec une clé gratuite, un appel entre dans les lignes gratuites du mois s'il tient dans ce qui en reste ; sinon, il se paie en entier sur vos crédits, aux prix de la grille publiée, et ce qui reste des lignes gratuites sert un appel plus court. Les lignes identiques ne partent qu'une fois. Une ligne complétée ne repart jamais, sauf si vous changez son entrée. Une ligne seule part avec une copie d'elle-même : la route exige deux lignes ; hors des lignes gratuites, la copie coûte une ligne (dans les lignes gratuites du mois, elle en prend une), et le journal le dit. Google arrête un script après quelques minutes : le passage s'arrête avant et le dit ; relancez-le pour continuer.
Ne modifiez pas la feuille pendant un passage. Avant d'écrire, le modèle relit l'entrée de chaque ligne : si elle a bougé (ligne insérée, supprimée ou triée, entrée modifiée), il s'arrête, n'écrit rien sur une autre ligne, et pose les résultats déjà reçus sur les lignes de même entrée (code feuille_changee), pour ne rien payer deux fois.

LE JOURNAL
L'onglet Journal Sirenic garde une ligne par appel (horodatage_utc, action, lignes_envoyees, statut_http, resultat, credits_debites, lignes_gratuites_restantes, credits_restants, numero_requete), lue dans la réponse : vous y voyez ce que chaque appel a débité et les lignes gratuites qui restent ce mois.

ERREURS
- 401 : la clé est refusée (inconnue, expirée ou mal copiée) ; le passage s'arrête.
- 402 : l'appel ne tient pas dans les lignes gratuites qui restent ce mois, et le solde de crédits ne le couvre pas ; rien n'est facturé, le passage s'arrête et dit le prix de l'appel et le solde, lus dans la réponse.
- 429 : le service limite le débit ; le modèle attend le délai annoncé et réessaie une fois, puis s'arrête et dit quand réessayer.
- 503 : le service est momentanément indisponible ; rien n'est facturé ; même attente, même nouvel essai.
- 200 sans lignes lisibles : l'appel a pu être débité ; le passage s'arrête, ses lignes portent sirenic_statut a_verifier et le numéro de requête, et ne repartent pas seules.
Une réponse en erreur n'est jamais facturée. Les lignes d'un appel arrêté portent sirenic_statut non_envoyee_<raison>.

CE QUI A CHANGÉ DEPUIS MA DERNIÈRE PASSE
À la fin d'un passage, le modèle propose la relecture. Sirenic > Ce qui a changé depuis ma dernière passe renvoie les lignes resolu par leur SIREN, avec la date de leur dernière lecture (paramètre depuis), et écrit sirenic_changements_verdict, sirenic_changements_nombre et sirenic_changements_derniers ; l'identité est relue en même temps. Le prix d'une ligne relue est celui de la grille avec depuis ; les appels suivent la même règle des lignes gratuites. Une ligne seule part avec une copie d'elle-même : la route exige deux lignes ; hors des lignes gratuites, la copie coûte une ligne (dans les lignes gratuites du mois, elle en prend une), et le journal le dit. Une ligne lue ou relue aujourd'hui (UTC) ne repart pas le même jour : une relecture arrêtée reprend aux autres lignes. Une relecture incomplète garde sa date de départ : la suivante relit toute la période.

EXPORTER
Sirenic > Exporter en CSV : un fichier séparé par des points-virgules, avec BOM, qui s'ouvre tel quel dans Excel. Une cellule qui commencerait une formule (=, +, -, @) y reçoit une apostrophe devant. Le menu Fichier > Télécharger de Google Sheets reste disponible.

DONNÉES PERSONNELLES
Sirenic ne sert jamais le nom ni l'adresse d'un entrepreneur individuel : sa ligne porte la résolution non_diffusible, avec son SIREN, le SIRET du siège, l'état et la TVA. Les candidats d'une ligne a_confirmer sont des personnes morales. L'API ne recopie jamais le nom saisi dans sa réponse ni dans ses journaux. Votre fichier reste dans votre classeur.

LANGUE
Le menu et les messages suivent la langue du classeur (Fichier > Paramètres).