ForHosting KIT · Outils pour développeurs

Convertisseur UPC-E

L'UPC-E 425261 se développe en UPC-A 042100005264 : les zéros supprimés pour les petits emballages sont rétablis, fabricant 42100 et produit 00526, et le chiffre de contrôle commun, 4, est calculé. La compression fait le chemin inverse. 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

Code: 425261
Mode de calcul: Expand

Vous obtenez

Direction: expand
Code en entrée: 425261
Système de numérotation: 0
Upc e: 425261

Le UPC-E est la forme à six chiffres à zéros supprimés d’un code-barres commercial UPC-A, utilisée sur les petits emballages où le symbole à douze chiffres ne tient pas. Les entrepôts, les imprimantes d’étiquettes et les bases produits stockent presque toujours la forme UPC-A développée, si bien que les opérateurs doivent convertir les deux sans deviner quels zéros ont été omis. Ce convertisseur UPC-E développe un UPC-E valide en UPC-A équivalent, recompresse un UPC-A éligible en UPC-E et calcule ou vérifie toujours la clé de contrôle partagée afin de détecter aussitôt un chiffre final erroné. Le mode auto choisit le sens selon la longueur de la chaîne ; expand et compress imposent une seule direction pour scripts et formulaires.

Fonctionnement de l’expansion et de la compression UPC-E

Un code UPC-A standard comporte douze chiffres : un chiffre de système de numérotation (0 ou 1 pour l’UPC-E grand public), un code fabricant de cinq chiffres, un code produit de cinq chiffres et une clé de contrôle mod-10 calculée avec les poids trois et un de gauche à droite. L’UPC-E ne conserve que six chiffres de données en supprimant des suites de zéros dans certains motifs fabricant et produit définis par GS1.

L’expansion reconstruit les zéros manquants à partir du sixième chiffre de données : s’il vaut 0, 1 ou 2, le fabricant se termine par ce chiffre plus deux zéros et le produit est 00 plus les trois chiffres centraux ; s’il vaut 3, le fabricant se termine par deux zéros et le produit est 000 plus deux chiffres ; s’il vaut 4, le fabricant se termine par un zéro et le produit est 0000 plus un chiffre ; de 5 à 9, le fabricant à cinq chiffres est conservé et le produit est 0000 plus ce chiffre final.

Le système de numérotation est préfixé, le corps de onze chiffres reçoit sa clé, et le résultat est un UPC-A canonique à douze chiffres. La compression est l’inverse : seuls les codes à système 0 ou 1 et à motif de zéros compatible peuvent devenir UPC-E ; le reste est signalé comme non compressible. Aucun flottant, échantillonnage aléatoire ni table externe : seulement des branches sur les chiffres et une somme pondérée.

Entrées, modes et champs de réponse

Envoyez le champ obligatoire code contenant les chiffres du code-barres. Espaces, tirets, underscores et points sont retirés pour que les valeurs copiées de l’emballage restent analysables. Sept chiffres sont système plus six données lorsque le premier est 0 ou 1, sinon six données plus clé de contrôle.

Huit chiffres sont système, six données et clé ; une mauvaise clé échoue à la validation. Onze chiffres sont un UPC-A sans clé—l’outil la calcule puis compresse. Douze chiffres sont un UPC-A complet avec vérification.

Treize chiffres ne sont acceptés que si la chaîne est une forme EAN-13 d’UPC-A commençant par 0.

Où un convertisseur UPC-E apporte de la valeur

Les équipes opérations retail collent des codes courts de petits packs cosmétiques, confiserie et électronique dans des outils d’inventaire n’acceptant que l’UPC-A à douze chiffres, et ont besoin d’une expansion qui n’invente jamais de zéros. Les imprimeurs et fabricants de marque distributeur conçoivent des symboles à zéros supprimés pour un artwork serré et doivent compresser un UPC-A catalogue en UPC-E uniquement lorsque le motif GS1 le permet, en échouant clairement sinon pour ne pas imprimer un SKU non éligible.

Les scripts d’assurance qualité font l’aller-retour sur des milliers de codes : développer, compresser et affirmer l’égalité, capturant les clés décalées avant un tirage. Les fiches e-commerce montrent souvent un code à six chiffres d’une feuille fournisseur alors que la place de marché exige le GTIN-12 ; convertir via ce point d’accès garde l’automatisation déterministe.

