ForHosting KIT · Outils pour développeurs

Chiffre de contrôle My Number Japon

Pour les onze chiffres 12345678901, le chiffre de contrôle du My Number japonais est 6, et le numéro complet devient 123456789016, selon la somme pondérée officielle modulo 11. La validation vérifie un numéro à douze chiffres, avec ou sans tirets. 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
12345678901
Vous obtenez
Mode de calcul
Compute
Entrée
12345678901
Chiffre de contrôle
6
Avec chiffre de contrôle
123456789016

Le My Number japonais (numéro individuel, 個人番号) est l’identifiant national de douze chiffres utilisé pour la fiscalité, la sécurité sociale, la réponse aux catastrophes et un ensemble croissant de formulaires publics et privés. Les onze premiers chiffres identifient le titulaire ; le douzième est un chiffre de contrôle produit par une somme pondérée fixe définie dans les règles de numérotation, non une valeur aléatoire ni consultée dans un registre. Cette capacité n’implémente que ce checksum. Le mode compute accepte exactement onze chiffres sans le chiffre de contrôle final et renvoie le chiffre officiel plus la chaîne complète de douze chiffres. Le mode validate accepte un numéro complet de douze chiffres (espaces ou tirets optionnels) et indique si le dernier chiffre correspond à la valeur attendue recalculée.

Comment le chiffre de contrôle My Number japonais est calculé

Selon les règles officielles du numéro individuel, le chiffre de contrôle My Number est un unique chiffre décimal (0–9) calculé à partir des onze chiffres du corps comptés de gauche à droite comme P1 à P11. Chaque position a un poids fixe Qn : pour n de 1 à 6 le poids est n+1, et pour n de 7 à 11 le poids est n−5. Cela donne la séquence de poids 2, 3, 4, 5, 6, 7, 2, 3, 4, 5, 6.

L’algorithme multiplie chaque chiffre du corps par son poids, additionne les onze produits et prend cette somme modulo 11. La valeur de contrôle provisoire est onze moins le reste ; si cette valeur provisoire vaut 10 ou 11, le chiffre de contrôle publié est 0, sinon c’est la valeur provisoire elle-même. De façon équivalente, reste 0 et reste 1 correspondent au chiffre 0, et les autres restes à 11 moins le reste.

La validation recalcule le chiffre attendu à partir des onze premiers chiffres d’une soumission de douze et le compare au douzième caractère. Un exemple transparent est la base 12345678901, qui donne le chiffre de contrôle 6 et le numéro complet 123456789016. L’algorithme est déterministe et local : pas de réseau, pas d’horloge et pas d’aléa.

Face aux outils génériques mod-11 ou Luhn, l’intention de recherche ici est étroite : des personnes qui ont besoin d’une calculatrice de chiffre de contrôle My Number du Japon pour des bases de onze chiffres ou d’un vérificateur du numéro individuel japonais de douze chiffres, non d’un outil de carte de paiement ou d’IMEI d’appareil.

Où les chiffres de contrôle My Number s’insèrent dans les flux réels au Japon

Banques, assureurs et fintech valident les valeurs My Number à l’ouverture de compte ou au rafraîchissement KYC sous les règles de confidentialité japonaises, en capturant les fautes de frappe avant l’écriture de la fiche client maîtresse. Les jobs ETL qui chargent des fichiers maîtres clients ou employés japonais parcourent chaque colonne My Number d’un flux CSV ou XML, appellent le mode validate et mettent en quarantaine les lignes où valid est false—capturant à la fois les éditions humaines et les bugs de générateurs.

Les formulaires d’e-gouvernement municipal acceptent souvent les formes à tirets et compactes ; supprimer espaces et tirets avant le contrôle des chiffres garde le contrat simple sans inventer un second algorithme. Ne traitez pas un My Number qui passe le contrôle comme preuve que le titulaire est vivant dans le registre des résidents, détient une My Number Card valide ou est autorisé à un service ; cela prouve seulement que le chiffre de contrôle est cohérent avec les onze chiffres du corps selon les poids officiels du numéro individuel japonais.

Auditer les colonnes My Number dans les données maîtres

Validez par lots chaque numéro individuel dans un CSV CRM, fiscal ou de paie et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur attendue recalculée.

Qu’est-ce que le chiffre de contrôle My Number japonais ?

C’est le douzième chiffre du numéro individuel du Japon (My Number / 個人番号), calculé par une somme pondérée fixe sur les onze premiers chiffres afin que les erreurs de saisie et de scan soient généralement détectées avant le stockage du numéro.

Que se passe-t-il avec une longueur incorrecte, des lettres ou une ponctuation étrange ?

Les tâches de validation en échec ne sont pas facturées.

