ForHosting KIT · Outils pour développeurs

Chiffre de contrôle NIP polonais

Les neuf chiffres 526104082 reçoivent le chiffre de contrôle 8, ce qui donne le NIP 526-104-08-28. Saisissez neuf chiffres pour compléter un numéro fiscal polonais, ou les dix pour repérer un chiffre mal tapé ou inversé avant d'enregistrer une facture ou un fournisseur. 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

Nip: 526104082
Mode de calcul: Compute

Vous obtenez

Entrée: 526104082
Chiffre de contrôle: 8
Avec chiffre de contrôle: 5261040828
Formaté: 526-104-08-28

Le numéro d'identification fiscale polonais (NIP, Numer Identyfikacji Podatkowej) est un code à dix chiffres utilisé sur les factures, les registres d'entreprises, les fichiers de paie et les champs fiscaux du commerce électronique en Pologne. Le dernier chiffre est un chiffre de contrôle dérivé d'une pondération fixe des neuf premiers chiffres selon la règle modulaire standard des systèmes fiscaux polonais. Un seul chiffre mal saisi ou une paire inversée casse souvent cette somme de contrôle, de sorte que valider le NIP avant d'émettre une facture, d'ouvrir un fournisseur ou d'accepter un fichier partenaire détecte tôt de nombreuses erreurs de frappe. Cette capacité calcule le chiffre de contrôle NIP polonais pour une charge de neuf chiffres (avec ou sans tirets courants), ou valide un numéro complet de dix chiffres qui inclut déjà le chiffre final, et signale une entrée incorrecte au lieu d'inventer un chiffre en silence.

Ce qu'est le chiffre de contrôle NIP polonais et comment fonctionnent les poids

Un NIP identifie les contribuables et les entités juridiques dans les flux fiscaux, commerciaux et administratifs polonais. Les formulaires imprimés regroupent souvent les chiffres avec des tirets du type XXX-XXX-XX-XX, mais la valeur sous-jacente est toujours dix chiffres décimaux. Les neuf premiers forment le corps ; le dixième est entièrement déterminé par un algorithme de contrôle public et n'est pas choisi librement par le contribuable.

La pondération officielle multiplie ces neuf chiffres, de gauche à droite, par la séquence fixe six, cinq, sept, deux, trois, quatre, cinq, six et sept. Les produits sont additionnés et le reste de cette somme modulo onze est le chiffre de contrôle candidat. Lorsque le reste vaut de zéro à neuf, cette valeur est le chiffre de contrôle et complète une chaîne NIP bien formée.

Lorsque le reste vaut dix, aucun chiffre décimal unique de contrôle n'existe pour ce corps : la combinaison de neuf chiffres n'est pas attribuable comme NIP valide selon la règle standard. Ce cas particulier explique pourquoi certaines chaînes aléatoires de neuf chiffres n'apparaissent jamais comme vrais numéros fiscaux même avant toute consultation de registre.

Comparé au Luhn mod-dix des cartes de paiement, le schéma NIP utilise un vecteur de poids fixe de gauche à droite et le modulo onze, de sorte que vous ne devez pas réutiliser un validateur Luhn sur les champs d'identifiant fiscal polonais. Comparé aux tables de lettres du DNI espagnol ou aux poids du CUIT argentin, la règle NIP polonaise est propre à cette disposition à dix chiffres et à ces neuf multiplicateurs.

Savoir quel schéma vous devez utiliser évite une fausse confiance lorsqu'un utilitaire générique de chiffre de contrôle accepte une chaîne qui n'est pas un NIP bien formé. Cet outil applique la pondération standard sur des chiffres purs après suppression optionnelle des tirets et espaces. Il ne interroge pas de portails gouvernementaux, ne prouve pas qu'une entreprise existe ni n'attribue un code de type — seulement que la chaîne de chiffres est cohérente avec l'algorithme de contrôle publié.

Où les chiffres de contrôle NIP s'intègrent dans les flux fiscaux, de facturation et commerciaux

Les systèmes de facturation électronique et de facturation stockent le NIP client ou fournisseur sur chaque document légal ; un seul chiffre mal saisi à l'onboarding peut envoyer un XML fiscal à la mauvaise partie ou faire échouer l'autorisation plus tard. Les checkouts e-commerce qui collectent l'identifiant fiscal d'une entreprise polonaise pour des commandes B2B peuvent recalculer le chiffre de contrôle sans appeler un registre externe, filtrant tôt le bruit OCR et les captures partielles.

Les équipes produit qui exposent déjà des outils généraux Luhn ou ISO 7064 doivent encore utiliser cette capacité spécifique NIP pour les champs d'identifiant fiscal polonais afin que poids, bornes de longueur et formatage des tirets correspondent au domaine. Les pages éducatives et SEO qui se classent sur des phrases telles que chiffre de contrôle NIP polonais ou validateur NIP Pologne ont besoin d'un outil gratuit en direct dont le chemin navigateur coïncide avec l'automatisation pour que les captures de tutoriels restent exactes.

