DOCS

Bundle

Bundle

Vendi prodotti raggruppati con un landed cost accurato e opzioni di imballaggio flessibili.

Un bundle è un prodotto venduto come un'unica unità (principale) che, al checkout, viene suddiviso in singoli articoli componenti. Quando un cliente acquista un bundle, Zonos lo espande nei suoi componenti, riduce il prezzo di ciascun componente in modo che corrisponda al prezzo del bundle e calcola dazi e imposte in base al codice HS e al paese di origine di ciascun componente.

Ad esempio, un commerciante vende magliette singolarmente a 30 $ ciascuna o in un bundle di 4 a 100 $. Quando un cliente acquista il bundle:

  • L'ordine e la fattura commerciale mostrano 4 magliette a 25 $ ciascuna (non 1 bundle a 100 $ né 4 magliette a 30 $ ciascuna)
  • Per il calcolo del landed cost vengono utilizzati il codice HS e il paese di origine di ogni maglietta
  • I costi di spedizione vengono calcolati utilizzando le dimensioni reali della scatola in cui il commerciante le spedisce

Modalità di imballaggio 

I bundle supportano due modalità di imballaggio che determinano come gli articoli vengono inseriti nelle scatole per la spedizione:

Assigned box

Il commerciante assegna in anticipo gli articoli a scatole specifiche con dimensioni note. Ogni scatola viene definita con lunghezza, larghezza, altezza e capacità di peso. La cartonizzazione utilizza queste scatole esatte anziché stimarle.

Ideale per: prodotti di cui conosci la scatola di spedizione, o bundle che vengono sempre spediti nella stessa scatola.

Auto-box

Il commerciante raggruppa gli articoli in un bundle senza specificare le scatole. Al momento dell'ordine, Zonos utilizza il proprio algoritmo di cartonizzazione per determinare l'imballaggio ottimale in base alle dimensioni degli articoli e alle opzioni di imballaggio disponibili.

Ideale per: bundle la cui modalità di imballaggio varia, prodotti con imballaggio flessibile, o quando desideri che Zonos ottimizzi automaticamente la selezione della scatola.

Entrambe le modalità espandono il bundle nei singoli componenti con codice HS, paese di origine e prezzo scontato per ciascun articolo. La differenza riguarda solo il modo in cui vengono determinate le scatole.

Come funzionano i bundle 

Quando crei un bundle in Catalog, definisci:

  • SKU o ID prodotto del bundle — l'identificatore del prodotto che corrisponde al tuo negozio
  • Prezzo del bundle — il prezzo totale come appare nel tuo negozio
  • Modalità di imballaggio — scatola assegnata o auto-box
  • Articoli componenti — ogni singolo prodotto incluso nel bundle, a cui si fa riferimento tramite il relativo ID articolo del catalogo. I componenti devono già esistere come articoli del catalogo prima di poterli aggiungere a un bundle.
  • Assegnazioni delle scatole (solo scatola assegnata) — quali componenti vengono spediti in quale scatola, con dimensioni e pesi reali

Quando viene effettuato un ordine contenente un bundle, Zonos automaticamente:

  1. Espande il bundle nei singoli componenti
  2. Riduce il prezzo di ciascun componente utilizzando rapporti di prezzo calcolati, in modo che i prezzi per articolo corrispondano al prezzo del bundle
  3. Calcola il landed cost utilizzando il codice HS, il paese di origine e le dimensioni della scatola di ciascun componente, fornendo un totale accurato di dazi, imposte e spedizione
  4. Genera le etichette — i bundle a scatola assegnata ricevono un'etichetta per ogni scatola definita; i bundle auto-box ricevono etichette in base ai risultati della cartonizzazione

Prerequisiti 

