DOCS

Bundles

Bundles

Sprzedawaj produkty w paczkach z dokładnym kosztem docelowym i elastycznymi opcjami pakowania.

Bundle to produkt sprzedawany jako pojedyncza jednostka (nadrzędna), która w kasie rozkłada się na poszczególne komponenty. Kiedy klient kupuje bundle, Zonos rozpakowuje go na komponenty, obniża cenę każdego komponentu, aby pasowała do ceny bundle'a, i oblicza cła oraz podatki na podstawie kodu HS i kraju pochodzenia każdego komponentu.

Na przykład sprzedawca sprzedaje koszulki pojedynczo po 30 dolarów każda, albo jako bundle 4 sztuk za 100 dolarów. Kiedy klient kupuje bundle:

  • Zamówienie i faktura handlowa pokazują 4 koszulki po 25 dolarów każda (a nie 1 bundle za 100 dolarów ani 4 koszulki po 30 dolarów każda)
  • Kod HS i kraj pochodzenia każdej koszulki są używane do obliczenia kosztu docelowego
  • Koszty wysyłki są obliczane na podstawie rzeczywistych wymiarów pudełka, w którym sprzedawca je wysyła

Tryby pakowania 

Bundle'y obsługują dwa tryby pakowania, które kontrolują sposób pakowania towarów do wysyłki:

Przypisane pudełko

Sprzedawca wcześniej przypisuje towary do konkretnych pudełek o znanych wymiarach. Każde pudełko jest zdefiniowane z długością, szerokością, wysokością i pojemnością wagową. Kartonyzacja używa tych dokładnych pudełek zamiast szacować.

Najlepsze dla: Produktów, dla których wiadomo, w jakim pudełku są wysyłane, lub bundle'ów, które zawsze wysyłane są w tym samym pudełku.

Auto-box

Sprzedawca grupuje towary w bundle bez określania pudełek. W momencie zamówienia Zonos używa swojego algorytmu kartonyzacji, aby określić optymalne pakowanie na podstawie wymiarów towarów i dostępnych opcji pakowania.

Najlepsze dla: Bundle'ów, w których pakowanie się zmienia, produktów z elastycznym pakowaniem, lub gdy chcesz, aby Zonos automatycznie optymalizował wybór pudełka.

Oba tryby rozpakowują bundle na poszczególne komponenty z kodami HS per-element, krajem pochodzenia i obniżoną ceną. Różnica dotyczy tylko sposobu określania pudełek.

Jak działają bundle'y 

Kiedy tworzysz bundle w Katalogu, definiujesz:

  • Bundle SKU lub ID produktu — identyfikator produktu zgodny z Twoim sklepem
  • Cena bundle'u — całkowita cena, jak pojawia się w Twoim sklepie
  • Tryb pakowania — przypisane pudełko lub auto-box
  • Komponenty — każdy indywidualny produkt zawarty w bundle'u, odwołany przez jego ID towaru katalogowego. Komponenty muszą już istnieć jako towary katalogowe, zanim będziesz mógł je dodać do bundle'u.
  • Przydziały pudełek (tylko przypisane pudełko) — które komponenty wysyłane są w którym pudełku, z rzeczywistymi wymiarami i wagami

Kiedy zamówienie zawierające bundle zostanie złożone, Zonos automatycznie:

  1. Rozpakowuje bundle na jego poszczególne komponenty
  2. Obniża cenę każdego komponentu używając obliczonych współczynników ceny, aby ceny per-element pasowały do ceny bundle'u
  3. Oblicza koszt docelowy używając kodu HS każdego komponentu, kraju pochodzenia i wymiarów pudełek — dając dokładną sumę cła, podatku i wysyłki
  4. Generuje etykiety — bundle'y z przypisanym pudełkiem otrzymują jedną etykietę na każde zdefiniowane pudełko; bundle'y auto-box otrzymują etykiety na podstawie wyników kartonyzacji

Wymagania wstępne 

