ForHosting KIT · Outils pour développeurs

Chiffre de contrôle REGON Pologne

Saisissez la base 12345678 et obtenez le chiffre de contrôle 5 : le REGON complet est 123456785. L'outil valide aussi les numéros de 9 et 14 chiffres, y compris la partie de l'entité mère dans une unité locale, et repère les fautes de frappe. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Nombre: 12345678

Vous obtenez

Mode de calcul: Compute
Entrée: 12345678
Forme: 9
Chiffre de contrôle: 5

Le REGON est le numéro d'identification statistique polonais attribué par Główny Urząd Statystyczny (GUS) dans le Registre officiel national de l'activité économique (Rejestr Gospodarki Narodowej). La plupart des entités reçoivent un REGON à neuf chiffres ; les unités locales d'organisations multi-sites reçoivent un REGON à quatorze chiffres dont les neuf premiers correspondent à l'entité parente. Le chiffre final de chaque forme est un chiffre de contrôle produit avec des poids officiels fixes et une règle modulo onze qui transforme le reste dix en zéro. Cette capacité n'implémente que cette règle : le mode compute accepte huit chiffres de base pour un REGON à neuf ou treize chiffres de base pour un REGON à quatorze et renvoie le chiffre de contrôle plus le numéro complet ; le mode validate accepte une chaîne complète de neuf ou quatorze chiffres et indique si le chiffre final correspond à la valeur attendue recalculée.

Comment le chiffre de contrôle REGON est calculé (formes à 9 et 14 chiffres)

Selon la spécification GUS, un REGON standard comporte toujours neuf chiffres décimaux. Les positions un à huit forment la charge utile délivrée pour l'entité juridique ou l'unité ; la position neuf est le chiffre de contrôle. Pour le calculer, multipliez ces huit chiffres par la séquence officielle de poids huit, neuf, deux, trois, quatre, cinq, six, sept, additionnez les produits et prenez la somme modulo onze.

Si le reste est dix, le chiffre de contrôle est zéro ; sinon le reste lui-même est le chiffre de contrôle. Un REGON à quatorze chiffres étend la forme à neuf avec cinq chiffres supplémentaires qui identifient une unité locale d'une organisation multi-sites. Les positions un à neuf sont le REGON parent (y compris son propre chiffre de contrôle) ; les positions dix à treize sont la charge de l'unité locale ; la position quatorze est un second chiffre de contrôle.

Ce chiffre final utilise une autre séquence officielle de poids sur les treize premiers chiffres : deux, quatre, huit, cinq, zéro, neuf, sept, trois, six, un, deux, quatre, huit. À nouveau la somme est prise modulo onze, et le reste dix devient zéro.

La validation recalcule le chiffre attendu pour la longueur soumise et le compare au dernier caractère ; pour les numéros à quatorze chiffres, cet outil indique aussi si le REGON parent à neuf chiffres embarqué passe encore sa propre vérification, afin qu'une tête corrompue ne soit pas masquée par un chiffre final chanceux. L'algorithme est déterministe et local : aucun appel au registre REGON, aucune horloge et aucun aléa. Un jeu de test connu est la base un-deux-trois-quatre-cinq-six-sept-huit, qui produit le chiffre de contrôle cinq et le REGON complet un-deux-trois-quatre-cinq-six-sept-huit-cinq.

Cet outil ne résout pas les numéros REGON en noms d'entreprise, ne prouve pas le statut fiscal ni l'activité, et ne contacte pas le GUS — il prouve seulement que la chaîne de chiffres est bien formée selon la règle officielle pondérée modulo onze.

Par rapport aux outils Luhn ou PESEL génériques, l'intention de recherche ici est étroite : les personnes qui ont besoin d'un calculateur de chiffre de contrôle REGON Pologne pour des bases de huit ou treize chiffres, ou d'un validateur REGON à neuf et quatorze chiffres, et non d'un outil d'identité personnelle ou de paiement.

Où les chiffres de contrôle REGON s'intègrent aux flux métier polonais