Prima di creare un bundle, assicurati che:

  • Tutti gli articoli componenti esistano come articoli del catalogo nel tuo Zonos Catalog. Il bundle fa riferimento ai componenti tramite il relativo ID articolo del catalogo: non puoi aggiungere articoli che non esistono già. Non è necessario che i componenti siano venduti singolarmente nel tuo negozio: possono esistere nel catalogo esclusivamente come parti del bundle.
  • Ogni componente disponga di codici HS, paese di origine e misure (peso e dimensioni) accurati. Questi dati sono utilizzati per i calcoli del landed cost quando il bundle viene espanso.
  • Lo SKU o l'ID prodotto del bundle corrisponda all'identificatore inviato dalla tua piattaforma e-commerce a Zonos e alla preferenza della chiave articolo nel tuo Zonos Dashboard. Per i negozi Shopify, l'ID prodotto del bundle deve essere l'ID della variante Shopify del prodotto bundle.

Ogni bundle deve contenere almeno 2 articoli componenti. Un bundle con un solo articolo dovrebbe invece essere un articolo del catalogo indipendente.

  1. Vai a Dashboard > Products > Bundles.
  2. Fai clic su Add Bundle nell'angolo in alto a destra.
  3. Inserisci lo SKU o il Product ID del bundle — deve corrispondere all'identificatore inviato dal tuo negozio a Zonos. Anche la preferenza della chiave articolo del tuo Zonos Dashboard deve essere impostata sull'identificatore corretto.
  4. Inserisci il nome, il prezzo e la valuta del bundle.
  5. Seleziona Assigned box come modalità di imballaggio.
  6. Aggiungi le scatole con dimensioni specifiche (lunghezza, larghezza, altezza e capacità di peso).
  7. Aggiungi gli articoli componenti cercando nel catalogo e assegna ciascuno a una scatola. Per ciascun componente, specifica:
    • Quantità — il numero di unità di questo componente presenti nel bundle
    • Scatola — la scatola in cui viene spedito questo componente
    • Rapporto di prezzo — la quota del prezzo del bundle rappresentata da questo componente (calcolata automaticamente se lasciata vuota)
  8. Fai clic su Save.

Sono disponibili due opzioni di importazione da Manage > Import:

Importa bundle 

Crea bundle che fanno riferimento ad articoli del catalogo esistenti. Gli articoli componenti devono già esistere nel catalogo prima dell'importazione.

  1. Vai a Dashboard > Products > Bundles.
  2. Fai clic su Manage > Import bundles.
  3. Scarica un modello CSV di esempio — scegli il formato Assigned box o Auto-box.
  4. Compila una riga per ogni articolo componente. I campi a livello di bundle (SKU, nome, prezzo) si ripetono in ogni riga relativa allo stesso bundle.
  5. Carica il CSV completato e fai clic su Import.

Campi CSV del bundle 

ColonnaDescrizione
Bundle SKULo SKU del bundle come appare nel tuo negozio.
Bundle Product IDIl product ID del bundle come appare nel tuo negozio.
Bundle NameIl nome del bundle.
Bundle DescriptionUna descrizione del bundle.
Bundle Image URLL'URL dell'immagine del bundle.
Bundle AmountIl prezzo totale del bundle.
Bundle CurrencyLa valuta del prezzo del bundle, ad esempio USD.
Box NumberIl numero della scatola in cui viene spedito il componente di questa riga, ad esempio 1 o 2. Usa lo stesso numero per tutti i componenti nella stessa scatola.
Box LengthLa lunghezza della scatola per questa riga.
Box WidthLa larghezza della scatola per questa riga.
Box HeightL'altezza della scatola per questa riga.
Box Dimensional UnitL'unità dimensionale della scatola, ad esempio INCH.
Box Weight CapacityLa capacità di peso massima della scatola.
Box Weight UnitL'unità di peso per la capacità della scatola, ad esempio POUND.
Item SKULo SKU di questo articolo componente. Deve corrispondere a un articolo del catalogo esistente.
Item Product IDIl product ID di questo articolo componente. Deve corrispondere a un articolo del catalogo esistente.
Item QuantityIl numero di unità di questo componente presenti nel bundle.

Nota: sia il prefisso di colonna "Bundle" sia "Kit" sono accettati per retrocompatibilità (ad esempio, "Kit SKU" funziona come "Bundle SKU").

Regole di validazione per l'importazione CSV dei bundle 