Przed utworzeniem bundle'u upewnij się, że:

  • Wszystkie komponenty istnieją jako towary katalogowe w Twoim Katalogu Zonos. Bundle odwołuje się do komponentów przez ich ID towaru katalogowego — nie możesz dodawać towarów, które nie istnieją. Komponenty nie muszą być sprzedawane indywidualnie w Twoim sklepie — mogą istnieć w Twoim katalogu wyłącznie jako części bundle'u.
  • Każdy komponent ma dokładne kody HS, kraj pochodzenia i wymiary (wagę i wymiary). Są one używane do obliczeń kosztu docelowego, gdy bundle zostanie rozpakowany.
  • SKU lub ID produktu bundle'u zgodne z identyfikatorem, który wysyła Twoja platforma e-commerce do Zonos i preferencją Item key w Twoim Panelu Kontrolnym Zonos. W przypadku sklepów Shopify, ID produktu bundle'u musi być ID wariantu Shopify produktu bundle'u.

Każdy bundle musi zawierać co najmniej 2 komponenty. Bundle z jednym elementem powinien być zamiast tego samodzielnym towarem katalogowym.

  1. Przejdź do Dashboard > Products > Bundles.
  2. Kliknij Add Bundle w prawym górnym rogu.
  3. Wpisz SKU lub Product ID bundle'u — musi być to identyfikator, który Twój sklep wysyła do Zonos. Ustawienie Item key preference w Twoim Panelu Kontrolnym Zonos musi być również ustawione na prawidłowy identyfikator.
  4. Wpisz nazwę, cenę i walutę bundle'u.
  5. Wybierz Assigned box jako tryb pakowania.
  6. Dodaj pudełka z konkretnymi wymiarami (długość, szerokość, wysokość i pojemność wagowa).
  7. Dodaj komponenty, wyszukując w swoim katalogu, i przypisz każdy z nich do pudełka. Dla każdego komponentu określ:
    • Ilość — ile jednostek tego komponentu znajduje się w bundle'u
    • Pudełko — w którym pudełku ten komponent jest wysyłany
    • Współczynnik ceny — część ceny bundle'u, którą reprezentuje ten komponent (obliczany automatycznie, jeśli pozostawiony pusty)
  8. Kliknij Save.

Dostępne są dwie opcje importu z Manage > Import:

Importuj bundle'y 

Tworzy bundle'y, które odwołują się do istniejących towarów katalogowych. Komponenty muszą już istnieć w Twoim katalogu przed importem.

  1. Przejdź do Dashboard > Products > Bundles.
  2. Kliknij Manage > Import bundles.
  3. Pobierz przykładowy szablon CSV — wybierz format Assigned box lub Auto-box.
  4. Wypełnij jeden wiersz na komponent. Pola na poziomie bundle'u (SKU, nazwa, cena) powtarzają się w każdym wierszu dla tego samego bundle'u.
  5. Prześlij ukończony CSV i kliknij Import.

Pola CSV bundle'u 

KolumnaOpis
Bundle SKUSKU bundle'u, jak pojawia się w Twoim sklepie.
Bundle Product IDID produktu bundle'u, jak pojawia się w Twoim sklepie.
Bundle NameNazwa bundle'u.
Bundle DescriptionOpis bundle'u.
Bundle Image URLURL obrazu bundle'u.
Bundle AmountCałkowita cena bundle'u.
Bundle CurrencyWaluta ceny bundle'u, np. USD.
Box NumberNumer pudełka, w którym wysyłany jest komponent z tego wiersza, np. 1 lub 2. Użyj tego samego numeru dla wszystkich komponentów w tym samym pudełku.
Box LengthDługość pudełka dla tego wiersza.
Box WidthSzerokość pudełka dla tego wiersza.
Box HeightWysokość pudełka dla tego wiersza.
Box Dimensional UnitJednostka wymiaru pudełka, np. INCH.
Box Weight CapacityMaksymalna pojemność wagi pudełka.
Box Weight UnitJednostka wagi dla pojemności pudełka, np. POUND.
Item SKUSKU tego komponentu. Musi być zgodne z istniejącym towarem katalogowym.
Item Product IDID produktu tego komponentu. Musi być zgodne z istniejącym towarem katalogowym.
Item QuantityIle jednostek tego komponentu znajduje się w bundle'u.

Uwaga: Zarówno przedrostki kolumn "Bundle", jak i "Kit" są akceptowane ze względu na kompatybilność wsteczną (np. "Kit SKU" działa tak samo jak "Bundle SKU").

Zasady walidacji importu CSV 

