ForHosting KIT · Outils pour développeurs

Chiffre de contrôle UPC-A

Le numéro de produit 01234567890 reçoit le chiffre de contrôle 5 : l'UPC-A complet s'écrit donc 012345678905. Collez un code entier de douze chiffres venu d'un partenaire ou d'un lecteur pour voir si son dernier chiffre est juste. 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: 01234567890

Vous obtenez

Mode de calcul: Compute
Entrée: 01234567890
Chiffre de contrôle: 5
Avec chiffre de contrôle: 012345678905

Les numéros de produit de détail en Amérique du Nord se terminent presque toujours par un chiffre de contrôle UPC-A : onze chiffres de charge qui identifient le fabricant et l'article, plus un chiffre final qui prouve que toute la chaîne a été saisie ou scannée sans erreur d'un seul chiffre. Cette capacité applique la règle standard GTIN-12 mod-10 utilisée sur chaque UPC-A à douze chiffres : les positions impaires depuis la gauche sont pondérées par trois, les paires par un, et le chiffre de contrôle est le montant nécessaire pour atteindre le prochain multiple de dix. Utilisez le mode compute lorsque vous ne disposez que du numéro de produit à onze chiffres et que vous avez besoin du chiffre pour une étiquette, une base de données ou un générateur de codes-barres ; utilisez le mode validate lorsqu'un partenaire, un scanner ou un formulaire envoie un code complet à douze chiffres et que vous avez besoin d'un indicateur valid clair plus le chiffre attendu pour les messages d'erreur.

Comment le chiffre de contrôle UPC-A est calculé

Un code UPC-A compte toujours douze chiffres. Les onze premiers forment le numéro de produit (souvent un préfixe d'entreprise GS1 plus une référence d'article) ; le douzième est le chiffre de contrôle. Pour le calculer, parcourez les onze chiffres de charge de gauche à droite avec des positions basées sur 1 : multipliez chaque chiffre en position impaire par trois et chaque chiffre en position paire par un, additionnez ces produits, puis prenez le chiffre de contrôle comme (10 moins cette somme modulo 10) modulo 10.

De façon équivalente, la chaîne complète de douze chiffres y compris le contrôle doit avoir une somme pondérée multiple de dix sous les mêmes poids de position. C'est la même famille de règles mod-10 utilisée pour GTIN-8, GTIN-12, GTIN-13 et GTIN-14 ; l'UPC-A est spécifiquement la forme à douze chiffres courante sur les emballages américains et canadiens. L'algorithme est déterministe et local : pas de consultation de catalogue, pas d'appel réseau et pas d'horloge.

Cet outil n'étend pas l'UPC-E, n'invente pas de préfixes pays EAN-13 et n'affirme pas qu'un checksum valide signifie que le produit est autorisé à la vente — il prouve seulement que la chaîne de chiffres est bien formée selon la règle UPC-A. Face aux validateurs multi-symbologies, l'intention de recherche est étroite : ceux qui ont besoin du calculateur de chiffre de contrôle UPC-A pour des charges à onze chiffres, pas d'un vérificateur général EAN ou ISBN.

Où les chiffres de contrôle UPC-A s'intègrent aux flux réels

Les équipes catalogue et PIM reçoivent des numéros de produit internes à onze chiffres et doivent ajouter le chiffre de contrôle UPC-A officiel avant d'imprimer des étiquettes de rayon ou de publier sur des places de marché qui rejettent les GTIN invalides. Les scanners d'entrepôt et les applications de réception valident des codes à douze chiffres au quai pour qu'une seule transposition ne crée pas un SKU fantôme ni un écart de stock.

Les tâches de qualité des données parcourent chaque colonne UPC d'un export CSV, 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 UPC-A validé comme preuve de propriété de marque ou d'enregistrement GS1 ; cela prouve seulement que le chiffre mod-10 est cohérent avec la charge sous les poids standard.

Cas d’usage

