ForHosting KIT · Strumenti per sviluppatori

Cifra di controllo UIC carro

Un carro con le prime undici cifre 21812471217 riceve la cifra di controllo 3, quindi il numero UIC completo è 218124712173. Se incolla un numero intero di dodici cifre, vede subito se l'ultima torna. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Numero
21812471217
Ottiene
Modalità di calcolo
Compute
Input
21812471217
Cifra di controllo
3
Numero del carro
218124712173

Gli operatori ferroviari, i proprietari di carri e i sistemi logistici identificano il materiale merci e viaggiatori con un numero europeo di veicolo UIC a dodici cifre. Undici di queste cifre codificano tipo, paese e identità di serie; la dodicesima è una cifra di autocontrollo derivata da una ponderazione fissa alternata due-uno, così che un errore di digitazione o una trasposizione fallisca molto più spesso che sembrare un altro veicolo valido. Questa capacità calcola quella cifra di controllo a partire da un carico utile di undici cifre, oppure convalida un numero completo di dodici e indica se la cifra finale memorizzata coincide con il valore ricalcolato.

Come si calcola la cifra di controllo UIC

Le regole UIC e di numerazione europea dei veicoli definiscono una cifra di controllo deterministica sui primi undici cifre del numero di veicolo a dodici. Numeri quelle posizioni di carico utile da sinistra a destra partendo dall'indice zero: ciascuna cifra è moltiplicata per peso due quando l'indice è pari e per peso uno quando è dispari; ogni prodotto maggiore di nove viene poi piegato sommando le sue cifre decimali (la stessa piega in stile Luhn degli schemi mod-10 affini). Si sommano gli undici valori piegati.

La cifra di controllo è dieci meno quella somma modulo dieci, ripresa modulo dieci, così che una somma già divisibile per dieci produca cifra di controllo zero. Aggiungendo quella sola cifra si ottiene il numero completo di dodici che compare sulla cassa del carro e nelle basi flotta, spesso stampato con spazi di raggruppamento e un trattino prima della cifra di controllo. La convalida è l'operazione inversa: si ricalcola la cifra attesa dai primi undici caratteri e la si confronta con la dodicesima.

*

Come calcolare una cifra di controllo o convalidare un numero completo

Invii un campo number con le cifre del carico utile o del veicolo completo. La modalità validate attende esattamente dodici cifre dopo la pulizia. Quella forma facilita mostrare «Lei ha digitato X, si attendeva Y» in un'interfaccia flotta senza una seconda richiesta.

Stringhe vuote, number assente, valori di mode non validi e lunghezze errate (ad esempio dieci o tredici cifre) falliscono prima di qualsiasi somma ponderata e non vengono fatturate. Preferisca compute quando crea o completa un nuovo blocco di serie; preferisca validate quando riceve un numero completo da uno scanner, un CSV o un modulo di cambio keeper e le serve un cancello booleano prima di memorizzare l'asset.

Dove le cifre di controllo UIC si inseriscono nei flussi ferroviari reali

I proprietari e i keeper del materiale rotabile assegnano le serie entro una classe e un codice paese; prima di aggiornare vernice, targhe e registri TAF/TSI devono aggiungere la cifra di controllo corretta affinché partner e sistemi di linea accettino l'identità alla prima lettura. I sistemi di officina e manutenzione importano CSV di keeper con numeri a dodici cifre e devono rifiutare le righe la cui cifra di controllo non corrisponde più, il che intercetta sia le modifiche umane sia i bug di scarto di uno nei generatori a monte.

Le applicazioni di terminal e intermodali che lasciano al personale digitare un numero di carro possono convalidare alla perdita del focus e bloccare i movimenti finché valid non è true, riducendo scambi EDI falliti e disallineamenti in scalo. Non consideri una cifra di controllo valida come prova di assegnazione, diritti di keeper o correttezza del codice di tipo — dimostra solo che la stringa di dodici cifre è aritmeticamente ben formata sotto la regola UIC dei pesi alternati due-uno, lo stesso criterio di onestà applicato a qualsiasi checksum industriale.

Auditare file di keeper e di scambio RIV

Convalidi in batch ogni numero di veicolo a dodici cifre in un CSV partner o in un export EDI e metta in quarantena le righe la cui cifra di controllo non corrisponde più al valore atteso ricalcolato.

Che cos'è la cifra di controllo di un numero di carro UIC?

