ForHosting KIT · Outils pour développeurs

Chiffre contrôle BSN Pays-Bas

Saisissez 12345678 et obtenez le chiffre de contrôle 2 : le BSN complet est donc 123456782. Vous pouvez aussi coller un numéro à neuf chiffres pour voir s'il passe le test du onze néerlandais. Utile pour les inscriptions et la paie. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Nombre
12345678
Vous obtenez
Mode de calcul
Compute
Entrée
12345678
Chiffre de contrôle
2
Bsn
123456782

Le BSN néerlandais (Burgerservicenummer) est le numéro de service du citoyen utilisé pour les impôts, la santé, la paie, la banque et les formulaires officiels aux Pays-Bas. C'est un identifiant à neuf chiffres dont le dernier est un chiffre de contrôle dérivé d'une somme pondérée fixe appelée test de onze ou elfproef. Huit chiffres identifient l'enregistrement ; le neuvième est choisi de sorte que neuf fois le premier plus huit fois le second, jusqu'à deux fois le huitième, moins le neuvième, soit divisible par onze. Cette capacité calcule ce chiffre final à partir d'une base pure de huit chiffres, ou valide un BSN complet de neuf et indique si le chiffre stocké correspond à la valeur recalculée.

Comment fonctionne le test de onze du BSN néerlandais

Un BSN moderne comporte toujours neuf chiffres décimaux lorsqu'il est écrit sans espaces ni ponctuation. Les huit premiers forment l'enregistrement de base ; le neuvième est le chiffre de contrôle. Pour l'obtenir, multipliez les huit chiffres de base par les poids descendants de neuf à deux, additionnez les produits et prenez la somme modulo onze.

Le reste est le chiffre de contrôle lorsqu'il est compris entre zéro et neuf. Si le reste vaut dix, aucun chiffre de contrôle unique n'existe pour cette base et la chaîne de huit chiffres ne peut pas être complétée en un BSN valide selon la règle officielle. La validation multiplie les neuf chiffres par les poids neuf, huit, sept, six, cinq, quatre, trois, deux et moins un, puis exige que la somme pondérée soit divisible par onze sans reste.

De façon équivalente, vous recalculez le neuvième chiffre attendu à partir des huit premiers et le comparez à celui soumis. *. Les BSN historiques à huit chiffres sont en général traités comme des valeurs à neuf avec un zéro initial avant d'appliquer les mêmes poids ; cet outil attend que vous fournissiez ce zéro lors de la validation de tels numéros afin que les règles de longueur restent explicites.

Où les chiffres de contrôle BSN s'intègrent aux flux produit réels

Les parcours d'onboarding fintech, insurtech et marketplace néerlandais demandent souvent le BSN tôt ; valider le test de onze au blur réduit les envois échoués et les tickets de support sans appeler un registre gouvernemental à chaque frappe. Les systèmes de paie et RH importent des CSV d'employés et doivent mettre en quarantaine les lignes dont le neuvième chiffre ne correspond plus, ce qui détecte les éditions humaines comme les erreurs d'un dans les générateurs amont.

Ne traitez pas un test de onze réussi comme preuve que la personne existe dans les systèmes de population néerlandais, que le numéro est actif ou que vous êtes autorisé à traiter le BSN sous le RGPD et le droit néerlandais de la vie privée : cela prouve seulement que la chaîne de neuf chiffres est arithmétiquement bien formée selon la règle BSN, la même exigence d'honnêteté que pour tout outil de somme de contrôle d'identité nationale.

Minimisez toujours la rétention, chiffrez au repos et ne traitez le BSN que lorsqu'une finalité licite existe.

Auditer les colonnes BSN dans des exports massifs

Validez par lots chaque BSN d'un CSV de paie ou d'un extrait ERP et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur recalculée du test de onze.

Qu'est-ce que le chiffre de contrôle du BSN néerlandais ?

C'est le neuvième chiffre d'un Burgerservicenummer, calculé à partir des huit premiers avec les poids officiels du test de onze, de sorte qu'une faute d'un chiffre et de nombreuses erreurs de transcription échouent plus souvent que de ressembler à un autre enregistrement.

Que se passe-t-il avec des lettres, tirets ou mauvaises longueurs ?

Les tâches de validation en échec ne sont pas facturées. Supprimez espaces ou ponctuation dans votre client avant l'appel.

L'outil de contrôle BSN des Pays-Bas est-il gratuit ?

L'outil navigateur est gratuit et s'exécute en local.

Comment vérifier un ancien BSN à huit chiffres ?

Ajoutez vous-même un zéro en tête pour obtenir neuf chiffres, puis validez-le normalement. L'outil ne complète jamais seul les numéros trop courts, si bien qu'une erreur de longueur ne passe pas inaperçue.

Un BSN qui passe le test du onze appartient-il à une personne réelle ?