Auditer les colonnes UPC dans les exports catalogue

Validez par lot chaque UPC à douze chiffres dans un CSV PIM ou partenaire 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 UPC-A ?

C'est le douzième chiffre d'un code UPC-A, calculé par une somme pondérée mod-10 afin que les erreurs d'un chiffre à la saisie ou au scan soient en général détectées avant le stockage ou l'impression du code.

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.

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

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

Comment se calcule le chiffre de contrôle UPC-A ?

En lisant les onze chiffres depuis la gauche, multipliez ceux de rang impair par 3 et ceux de rang pair par 1, puis additionnez le tout. Le chiffre de contrôle est ce qui amène cette somme au multiple de dix suivant, ou 0 si elle en est déjà un.

Un UPC-A est-il la même chose qu'un EAN-13 ?

Ils appartiennent à la même famille de règles de contrôle, mais l'UPC-A est la forme à douze chiffres, aussi appelée GTIN-12, courante sur les emballages aux États-Unis et au Canada. Cet outil ne traite que cette forme, ni EAN-13 ni ISBN.

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/upc-check

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

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

import os, requests

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

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

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

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.upc_check",
  "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 stockiez jamais un code à moitié nettoyé. La même arithmétique pure s'exécute gratuitement dans le navigateur et au prix API publié.

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

Envoyez un champ number qui ne contient que les caractères de zéro à neuf. Une mauvaise longueur est une erreur explicite qui nomme le mode et la longueur envoyée — onze pour compute, douze pour validate — afin que les formulaires clients puissent afficher « il faut onze chiffres » sans deviner. Chaînes vides, number manquant et valeurs de mode invalides échouent avant toute somme pondérée et ne sont pas facturés. Préférez compute lorsque vous créez ou complétez des numéros de produit ; préférez validate lorsque vous conditionnez une recherche ou une import à un code complet issu d'un utilisateur ou d'un fichier partenaire. 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 défaut : le moteur exige exactement onze chiffres, renvoie check_digit comme chaîne d'un caractère et renvoie with_check comme l'UPC-A à douze chiffres que vous pouvez imprimer ou persister. Le mode validate exige exactement douze chiffres ; la réponse indique valid true lorsque le chiffre final correspond au expected_check_digit recalculé, et inclut toujours payload (les onze premiers chiffres), check_digit, expected_check_digit et length douze. Des alias tels que digits, upc et code sont acceptés pour le même champ de charge, de sorte que les intégrations qui parlent déjà d'« upc » n'ont pas besoin de renommer. Comme le chemin est du 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 UPC-A s'intègrent aux flux réels

Les formulaires d'inscription e-commerce peuvent recalculer expected_check_digit et afficher une correction claire lorsqu'un vendeur colle un code avec le dernier chiffre erroné.

Cas d'intégration

Compléter un numéro de produit à 11 chiffres pour les étiquettes

Appelez le mode compute avec la charge à onze chiffres, stockez with_check et envoyez l'UPC-A à douze chiffres à votre imprimante de codes-barres ou à votre fiche marketplace.

Valider un UPC-A scanné ou saisi à l'entrée

Lorsqu'un scanner ou un formulaire envoie douze chiffres, appelez le mode validate et bloquez la recherche 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 UPC-A avec cette API ?

POST avec number fixé à exactement onze chiffres et mode compute (ou omettez mode). La réponse inclut check_digit et with_check (l'UPC-A complet à douze chiffres).

Comment valider un UPC-A complet à douze chiffres ?

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

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le chiffre de contrôle UPC-A est calculé

Où les chiffres de contrôle UPC-A s'intègrent aux flux réels

Cas d’usage

Auditer les colonnes UPC dans les exports catalogue

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 UPC-A s'intègrent aux flux réels

Cas d'intégration

Compléter un numéro de produit à 11 chiffres pour les étiquettes

Valider un UPC-A scanné ou saisi à l'entrée

Questions techniques

merci