ForHosting KIT · Outils pour développeurs

Chiffre de contrôle UTR Royaume-Uni

Calculez ou vérifiez le premier chiffre d’un UTR britannique : le corps 123456789 donne le chiffre de contrôle 1, d’où l’UTR complet 1123456789. Repérez une référence mal saisie avant qu’elle n’arrive dans un formulaire ou un import. 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
123456789
Mode de calcul
Compute
Vous obtenez
Entrée
123456789
Chiffre de contrôle
1
Avec chiffre de contrôle
1123456789
Somme pondérée
230

Le Unique Taxpayer Reference (UTR) est l’identifiant à dix chiffres que HM Revenue and Customs délivre aux particuliers et aux sociétés pour le Self Assessment et l’impôt sur les sociétés. Le chiffre initial n’est pas aléatoire : c’est un chiffre de contrôle dérivé des neuf chiffres du corps à l’aide de poids positionnels fixes et d’une table de restes modulo onze. Une faute de frappe sur un seul chiffre du corps change presque toujours le contrôle exigé, de sorte que les formulaires et les imports par lots peuvent rejeter des UTR impossibles avant les passerelles HMRC. Cette capacité calcule ce chiffre de contrôle initial à partir d’un corps de neuf chiffres que vous détenez déjà, ou valide un UTR complet de dix chiffres et indique si le contrôle stocké correspond à la table de restes pondérés.

Fonctionnement du chiffre de contrôle UTR du Royaume-Uni et de la table de restes

Selon la construction de style HMRC largement documentée chez les comptables et les éditeurs de logiciels, un Unique Taxpayer Reference standard comporte dix chiffres décimaux. Le premier est le chiffre de contrôle ; les neuf suivants forment le corps. Chaque chiffre du corps est multiplié par un poids fixe de la séquence six, sept, huit, neuf, dix, cinq, quatre, trois, deux de gauche à droite.

Ces neuf produits sont additionnés et la somme est réduite modulo onze pour produire un reste entre zéro et dix.

Une table de restes associe ce reste à un seul chiffre de contrôle : le reste zéro donne le contrôle zéro ; le reste un est rejeté car onze moins un vaut dix, ce qui ne tient pas sur une seule position décimale et n’est jamais émis comme corps UTR légal ; les restes de deux à dix correspondent aux contrôles de neuf à un, soit la même règle que onze moins le reste lorsque le résultat n’est pas dix.

La validation recalcule le chiffre initial attendu à partir des neuf chiffres du corps et le compare au premier chiffre de la chaîne de dix chiffres soumise. Cette conception n’est ni Luhn, ni Damm, ni le ISO 7064 MOD 11-2 pur : c’est un schéma modulo onze à poids fixes avec contrôle en tête plutôt qu’en fin. Par rapport aux chiffres de contrôle de codes-barres comme EAN ou UPC, la règle UTR n’est pas liée à une disposition GTIN de détail et place toujours le contrôle en tête.

Par rapport aux schémas Steuer-ID allemand ou personnummer suédois, l’alphabet reste purement numérique et le vecteur de poids est propre à cette référence fiscale. Utilisez-le uniquement pour l’hygiène de format ; un contrôle réussi ne prouve pas que HMRC a émis le numéro, qu’il appartient à une personne donnée ni qu’une déclaration est autorisée.

Où les chiffres de contrôle UTR du Royaume-Uni s’intègrent dans les systèmes réels

Les cabinets comptables et les éditeurs fiscaux ont besoin d’un oracle partagé qui correspond à la table de restes pondérés utilisée dans les macros de tableur et les outils de bureau hérités, afin qu’un UTR mal saisi échoue à la saisie et non à l’envoi HMRC. Les produits fintech et de paie qui collectent des références Self Assessment pour les travailleurs indépendants peuvent valider à la perte de focus et afficher le chiffre initial attendu lorsque le contrôle saisi ne correspond pas, réduisant les tickets de support pour déclarations rejetées.

Les flux de secrétariat sociétaire et de constitution stockent des UTR d’impôt sur les sociétés à côté des numéros Companies House et peuvent valider par lots chaque colonne de dix chiffres d’un CSV partenaire avant un envoi massif. Les tests d’intégration et les jobs de qualité de données recalculent le chiffre de contrôle attendu pour chaque ligne et signalent celles dont la valeur complète stockée 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.

Les équipes produit qui utilisent déjà Luhn pour des champs de type carte ou ISO 7064 pour d’autres identifiants nationaux peuvent adopter ce schéma lorsqu’une spécification de référence fiscale britannique exige le contrôle pondéré en tête. Documentez que vous stockez un UTR du Royaume-Uni à côté du numéro pour ne jamais le confondre avec des numéros de National Insurance, de TVA ou des CRN Companies House.

N’utilisez jamais cet outil pour inventer de fausses identités fiscales à des fins de fraude ; il s’agit uniquement d’un contrôle de format et il ne contacte pas HMRC.

Auditer en lot les colonnes UTR de Self Assessment

Validez par lots chaque UTR de dix chiffres d’un export client ou d’un dump CRM et mettez en quarantaine les lignes dont le chiffre de contrôle initial ne correspond plus à la table de restes pondérés.

