Calcul et validation du chiffre de contrôle du NIF portugais

Saisissez les huit premiers chiffres pour calculer le neuvième, ou transmettez les neuf chiffres afin de vérifier si le chiffre fourni correspond au calcul. Le résultat est déterministe et immédiat, ce qui convient aux formulaires, importations, procédures comptables et validations par API. Les longueurs incorrectes, les caractères non numériques et les modes non pris en charge sont signalés clairement, sans nettoyage ni interprétation silencieuse.

Choisissez entre le calcul et la validation

Utilisez le mode de calcul lorsque vous possédez déjà la base à huit chiffres d’un NIF portugais et souhaitez obtenir son chiffre de contrôle final. La réponse comprend le chiffre calculé et la valeur complète à neuf chiffres, que vous pouvez intégrer directement à une validation ultérieure ou à un scénario de test. Utilisez le mode de validation lorsque la source contient déjà les neuf chiffres. La validation sépare les huit premiers du neuvième fourni, calcule la valeur attendue et indique si les deux concordent. Elle renvoie également les chiffres fourni et attendu, ce qui facilite le diagnostic d’un échec. Conservez l’entrée sous forme de chaîne plutôt que de nombre. Une chaîne préserve précisément chaque caractère, y compris un zéro initial, et empêche le formatage numérique d’un tableur ou d’un langage de programmation de modifier l’identifiant avant son évaluation. Le mode par défaut est la validation, mais vous devriez le préciser explicitement lorsqu’un processus peut recevoir les deux formats.

Comprenez le calcul modulo onze

L’algorithme traite les huit premiers chiffres de gauche à droite avec des coefficients décroissants allant de neuf à deux. Il multiplie le premier chiffre par neuf, le deuxième par huit, puis poursuit jusqu’à multiplier le huitième par deux. Les huit produits sont additionnés et le total est réduit modulo onze. Si le reste vaut zéro ou un, le chiffre de contrôle est zéro. Pour tout autre reste, le chiffre correspond à onze moins ce reste. La validation exécute strictement le même calcul sur les huit premières positions et compare le résultat à la neuvième. Cette capacité ne retire ni espaces, ni points, ni tirets, ni préfixes nationaux, ni libellés avant le calcul. Cette rigueur est volontaire : un nettoyage automatique pourrait donner une apparence fiable à des données mal formées et masquer une erreur antérieure de correspondance des champs. Envoyez uniquement des chiffres ASCII de zéro à neuf. Aucune requête réseau, valeur aléatoire, horloge, base de données ou conversion régionale n’intervient ; une entrée et un mode identiques produisent donc toujours la même sortie JSON.

Interprétez le résultat et ses limites

Un résultat de validation vrai signifie que le neuvième chiffre concorde avec la somme de contrôle modulo onze dérivée des huit précédents. Il s’agit d’un contrôle structurel utile pour repérer les fautes de saisie, les importations endommagées et les colonnes mal associées, mais il ne prouve pas que le numéro a été attribué, qu’il reste actif ou qu’il appartient à une personne ou une organisation donnée. Ces questions nécessitent un registre faisant autorité ou une procédure professionnelle adaptée. De même, ce calculateur vérifie délibérément la somme de contrôle sans imposer d’hypothèse sur les catégories éventuellement encodées dans le premier chiffre. Son périmètre reste ainsi précis et un numéro au contrôle valide n’est pas rejeté en raison d’une évolution externe des règles d’attribution. Dans un pipeline, distinguez une erreur d’entrée d’un résultat faux : l’erreur signale un type, une longueur, des caractères ou un mode incorrects ; faux indique qu’une valeur bien formée a été vérifiée sans concordance. Chaque requête API coûte $0.002, et le même noyau déterministe peut s’exécuter dans le navigateur.