Aggiungere gli identificativi di prodotto UE (PID)
Aggiungi gli identificativi di prodotto richiesti dall'UE sulle spedizioni B2C
di basso valore, per ciascuna integrazione Zonos.
Dal 1° novembre 2026, l'UE richiede gli identificativi di prodotto (PID) per ogni articolo delle spedizioni business-to-consumer in ingresso nell'UE di valore pari o inferiore a 150 €. Le spedizioni prive di tali identificativi potrebbero essere trattenute o respinte dalla dogana. Questa guida mostra dove aggiungere gli identificativi per ciascuna integrazione Zonos.
La soglia di 150 € si applica a ciascuna spedizione: ciò che invii a un singolo cliente con un unico contratto di trasporto, ovvero una lettera di vettura, e considera solo il valore della merce, escluse spedizione e assicurazione. Una spedizione di più colli con un'unica lettera di vettura è una sola spedizione, quindi quei colli vengono valutati insieme. Un ordine che spedisci in due spedizioni separate costituisce due spedizioni, ciascuna valutata in base al proprio valore. Poiché questo dipende da come un ordine viene imballato e spedito, l'approccio più semplice è compilare gli identificativi per tutto ciò che vendi nell'UE.
I merchant Shopify aggiungono gli identificativi in Shopify e Zonos li acquisisce automaticamente. Per tutte le altre integrazioni, aggiungili in Zonos Catalog oppure mappali dai campi del tuo negozio, se le impostazioni del plugin offrono la mappatura personalizzata.
Integrazione↕
Dove aggiungere gli identificativi↕
Shopify (Zonos Duty and Tax)
Su ogni variante di prodotto nell'admin di Shopify
Magento
Zonos Catalog, oppure mappatura degli attributi nelle impostazioni del plugin Zonos (passaggi più avanti)
Aggiungi tutti e tre gli identificativi su ogni variante nell'admin di Shopify. L'app Zonos li acquisisce.
Nell'admin di Shopify, apri Products e seleziona un prodotto.
Apri la variante che vuoi aggiornare.
Per l'ID prodotto del venditore (M-PID), l'app Zonos usa automaticamente l'ID prodotto di Shopify. Per usare invece il tuo SKU, ogni prodotto deve avere uno SKU e ogni SKU deve essere univoco: assicurati che il campo SKU sia compilato e che lo SKU non sia usato su nessun'altra variante.
Aggiungi il codice del produttore come codice a barre di tipo NS-PID (identificativo non standardizzato del prodotto del produttore).
Se il prodotto ha un codice UPC, EAN, GTIN o ISBN, aggiungilo come secondo codice a barre con il tipo corrispondente.
Salva e ripeti per ogni variante.
Suggerimenti:
Inserisci il codice del produttore in un codice a barre NS-PID dedicato, non nel campo SKU o UPC. Zonos invia alla dogana ogni tipo di codice a barre come identificativo distinto.
Una variante può contenere più codici a barre, ma Zonos legge solo i primi cinque. Mantieni tra questi l'NS-PID e il codice a barre principale del prodotto.
I codici a barre inseriti prima di questa modifica continuano a funzionare come UPC/EAN. L'unica novità è il codice del produttore.
Magento, WooCommerce, BigCommerce, Miva e qualsiasi altra integrazione possono aggiungere gli identificativi in Zonos Catalog. Alcuni plugin possono anche mapparli dai campi del tuo negozio. Scegli l'opzione più adatta al modo in cui gestisci già i dati di prodotto.
Trova il prodotto. Ogni variante è un articolo di catalogo a sé.
Compila i tre campi identificativi:
SKU o Product ID: il tuo ID prodotto del venditore (M-PID). Va bene l'uno o l'altro.
Manufacturer product ID: il codice del produttore
GTIN: il codice UPC, EAN, GTIN o ISBN, se il prodotto ne ha uno
Salva e ripeti per ogni articolo.
Per un catalogo di grandi dimensioni, aggiungi gli identificativi a un file di caricamento del catalogo invece di modificare gli articoli uno alla volta. Assicurati che lo SKU di ogni articolo in Zonos Catalog corrisponda esattamente allo SKU nel tuo negozio.
Gli identificativi di Catalog arrivano sulle etichette solo in due casi
Zonos utilizza gli identificativi presenti in Zonos Catalog solo se:
Stampi le etichette di spedizione da Dashboard.
Stampi le etichette al di fuori di Dashboard e chiami l'API di Zonos per ottenere i dettagli di catalogo del prodotto prima di richiedere l'etichetta al corriere. Consulta Trovare un prodotto per sapere come cercare un articolo di catalogo.
Se stampi le etichette al di fuori di Dashboard e non chiami l'API di Zonos per i dettagli di catalogo, collabora con il tuo fornitore di etichette per includere gli identificativi al momento della stampa.
Opzione 2: Mappatura personalizzata nelle impostazioni del plugin
Alcuni plugin Zonos possono leggere gli identificativi da campi che già gestisci nel tuo negozio, come un attributo personalizzato. Apri le impostazioni del plugin Zonos e cerca un'opzione di mappatura personalizzata o degli attributi. Se è presente, mappa:
il campo SKU su SKU
il campo che contiene il codice del produttore su Manufacturer product ID
il campo UPC o EAN su GTIN
Se il plugin non offre la mappatura personalizzata, usa Zonos Catalog. Scegli la tua piattaforma per i relativi passaggi di configurazione.
Importante: la mappatura degli attributi per il codice del produttore e il GTIN richiede il modulo Zonos Checkout (zonos/checkout) versione 2.3.40 o successiva. Per verificare la versione installata, esegui composer show zonos/checkout. Per i passaggi di installazione, consulta la guida all'integrazione con Magento.
Il plugin Magento legge il codice del produttore e il GTIN dagli attributi di prodotto. Se i tuoi prodotti non hanno ancora attributi dedicati, creali prima.
1. Crea gli attributi
Salta gli attributi che hai già.
Vai su Stores > Attributes > Product e fai clic su Add New Attribute.
Imposta Default Label su un nome facilmente riconoscibile, ad esempio ns_pid per il codice del produttore o gtin per il codice a barre.
Imposta Catalog Input Type for Store Owner su Text Field e Values Required su No.
Fai clic su Save Attribute, quindi ripeti per il secondo attributo.
2. Aggiungi gli attributi ai set di attributi
Vai su Stores > Attributes > Attribute Set e apri il set utilizzato dai tuoi prodotti.
Trascina ogni nuovo attributo da Unassigned Attributes in un gruppo, ad esempio Product Details.
Fai clic su Save. Ripeti per ogni set di attributi utilizzato dai tuoi prodotti destinati all'UE.
3. Compila i valori sui prodotti
Apri ogni prodotto in Catalog > Products e inserisci il codice del produttore e il GTIN. Per impostare i valori su più prodotti contemporaneamente, selezionali nella griglia dei prodotti e scegli Update attributes dal menu Actions.
4. Mappa gli attributi nelle impostazioni di Zonos
Vai su Stores > Configuration > Zonos > Zonos Duty and Tax.
Scorri fino ai campi di mappatura degli attributi (Brand, HS code, Length e così via).
Imposta GTIN / EAN / UPC sull'attributo del codice a barre, ad esempio gtin.
Imposta Manufacturer Product ID sull'attributo del codice del produttore, ad esempio ns_pid.
Se un prodotto non ha un proprio codice del produttore (NS-PID), puoi fare in modo che Zonos invii il suo S-PID (GTIN) come NS-PID. L'impostazione si applica a tutte le integrazioni, è disattivata per impostazione predefinita e non sostituisce mai un codice del produttore che hai già aggiunto.
In Dashboard, vai su Settings > Landed cost > Catalog.
In Product identifiers, seleziona Use S-PID as NS-PID.
Leggi la dichiarazione di consenso che compare sotto la casella di controllo, quindi fai clic su Save.
Perché l'impostazione sia utile, il prodotto deve avere un S-PID. Se un prodotto non ha né un codice del produttore né un S-PID, devi comunque aggiungere un codice del produttore.
Ottieni prima l'autorizzazione del produttore
Attivando questa impostazione, confermi di aver ricevuto dal produttore il consenso all'uso del suo S-PID (GTIN) come NS-PID. Zonos registra il testo della dichiarazione che hai accettato, chi ha attivato l'impostazione e quando.
Se ti integri direttamente con Zonos anziché tramite un plugin di piattaforma, hai due modi per fornire gli identificativi: salvarli una sola volta per prodotto in Zonos Catalog, oppure passarli su ogni articolo della richiesta. Catalog completa qualsiasi identificativo lasciato vuoto nella richiesta, quindi la maggior parte dei merchant li salva una volta e non invia nulla in più al momento del preventivo.
Identificativo in questa pagina↕
Campo API↕
ID prodotto del venditore (M-PID)
sku o productId
Codice del produttore
manufacturerProductId
S-PID (GTIN, UPC, EAN, ISBN)
gtin
Per l'M-PID, invia sku oppure productId. I nomi dei campi sono gli stessi in itemCreateWorkflow, negli articoli di un carrello e in catalogItemCreate, quindi non cambia nulla tra il flusso del preventivo e quello del catalogo.
Aggiungi gli identificativi a ogni articolo in itemCreateWorkflow. Usa questa opzione se non gestisci un catalogo con Zonos, oppure quando gli identificativi di un articolo differiscono dalla sua voce di catalogo.
Invia il gtin solo con cifre, senza trattini né spazi. I valori UPC, EAN, JAN e ISBN a 13 cifre vanno tutti in questo unico campo e Zonos determina lo standard dal numero stesso.
Corretto: 012345678905
Rifiutato: 0-12345-67890-5
Se hai un ISBN a 10 cifre, invia invece la versione a 13 cifre, perché un ISBN a 10 cifre può terminare con la lettera X.
Se un prodotto non ha un codice a barre, ometti gtin invece di inviare una stringa vuota, riutilizzare il tuo SKU o inserire un testo segnaposto come N/A. Un identificativo che rimanda al prodotto sbagliato è peggio di nessun identificativo, perché la dogana potrebbe usarlo per identificare la merce.
Una volta che gli identificativi sono presenti sui tuoi prodotti, Zonos li inserisce dove ciascun corriere se li aspetta quando crea l'etichetta e la fattura commerciale. Non devi formattare nulla tu stesso.
Zonos invia gli identificativi sulle spedizioni verso l'UE, dove sono obbligatori, per:
FedEx
UPS
DHL Express
APC
Asendia
USPS
Zonos sta aggiungendo altri corrieri. Aggiungi gli identificativi ai tuoi prodotti con qualsiasi corriere tu spedisca: vengono salvati nel tuo catalogo e usati fin da ora per il landed cost, e saranno inviati non appena quel corriere verrà aggiunto, senza dover rifare nulla in seguito. Per sapere a che punto è un corriere, contatta il supporto Zonos.
Se crei le etichette in autonomia
Se generi le etichette tramite la tua integrazione con il corriere anziché tramite Zonos, sei responsabile dell'invio degli identificativi. Ogni corriere li richiede in una posizione diversa e i corrieri differiscono su cosa inviare quando un prodotto non ha un S-PID: alcuni vogliono un valore esplicito "none", altri vogliono che il campo venga omesso. Contatta il supporto Zonos per i dettagli che si applicano ai tuoi corrieri.
Aggiungere gli identificativi di prodotto UE
Aggiungere gli identificativi di prodotto UE (PID)
Aggiungi gli identificativi di prodotto richiesti dall'UE sulle spedizioni B2C di basso valore, per ciascuna integrazione Zonos.
Dal 1° novembre 2026, l'UE richiede gli identificativi di prodotto (PID) per ogni articolo delle spedizioni business-to-consumer in ingresso nell'UE di valore pari o inferiore a 150 €. Le spedizioni prive di tali identificativi potrebbero essere trattenute o respinte dalla dogana. Questa guida mostra dove aggiungere gli identificativi per ciascuna integrazione Zonos.
La soglia di 150 € si applica a ciascuna spedizione: ciò che invii a un singolo cliente con un unico contratto di trasporto, ovvero una lettera di vettura, e considera solo il valore della merce, escluse spedizione e assicurazione. Una spedizione di più colli con un'unica lettera di vettura è una sola spedizione, quindi quei colli vengono valutati insieme. Un ordine che spedisci in due spedizioni separate costituisce due spedizioni, ciascuna valutata in base al proprio valore. Poiché questo dipende da come un ordine viene imballato e spedito, l'approccio più semplice è compilare gli identificativi per tutto ciò che vendi nell'UE.
Per informazioni di contesto sulla normativa, inclusi i codici TARIC e le eccezioni, consulta la guida agli identificativi di prodotto UE (PID).
Cosa è richiesto
Ogni prodotto richiede fino a tre identificativi. Due sono sempre obbligatori; l'S-PID è obbligatorio solo se il prodotto ne dispone.
TSHIRT-BLU-MMX-500-BLK012345678905Per l'ID prodotto del venditore (M-PID) puoi usare lo SKU del prodotto oppure il suo ID prodotto. Ne basta uno.
Se il prodotto lo fabbrichi tu, il tuo numero di modello o codice articolo è il codice del produttore.
Dove aggiungerli
I merchant Shopify aggiungono gli identificativi in Shopify e Zonos li acquisisce automaticamente. Per tutte le altre integrazioni, aggiungili in Zonos Catalog oppure mappali dai campi del tuo negozio, se le impostazioni del plugin offrono la mappatura personalizzata.
Shopify
Aggiungi tutti e tre gli identificativi su ogni variante nell'admin di Shopify. L'app Zonos li acquisisce.
Suggerimenti:
Qualsiasi integrazione: Zonos Catalog o mappatura del plugin
Magento, WooCommerce, BigCommerce, Miva e qualsiasi altra integrazione possono aggiungere gli identificativi in Zonos Catalog. Alcuni plugin possono anche mapparli dai campi del tuo negozio. Scegli l'opzione più adatta al modo in cui gestisci già i dati di prodotto.
Opzione 1: Zonos Catalog
Per un catalogo di grandi dimensioni, aggiungi gli identificativi a un file di caricamento del catalogo invece di modificare gli articoli uno alla volta. Assicurati che lo SKU di ogni articolo in Zonos Catalog corrisponda esattamente allo SKU nel tuo negozio.
Zonos utilizza gli identificativi presenti in Zonos Catalog solo se:
Se stampi le etichette al di fuori di Dashboard e non chiami l'API di Zonos per i dettagli di catalogo, collabora con il tuo fornitore di etichette per includere gli identificativi al momento della stampa.
Per sapere dove inserire i PID per il tuo corriere specifico, consulta la nostra guida agli identificativi di prodotto UE.
Opzione 2: Mappatura personalizzata nelle impostazioni del plugin
Alcuni plugin Zonos possono leggere gli identificativi da campi che già gestisci nel tuo negozio, come un attributo personalizzato. Apri le impostazioni del plugin Zonos e cerca un'opzione di mappatura personalizzata o degli attributi. Se è presente, mappa:
Se il plugin non offre la mappatura personalizzata, usa Zonos Catalog. Scegli la tua piattaforma per i relativi passaggi di configurazione.
Il plugin Magento legge il codice del produttore e il GTIN dagli attributi di prodotto. Se i tuoi prodotti non hanno ancora attributi dedicati, creali prima.
1. Crea gli attributi
Salta gli attributi che hai già.
ns_pidper il codice del produttore ogtinper il codice a barre.2. Aggiungi gli attributi ai set di attributi
3. Compila i valori sui prodotti
Apri ogni prodotto in Catalog > Products e inserisci il codice del produttore e il GTIN. Per impostare i valori su più prodotti contemporaneamente, selezionali nella griglia dei prodotti e scegli Update attributes dal menu Actions.
4. Mappa gli attributi nelle impostazioni di Zonos
gtin.ns_pid.Usare l'S-PID come NS-PID
Se un prodotto non ha un proprio codice del produttore (NS-PID), puoi fare in modo che Zonos invii il suo S-PID (GTIN) come NS-PID. L'impostazione si applica a tutte le integrazioni, è disattivata per impostazione predefinita e non sostituisce mai un codice del produttore che hai già aggiunto.
Perché l'impostazione sia utile, il prodotto deve avere un S-PID. Se un prodotto non ha né un codice del produttore né un S-PID, devi comunque aggiungere un codice del produttore.
Attivando questa impostazione, confermi di aver ricevuto dal produttore il consenso all'uso del suo S-PID (GTIN) come NS-PID. Zonos registra il testo della dichiarazione che hai accettato, chi ha attivato l'impostazione e quando.
Checkout e Landed Cost API
Se ti integri direttamente con Zonos anziché tramite un plugin di piattaforma, hai due modi per fornire gli identificativi: salvarli una sola volta per prodotto in Zonos Catalog, oppure passarli su ogni articolo della richiesta. Catalog completa qualsiasi identificativo lasciato vuoto nella richiesta, quindi la maggior parte dei merchant li salva una volta e non invia nulla in più al momento del preventivo.
skuoproductIdmanufacturerProductIdgtinPer l'M-PID, invia
skuoppureproductId. I nomi dei campi sono gli stessi initemCreateWorkflow, negli articoli di un carrello e incatalogItemCreate, quindi non cambia nulla tra il flusso del preventivo e quello del catalogo.Aggiungi gli identificativi a ogni articolo in
itemCreateWorkflow. Usa questa opzione se non gestisci un catalogo con Zonos, oppure quando gli identificativi di un articolo differiscono dalla sua voce di catalogo.mutation ItemCreateWorkflow($input: [ItemCreateWorkflowInput!]!) {itemCreateWorkflow(input: $input) {idskumanufacturerProductIdgtin}}Invia il
gtinsolo con cifre, senza trattini né spazi. I valori UPC, EAN, JAN e ISBN a 13 cifre vanno tutti in questo unico campo e Zonos determina lo standard dal numero stesso.0123456789050-12345-67890-5Se hai un ISBN a 10 cifre, invia invece la versione a 13 cifre, perché un ISBN a 10 cifre può terminare con la lettera X.
Se un prodotto non ha un codice a barre, ometti
gtininvece di inviare una stringa vuota, riutilizzare il tuo SKU o inserire un testo segnaposto comeN/A. Un identificativo che rimanda al prodotto sbagliato è peggio di nessun identificativo, perché la dogana potrebbe usarlo per identificare la merce.Come Zonos li invia al tuo corriere
Una volta che gli identificativi sono presenti sui tuoi prodotti, Zonos li inserisce dove ciascun corriere se li aspetta quando crea l'etichetta e la fattura commerciale. Non devi formattare nulla tu stesso.
Zonos invia gli identificativi sulle spedizioni verso l'UE, dove sono obbligatori, per:
Zonos sta aggiungendo altri corrieri. Aggiungi gli identificativi ai tuoi prodotti con qualsiasi corriere tu spedisca: vengono salvati nel tuo catalogo e usati fin da ora per il landed cost, e saranno inviati non appena quel corriere verrà aggiunto, senza dover rifare nulla in seguito. Per sapere a che punto è un corriere, contatta il supporto Zonos.
Se generi le etichette tramite la tua integrazione con il corriere anziché tramite Zonos, sei responsabile dell'invio degli identificativi. Ogni corriere li richiede in una posizione diversa e i corrieri differiscono su cosa inviare quando un prodotto non ha un S-PID: alcuni vogliono un valore esplicito "none", altri vogliono che il campo venga omesso. Contatta il supporto Zonos per i dettagli che si applicano ai tuoi corrieri.
Prima del 1° novembre
Questa pagina è stata utile?