Les plateformes de comptabilité et de facturation électronique reçoivent des bases internes de huit chiffres pendant l'intégration en bac à sable et doivent ajouter le chiffre de contrôle officiel GUS avant qu'un REGON n'apparaisse sur des factures, des exportations JPK ou des annuaires de prestataires. Les places de marché et portails B2B valident les numéros REGON à neuf chiffres à l'enregistrement des fournisseurs pour qu'une seule transposition ne crée pas une entité fantôme et un document KSeF ou EDI rejeté.

Les opérateurs de vente au détail et de logistique multi-sites recalculent le chiffre de contrôle à quatorze chiffres de l'unité locale lorsqu'un entrepôt ou une succursale est ajouté sous un REGON parent, et revérifient la tête embarquée à neuf chiffres pour que les fichiers d'unité locale ne divergent jamais de l'enregistrement parent.

Les jobs ETL qui chargent des fichiers maîtres de prestataires parcourent chaque colonne REGON d'un export CSV ou ERP, appellent le mode validate et mettent en quarantaine les lignes où valid est false — capturant à la fois les éditions humaines et les bogues de générateurs.

Ne traitez pas un REGON qui passe la vérification comme une preuve que l'entité est active dans le registre REGON, assujettie à la TVA ou agréée pour une activité donnée ; cela prouve seulement que le chiffre de contrôle est cohérent avec la charge utile sous les poids officiels GUS utilisés pour les numéros statistiques polonais.

Cas d’usage

Auditer les colonnes REGON dans les données maîtres de prestataires

Validez par lots chaque REGON à neuf et quatorze chiffres dans un CSV d'ERP, de CRM ou de facturation électronique 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 REGON ?

C'est le chiffre final d'un numéro statistique REGON polonais, calculé avec les poids officiels GUS et une règle mod-11 (le reste dix devient zéro), afin que les erreurs de saisie et de lecture soient généralement détectées avant le stockage ou la facturation du numéro.

Que se passe-t-il avec une longueur incorrecte, des lettres ou des tirets ?

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

Comment se calcule le chiffre de contrôle du REGON ?

Multipliez les huit premiers chiffres par les poids 8, 9, 2, 3, 4, 5, 6, 7, additionnez les produits et divisez par 11. Le reste est le chiffre de contrôle, sauf qu'un reste de 10 devient 0. Pour 12345678, on obtient 5.

Qu'est-ce qu'un REGON à 14 chiffres ?

Il identifie une unité locale, comme une agence ou un entrepôt, d'une organisation à plusieurs sites. Ses neuf premiers chiffres reprennent le REGON de l'entité mère, quatre autres désignent l'unité et le dernier est un second chiffre de contrôle avec ses propres poids.

Un REGON valide signifie-t-il que l'entreprise est active ?

Non. Un chiffre de contrôle correct montre seulement que le numéro est bien formé. L'outil ne consulte pas le registre officiel : il ne peut pas dire si l'entité est active, autorisée ou toujours inscrite.

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

POSThttps://api.kit.forhosting.com/enc/regon-poland

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/regon-poland \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"12345678"}'