È la dodicesima cifra di un numero europeo di veicolo ferroviario, calcolata dai primi undici con pesi alternati 2 e 1 e una piega di somma cifre in stile Luhn, così che errori di una sola cifra falliscano molto più spesso che sembrare un altro veicolo.

Cosa succede con lettere, lunghezze errate o separatori non validi?

Le attività di convalida fallite non sono fatturate.

Lo strumento di cifra di controllo UIC carro è gratuito?

Lo strumento browser è gratuito e gira in locale.

Come si calcola la cifra di controllo di un carro UIC?

Partendo da sinistra, le undici cifre si moltiplicano per 2, 1, 2, 1 e così via. Un prodotto oltre 9 viene sostituito dalla somma delle sue due cifre, si somma tutto e la cifra è ciò che manca per arrivare alla decina successiva (0 se lo è già).

Una cifra di controllo valida prova che il carro è immatricolato?

No. Mostra solo che le dodici cifre sono coerenti tra loro. Non dice se il numero è stato assegnato, chi è il detentore del carro né se il codice di tipo è corretto.

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.

POSThttps://api.kit.forhosting.com/enc/uic-wagon

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/enc/uic-wagon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"21812471217"}'
{
  "number": "21812471217"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.uic_wagon",
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Spazi, trattini e punti del layout stampato abituale vengono rimossi prima dell'aritmetica; lettere e altri non-cifre sono rifiutati con un errore invalid_input chiaro. La esegua gratis nel browser o chiami l'API KIT al prezzo pubblicato; entrambi i percorsi usano lo stesso algoritmo intero puro, senza rete e senza registri di veicoli memorizzati.

Come si calcola la cifra di controllo UIC

Poiché l'algoritmo è aritmetica intera pura a pesi fissi, lo stesso carico utile produce sempre la stessa cifra di controllo su ogni piattaforma — browser, Worker o harness di test offline —, ecco perché la capacità è consegnata come motore parse di tier A e non come chiamata a un modello.

Come calcolare una cifra di controllo o convalidare un numero completo

Spazi, trattini e punti opzionali vengono rimossi così che i moduli accettino il layout di visualizzazione abituale con gruppi e un trattino finale prima della cifra di controllo; lettere e altri simboli sono rifiutati come ingresso non numerico con invalid_input, affinché un modulo non accetti mai un valore ripulito in silenzio che resta errato. La modalità compute è predefinita: fornisca esattamente undici cifre di carico utile dopo la pulizia; il motore restituisce check_digit come stringa di un carattere, vehicle_number come quelle undici cifre più il controllo, e length dodici. La risposta indica valid true quando la cifra finale coincide con expected_check_digit ricalcolato, e include sempre payload (le prime undici cifre), check_digit come inviato, expected_check_digit e il vehicle_number canonico formato da payload più la cifra attesa. Poiché il percorso è parse puro, senza orologio, sorgente casuale né rete, lo stesso ingresso produce sempre lo stesso JSON nello strumento gratuito del browser e sull'API. A $0.002 per richiesta riuscita può proteggere import massivi di flotta, file di scambio RIV e audit EDI partner senza negoziare un livello personalizzato.

Dove le cifre di controllo UIC si inseriscono nei flussi ferroviari reali

I test di integrazione e i job di qualità dati ricalcolano expected_check_digit per ogni colonna veicolo di un export e mettono in quarantena le discrepanze prima che raggiungano registri nazionali o internazionali. Le stampanti di etichette che compongono stencil da carichi utili di undici cifre chiamano la modalità compute una volta per veicolo e collocano vehicle_number sotto il grafico di marcatura.

Completare un carico utile di undici cifre per targhe e vernice

Prenda le cifre di tipo, paese e serie (undici in totale), chiami la modalità compute e stampi vehicle_number sul carro così che la marcatura porti una cifra di controllo UIC valida per il partner.

Convalidare numeri di carro scansionati o digitati in ingresso

Quando uno scanner portatile o un modulo invia dodici cifre, chiami la modalità validate e blocchi aggiornamenti di flotta o scalo se valid è false, mostrando expected_check_digit per correggere un errore di digitazione.

Come calcolo una cifra di controllo UIC con questa API?

Invii un POST con number di esattamente undici cifre (spazi, trattini e punti opzionali) e mode compute (oppure ometta mode). La risposta include check_digit e vehicle_number (il codice completo a dodici cifre).

Come convalido un numero di veicolo completo a dodici cifre?

Invii un POST con la stringa di dodici cifre e mode validate. La risposta include valid, check_digit, expected_check_digit, payload e il vehicle_number canonico.

Leggi la documentazione completa del KIT →