L’outil de chiffre de contrôle My Number est-il gratuit ?

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

Comment se calcule le chiffre de contrôle du My Number ?

Les onze chiffres, lus depuis la gauche, sont multipliés par 2, 3, 4, 5, 6, 7, 2, 3, 4, 5 et 6, puis les produits sont additionnés. Le chiffre vaut 11 moins le reste de la division par 11, sauf que les restes 0 et 1 donnent 0.

Un chiffre de contrôle valide prouve-t-il que le numéro appartient à quelqu'un ?

Non. L'outil fait seulement le calcul et n'interroge aucun registre : un chiffre correct ne prouve pas que la personne est vivante, inscrite ou ayant droit à un service. Il sert surtout à repérer un chiffre mal saisi.

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/mynumber-japan

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/mynumber-japan \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"12345678901"}'
{
  "number": "12345678901"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.mynumber_japan",
  "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 corps non numériques et les longueurs incorrectes échouent avec invalid_input au lieu d’un nettoyage silencieux. La même arithmétique pure s’exécute gratuitement dans le navigateur et au prix API publié, sans appel au registre de population et sans prétendre qu’un checksum valide signifie que la personne est vivante, enregistrée ou autorisée à un service.

Contrat d’entrée, modes et comportement d’erreur

Envoyez un champ number contenant le corps du My Number. Une longueur incorrecte est une erreur explicite qui nomme le mode et la longueur envoyée—onze pour compute, douze pour validate—afin que les formulaires clients affichent un message précis sans deviner. Les chaînes vides, number manquant et valeurs de mode invalides échouent avant toute somme pondérée et ne sont pas facturés. Une chaîne de douze chiffres bien formée qui a simplement le mauvais chiffre de contrôle renvoie valid false sans lever d’exception, afin que les jobs par lots puissent mettre des lignes en quarantaine au lieu d’interrompre tout le fichier. Les espaces et tirets sont supprimés pour accepter les formes d’affichage courantes telles que 1234-5678-9012 ou des groupes espacés après normalisation ; toute autre ponctuation et les lettres sont rejetées comme entrée non numérique avec invalid_input, afin qu’une valeur silencieusement tronquée n’atteigne jamais le stockage. Le mode compute est le défaut : le moteur exige exactement onze chiffres, renvoie check_digit comme chaîne d’un caractère, renvoie with_check comme le numéro individuel de douze chiffres que vous pouvez imprimer ou persister, et inclut weights et algorithm pour les pistes d’audit. Le mode validate accepte exactement douze chiffres ; la réponse indique valid true lorsque le chiffre final correspond au expected_check_digit recalculé, et inclut toujours payload (les onze chiffres du corps), check_digit, expected_check_digit, length, weights et algorithm. Les alias mynumber, my_number, individual_number, digits et code sont acceptés pour le même champ de charge utile, afin que les intégrations qui parlent déjà des noms de champs japonais n’aient pas besoin de renommer. Comme le chemin est pure parse sans horloge, source aléatoire ni réseau, le même corps JSON produit toujours le même résultat JSON sur l’outil navigateur gratuit et sur l’API à $0.002 par requête réussie.

Où les chiffres de contrôle My Number s’insèrent dans les flux réels au Japon

Les portails fiscaux et de sécurité sociale recalculent expected_check_digit lorsqu’un citoyen saisit ou colle un numéro individuel de douze chiffres, pour qu’une seule transposition ne crée pas un envoi fantôme et un dossier rejeté. Employeurs et prestataires de paie complètent des bases de onze chiffres en sandboxes avec le mode compute, puis stockent with_check dans des employés de test qui doivent ressembler à des identifiants de production sans utiliser de vrais numéros de citoyens.

Compléter une base My Number de 11 chiffres pour fixtures de test

Appelez le mode compute avec onze chiffres du corps, stockez with_check et utilisez le numéro individuel de douze chiffres dans des enregistrements de test fiscaux, de paie ou municipaux en sandbox.

Valider des My Number japonais saisis ou importés

Lorsqu’un formulaire, un fichier bancaire ou un flux RH soumet douze chiffres, appelez le mode validate et bloquez l’inscription si valid est false, en affichant expected_check_digit pour aider à corriger une seule faute de frappe.

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

Envoyez un POST avec number réglé sur exactement onze chiffres et mode compute (ou omettez mode). La réponse inclut check_digit et with_check (le numéro individuel complet de douze chiffres).

Comment valider un My Number complet de douze chiffres ?

Envoyez un POST avec la chaîne de chiffres (espaces ou tirets optionnels) et mode validate. La réponse inclut valid, check_digit, expected_check_digit et payload (les onze chiffres du corps).

Consulter la documentation complète du KIT →