Le seguenti regole di validazione si applicano a tutte le importazioni CSV dei bundle:

  • Minimo 2 articoli — ogni bundle deve contenere almeno 2 articoli componenti. Un bundle con un solo articolo dovrebbe invece essere un articolo del catalogo indipendente.
  • Campi scatola tutto-o-niente — per i bundle a scatola assegnata, tutti e 6 i campi relativi alla scatola devono essere presenti in ogni riga: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity e Box Weight Unit. Se è impostato un campo scatola, sono richiesti tutti e 6. Se tutti i campi scatola sono vuoti, il bundle viene trattato come auto-box.
  • Nessuna combinazione di modalità di imballaggio — un singolo bundle non può combinare righe a scatola assegnata (con dimensioni della scatola) e righe auto-box (senza dimensioni della scatola). Tutte le righe di un bundle devono utilizzare la stessa modalità.
  • Normalizzazione del codice HS — i codici HS vengono formattati automaticamente durante l'importazione. I caratteri non alfanumerici (punti, trattini, spazi) vengono rimossi e il codice viene normalizzato in un formato a cifre pari.

Crea sia articoli del catalogo sia bundle in un unico caricamento. Usa questa opzione quando i tuoi articoli componenti non esistono già nel catalogo — verranno creati o aggiornati automaticamente.

  1. Vai a Dashboard > Products > Bundles.
  2. Fai clic su Manage > Import bundles + catalog items.
  3. Scarica un modello CSV di esempio — scegli il formato Assigned box o Auto-box.
  4. Compila una riga per ogni articolo componente, incluse le colonne di dettaglio dell'articolo (nome, codice HS, paese di origine, misure).
  5. Carica il CSV completato e fai clic su Import.

L'importazione crea prima o aggiorna gli articoli del catalogo figli, quindi crea i bundle facendo riferimento a essi. Se un articolo con lo stesso SKU o product ID esiste già, i suoi dettagli vengono aggiornati con i valori del CSV. I codici HS vengono normalizzati automaticamente durante l'importazione (i caratteri non alfanumerici vengono rimossi e il codice viene formattato nello standard a cifre pari).

Campi CSV combinati 

Include tutti i campi CSV del bundle più le colonne di dettaglio dell'articolo:

ColonnaDescrizione
Bundle SKULo SKU del bundle.
Bundle Product IDIl product ID del bundle.
Bundle NameIl nome del bundle.
Bundle DescriptionUna descrizione del bundle.
Bundle Image URLL'URL dell'immagine del bundle.
Bundle AmountIl prezzo totale del bundle.
Bundle CurrencyLa valuta del prezzo del bundle, ad esempio USD.
Box NumberLa scatola in cui viene spedito questo componente.
Box LengthLa lunghezza della scatola.
Box WidthLa larghezza della scatola.
Box HeightL'altezza della scatola.
Box Dimensional UnitL'unità dimensionale, ad esempio INCH.
Box Weight CapacityLa capacità di peso della scatola.
Box Weight UnitL'unità di peso, ad esempio POUND.
Item SKULo SKU dell'articolo componente.
Item Product IDIl product ID dell'articolo componente.
Item NameIl nome visualizzato per l'articolo del catalogo.
Item DescriptionLa descrizione dell'articolo.
Item HS CodeIl codice del Sistema Armonizzato per la classificazione doganale.
Item Country of OriginIl codice paese di due lettere in cui l'articolo è fabbricato, ad esempio CN.
Item WeightIl peso dell'articolo.
Item Weight UnitL'unità di peso, ad esempio POUND.
Item LengthLa lunghezza dell'articolo.
Item WidthLa larghezza dell'articolo.
Item HeightL'altezza dell'articolo.
Item Dimensional UnitL'unità dimensionale per le misure dell'articolo, ad esempio INCH.
Item QuantityIl numero di unità di questo componente presenti nel bundle.
Item AmountIl prezzo del singolo articolo componente. Utilizzato per creare o aggiornare l'articolo del catalogo.
Item CurrencyLa valuta del prezzo dell'articolo, ad esempio USD.
Item Packing PreferenceCome deve essere imballato questo articolo. Usa ASSIGNED_BOX per gli articoli imballati nella scatola specificata, CONSOLIDATED per la cartonizzazione, o SHIPS_ALONE per gli articoli che devono essere spediti separatamente. Facoltativo — il valore predefinito è ASSIGNED_BOX quando sono presenti le colonne della scatola.
  1. Vai a Dashboard > Products > Bundles.
  2. Fai clic su Manage > Export.
  3. Scegli un'opzione di esportazione:
    • Export all bundles — esporta tutti i bundle
    • Export assigned box bundles — esporta solo i bundle con scatole preassegnate
    • Export auto bundles — esporta solo i bundle auto-box
  4. Fai clic su Export. Il CSV ti verrà inviato via email quando sarà pronto.