Qu’est-ce qu’un chiffre de contrôle UTR du Royaume-Uni ?

C’est le chiffre initial d’un Unique Taxpayer Reference à dix chiffres, calculé à partir des neuf chiffres du corps avec les poids 6,7,8,9,10,5,4,3,2 et une table de restes modulo onze (11 − reste, avec reste 0 → 0 et reste 1 jamais émis).

Que se passe-t-il avec des lettres, des espaces ou une mauvaise longueur ?

Compute exige exactement neuf chiffres ; validate exige exactement dix. Les tâches de validation en échec ne sont pas facturées.

L’outil de chiffre de contrôle UTR du Royaume-Uni est-il gratuit ?

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

Comment se calcule le chiffre de contrôle d’un UTR britannique ?

Multipliez les neuf chiffres du corps par 6, 7, 8, 9, 10, 5, 4, 3 et 2, additionnez les produits et prenez le reste de la division par 11. Un reste de 0 donne 0 ; les restes 2 à 10 donnent 9 à 1. Pour 123456789 : somme 230, reste 10, chiffre 1.

Un chiffre de contrôle correct prouve-t-il qu’un UTR est authentique ?

Non. Il montre seulement que le numéro est bien formé. Une vérification réussie ne prouve pas que HMRC l’a attribué, qu’il appartient à une personne donnée ni qu’une déclaration est autorisée ; elle repère surtout les fautes de frappe.

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/utr-uk

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/utr-uk \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"123456789"}'
{
  "number": "123456789"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.utr_uk",
  "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.

Une entrée non numérique, des longueurs incorrectes et des corps qui exigeraient une valeur de contrôle à deux chiffres échouent avec une erreur claire invalid_input. Exécutez-la gratuitement dans le navigateur ou appelez l’API KIT au prix publié ; les deux chemins partagent la même arithmétique pure, sans réseau et sans données de contribuables stockées.

Fonctionnement du chiffre de contrôle UTR du Royaume-Uni et de la table de restes

Cet outil nomme toujours l’algorithme uk-utr-weights-mod11 dans le JSON afin que les systèmes aval enregistrent quel schéma a protégé la valeur.

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

Envoyez un champ number ne contenant que les caractères de zéro à neuf après suppression des espaces ou tirets optionnels. Chaînes vides, number manquant, valeurs de mode invalides, neuf chiffres en validate et dix en compute échouent avant la fin du parcours et ne sont pas facturés. Préférez compute pour compléter un corps que vous contrôlez déjà ; préférez validate lorsqu’un utilisateur, un scanner ou une colonne CSV fournit un UTR de dix chiffres et que vous avez besoin d’une porte booléenne avant de rechercher l’enregistrement. Lettres, points décimaux, notation scientifique et autre ponctuation sont rejetés comme entrée non numérique avec invalid_input, afin que vous n’acceptiez jamais une chaîne de déchets « nettoyée » en silence. Le mode compute est le défaut : fournissez exactement neuf chiffres de corps et le moteur renvoie check_digit comme chaîne d’un caractère, with_check comme l’UTR à dix chiffres avec le contrôle en tête, plus weighted_sum et remainder pour les pistes d’audit. Le mode validate attend un UTR complet de dix chiffres : la réponse indique valid vrai lorsque le chiffre initial correspond à la valeur de table de restes du corps, et inclut toujours check_digit, body sans le chiffre initial, weighted_sum, remainder et expected_check_digit lorsqu’une valeur attendue légale existe. Les corps dont la somme pondérée laisse le reste un ne peuvent pas produire un contrôle à un chiffre : compute les rejette avec invalid_input et validate renvoie valid faux. 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 sur l’outil gratuit du navigateur et sur l’API. À $0.002 par requête réussie vous pouvez protéger des imports CRM en masse, des formulaires d’onboarding Self Assessment et des audits de fichiers partenaires sans négocier un palier sur mesure.

Compléter un corps UTR de neuf chiffres avec son chiffre de contrôle

Lorsque votre système détient les neuf chiffres du corps d’un Unique Taxpayer Reference, appelez le mode compute et stockez with_check afin que chaque enregistrement porte un UTR de dix chiffres bien formé avant l’impression de formulaires ou de lettres.

Valider des UTR complets saisis ou importés à l’entrée

Lorsqu’un utilisateur ou une ligne CSV soumet un UTR de dix chiffres, appelez le mode validate et bloquez la recherche lorsque valid est faux, en affichant éventuellement expected_check_digit pour aider à corriger une seule faute de frappe.

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

Effectuez un POST avec number égal aux neuf chiffres du corps et mode compute (ou omettez mode). La réponse inclut check_digit, with_check (contrôle initial plus corps), weighted_sum et remainder.

Comment valider un Unique Taxpayer Reference complet ?

Effectuez un POST avec l’UTR complet de dix chiffres (espaces ou tirets optionnels) et mode validate. La réponse inclut valid, check_digit, expected_check_digit le cas échéant, body, weighted_sum et remainder.

Consulter la documentation complète du KIT →