Pas forcément. Le test montre seulement que les chiffres sont cohérents entre eux. Il ne prouve ni que la personne figure dans les registres néerlandais, ni que le numéro est actif, ni que vous pouvez le traiter.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/enc/bsn-netherlands

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/enc/bsn-netherlands \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"12345678"}'
{
  "number": "12345678"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.bsn_netherlands",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Les caractères non numériques, les longueurs incorrectes, l'entrée vide et les bases dont le reste est dix (aucun chiffre de contrôle monochiffre possible) sont rejetés avec une erreur invalid_input claire. Exécutez-la gratuitement dans le navigateur ou appelez l'API KIT ; les deux chemins partagent la même arithmétique pure, sans réseau et sans registres de population stockés.

Comment fonctionne le test de onze du BSN néerlandais

Comme l'algorithme est une arithmétique modulaire entière pure à poids fixes, les mêmes huit chiffres produisent toujours le même chiffre de contrôle sur chaque plateforme—navigateur, Worker ou banc de test hors ligne—c'est pourquoi la capacité est publiée comme moteur parse de niveau A et non comme appel à un modèle.

Comment calculer le chiffre de contrôle ou valider un BSN complet

Envoyez un champ number qui ne contient que les caractères de zéro à neuf. Le mode validate attend exactement neuf chiffres. Cette forme facilite l'affichage « vous avez saisi X, attendu Y » dans une interface KYC ou RH sans seconde requête. Chaînes vides, number manquant, valeurs de mode invalides et longueurs incorrectes (par exemple sept ou dix chiffres) échouent avant toute somme pondérée et ne sont pas facturées. Espaces, points, tirets, lettres et points décimaux sont rejetés comme entrée non numérique avec invalid_input, afin qu'un formulaire n'accepte jamais une valeur nettoyée en silence : supprimez le formatage dans votre client si l'utilisateur colle des numéros masqués. Le mode compute est le mode par défaut : fournissez exactement huit chiffres de base ; le moteur renvoie check_digit comme chaîne d'un caractère, bsn comme le code complet à neuf chiffres, sum_base comme la somme pondérée intermédiaire des huit, length neuf et l'étiquette de l'algorithme. Si la base de huit chiffres donne un reste de dix, compute échoue avec invalid_input plutôt que d'inventer un chiffre à deux positions ou nul. La réponse indique valid true uniquement lorsque le chiffre final correspond à expected_check_digit recalculé et que la somme pondérée complète est divisible par onze ; elle inclut toujours base (les huit premiers), check_digit tel que soumis, expected_check_digit lorsqu'une base légale existe, weighted_sum et le bsn canonique formé de base plus le chiffre attendu. Comme le chemin est un parse pur sans horloge, source aléatoire ni réseau, la même entrée produit toujours le même JSON dans l'outil gratuit du navigateur et via l'API. À $0.002 par requête réussie, vous pouvez protéger des imports CRM massifs, des audits de fichiers partenaires et des portes de formulaire sans négocier un niveau sur mesure.

Où les chiffres de contrôle BSN s'intègrent aux flux produit réels

Les portails de santé et pharmacies qui stockent le BSN comme clé patient peuvent bloquer la suite tant que valid n'est pas true et afficher expected_check_digit lorsque le chiffre est faux. Les jobs de qualité des données recalculent expected_check_digit pour chaque colonne BSN d'un export et signalent les écarts avant facturation ou reporting fiscal. Dans chaque flux le contrat est le même : chiffres uniquement, huit pour compute ou neuf pour validate, JSON structuré testable par goldens, comportement identique gratuit dans le navigateur ou via solde KIT prépayé, et échec honnête lorsque l'entrée n'est pas une chaîne de chiffres bien formée ou que la base ne peut pas produire un unique chiffre de contrôle.

Compléter huit chiffres de base pour fixtures et formulaires

Prenez une base de huit chiffres d'un plan de tests ou d'un enregistrement partiel, appelez le mode compute et stockez ou affichez le bsn complet à neuf chiffres avec le chiffre de contrôle ajouté.

Valider des BSN saisis ou importés à l'entrée

Lorsqu'un formulaire d'inscription, un import CRM ou une API partenaire envoie neuf chiffres, appelez le mode validate et bloquez le stockage si valid est false, en affichant expected_check_digit pour corriger une faute de frappe.

Comment calculer un chiffre de contrôle BSN avec cette API ?

Envoyez un POST avec number de exactement huit chiffres et mode compute (ou omettez mode). La réponse inclut check_digit et bsn (le code complet à neuf chiffres). Les bases avec reste dix échouent avec invalid_input.

Comment valider un BSN complet à neuf chiffres ?

Envoyez un POST avec la chaîne de neuf chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit, base, weighted_sum et le bsn canonique.

Consulter la documentation complète du KIT →