Simbologia di codice a barre consigliata per ogni uso
Scegliere un codice a barre non significa soprattutto decidere quale motivo grafico sia più gradevole.
Esegui gratis nel browser
La simbologia corretta dipende da chi effettuerà la scansione, dall'identificativo da codificare e dalla norma di settore che regola il processo. Questo strumento deterministico associa quattro impieghi comuni — prodotto al dettaglio, etichetta di spedizione, gestione dell'inventario e libro di biblioteca — al codice a barre monodimensionale normalmente adottato. Spiega inoltre l'identificativo e la norma alla base della scelta, affinché Lei possa distinguere una convenzione di settore da un'alternativa semplicemente leggibile.
Parta dall'ecosistema di scansione, non dalla grafica
Una simbologia definisce come i caratteri vengono rappresentati mediante barre e spazi, ma un'implementazione efficace richiede più della sola possibilità tecnica di codifica. Una cassa del commercio al dettaglio si aspetta identificativi gestiti secondo le regole GS1, mentre un magazzino privato può avere bisogno soltanto di un codice interno compatto. Verifichi anzitutto chi assegna i dati, dove verrà letto il simbolo e se un'altra organizzazione dovrà comprenderlo senza accordi privati. Per un prodotto al dettaglio, EAN-13 è la raccomandazione globale più comune perché contiene un GTIN-13 ed è riconosciuto dall'infrastruttura dei punti vendita. Nei mercati basati sui GTIN a 12 cifre, UPC-A rimane diffuso e appartiene allo stesso sistema di identificazione GS1. Il risultato indica quindi lo standard abituale senza presumere requisiti identici in ogni Paese, partner o lettore. Prima di stampare un lotto di produzione, confermi il titolare dei dati e le specifiche del partner commerciale. Anche un simbolo perfettamente leggibile può essere errato se contiene un identificativo non autorizzato, ha dimensioni inadatte o si trova nel punto sbagliato della confezione.
Distingua la struttura dei dati dal supporto del codice
L'identificativo e il relativo supporto stampato sono collegati, ma non coincidono. Code 128 è una simbologia generica capace di codificare in modo efficiente un ampio insieme di caratteri. GS1-128 usa quel supporto con ulteriori regole GS1, tra cui un carattere funzione iniziale e gli Identificatori di Applicazione che definiscono significato e lunghezza degli elementi. Questa distinzione spiega perché lo strumento scelga GS1-128 per un'etichetta di spedizione e Code 128 semplice per la gestione interna dell'inventario. Un'etichetta logistica può dover contenere un codice seriale dell'unità logistica, una data, un lotto o un altro campo strutturato che i sistemi riceventi interpretino in modo uniforme. Un'etichetta interna richiede spesso solo uno SKU o un identificativo patrimoniale definito dall'organizzazione, quindi Code 128 è più semplice e ampiamente compatibile. Non aggiunga la sintassi GS1 soltanto perché la stampante offre tale opzione: gli identificativi devono essere assegnati e formattati correttamente. Allo stesso modo, non usi una stringa Code 128 libera se il vettore, il rivenditore o il cliente richiede dati GS1.
Consideri il risultato un punto di partenza normativo
Il risultato presenta la convenzione generalmente associata all'impiego selezionato, insieme alla norma, all'identificativo codificato e alla motivazione. Per un libro di biblioteca raccomanda EAN-13 contenente ISBN-13, spesso chiamato Bookland EAN. Tale scelta identifica un'edizione pubblicata; la biblioteca può comunque aggiungere un altro codice per identificare la singola copia nel proprio sistema di prestito. Considerazioni analoghe valgono negli altri casi. Un programma di inventario potrebbe essere tenuto a usare identificativi GS1, norme militari o un simbolo bidimensionale per esigenze del cliente o limiti di spazio. Un vettore può imporre una specifica con più simboli anziché un unico codice generico. Le confezioni destinate alla vendita devono inoltre rispettare requisiti di qualità di stampa, zone libere, dimensioni, colori e posizione. Usi la risposta per scegliere la famiglia normativa consueta e formulare domande al fornitore, alla tipografia, al partner commerciale o all'ente normativo. Prima dell'adozione, verifichi formato e dimensioni esatti, provi i lettori reali e ottenga gli identificativi dall'organizzazione autorizzata a rilasciarli.
Casi d'uso
Progettare una confezione per la vendita
Identifichi il supporto GS1 abituale prima di riservare spazio nella grafica o richiedere un GTIN per un prodotto di consumo.
Creare etichette operative
Distingua i dati logistici GS1 strutturati da un identificativo Code 128 privato usato soltanto nell'inventario interno.
Etichettare una raccolta bibliotecaria
Confermi il supporto convenzionale per ISBN-13, considerando che ogni copia in prestito può richiedere un codice distinto.
Domande frequenti
Quanto costa la raccomandazione?
Ogni richiesta API costa $0.002; la stessa consultazione deterministica può essere eseguita anche nel browser.
Perché EAN-13 è consigliato per un prodotto al dettaglio?
EAN-13 è il supporto abituale di un GTIN-13 GS1 ed è compatibile con i punti vendita di tutto il mondo. UPC-A è comune per i GTIN-12 nei mercati incentrati su UPC.
Qual è la differenza tra Code 128 e GS1-128?
Code 128 è la simbologia. GS1-128 applica regole di formato e Identificatori di Applicazione GS1 per rendere comprensibili i campi strutturati.
A un libro di biblioteca basta il codice ISBN?
Non sempre. ISBN-13 identifica l'edizione pubblicata; la biblioteca può aggiungere un altro codice per distinguere ogni copia in circolazione.
Questo risultato sostituisce le specifiche di un vettore o rivenditore?
No. Indica la simbologia tipica per un uso generale. Un partner può imporre identificativi, dimensioni, posizione, qualità di stampa o simboli aggiuntivi.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/doc/barcode-symbology-recommend \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"use_case":"retail_product"}'const res = await fetch("https://api.kit.forhosting.com/doc/barcode-symbology-recommend", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"use_case": "retail_product"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/barcode-symbology-recommend",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"use_case": "retail_product"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/barcode-symbology-recommend", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"use_case":"retail_product"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"use_case":"retail_product"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/barcode-symbology-recommend", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"use_case": "retail_product"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "doc.barcode_symbology_recommend",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
max_pages | 200 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |