Chiffre de contrôle UIC wagon
Un wagon dont les onze premiers chiffres sont 21812471217 reçoit le chiffre de contrôle 3 : son numéro UIC complet est donc 218124712173. Collez plutôt un numéro entier de douze chiffres pour voir aussitôt si le dernier concorde. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Nombre
- 21812471217
- Mode de calcul
- Compute
- Entrée
- 21812471217
- Chiffre de contrôle
- 3
- Numéro de wagon
- 218124712173
Les exploitants ferroviaires, les propriétaires de wagons et les systèmes logistiques identifient le matériel de fret et de voyageurs par un numéro européen de véhicule UIC à douze chiffres. Onze de ces chiffres codent le type, le pays et l'identité de série ; le douzième est un chiffre d'autocontrôle dérivé d'une pondération fixe alternée deux-un, de sorte qu'une faute de frappe ou une transposition échoue bien plus souvent que de ressembler à un autre véhicule valide. Cette capacité calcule ce chiffre de contrôle à partir d'une charge utile de onze chiffres, ou valide un numéro complet de douze et indique si le chiffre final stocké correspond à la valeur recalculée.
Comment le chiffre de contrôle UIC est calculé
Les règles UIC et de numérotation européenne des véhicules définissent un chiffre de contrôle déterministe sur les onze premiers chiffres du numéro de véhicule à douze. Numérotez ces positions de charge utile de gauche à droite en commençant à l'indice zéro : chaque chiffre est multiplié par le poids deux lorsque l'indice est pair et par le poids un lorsqu'il est impair ; tout produit supérieur à neuf est ensuite plié en sommant ses chiffres décimaux (le même pliage de style Luhn des schémas mod-10 apparentés).
Les onze valeurs pliées sont sommées. Le chiffre de contrôle est dix moins cette somme modulo dix, reprise modulo dix, de sorte qu'une somme déjà divisible par dix produit le chiffre de contrôle zéro. L'ajout de ce seul chiffre donne le numéro complet de douze qui figure sur la caisse du wagon et dans les bases de flotte, souvent imprimé avec des espaces de regroupement et un tiret avant le chiffre de contrôle.
La validation est l'opération inverse : recalculer le chiffre attendu à partir des onze premiers caractères et le comparer au douzième. *
Comment calculer un chiffre de contrôle ou valider un numéro complet
Envoyez un champ number contenant les chiffres de la charge utile ou du véhicule complet. Le mode validate attend exactement douze chiffres après nettoyage. Cette forme facilite d'afficher « vous avez saisi X, on attendait Y » dans une interface de flotte sans seconde requête.
Chaînes vides, number manquant, valeurs de mode invalides et longueurs incorrectes (par exemple dix ou treize chiffres) échouent avant toute somme pondérée et ne sont pas facturées. Préférez compute pour créer ou compléter un nouveau bloc de série ; préférez validate lorsque vous recevez un numéro complet d'un scanner, d'un CSV ou d'un formulaire de changement de keeper et qu'il vous faut une porte booléenne avant de stocker l'actif.
Où les chiffres de contrôle UIC s'intègrent aux flux ferroviaires réels
Les propriétaires et keepers de matériel roulant attribuent des séries dans une classe et un code pays ; avant de mettre à jour peinture, plaques et registres TAF/TSI ils doivent ajouter le chiffre de contrôle correct pour que partenaires et systèmes de voie acceptent l'identité dès la première lecture.
Les systèmes d'atelier et de maintenance importent des CSV de keepers avec des numéros à douze chiffres et doivent rejeter les lignes dont le chiffre de contrôle ne correspond plus, ce qui détecte à la fois les éditions humaines et les bugs de décalage d'un dans les générateurs en amont.
Les applications de terminal et d'intermodal qui laissent les agents saisir un numéro de wagon peuvent valider à la perte de focus et bloquer les mouvements tant que valid n'est pas true, réduisant les échanges EDI échoués et les décalages de triage.
Ne traitez pas un chiffre de contrôle valide comme preuve d'allocation, de droits de keeper ou de correction de code de type — il prouve seulement que la chaîne de douze chiffres est arithmétiquement bien formée sous la règle UIC des poids alternés deux-un, le même critère d'honnêteté que pour tout checksum industriel.
Cas d’usage
Auditer les fichiers keeper et d'échange RIV
Validez par lot chaque numéro de véhicule à douze chiffres d'un CSV partenaire ou d'un export EDI et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur attendue recalculée.
Questions fréquentes
Qu'est-ce qu'un chiffre de contrôle de numéro de wagon UIC ?
C'est le douzième chiffre d'un numéro européen de véhicule ferroviaire, calculé à partir des onze premiers avec des poids alternés 2 et 1 et un pliage de somme de chiffres de style Luhn, de sorte qu'une faute d'un seul chiffre échoue bien plus souvent que de ressembler à un autre véhicule.
Que se passe-t-il avec lettres, mauvaises longueurs ou séparateurs incorrects ?
Les tâches de validation échouées ne sont pas facturées.
L'outil de chiffre de contrôle UIC wagon est-il gratuit ?
L'outil navigateur est gratuit et s'exécute en local.
Comment se calcule le chiffre de contrôle d'un wagon UIC ?
En partant de la gauche, les onze chiffres sont multipliés par 2, 1, 2, 1 et ainsi de suite. Un produit supérieur à 9 est remplacé par la somme de ses deux chiffres, on additionne le tout, et le chiffre est ce qui manque pour atteindre la dizaine suivante (0 si c'en est déjà une).
Un chiffre de contrôle valide prouve-t-il que le wagon est immatriculé ?
Non. Il montre seulement que les douze chiffres sont cohérents entre eux. Il ne dit pas si le numéro a été attribué, qui est le détenteur du wagon ni si le code de type est correct.
Outils associés
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/enc/uic-wagon \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"21812471217"}'const res = await fetch("https://api.kit.forhosting.com/enc/uic-wagon", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": "21812471217"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/uic-wagon",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": "21812471217"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/uic-wagon", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":"21812471217"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":"21812471217"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/uic-wagon", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"number": "21812471217"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.uic_wagon",
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Espaces, tirets et points du format imprimé habituel sont retirés avant l'arithmétique ; lettres et autres non-chiffres sont rejetés avec une erreur invalid_input claire. Exécutez-la gratuitement dans le navigateur ou appelez l'API KIT au prix publié ; les deux chemins utilisent le même algorithme entier pur, sans réseau et sans registres de véhicules stockés.
Comment le chiffre de contrôle UIC est calculé
Comme l'algorithme est de l'arithmétique entière pure à poids fixes, la même charge utile produit toujours le même chiffre de contrôle sur chaque plateforme — navigateur, Worker ou banc de tests hors ligne —, c'est pourquoi la capacité est livrée en moteur parse de tier A et non en appel de modèle.
Comment calculer un chiffre de contrôle ou valider un numéro complet
Espaces, tirets et points optionnels sont retirés pour que les formulaires acceptent la mise en page d'affichage courante avec groupes et un tiret final avant le chiffre de contrôle ; lettres et autres symboles sont rejetés comme entrée non numérique avec invalid_input, de sorte qu'un formulaire n'accepte jamais une valeur nettoyée en silence qui reste fausse. Le mode compute est le défaut : fournissez exactement onze chiffres de charge utile après nettoyage ; le moteur renvoie check_digit comme chaîne d'un caractère, vehicle_number comme ces onze chiffres plus le contrôle, et length douze. La réponse indique valid true lorsque le chiffre final correspond au expected_check_digit recalculé, et inclut toujours payload (les onze premiers chiffres), check_digit tel qu'envoyé, expected_check_digit et le vehicle_number canonique formé de payload plus le chiffre attendu. Comme le chemin est parse pur, sans horloge, source aléatoire ni réseau, la même entrée produit toujours le même JSON sur l'outil gratuit du navigateur et sur l'API. À $0.002 par requête réussie vous pouvez protéger les imports massifs de flotte, les fichiers d'échange RIV et les audits EDI partenaires sans négocier un palier sur mesure.
Où les chiffres de contrôle UIC s'intègrent aux flux ferroviaires réels
Les tests d'intégration et les jobs de qualité de données recalculent expected_check_digit pour chaque colonne véhicule d'un export et mettent en quarantaine les écarts avant qu'ils n'atteignent les registres nationaux ou internationaux. Les imprimantes d'étiquettes qui composent des pochoirs à partir de charges utiles de onze chiffres appellent le mode compute une fois par véhicule et placent vehicle_number sous le graphisme de marquage. Dans chaque flux le contrat est le même : chiffres après nettoyage optionnel des séparateurs, onze pour compute ou douze pour validate, JSON structuré testable par goldens, comportement identique gratuit dans le navigateur ou via solde prépayé KIT, et échec honnête lorsque l'entrée n'est pas une chaîne UIC bien formée.
Cas d'intégration
Compléter une charge utile de onze chiffres pour plaques et peinture
Prenez les chiffres de type, de pays et de série (onze au total), appelez le mode compute et imprimez vehicle_number sur le wagon pour que le marquage porte un chiffre de contrôle UIC valide pour le partenaire.
Valider des numéros de wagon scannés ou saisis à l'entrée
Lorsqu'un scanner portable ou un formulaire envoie douze chiffres, appelez le mode validate et bloquez les mises à jour de flotte ou de triage si valid est false, en affichant expected_check_digit pour corriger une faute de frappe.
Questions techniques
Comment calculer un chiffre de contrôle UIC avec cette API ?
Envoyez un POST avec number de exactement onze chiffres (espaces, tirets et points optionnels) et mode compute (ou omettez mode). La réponse inclut check_digit et vehicle_number (le code complet à douze chiffres).
Comment valider un numéro de véhicule complet à douze chiffres ?
Envoyez un POST avec la chaîne de douze chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit, payload et le vehicle_number canonique.