Poniższe zasady walidacji dotyczą wszystkich importów CSV bundle'ów:

  • Minimum 2 towary — Każdy bundle musi zawierać co najmniej 2 komponenty. Bundle z jednym elementem powinien być zamiast tego samodzielnym towarem katalogowym.
  • Pola pudełka wszystko albo nic — Dla bundle'ów z przypisanym pudełkiem wszystkie 6 pól pudełka musi być obecnych w każdym wierszu: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity i Box Weight Unit. Jeśli ustawione jest jakiekolwiek pole pudełka, wszystkie 6 jest wymaganych. Jeśli wszystkie pola pudełka są puste, bundle jest traktowany jako auto-box.
  • Brak mieszania trybów pakowania — Pojedynczy bundle nie może mieszać wierszy z przypisanym pudełkiem (z wymiarami pudełka) i wierszy auto-box (bez wymiarów pudełka). Wszystkie wiersze dla jednego bundle'u muszą używać tego samego trybu.
  • Normalizacja kodu HS — Kody HS są automatycznie formatowane podczas importu. Znaki niealfanumeryczne (kropki, myślniki, spacje) są usuwane, a kod jest normalizowany do formatu z parzystą liczbą cyfr.

Importuj bundle'y + towary katalogowe 

Tworzy zarówno towary katalogowe, JAK I bundle'y w jednym uploadzie. Użyj tego, gdy Twoje komponenty jeszcze nie istnieją w katalogu — zostaną utworzone lub zaktualizowane automatycznie.

  1. Przejdź do Dashboard > Products > Bundles.
  2. Kliknij Manage > Import bundles + catalog items.
  3. Pobierz przykładowy szablon CSV — wybierz format Assigned box lub Auto-box.
  4. Wypełnij jeden wiersz na komponent, wraz z kolumnami szczegółów towaru (nazwa, kod HS, kraj pochodzenia, wymiary).
  5. Prześlij ukończony CSV i kliknij Import.

Import najpierw tworzy lub aktualizuje podrzędne towary katalogowe, a następnie tworzy bundle'y, które się do nich odwołują. Jeśli towar o tym samym SKU lub ID produktu już istnieje, jego dane są aktualizowane wartościami z CSV. Kody HS są automatycznie normalizowane podczas importu (znaki niealfanumeryczne są usuwane, a kod jest formatowany do standardowego formatu z parzystą liczbą cyfr).

Połączone pola CSV 

Zawiera wszystkie pola CSV bundle'u plus kolumny szczegółów towaru:

KolumnaOpis
Bundle SKUSKU bundle'u.
Bundle Product IDID produktu bundle'u.
Bundle NameNazwa bundle'u.
Bundle DescriptionOpis bundle'u.
Bundle Image URLURL obrazu bundle'u.
Bundle AmountCałkowita cena bundle'u.
Bundle CurrencyWaluta ceny bundle'u, np. USD.
Box NumberW którym pudełku wysyłany jest ten komponent.
Box LengthDługość pudełka.
Box WidthSzerokość pudełka.
Box HeightWysokość pudełka.
Box Dimensional UnitJednostka wymiaru, np. INCH.
Box Weight CapacityPojemność wagi pudełka.
Box Weight UnitJednostka wagi, np. POUND.
Item SKUSKU komponentu.
Item Product IDID produktu komponentu.
Item NameNazwa wyświetlana towaru katalogowego.
Item DescriptionOpis towaru.
Item HS CodeKod Systemu Zharmonizowanego (HS) do klasyfikacji celnej.
Item Country of OriginDwuliterowy kod kraju, w którym towar jest produkowany, np. CN.
Item WeightWaga towaru.
Item Weight UnitJednostka wagi, np. POUND.
Item LengthDługość towaru.
Item WidthSzerokość towaru.
Item HeightWysokość towaru.
Item Dimensional UnitJednostka wymiaru towaru, np. INCH.
Item QuantityIle jednostek tego komponentu znajduje się w bundle'u.
Item AmountCena pojedynczego towaru komponentu. Używana przy tworzeniu lub aktualizacji towaru katalogowego.
Item CurrencyWaluta ceny towaru, np. USD.
Item Packing PreferenceJak ten towar ma być zapakowany. Użyj ASSIGNED_BOX dla towarów pakowanych w określonym pudełku, CONSOLIDATED dla kartonyzacji, lub SHIPS_ALONE dla towarów, które muszą być wysyłane osobno. Opcjonalne — domyślnie ASSIGNED_BOX, gdy obecne są kolumny pudełka.
  1. Przejdź do Dashboard > Products > Bundles.
  2. Kliknij Manage > Export.
  3. Wybierz opcję eksportu:
    • Export all bundles — eksportuje wszystkie bundle'y
    • Export assigned box bundles — eksportuje tylko bundle'y z wcześniej przypisanymi pudełkami
    • Export auto bundles — eksportuje tylko bundle'y auto-box
  4. Kliknij Export. Plik CSV zostanie wysłany do Ciebie e-mailem, gdy będzie gotowy.