Nota: le modifiche a un bundle influiscono solo sugli ordini futuri. Gli ordini già effettuati ed evasi non sono interessati.

  1. Vai a Dashboard > Products > Bundles.
  2. Fai clic sul bundle che desideri modificare.
  3. Aggiorna i campi e fai clic su Save.

Puoi modificare la modalità di imballaggio, aggiungere o rimuovere componenti, aggiornare le assegnazioni delle scatole e modificare il prezzo del bundle.

Per eliminare un singolo bundle, aprilo e fai clic su Delete.

Per eliminare più bundle contemporaneamente:

  1. Seleziona i bundle che desideri eliminare utilizzando le caselle di controllo.
  2. Fai clic su Delete selected.
  3. Conferma l'eliminazione.

Per eliminare tutti i bundle nella pagina corrente, fai clic su Manage > Delete page.

Puoi aggiungere bundle a un preventivo direttamente dal preventivatore per visualizzare in anteprima il landed cost prima di effettuare un ordine.

  1. Nel preventivatore, passa alla scheda Search bundles nella sezione Items.
  2. Cerca un bundle per nome, SKU o product ID.
  3. Seleziona un bundle. Zonos automaticamente:
    • Espande il bundle nei singoli articoli componenti nell'elenco articoli, ciascuno con il proprio codice HS, paese di origine e prezzo scontato.
    • Popola le scatole (solo bundle a scatola assegnata) — le scatole predefinite del bundle vengono aggiunte alla sezione Boxes con le dimensioni precompilate.
    • Salta la popolazione delle scatole (bundle auto-box) — la cartonizzazione determina le scatole al momento del calcolo del preventivo.
  4. Gli articoli componenti vengono visualizzati raggruppati sotto il nome del bundle nell'elenco articoli.
  5. Calcola il preventivo. Il landed cost riflette la struttura effettiva del bundle — dazi, imposte e spedizione per componente basati sulle dimensioni reali o determinate automaticamente delle scatole.

Puoi aggiungere più bundle e articoli indipendenti allo stesso preventivo. Ogni bundle si espande in modo indipendente.

Perché i bundle sono importanti per il landed cost 

Senza bundle, Zonos vede una singola voce di riga (ad esempio, "Truck Tire 4-Pack — 1.000 $") senza alcuna visibilità sul contenuto. Ciò causa problemi:

  • Nessun codice HS per articolo — Zonos non può classificare i componenti per ottenere aliquote di dazio accurate
  • Nessuna dimensione reale delle scatole — i costi di spedizione vengono stimati utilizzando l'algoritmo di imballaggio automatico anziché le scatole effettive del commerciante
  • Nessun prezzo per articolo — per i calcoli dei dazi viene utilizzato il prezzo completo del bundle anziché il prezzo scontato per componente

I bundle risolvono tutti e tre i problemi fornendo a Zonos in anticipo la scomposizione dei componenti, le assegnazioni delle scatole (o il raggruppamento auto-box) e l'allocazione del prezzo. Il risultato è un preventivo del landed cost che riflette ciò che il cliente pagherà effettivamente alla frontiera.

Rapporti di prezzo e prezzi dei componenti 

Quando un bundle viene venduto, Zonos deve sapere quanto vale singolarmente ciascun componente. Questo perché le spedizioni internazionali richiedono un valore dichiarato per articolo sulla fattura commerciale, e dazi e imposte vengono calcolati su ciascun articolo separatamente.