Ne traitez pas un chiffre de contrôle NIP correct comme preuve que la personne ou l'entreprise est correctement identifiée, active auprès de l'administration fiscale, autorisée à facturer ou présente dans un registre officiel — cela prouve seulement que la chaîne de chiffres est cohérente avec l'algorithme de contrôle NIP polonais.

Cas d’usage

Auditer les colonnes NIP dans les fichiers partenaires et factures

Validez en lot chaque NIP d'un import CSV et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur attendue recalculée.

Questions fréquentes

Comment calcule-t-on le chiffre de contrôle du NIP polonais ?

Multipliez les neuf premiers chiffres par les poids 6, 5, 7, 2, 3, 4, 5, 6 et 7, additionnez les produits et prenez la somme modulo 11. Si le reste est 0–9 c'est le chiffre de contrôle ; s'il est 10 le corps n'est pas une base NIP valide.

Quelle est la différence entre les modes compute et validate ?

Compute prend neuf chiffres et renvoie le chiffre de contrôle et le NIP complet à dix chiffres. Validate prend dix chiffres incluant le final et indique s'il correspond au chiffre de contrôle recalculé.

Les tirets et espaces sont-ils autorisés ?

Oui. Les séparateurs courants sont supprimés avant l'analyse.

Que se passe-t-il si le chiffre de contrôle est incorrect ?

En mode validate la réponse inclut encore le chiffre attendu lorsqu'il existe, et valid est false.

Pourquoi certains numéros de neuf chiffres n'ont-ils aucun chiffre de contrôle valide ?

Parce que lorsque la somme pondérée divisée par onze laisse un reste de dix, aucun chiffre ne peut la compléter. Ce corps ne sera jamais un NIP valide, et l'outil le signale au lieu d'inventer un chiffre.

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

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

import os, requests

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

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

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

{
  "nip": "526104082"
}

Exemple de réponse

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

Utilisez-la gratuitement dans le navigateur ou appelez l'API KIT au prix publié ; les deux chemins exécutent la même arithmétique déterministe sans requête réseau et sans registre de contribuables réels.

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

Envoyez un champ nip contenant les chiffres de zéro à neuf, éventuellement séparés par des tirets ou des espaces. Le mode validate attend un numéro complet de dix chiffres incluant le chiffre de contrôle final (par exemple 5261040828 ou 526-104-08-28). Chaînes vides, nip manquant, valeurs de mode invalides et longueurs incorrectes échouent avant toute somme pondérée et ne sont pas facturées. Préférez compute lorsque vous assemblez un NIP à partir d'un corps de neuf chiffres connu ; préférez validate lorsqu'un utilisateur, un fichier partenaire ou une étiquette scannée fournit un numéro complet et que vous avez besoin d'un filtre booléen avant une consultation de registre ou de données maîtres. Lettres, autre ponctuation, tirets doubles ou tirets en tête ou en fin sont rejetés comme entrée mal formée avec invalid_input afin que vous n'acceptiez jamais une valeur nettoyée en silence. Le mode compute est le défaut : fournissez exactement neuf chiffres sans le chiffre de contrôle (par exemple 526104082 ou un corps de neuf chiffres à tirets) et le moteur renvoie check_digit comme chaîne d'un caractère, with_check comme la chaîne complète de dix chiffres incluant ce chiffre, et formatted sous la forme habituelle XXX-XXX-XX-XX. Si la somme pondérée modulo onze vaut dix, le mode compute échoue avec invalid_input car aucun chiffre final valide n'existe pour ce corps. La réponse indique valid true lorsque le chiffre recalculé correspond au dernier, et inclut toujours check_digit, payload sans le dernier chiffre, weighted_sum_mod11 et formatted pour un affichage cohérent ; lorsqu'un chiffre attendu valide existe, il est aussi renvoyé comme expected_check_digit. Comme le chemin est purement parse, 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 filtrer des imports massifs de fournisseurs, des formulaires d'onboarding et des jobs ETL sans négocier un niveau sur mesure.

Où les chiffres de contrôle NIP s'intègrent dans les flux fiscaux, de facturation et commerciaux

Le mode validate à l'entrée bloque l'enregistrement lorsque valid est false et peut afficher expected_check_digit pour que le greffier corrige le formulaire avant d'écrire l'enregistrement. Les imports de paie, comptabilité et CRM reçoivent des NIP partenaires depuis des tableurs où un mauvais chiffre final rejetterait un lot entier ; un oracle déterministe qui renvoie valid et with_check permet de marquer les lignes avant la production.

Cas d'intégration

Filtrer les champs NIP sur les formulaires fournisseurs et clients

Lorsqu'un utilisateur soumet un NIP polonais complet, appelez le mode validate et bloquez l'enregistrement si valid est false, en affichant expected_check_digit pour corriger une seule erreur de frappe avant d'écrire l'enregistrement ERP.

Calculer le chiffre final lors de la complétion d'identifiants

À partir d'un corps de neuf chiffres, appelez le mode compute et stockez with_check ou formatted afin que chaque nouvelle chaîne NIP porte le chiffre final correct avant impression, export ou génération de facture.

Questions techniques

Combien coûte le calculateur de chiffre de contrôle NIP polonais ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →