ForHosting KIT · Outils pour développeurs

Chiffre de contrôle EAN-13

Saisissez les douze chiffres du produit et obtenez le treizième : 400638133393 reçoit le chiffre de contrôle 1 et s'imprime 4006381333931. Collez un EAN-13 complet pour repérer un code mal saisi avant l'impression des étiquettes ou l'import du fichier d'un fournisseur. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Nombre
400638133393
Vous obtenez
Mode de calcul
Compute
Entrée
400638133393
Chiffre de contrôle
1
Ean13
4006381333931

Les produits de grande distribution, les lignes d’emballage et les catalogues identifient presque toujours chaque article avec un code-barres EAN-13 à treize chiffres (aussi appelé GTIN-13). Douze de ces chiffres portent le préfixe d’entreprise GS1 et la référence article ; le treizième est un chiffre de contrôle issu d’une formule de poids alternés fixes, de sorte qu’une faute de frappe ou une transposition échoue bien plus souvent que de ressembler à un autre produit valide. Cette capacité calcule ce chiffre de contrôle à partir d’un numéro produit de douze chiffres, ou valide un code-barres complet à treize et indique si le chiffre final stocké correspond à la valeur recalculée.

Comment le chiffre de contrôle EAN-13 est calculé

La spécification GS1 de l’EAN-13 (identique en structure au GTIN-13) définit un chiffre de contrôle déterministe sur les douze premiers chiffres. Numérotez ces positions de données de gauche à droite à partir de l’indice zéro : chaque chiffre est multiplié par le poids un lorsque l’indice est pair et par le poids trois lorsqu’il est impair ; puis les douze valeurs pondérées sont additionnées. Le chiffre de contrôle vaut dix moins cette somme modulo dix, repris modulo dix, de sorte qu’une somme déjà divisible par dix donne le chiffre zéro.

L’ajout de ce seul chiffre produit le code complet à treize chiffres imprimé sous les barres et encodé dans le symbole. La validation est l’opération inverse : recalculez le chiffre attendu à partir des douze premiers caractères et comparez-le au treizième. *

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

Envoyez un champ number ne contenant que les caractères de zéro à neuf. Le mode validate attend exactement treize chiffres. Cette forme facilite l’affichage « vous avez saisi X, attendu Y » dans une interface d’emballage sans second appel.

Chaînes vides, number manquant, valeurs de mode invalides et longueurs incorrectes (par exemple onze ou quatorze chiffres) échouent avant toute somme pondérée et ne sont pas facturées. Préférez compute pour créer ou compléter un code produit ; préférez validate lorsque vous recevez un code-barres complet d’un scanner, d’un CSV ou d’un flux fournisseur et qu’il vous faut une porte booléenne avant d’enregistrer le SKU.

Où les chiffres de contrôle EAN-13 s’intègrent aux flux réels

Les marques et les équipes de marque distributeur reçoivent un préfixe d’entreprise GS1 et attribuent des références article ; avant l’impression des visuels elles doivent ajouter le chiffre de contrôle correct pour que les scanners en magasin acceptent le symbole dès le premier passage. Les entrepôts et systèmes 3PL importent des CSV fournisseurs de codes à treize chiffres et doivent rejeter les lignes dont le chiffre de contrôle ne correspond plus, ce qui détecte les retouches humaines comme les bugs d’un des générateurs amont.

Les outils de catalogue e-commerce qui laissent le marchand saisir un EAN peuvent valider à la perte de focus et bloquer la mise en ligne tant que valid n’est pas true, réduisant les envois marketplace en échec. Les imprimeries qui composent des étiquettes de rayon à partir de numéros produit à douze chiffres appellent le mode compute une fois par SKU et placent ean13 sous le graphisme du code-barres.

Ne traitez pas un chiffre de contrôle valide comme preuve d’allocation GS1 ou de propriété de marque — il prouve seulement que la chaîne de treize chiffres est arithmétiquement correcte sous la règle EAN-13, le même niveau d’honnêteté que pour tout checksum de retail.

Compléter un numéro produit à douze chiffres pour l’impression

Prenez le préfixe GS1 plus la référence article (douze chiffres), appelez le mode compute et imprimez ean13 sous les barres pour que l’étiquette porte un EAN-13 valide au scanner.

Auditer les colonnes GTIN fournisseurs