const res = await fetch("https://api.kit.forhosting.com/enc/regon-poland", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "number": "12345678"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/regon-poland",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "number": "12345678"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/regon-poland", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"number":"12345678"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"number":"12345678"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/regon-poland", 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": "12345678"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.regon_poland",
  "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

par requête$0.002

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

Les entrées non numériques et les longueurs incorrectes échouent avec invalid_input au lieu d'un nettoyage silencieux, afin que vous ne persistiez jamais un identifiant à moitié nettoyé. La même arithmétique pure s'exécute gratuitement dans le navigateur et au prix API publié, sans consultation réseau du registre REGON et sans prétendre qu'une somme de contrôle valide signifie que l'entité est active, agréée ou encore inscrite.

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

Envoyez un champ number qui ne contient que les caractères zéro à neuf. Une longueur incorrecte est une erreur explicite qui nomme le mode et la longueur envoyée — huit ou treize pour compute, neuf ou quatorze pour validate — afin que les formulaires clients affichent un message clair sans deviner. Les chaînes vides, le number manquant et les valeurs de mode invalides échouent avant toute somme pondérée et ne sont pas facturés. Préférez compute lorsque vous complétez des identifiants de base pour des étiquettes, des jeux de test ou des générateurs internes qui détiennent déjà huit ou treize chiffres ; préférez validate lorsque vous conditionnez un formulaire, un fichier partenaire ou une importation de scanner à un REGON complet fourni par un utilisateur. Les tâches de validation qui rejettent une forme incorrecte ne sont pas facturées ; une chaîne bien formée de neuf ou quatorze chiffres qui a simplement le mauvais chiffre de contrôle renvoie valid false sans lever d'exception. Les espaces, tirets, lettres et points décimaux sont rejetés 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 mode par défaut : le moteur exige exactement huit chiffres pour un REGON à neuf ou exactement treize chiffres pour un REGON à quatorze, renvoie check_digit comme chaîne d'un caractère, renvoie with_check comme le numéro complet que vous pouvez imprimer ou persister, et renvoie aussi form (neuf ou quatorze), length et le vecteur de poids utilisé pour les pistes d'audit. Lors du calcul d'un REGON à quatorze chiffres à partir de treize, la réponse inclut aussi base9 et base9_valid pour que vous voyiez si la tête embarquée à neuf chiffres correspond encore aux poids officiels sur huit chiffres. Le mode validate accepte exactement neuf ou quatorze chiffres ; la réponse indique valid true lorsque le chiffre final correspond à expected_check_digit recalculé, et inclut toujours payload (chiffres sans le dernier), check_digit, expected_check_digit, form et length. Pour la validation à quatorze chiffres, base9_valid et trailing_valid doivent tous deux être vrais pour valid true, de sorte qu'un REGON parent endommagé n'est jamais accepté simplement parce que le quatorzième chiffre correspond par hasard. Des alias tels que digits, regon et code sont acceptés pour le même champ de charge, afin que les intégrations qui parlent déjà de « regon » n'aient pas besoin de renommer. Comme le chemin est un parse pur 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 REGON s'intègrent aux flux métier polonais

Les tests d'intégration figent with_check pour des jeux de test connus tels que un-deux-trois-quatre-cinq-six-sept-huit-cinq afin que les bibliothèques de formulaires, les imprimantes d'étiquettes et cette API ne divergent jamais.

Cas d'intégration

Compléter une base REGON de 8 chiffres pour des jeux de facture

Appelez le mode compute avec huit chiffres, stockez with_check et utilisez le REGON à neuf chiffres dans des factures de test, des échantillons JPK ou des enregistrements de prestataires en bac à sable.

Valider des REGON saisis ou importés à l'entrée

Lorsqu'un formulaire, un flux partenaire ou un scanner envoie neuf ou quatorze chiffres, appelez le mode validate et bloquez l'enregistrement si valid est false, en affichant expected_check_digit pour corriger une seule faute de frappe.

Questions techniques

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

Envoyez un POST avec number réglé à exactement huit chiffres (REGON à neuf) ou treize chiffres (REGON à quatorze) et mode compute (ou omettez mode). La réponse inclut check_digit, with_check, form et le vecteur de poids utilisé.

Comment valider un REGON complet à neuf ou quatorze chiffres ?

Envoyez un POST avec la chaîne de neuf ou quatorze chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit et payload (chiffres sans le dernier). La validation à quatorze chiffres signale aussi base9_valid pour le REGON parent embarqué.

L'outil de chiffre de contrôle REGON est-il gratuit ?

L'outil navigateur est gratuit et s'exécute localement. Les appels API utilisent le solde prépayé KIT au prix de base publié $0.002 ; une entrée invalide n'est jamais facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le chiffre de contrôle REGON est calculé (formes à 9 et 14 chiffres)

Où les chiffres de contrôle REGON s'intègrent aux flux métier polonais

Cas d’usage

Auditer les colonnes REGON dans les données maîtres de prestataires

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

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

Où les chiffres de contrôle REGON s'intègrent aux flux métier polonais

Cas d'intégration

Compléter une base REGON de 8 chiffres pour des jeux de facture

Valider des REGON saisis ou importés à l'entrée

Questions techniques

merci