Il priceRatio determina come il prezzo totale del bundle viene ripartito tra i suoi componenti. Non è necessario impostarlo manualmente — se lo lasci vuoto, Zonos suddivide automaticamente il prezzo in modo uniforme tra tutti i componenti.

Ad esempio, un bundle da 1.000 $ con 4 pneumatici e nessun rapporto di prezzo impostato dichiarerebbe automaticamente ogni pneumatico a 250 $ (0.25 ciascuno). Se i tuoi componenti hanno valori diversi — ad esempio 2 pneumatici premium e 2 standard — puoi impostare manualmente rapporti come 0.35 e 0.15 per riflettere l'effettiva differenza di valore.

Zonos normalizza automaticamente i rapporti, così non devi preoccuparti dei calcoli:

  • Se lasci alcuni rapporti vuoti, il valore restante viene distribuito uniformemente tra quei componenti
  • Se i rapporti non sommano esattamente a 1.0, Zonos li scala proporzionalmente
  • I rapporti finali sommano sempre esattamente a 1.0

Cartonizzazione ed etichette 

I componenti dei bundle a scatola assegnata utilizzano scatole definite dal commerciante anziché l'algoritmo standard di bin-packing. Il packingPreference di ciascun componente è impostato su ASSIGNED_BOX, che indica alla cartonizzazione di inserirlo nella scatola specificata da packageOptionId e packageOptionIdIndex.

Questo è il vantaggio principale dei bundle a scatola assegnata — il commerciante sa esattamente come viene spedito il proprio prodotto, quindi le dimensioni e i pesi delle scatole utilizzati per il calcolo del landed cost sono accurati, non stimati.

Ogni scatola di un bundle genera la propria etichetta di spedizione con il proprio numero di tracciamento. Un bundle con due scatole produce due etichette.

Ordini misti

Gli articoli che non fanno parte di un bundle nello stesso ordine vengono imballati separatamente utilizzando l'algoritmo di cartonizzazione standard, indipendentemente dalla modalità di imballaggio utilizzata dai bundle.

Ordini con bundle misti 

Un singolo ordine può contenere contemporaneamente più bundle e articoli indipendenti. Ad esempio, un ordine con:

  • 1 bundle da 4 pezzi con scatole assegnate (spedito in 2 scatole)
  • 1 bundle auto-box da 3 articoli (la cartonizzazione determina l'imballaggio)
  • 1 articolo singolo indipendente

Zonos espande ciascun bundle in modo indipendente. Il calcolo del landed cost copre tutte le scatole con dimensioni accurate e tutti i prezzi dei singoli componenti. Ogni scatola riceve la propria etichetta.

Integrazione Shopify 

I bundle presentano un comportamento specifico quando vengono utilizzati con negozi Shopify.

Configurazione

L'ID prodotto del bundle in Zonos Catalog deve corrispondere all'ID della variante Shopify del prodotto bundle. In questo modo Zonos associa la voce di riga Shopify alla definizione del bundle. Puoi trovare l'ID della variante nell'URL di amministrazione Shopify durante la visualizzazione della variante del prodotto.

Flusso dell'ordine

Quando un cliente ordina un bundle in un negozio Shopify:

  1. Shopify invia una singola voce di riga per il prodotto principale del bundle (ad esempio, "Truck Tire 4-Pack x 1").
  2. Zonos associa l'ID della variante della voce di riga all'ID prodotto del bundle nel tuo catalogo.
  3. Zonos espande il bundle nei suoi singoli componenti per il calcolo del landed cost: per ottenere dazi e imposte accurati vengono utilizzati il codice HS, il paese di origine e il prezzo scontato di ciascun componente.
  4. L'ordine Shopify continua a mostrare la singola voce di riga del bundle: l'espansione dei componenti viene gestita interamente da Zonos.

Evasione

Durante la creazione delle evasioni, Zonos associa nuovamente i componenti del bundle espanso alla voce di riga del bundle Shopify originale. Il commerciante vede il prodotto principale del bundle evaso in Shopify (ad esempio, "Truck Tire 4-Pack x 1 fulfilled"), mentre la fattura commerciale e i documenti doganali elencano ogni componente separatamente.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

Questa pagina è stata utile?