Associez cette capacité à une validation générale de clé ou à la génération d’image de code-barres si vous avez aussi besoin de preuves multi-symbologies ou de symboles imprimables, mais gardez l’expansion et la compression UPC-E sur leur propre page d’atterrissage pour une intention de recherche mono-usage. Préférez auto pour les interfaces de collage, expand pour les lots de codes courts et compress pour les exports catalogue qui ne doivent devenir UPC-E que s’ils sont éligibles.

Cas d’usage

Réception retail de petits emballages

Les réceptionnaires développent des symboles UPC-E à six chiffres de packs compacts en UPC-A à douze chiffres pour des fichiers de lecture WMS qui ne stockent que la forme complète.

Conception d’étiquettes et marque distributeur

Les graphistes compressent des valeurs UPC-A catalogue en UPC-E lorsque le motif de zéros le permet, et reçoivent une erreur claire lorsqu’un SKU ne peut pas utiliser légalement la suppression de zéros.

Questions fréquentes

Que fait ce convertisseur UPC-E ?

Il développe l’UPC-E (6–8 chiffres) en UPC-A complet à 12 chiffres et recompresse un UPC-A éligible (ou EAN-13 commençant par 0) en UPC-E, en calculant ou vérifiant toujours la clé de contrôle partagée.

Quels systèmes de numérotation sont pris en charge ?

La suppression de zéros UPC-E ne s’applique qu’aux systèmes 0 et 1.

Comment le mode auto choisit-il entre expansion et compression ?

Auto développe les codes de 6–8 chiffres et compresse ceux de 11–13 chiffres. Forcez expand ou compress lorsque vous avez besoin d’une seule direction quelle que soit la longueur.

Pourquoi mon UPC-A ne peut-il pas être compressé en UPC-E ?

Seuls les codes au système de numérotation 0 ou 1 dont le fabricant et le produit contiennent l'un des motifs de zéros définis par GS1 ont une forme à six chiffres. Tout autre est signalé comme non compressible au lieu de finir sur une étiquette fausse.

Comment les zéros manquants sont-ils rétablis ?

C'est le sixième chiffre de données qui décide. Avec 0, 1 ou 2, le fabricant se termine par ce chiffre suivi de deux zéros ; avec 3, par deux zéros ; avec 4, par un zéro ; de 5 à 9, le fabricant reste entier et le produit devient quatre zéros plus ce 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/upce

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

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

import os, requests

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

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

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

{
  "code": "425261"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.upce",
  "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 codes non compressibles, à clé incorrecte ou à système de numérotation non pris en charge sont rejetés avec invalid_input plutôt qu’une étiquette fausse en silence. Les appels API réussis coûtent le prix de base publié $0.002 par élément.

Entrées, modes et champs de réponse

Six chiffres sont traités comme données UPC-E sous système 0 par défaut, ou 0 ou 1 si vous fixez number_system. Le mode auto (par défaut) développe les longueurs jusqu’à huit et compresse de onze à treize ; expand et compress forcent une direction et lèvent invalid_input si la longueur ne convient pas. Les alias text, value, input, barcode et upc sont acceptés pour code ; op, action et direction peuvent remplacer mode ; ns, numberSystem et system peuvent remplacer number_system. Une réponse réussie inclut toujours mode, direction, code_in, number_system, upc_e (six chiffres de données), upc_e_full (huit avec système et clé), upc_a (douze), manufacturer_code, product_code, check_digit et valid à true. Les entrées manquantes, vides, non numériques, trop longues, non compressibles ou à clé incorrecte échouent avec invalid_input et ne sont pas facturées sur le chemin prépayé. Le tarif des appels réussis est la base publiée de $0.002 par élément.

Où un convertisseur UPC-E apporte de la valeur

Chaque appel réussi coûte le prix de base $0.002 sans jetons de modèle ni réseau sortant ; l’échec de validation ne consomme pas le solde.

Cas d'intégration

Fixtures QA et flux marketplace

Les pipelines font l’aller-retour expand/compress pour les tests golden et convertissent les codes courts fournisseur en GTIN-12 pour les mises en ligne sans deviner les zéros à la main.

Questions techniques

Que se passe-t-il si mon UPC-A n’est pas compressible ?

Si les chiffres fabricant et produit ne correspondent pas à un motif GS1 de suppression de zéros, la requête échoue avec invalid_input indiquant que le code n’est pas compressible en UPC-E.

Combien coûte le convertisseur UPC-E ?

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

Consulter la documentation complète du KIT →