Uwaga: Edycje bundle'u wpływają tylko na przyszłe zamówienia. Zamówienia już złożone i zrealizowane nie są dotknięte.

  1. Przejdź do Dashboard > Products > Bundles.
  2. Kliknij bundle, który chcesz edytować.
  3. Zaktualizuj pola i kliknij Save.

Możesz zmienić tryb pakowania, dodać lub usunąć komponenty, zaktualizować przydziały pudełek i zmodyfikować cenę bundle'u.

Aby usunąć jeden bundle, otwórz bundle i kliknij Delete.

Aby usunąć wiele bundle'ów na raz:

  1. Zaznacz bundle'y, które chcesz usunąć, używając pól wyboru.
  2. Kliknij Delete selected.
  3. Potwierdź usunięcie.

Aby usunąć wszystkie bundle'y na bieżącej stronie, kliknij Manage > Delete page.

Możesz dodać bundle'y do wyceny bezpośrednio z Quotera, aby podejrzeć koszt docelowy przed złożeniem zamówienia.

  1. W Quoterze przełącz się na kartę Search bundles w sekcji Items.
  2. Wyszukaj bundle po nazwie, SKU lub ID produktu.
  3. Wybierz bundle. Zonos automatycznie:
    • Rozpakowuje bundle na poszczególne komponenty na liście towarów, każdy z własnym kodem HS, krajem pochodzenia i obniżoną ceną.
    • Wypełnia pudełka (tylko bundle'y z przypisanym pudełkiem) — predefiniowane pudełka bundle'u są dodawane do sekcji Boxes z wypełnionymi wymiarami.
    • Pomija wypełnianie pudełek (bundle'y auto-box) — kartonyzacja określa pudełka przy obliczaniu wyceny.
  4. Komponenty pojawiają się pogrupowane pod nazwą bundle'u na liście towarów.
  5. Oblicz wycenę. Koszt docelowy odzwierciedla rzeczywistą strukturę bundle'u — cła, podatki i wysyłkę per-komponent na podstawie rzeczywistych lub automatycznie określonych wymiarów pudełek.

Możesz dodać wiele bundle'ów i pojedynczych towarów do tej samej wyceny. Każdy bundle rozpakowuje się niezależnie.

Dlaczego bundle'y są ważne dla kosztu docelowego 

Bez bundle'ów, Zonos widzi jeden element liniowy (np. „Truck Tire 4-Pack — 1000 dolarów") bez widoczności na to, co jest w środku. To powoduje problemy:

  • Brak kodów HS per-element — Zonos nie może klasyfikować komponentów dla dokładnych stawek celnych
  • Brak rzeczywistych wymiarów pudełek — koszty wysyłki są szacowane przy użyciu algorytmu auto-pakowania zamiast rzeczywistych pudełek sprzedawcy
  • Brak cen per-element — pełna cena bundle'u jest używana do obliczeń celnych zamiast obniżonej ceny per-komponent

Bundle'y rozwiązują wszystkie trzy poprzez danie Zonos rozkładu komponentów, przypisania pudełek (lub grupowania auto-box) i alokacji cen z góry. Wynik to wycena kosztu docelowego, która odzwierciedla to, co klient faktycznie zapłaci na granicy.

Współczynniki ceny i wycena komponentów 

Kiedy bundle jest sprzedawany, Zonos musi wiedzieć, ile wart jest każdy komponent z osobna. Wynika to z faktu, że międzynarodowe przesyłki wymagają zadeklarowanej wartości na fakturze handlowej dla każdego towaru, a cło/podatek są obliczane dla każdego towaru osobno.

priceRatio kontroluje, jak całkowita cena bundle'u jest dzielona między jego komponenty. Nie musisz ustawiać tego samodzielnie — jeśli pozostawisz to pole puste, Zonos automatycznie rozdzieli cenę równomiernie między wszystkie komponenty.

Na przykład bundle za 1000 dolarów z 4 oponami bez ustawionych współczynników ceny automatycznie zadeklaruje każdą oponę za 250 dolarów (0.25 każda). Jeśli Twoje komponenty mają różne wartości — powiedzmy 2 opony premium i 2 standardowe — możesz ręcznie ustawić proporcje takie jak 0.35 i 0.15, aby odzwierciedlić rzeczywistą różnicę wartości.

Zonos automatycznie normalizuje proporcje, więc nie musisz martwić się o matematykę:

  • Jeśli pozostawisz niektóre proporcje puste, pozostała wartość jest rozdzielana równomiernie między te komponenty
  • Jeśli proporcje nie sumują się dokładnie do 1.0, Zonos skaluje je proporcjonalnie
  • Ostateczne proporcje zawsze sumują się dokładnie do 1.0

Kartonyzacja i etykiety 

Komponenty bundle'u z przypisanym pudełkiem używają pudełek zdefiniowanych przez sprzedawcę zamiast standardowego algorytmu bin-packingu. packingPreference każdego komponentu jest ustawiony na ASSIGNED_BOX, co mówi kartonyzacji, aby umieściła go w pudełku określonym przez packageOptionId i packageOptionIdIndex.

To jest główna przewaga bundle'ów z przypisanym pudełkiem — sprzedawca dokładnie wie, jak jego produkt jest wysyłany, więc wymiary pudełek i wagi używane do obliczenia kosztu docelowego są dokładne, a nie szacunkowe.

Każde pudełko w bundle'u generuje własną etykietę wysyłkową z własnym numerem śledzenia. Bundle z dwoma pudełkami tworzy dwie etykiety.

Zamówienia mieszane

Towary nie będące bundle'ami w tym samym zamówieniu są pakowane osobno, używając standardowego algorytmu kartonyzacji, niezależnie od tego, jakiego trybu pakowania używają bundle'y.

Zamówienia z wieloma bundle'ami 

Jedno zamówienie może zawierać jednocześnie wiele bundle'ów i pojedyncze towary. Na przykład zamówienie z:

  • 1x bundle 4-pack z przypisanymi pudełkami (wysyłany w 2 pudełkach)
  • 1x bundle auto-box z 3 towarami (kartonyzacja określa pakowanie)
  • 1x pojedynczy samodzielny towar

Zonos rozpakowuje każdy bundle niezależnie. Obliczenie kosztu docelowego obejmuje wszystkie pudełka z dokładnymi wymiarami i wszystkie poszczególne ceny komponentów. Każde pudełko dostaje własną etykietę.

Integracja Shopify 

Bundle'y mają specyficzne zachowanie, gdy są używane ze sklepami Shopify.

Konfiguracja

ID produktu bundle'u w Katalogu Zonos musi być zgodne z ID wariantu Shopify produktu bundle'u. To jest sposób, w jaki Zonos pasuje element liniowy Shopify do definicji bundle'u. ID wariantu można znaleźć w URL panelu administratora Shopify, gdy przeglądasz wariant produktu.

Przepływ zamówienia

Gdy klient zamawia bundle w sklepie Shopify:

  1. Shopify wysyła jeden element liniowy dla bundle'u nadrzędnego (np. „Truck Tire 4-Pack x 1").
  2. Zonos dopasowuje ID wariantu elementu liniowego do ID produktu bundle'u w Twoim katalogu.
  3. Zonos rozpakowuje bundle na jego poszczególne komponenty do obliczenia kosztu docelowego — kod HS każdego komponentu, kraj pochodzenia i obniżona cena są używane do dokładnych ceł i podatków.
  4. Zamówienie Shopify nadal pokazuje element liniowy bundle'u — rozpakowanie komponentów jest obsługiwane całkowicie przez Zonos.

Realizacja

Podczas tworzenia realizacji, Zonos mapuje rozpakowane komponenty bundle'u z powrotem do oryginalnego elementu liniowego bundle'u Shopify. Sprzedawca widzi zrealizowany bundle rodzicielski w Shopify (np. „Truck Tire 4-Pack x 1 fulfilled"), podczas gdy faktura handlowa i dokumenty celne wymieniają każdy komponent osobno.

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

Czy ta strona była pomocna?