ForHosting KIT · Outils pour développeurs

Chiffre de contrôle NPI

La base 123456789 reçoit le chiffre de contrôle 3 : le NPI complet est donc 1234567893. Saisissez neuf chiffres pour compléter l'identifiant d'un prestataire de soins américain, ou dix pour confirmer son dernier chiffre avant une demande de remboursement ou un annuaire. 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: 123456789

Vous obtenez

Mode de calcul: Compute
Entrée: 123456789
Préfixe: 80840
Avec préfixe: 80840123456789

Le National Provider Identifier des États-Unis est un numéro à dix chiffres qui identifie les cliniciens individuels et les prestataires organisationnels dans les demandes, les inscriptions et les annuaires sous HIPAA. Les neuf premiers chiffres sont l’identifiant de base émis via NPPES ; le dixième est un chiffre de contrôle produit par l’algorithme de Luhn après application du préfixe constant 80840 à la base. Cette règle fait se comporter un NPI comme un identifiant de style ISO aux fins de somme de contrôle, sans prétendre qu’il s’agit d’une carte de paiement. Cette capacité n’implémente que cette règle CMS : le mode compute accepte exactement neuf chiffres de base et renvoie le chiffre de contrôle plus le NPI complet à dix chiffres ; le mode validate accepte un NPI complet à dix chiffres et indique si le chiffre final correspond à la valeur attendue recalculée.

Comment le chiffre de contrôle NPI se calcule avec le préfixe 80840

Selon la spécification des Centers for Medicare & Medicaid Services, un NPI comporte toujours dix chiffres décimaux. Les positions un à neuf forment l’identifiant de base (les individus commencent en général par un, les organisations par deux, bien que cet outil n’impose pas le type d’émetteur). La position dix est le chiffre de contrôle.

Pour le calculer, concaténez la constante fixe de cinq chiffres 80840 devant la base de neuf, ce qui produit une chaîne de quatorze chiffres imitant la charge d’un calcul Luhn de type numéro de carte.

Appliquez l’algorithme classique double-add-double de Luhn depuis la droite de cette chaîne de quatorze : doublez chaque second chiffre en commençant par le chiffre de base le plus à droite, car une fois le chiffre de contrôle ajouté ce chiffre de base occupe la position deux depuis la droite de la séquence complète de quinze de style ISO. Lorsque le double d’un chiffre est supérieur à neuf, soustrayez neuf (de façon équivalente, additionnez les dizaines et les unités du produit).

Additionnez chaque valeur pondérée ; le chiffre de contrôle est dix moins cette somme modulo dix, modulo dix à nouveau, afin que la séquence complète y compris le contrôle ait un total Luhn divisible par dix. La validation recalcule le chiffre attendu à partir des neuf premiers caractères après le même préfixe 80840 et le compare au dixième chiffre du NPI soumis. L’algorithme est déterministe et local : aucun appel au registre NPPES, aucune horloge et aucune aléatoire.

Cet outil ne résout pas les NPI en noms, ne prouve ni la taxonomie ni le statut d’inscription et ne contacte pas CMS : il prouve seulement que la chaîne de chiffres est bien formée selon la règle Luhn officielle avec 80840.

Par rapport aux outils Luhn génériques de carte ou d’IMEI, l’intention de recherche ici est étroite : ceux qui ont besoin d’une calculatrice de chiffre de contrôle NPI pour des bases à neuf chiffres ou d’un vérificateur de National Provider Identifier à dix, non d’un outil de paiement ou d’appareil.

Où les chiffres de contrôle NPI s’insèrent dans les flux de santé réels

Les éditeurs de gestion de cabinet et d’EHR reçoivent des bases internes à neuf chiffres dans des sandboxes d’onboarding et doivent ajouter le chiffre de contrôle Luhn officiel avant qu’un NPI n’apparaisse sur des demandes, des factures ou des annuaires de prestataires. Les clearinghouses et les payeurs valident les NPI à dix chiffres à l’admission des demandes afin qu’une seule transposition ne crée pas un prestataire fantôme ni une transaction 837 rejetée.

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

Ne traitez pas un NPI qui passe la vérification comme preuve que le prestataire est actif dans NPPES, autorisé dans un État ou inscrit auprès d’un payeur ; cela prouve seulement que le chiffre Luhn est cohérent avec la base sous les poids CMS 80840 utilisés pour les National Provider Identifiers.

Cas d’usage

Auditer les colonnes NPI dans les données de référence des prestataires

