Cifra di controllo My Number Giappone
Per le undici cifre 12345678901 la cifra di controllo del My Number giapponese è 6, e il numero completo diventa 123456789016, secondo la somma ponderata ufficiale modulo 11. La convalida verifica un numero di dodici cifre, con o senza trattini. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Numero
- 12345678901
- Modalità di calcolo
- Compute
- Input
- 12345678901
- Cifra di controllo
- 6
- Con cifra di controllo
- 123456789016
Il My Number giapponese (Numero Individuale, 個人番号) è l’identificatore nazionale di dodici cifre usato per imposte, previdenza sociale, risposta alle catastrofi e un insieme crescente di moduli pubblici e privati. Le prime undici cifre identificano il titolare; la dodicesima è una cifra di controllo prodotta da una somma ponderata fissa definita nelle regole di numerazione, non un valore casuale né consultato in un registro. Questa capacità implementa solo quel checksum. La modalità compute accetta esattamente undici cifre senza la cifra di controllo finale e restituisce la cifra ufficiale più la stringa completa di dodici cifre. La modalità validate accetta un numero completo di dodici cifre (spazi o trattini opzionali) e indica se l’ultima cifra corrisponde al valore atteso ricalcolato.
Come si calcola la cifra di controllo del My Number giapponese
Secondo le regole ufficiali del Numero Individuale, la cifra di controllo My Number è un’unica cifra decimale (0–9) calcolata dalle undici cifre del corpo contate da sinistra a destra come P1 fino a P11. Ogni posizione ha un peso fisso Qn: per n da 1 a 6 il peso è n+1, e per n da 7 a 11 il peso è n−5. Ciò produce la sequenza di pesi 2, 3, 4, 5, 6, 7, 2, 3, 4, 5, 6.
L’algoritmo moltiplica ogni cifra del corpo per il suo peso, somma gli undici prodotti e prende quel totale modulo 11. Il valore di controllo provvisorio è undici meno il resto; se quel valore provvisorio è 10 o 11, la cifra di controllo pubblicata è 0, altrimenti è il valore provvisorio stesso. In modo equivalente, resto 0 e resto 1 mappano sulla cifra 0, e gli altri resti su 11 meno il resto.
La validazione ricalcola la cifra attesa dalle prime undici cifre di un invio di dodici e la confronta con il dodicesimo carattere. Un esempio trasparente è la base 12345678901, che produce la cifra di controllo 6 e il numero completo 123456789016. L’algoritmo è deterministico e locale: nessuna rete, nessun orologio e nessuna casualità.
Rispetto a strumenti generici mod-11 o Luhn, l’intento di ricerca qui è stretto: persone che servono una calcolatrice della cifra di controllo My Number del Giappone per basi di undici cifre o un verificatore del Numero Individuale giapponese di dodici cifre, non uno strumento per carte di pagamento o IMEI di dispositivi.
Dove le cifre di controllo My Number si inseriscono nei flussi reali in Giappone
Banche, assicuratori e fintech validano i valori My Number all’apertura del conto o al rinnovo KYC secondo le norme sulla privacy giapponesi, intercettando errori di battitura prima di scrivere il record anagrafico del cliente. I job ETL che caricano file anagrafici di clienti o dipendenti giapponesi scorrono ogni colonna My Number in un feed CSV o XML, chiamano la modalità validate e mettono in quarantena le righe in cui valid è false—catturando sia modifiche umane sia bug di generatori.
I moduli di e-government comunali spesso accettano forme con trattini e compatte; rimuovere spazi e trattini prima del controllo delle cifre mantiene il contratto semplice senza inventare un secondo algoritmo. Non consideri un My Number che supera il controllo come prova che il titolare sia vivo nel registro dei residenti, possegga una My Number Card valida o sia autorizzato a un servizio; dimostra solo che la cifra di controllo è coerente con le undici cifre del corpo secondo i pesi ufficiali del Numero Individuale giapponese.
Casi d'uso
Verificare le colonne My Number nei dati anagrafici
Validi in batch ogni Numero Individuale in un CSV di CRM, tasse o payroll e metta in quarantena le righe la cui cifra di controllo non coincide più con il valore atteso ricalcolato.
Domande frequenti
Cos’è la cifra di controllo del My Number giapponese?
È la dodicesima cifra del Numero Individuale del Giappone (My Number / 個人番号), calcolata con una somma ponderata fissa sulle prime undici cifre affinché errori di digitazione e di scansione siano di solito intercettati prima che il numero venga memorizzato.
Cosa succede con lunghezza errata, lettere o punteggiatura strana?
Le attività di validazione non riuscite non vengono fatturate.
Lo strumento per la cifra di controllo My Number è gratuito?
Lo strumento browser è gratuito e gira in locale.
Come si calcola la cifra di controllo del My Number?
Le undici cifre, lette da sinistra, si moltiplicano per 2, 3, 4, 5, 6, 7, 2, 3, 4, 5 e 6, e i prodotti si sommano. La cifra è 11 meno il resto della divisione per 11, tranne che i resti 0 e 1 danno 0.
Una cifra di controllo valida dimostra che il numero appartiene a qualcuno?
No. Lo strumento esegue solo il calcolo e non consulta alcun registro, quindi una cifra corretta non prova che la persona sia viva, registrata o abbia diritto a un servizio. Serve soprattutto a intercettare una cifra digitata male.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/enc/mynumber-japan \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"12345678901"}'const res = await fetch("https://api.kit.forhosting.com/enc/mynumber-japan", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "12345678901"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/mynumber-japan",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "12345678901"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/mynumber-japan", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"12345678901"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"12345678901"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/mynumber-japan", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"number": "12345678901"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.mynumber_japan",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Corpi non numerici e lunghezze errate falliscono con invalid_input invece di una rimozione silenziosa. La stessa aritmetica pura gira gratis nel browser e al prezzo API pubblicato, senza chiamata al registro della popolazione e senza affermare che un checksum valido significhi che la persona sia viva, registrata o autorizzata a un servizio.
Contratto di input, modalità e comportamento degli errori
Invii un campo number che contenga il corpo del My Number. Una lunghezza errata è un errore esplicito che nomina la modalità e la lunghezza inviata—undici per compute, dodici per validate—così i moduli client possono mostrare un messaggio preciso senza indovinare. Stringhe vuote, number mancante e valori di mode non validi falliscono prima di qualsiasi somma ponderata e non vengono fatturati. Una stringa di dodici cifre ben formata che ha semplicemente la cifra di controllo sbagliata restituisce valid false senza lanciare, così i job batch possono mettere in quarantena le righe invece di interrompere l’intero file. Spazi e trattini vengono rimossi così forme di visualizzazione comuni come 1234-5678-9012 o gruppi spaziati sono accettate dopo la normalizzazione; altra punteggiatura e lettere sono rifiutate come input non numerico con invalid_input, affinché un valore rimosso in silenzio non raggiunga mai l’archiviazione. La modalità compute è predefinita: il motore richiede esattamente undici cifre, restituisce check_digit come stringa di un carattere, restituisce with_check come il Numero Individuale di dodici cifre che Lei può stampare o persistere, e include weights e algorithm per le tracce di audit. La modalità validate accetta esattamente dodici cifre; la risposta riporta valid true quando la cifra finale coincide con expected_check_digit ricalcolato, e include sempre payload (le undici cifre del corpo), check_digit, expected_check_digit, length, weights e algorithm. Alias come mynumber, my_number, individual_number, digits e code sono accettati per lo stesso campo di payload, così le integrazioni che già usano nomi di campo giapponesi non devono rinominare. Poiché il percorso è pure parse senza orologio, fonte casuale né rete, lo stesso corpo JSON produce sempre lo stesso risultato JSON sullo strumento browser gratuito e sull’API a $0.002 per richiesta riuscita.
Dove le cifre di controllo My Number si inseriscono nei flussi reali in Giappone
I portali fiscali e di previdenza sociale ricalcolano expected_check_digit quando un cittadino digita o incolla un Numero Individuale di dodici cifre, così una sola trasposizione non crea un invio fantasma e una pratica respinta. Datori di lavoro e fornitori di payroll completano basi di undici cifre in sandbox con la modalità compute, poi memorizzano with_check in dipendenti di test che devono assomigliare a identificatori di produzione senza usare numeri reali di cittadini.
Casi di integrazione
Completare una base My Number di 11 cifre per fixture di test
Chiami la modalità compute con undici cifre del corpo, memorizzi with_check e usi il Numero Individuale di dodici cifre in record di test fiscali, payroll o comunali in sandbox.
Validare My Number giapponesi digitati o importati
Quando un modulo, un file bancario o un feed HR invia dodici cifre, chiami la modalità validate e blocchi l’iscrizione se valid è false, mostrando expected_check_digit per aiutare a correggere un solo errore di battitura.
Domande tecniche
Come si calcola una cifra di controllo My Number con questa API?
Invii un POST con number impostato su esattamente undici cifre e mode compute (oppure ometta mode). La risposta include check_digit e with_check (il Numero Individuale completo di dodici cifre).
Come si valida un My Number completo di dodici cifre?
Invii un POST con la stringa di cifre (spazi o trattini opzionali) e mode validate. La risposta include valid, check_digit, expected_check_digit e payload (le undici cifre del corpo).