validate-fr

Validation des identifiants français — zéro dépendance, ESM + CJS + types.

SIREN, SIRET, TVA intracommunautaire, IBAN, code postal, téléphone. Validation de format et de clé de contrôle (Luhn, mod-97 IBAN, clé TVA).

🔎 Besoin de vérifier en base réelle ?

Cette lib valide le format et la clé (hors-ligne, gratuit). Pour savoir si une entreprise est réellement immatriculée et active, si un IBAN/RIB existe ou récupérer la raison sociale depuis un SIRET, utilisez l'API → data-checker.fr (validation email / téléphone / SIRET / IBAN en temps réel).

Install

npm install validate-fr

Usage

import {
  isValidSiren, isValidSiret, isValidVatFr,
  isValidIban, isValidCodePostal, isValidPhoneFr,
  formatPhoneFr, sirenFromSiret,
} from "validate-fr";

isValidSiren("732 829 320");                      // true
isValidSiret("732 829 320 00074");                // true
isValidVatFr("FR44732829320");                    // true
isValidIban("FR14 2004 1010 0505 0001 3M02 606"); // true
isValidIban("DE89...", "DE");                     // restreint au pays
isValidCodePostal("97400");                       // true (DOM)
isValidPhoneFr("06 12 34 56 78");                 // true
formatPhoneFr("06.12.34.56.78");                  // "+33612345678"
sirenFromSiret("73282932000074");                 // "732829320"

API

| Fonction | Renvoie | Notes | |---|---|---| | isValidSiren(s) | boolean | 9 chiffres, Luhn (+ cas La Poste) | | isValidSiret(s) | boolean | 14 chiffres, Luhn (+ cas La Poste) | | isValidVatFr(s) | boolean | FR + clé + SIREN, clé (12 + 3·(SIREN mod 97)) mod 97 | | isValidIban(s, country?) | boolean | mod-97 ISO 13616, longueur par pays | | isValidCodePostal(s) | boolean | 5 chiffres, départements valides + DOM/TOM | | isValidPhoneFr(s) | boolean | fixe/mobile, 0X / +33 / 0033 | | formatPhoneFr(s) | string \| null | format E.164 | | sirenFromSiret(s) | string \| null | extrait le SIREN |

Tous les validateurs tolèrent espaces et points.

Validation en temps réel (API)

validate-fr s'arrête à la cohérence mathématique. Pour aller plus loin :

| Besoin | Cette lib | API data-checker.fr | |---|---|---| | Format & clé de contrôle | ✅ | ✅ | | Entreprise réellement immatriculée / active | ❌ | ✅ | | Raison sociale, adresse depuis un SIRET | ❌ | ✅ | | IBAN/RIB existant, email/téléphone valides | ❌ | ✅ |

👉 data-checker.fr — API B2B de validation de données françaises.

License

MIT © KIPDEV — kipdev.io