Validez par lots chaque NPI à dix chiffres dans un CSV d’EHR, de credentialing ou de clearinghouse 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 NPI ?

C’est le dixième chiffre d’un National Provider Identifier américain, calculé avec l’algorithme de Luhn après préfixation de la constante 80840 aux neuf premiers chiffres, afin que les erreurs de saisie et de lecture soient en général détectées avant stockage ou facturation.

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

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

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

On place 80840 devant la base de neuf chiffres et on applique la méthode de Luhn à ces quatorze chiffres : on double un chiffre sur deux en partant de la droite, on retire neuf à tout résultat supérieur à neuf, puis on additionne. Le chiffre de contrôle amène le total à un multiple de dix.

Pourquoi ajoute-t-on 80840 devant la base ?

C'est le préfixe fixe de la règle des CMS : il donne au NPI le même chiffre de contrôle qu'un numéro de type carte vérifié par Luhn. Il ne sert qu'au calcul, et le NPI imprimé garde dix chiffres, comme 1234567893.

Un NPI valide signifie-t-il que le prestataire est actif ?

Non. Un résultat valide indique seulement que le dernier chiffre correspond au calcul. L'outil n'interroge pas le registre NPPES et ne dit pas si le prestataire est actif, inscrit ou titulaire d'une licence.

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/npi

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

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

import os, requests

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

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

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

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.npi",
  "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 mauvaises longueurs é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 publié de l’API, sans consultation réseau des registres NPPES et sans affirmer qu’une somme de contrôle valide signifie que le prestataire est actif, inscrit ou autorisé.

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

Envoyez un champ number ne contenant que les caractères de zéro à neuf. Une mauvaise longueur est une erreur explicite qui nomme le mode et la longueur envoyée —neuf pour compute, dix pour validate— afin que les formulaires clients puissent afficher « neuf chiffres requis » sans deviner. Chaînes vides, number manquant et valeurs de mode invalides échouent avant toute somme Luhn et ne sont pas facturés. Les tâches de validation qui rejettent une forme incorrecte ne sont pas facturées ; une chaîne bien formée de dix chiffres qui a simplement le mauvais chiffre de contrôle renvoie valid false sans lever d’exception. 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 neuf chiffres, renvoie check_digit comme chaîne d’un caractère, renvoie with_check comme le NPI à dix chiffres que vous pouvez imprimer ou persister, et renvoie aussi prefix (toujours 80840) et prefixed (80840 plus la base de neuf) pour les pistes d’audit et le débogage de la règle CMS. Le mode validate exige exactement dix chiffres ; la réponse indique valid true lorsque le chiffre final correspond à expected_check_digit recalculé, et inclut toujours payload (les neuf premiers chiffres), check_digit, expected_check_digit, prefix, prefixed et length dix. Les alias digits, npi et code sont acceptés pour le même champ de charge afin que les intégrations qui parlent déjà de « npi » n’aient pas à 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 gratuit du navigateur et sur l’API à $0.002 par requête réussie.

Où les chiffres de contrôle NPI s’insèrent dans les flux de santé réels

Les équipes de credentialing et de listes recalculent expected_check_digit lorsqu’une clinique lit un numéro au téléphone ou le colle depuis un PDF, capturant les fautes de frappe avant l’envoi d’un contrat ou d’un fichier d’inscription.

Cas d'intégration

Compléter une base NPI à 9 chiffres pour des fixtures de demandes

Appelez le mode compute avec la base de neuf chiffres, stockez with_check et utilisez le NPI à dix dans des demandes de test, factures ou enregistrements sandbox de prestataires.

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

Lorsqu’un formulaire, un fichier de liste ou un flux partenaire envoie dix chiffres, appelez le mode validate et bloquez l’inscription 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 NPI avec cette API ?

Envoyez un POST avec number égal à exactement neuf chiffres et mode compute (ou omettez mode). La réponse inclut check_digit, with_check (le NPI complet à dix chiffres) et prefix 80840 pour l’audit de la règle CMS.

Comment valider un NPI complet à dix chiffres ?

Envoyez un POST avec la chaîne de dix chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit et payload (chiffres sans le dernier).

L’outil de chiffre de contrôle NPI 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 ; l’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 NPI se calcule avec le préfixe 80840

Où les chiffres de contrôle NPI s’insèrent dans les flux de santé réels

Cas d’usage

Auditer les colonnes NPI dans les données de référence des 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 NPI s’insèrent dans les flux de santé réels

Cas d'intégration

Compléter une base NPI à 9 chiffres pour des fixtures de demandes

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

Questions techniques

merci