Validez en lot chaque EAN-13 d’un CSV partenaire ou d’un export ERP et mettez en quarantaine les lignes dont le chiffre de contrôle ne correspond plus à la valeur attendue recalculée.

Qu’est-ce qu’un chiffre de contrôle EAN-13 ?

C’est le treizième chiffre d’un code-barres de retail, calculé à partir des douze premiers avec les poids GS1 alternés de 1 et 3, de sorte qu’une faute d’un seul chiffre fasse échouer la validation bien plus souvent que de ressembler à un autre produit.

Que se passe-t-il avec lettres, espaces, tirets ou mauvaises longueurs ?

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

L’outil de chiffre de contrôle EAN-13 est-il gratuit ?

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

Comment se calcule le chiffre de contrôle EAN-13 ?

Multipliez les douze chiffres alternativement par 1 et par 3, en commençant par 1 sur le premier, puis additionnez les résultats. Le chiffre de contrôle complète la somme jusqu'au multiple de dix suivant, ou vaut 0 si elle en est déjà un.

Un EAN-13 valide prouve-t-il que le produit est enregistré ?

Non. Un chiffre de contrôle correct prouve seulement que les treize chiffres sont bien formés selon la règle EAN-13. Il n'indique ni si GS1 a attribué ce numéro, ni à qui appartient la marque.

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.

POSThttps://api.kit.forhosting.com/enc/ean-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é.

curl -X POST https://api.kit.forhosting.com/enc/ean-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"400638133393"}'
{
  "number": "400638133393"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ean_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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Les caractères non numériques et les longueurs incorrectes sont rejetés avec une erreur invalid_input claire, sans nettoyer silencieusement les entrées parasites. Exécutez-la gratuitement dans le navigateur ou appelez l’API KIT au tarif publié ; les deux chemins utilisent la même arithmétique pure, sans réseau et sans stocker de codes-barres.

Comment le chiffre de contrôle EAN-13 est calculé

La même règle sous-tend des identifiants de retail proches comme l’UPC-A lorsqu’il est complété par un zéro à gauche jusqu’à treize chiffres, mais cet outil se concentre strictement sur la disposition douze plus un de l’EAN-13 afin que l’intention de recherche et les contrats d’API restent clairs. Comme l’algorithme est une arithmétique entière pure à poids fixes, le même numéro produit donne toujours le même chiffre de contrôle sur chaque plateforme — navigateur, Worker ou banc de tests hors ligne —, d’où une capacité livrée comme moteur parse de tier A et non comme appel à un modèle.

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

Espaces, tirets, lettres et points décimaux sont rejetés comme entrée non numérique avec invalid_input, afin qu’un formulaire n’accepte jamais une valeur nettoyée en silence. Le mode compute est le défaut : fournissez exactement douze chiffres produit ; le moteur renvoie check_digit comme chaîne d’un caractère, ean13 comme ces douze chiffres plus le contrôle, et length treize. La réponse indique valid true lorsque le chiffre final correspond à l’expected_check_digit recalculé, et inclut toujours payload (les douze premiers chiffres), check_digit tel que soumis, expected_check_digit et l’ean13 canonique formé de payload plus le chiffre attendu. 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 protéger les imports massifs de catalogue, les imprimantes d’étiquettes et les audits de fichiers partenaires sans négocier un palier sur mesure.

Où les chiffres de contrôle EAN-13 s’intègrent aux flux réels

Les tests d’intégration et les jobs de qualité de données recalculent expected_check_digit pour chaque colonne GTIN d’un export et mettent en quarantaine les écarts avant le point de vente.

Valider des codes scannés ou saisis à l’entrée

Lorsqu’un scanner portable ou un formulaire envoie treize chiffres, appelez le mode validate et bloquez les mises à jour de stock ou de catalogue si valid est false, en affichant expected_check_digit pour corriger une faute de frappe.

Comment calculer un chiffre de contrôle EAN-13 avec cette API ?

Envoyez un POST avec number égal à exactement douze chiffres et mode compute (ou omettez mode). La réponse inclut check_digit et ean13 (le code complet à treize chiffres).

Comment valider un code-barres complet à treize chiffres ?

Envoyez un POST avec la chaîne de treize chiffres et mode validate. La réponse inclut valid, check_digit, expected_check_digit, payload et l’ean13 canonique.

Consulter la documentation complète du KIT →