DOCS

Gói hàng

Gói hàng

Bán sản phẩm gói với chi phí đã hạ cánh chính xác và các tùy chọn đóng gói linh hoạt.

Gói hàng là một sản phẩm được bán dưới dạng một đơn vị (cha) duy nhất, được tách thành các mục thành phần riêng lẻ tại khâu thanh toán. Khi khách hàng mua một gói hàng, Zonos sẽ mở rộng gói hàng thành các thành phần của nó, chiết khấu giá của mỗi thành phần để khớp với giá gói hàng, và tính toán thuế quan cùng thuế dựa trên mã HS và quốc gia xuất xứ của mỗi thành phần.

Ví dụ, một thương nhân bán áo sơ mi riêng lẻ với giá 30 USD mỗi chiếc, hoặc dưới dạng gói 4 chiếc với giá 100 USD. Khi khách hàng mua gói hàng:

  • Đơn hàng và hoá đơn thương mại hiển thị 4 áo sơ mi với giá 25 USD mỗi chiếc (không phải 1 gói hàng giá 100 USD hay 4 áo sơ mi giá 30 USD mỗi chiếc)
  • Mã HS và quốc gia xuất xứ của mỗi áo sơ mi được dùng để tính chi phí đã hạ cánh
  • Chi phí vận chuyển được tính dựa trên kích thước hộp thực tế mà thương nhân dùng để gửi hàng

Chế độ đóng gói 

Gói hàng hỗ trợ hai chế độ đóng gói kiểm soát cách các mục được đóng hộp để vận chuyển:

Hộp chỉ định

Thương nhân gán trước các mục vào các hộp cụ thể có kích thước đã biết. Mỗi hộp được xác định với chiều dài, chiều rộng, chiều cao, và dung lượng trọng lượng. Cartonization sử dụng chính xác các hộp này thay vì ước tính.

Phù hợp nhất cho: Các sản phẩm mà bạn đã biết chúng được gửi trong hộp nào, hoặc các gói hàng luôn được gửi trong cùng một hộp.

Hộp tự động

Thương nhân nhóm các mục vào một gói hàng mà không chỉ định hộp. Tại thời điểm đặt hàng, Zonos sử dụng thuật toán cartonization của mình để xác định cách đóng hộp tối ưu dựa trên kích thước của các mục và các tùy chọn đóng gói hiện có.

Phù hợp nhất cho: Các gói hàng có cách đóng gói thay đổi, các sản phẩm có bao bì linh hoạt, hoặc khi bạn muốn Zonos tự động tối ưu hóa việc chọn hộp.

Cả hai chế độ đều mở rộng gói hàng thành các thành phần riêng lẻ với mã HS, quốc gia xuất xứ, và giá chiết khấu cho từng mục. Sự khác biệt duy nhất là ở cách xác định hộp.

Cách gói hàng hoạt động 

Khi bạn tạo một gói hàng trong Catalog, bạn xác định:

  • SKU gói hàng hoặc ID sản phẩm — định danh sản phẩm khớp với cửa hàng của bạn
  • Giá gói hàng — tổng giá như nó xuất hiện trong cửa hàng của bạn
  • Chế độ đóng gói — hộp chỉ định hoặc hộp tự động
  • Mục thành phần — mỗi sản phẩm riêng lẻ có trong gói hàng, được tham chiếu bằng ID mục danh mục của nó. Các thành phần phải đã tồn tại dưới dạng mục danh mục trước khi bạn có thể thêm chúng vào gói hàng.
  • Gán hộp (chỉ áp dụng cho hộp chỉ định) — thành phần nào được gửi trong hộp nào, với kích thước và trọng lượng thực tế

Khi một đơn hàng chứa gói hàng được đặt, Zonos tự động:

  1. Mở rộng gói hàng thành các thành phần riêng lẻ của nó
  2. Chiết khấu mỗi thành phần bằng cách sử dụng tỷ lệ giá đã tính toán để giá từng mục khớp với giá gói hàng
  3. Tính toán chi phí đã hạ cánh bằng cách sử dụng mã HS, quốc gia xuất xứ, và kích thước hộp của mỗi thành phần — cho ra tổng thuế quan, thuế, và vận chuyển chính xác
  4. Tạo nhãn — gói hàng dạng hộp chỉ định nhận một nhãn cho mỗi hộp được xác định; gói hàng dạng hộp tự động nhận nhãn dựa trên kết quả cartonization

Điều kiện tiên quyết 

Trước khi tạo một gói hàng, hãy đảm bảo rằng:

  • Tất cả các mục thành phần tồn tại dưới dạng mục danh mục trong Zonos Catalog của bạn. Gói hàng tham chiếu các thành phần theo ID mục danh mục của chúng — bạn không thể thêm các mục chưa tồn tại. Các thành phần không cần phải được bán riêng lẻ trong cửa hàng của bạn — chúng có thể chỉ tồn tại trong danh mục của bạn với vai trò là các bộ phận của gói hàng.
  • Mỗi thành phần có mã HS, quốc gia xuất xứ, và các số đo (trọng lượng và kích thước) chính xác. Các thông tin này được dùng để tính chi phí đã hạ cánh khi gói hàng được mở rộng.
  • SKU hoặc ID sản phẩm của gói hàng khớp với định danh mà nền tảng thương mại điện tử của bạn gửi đến Zonos và tùy chọn khóa mục (Item key preference) trong Zonos Dashboard của bạn. Đối với các cửa hàng Shopify, ID sản phẩm của gói hàng phải là ID biến thể Shopify của sản phẩm gói hàng.

Mỗi gói hàng phải chứa ít nhất 2 mục thành phần. Một gói hàng chỉ có một mục nên là một mục danh mục độc lập thay vì gói hàng.

  1. Đi tới Dashboard > Products > Bundles.
  2. Nhấp vào Add Bundle ở góc trên cùng bên phải.
  3. Nhập SKU hoặc Product ID của gói hàng — điều này phải khớp với định danh mà cửa hàng của bạn gửi đến Zonos. Item key preference trong Zonos Dashboard của bạn cũng phải được đặt thành định danh chính xác.
  4. Nhập tên, giá, và tiền tệ của gói hàng.
  5. Chọn Assigned box làm chế độ đóng gói.
  6. Thêm các hộp với kích thước cụ thể (chiều dài, chiều rộng, chiều cao, và dung lượng trọng lượng).
  7. Thêm các mục thành phần bằng cách tìm kiếm trong danh mục của bạn và gán mỗi mục vào một hộp. Đối với mỗi thành phần, hãy chỉ định:
    • Quantity — có bao nhiêu đơn vị của thành phần này trong gói hàng
    • Box — thành phần này được gửi trong hộp nào
    • Price ratio — phần nào của giá gói hàng mà thành phần này đại diện (tự động tính toán nếu để trống)
  8. Nhấp vào Save.

Có hai tùy chọn nhập có sẵn từ Manage > Import:

Nhập gói hàng 

Tạo các gói hàng tham chiếu đến các mục danh mục hiện có. Các mục thành phần phải đã tồn tại trong danh mục của bạn trước khi nhập.

  1. Đi tới Dashboard > Products > Bundles.
  2. Nhấp vào Manage > Import bundles.
  3. Tải xuống mẫu CSV — chọn định dạng Assigned box hoặc Auto-box.
  4. Điền một hàng cho mỗi mục thành phần. Các trường cấp gói hàng (SKU, tên, giá) lặp lại trên mỗi hàng cho cùng một gói hàng.
  5. Tải lên tệp CSV đã hoàn thành của bạn và nhấp vào Import.

Các trường CSV của gói hàng 

CộtMô tả
Bundle SKUSKU của gói hàng như nó xuất hiện trong cửa hàng của bạn.
Bundle Product IDID sản phẩm của gói hàng như nó xuất hiện trong cửa hàng của bạn.
Bundle NameTên của gói hàng.
Bundle DescriptionMô tả về gói hàng.
Bundle Image URLURL hình ảnh cho gói hàng.
Bundle AmountTổng giá của gói hàng.
Bundle CurrencyTiền tệ của giá gói hàng, ví dụ: USD.
Box NumberSố hộp mà thành phần của hàng này được gửi, ví dụ: 1 hoặc 2. Dùng cùng một số cho tất cả các thành phần trong cùng một hộp.
Box LengthChiều dài của hộp cho hàng này.
Box WidthChiều rộng của hộp cho hàng này.
Box HeightChiều cao của hộp cho hàng này.
Box Dimensional UnitĐơn vị kích thước cho hộp, ví dụ: INCH.
Box Weight CapacityDung lượng trọng lượng tối đa của hộp.
Box Weight UnitĐơn vị trọng lượng cho dung lượng hộp, ví dụ: POUND.
Item SKUSKU của mục thành phần này. Phải khớp với một mục danh mục hiện có.
Item Product IDID sản phẩm của mục thành phần này. Phải khớp với một mục danh mục hiện có.
Item QuantityCó bao nhiêu đơn vị của thành phần này trong gói hàng.

Ghi chú: Cả hai tiền tố cột "Bundle""Kit" đều được chấp nhận để tương thích ngược (ví dụ: "Kit SKU" hoạt động giống như "Bundle SKU").

Quy tắc xác thực khi nhập CSV 

Các quy tắc xác thực sau áp dụng cho tất cả các lần nhập CSV gói hàng:

  • Tối thiểu 2 mục — Mỗi gói hàng phải chứa ít nhất 2 mục thành phần. Một gói hàng chỉ có một mục nên là một mục danh mục độc lập thay vì gói hàng.
  • Tất cả hoặc không có trường hộp nào — Đối với gói hàng dạng hộp chỉ định, cả 6 trường hộp phải có mặt trên mỗi hàng: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity, và Box Weight Unit. Nếu bất kỳ trường hộp nào được đặt, cả 6 trường đều bắt buộc. Nếu tất cả các trường hộp đều trống, gói hàng được xử lý như hộp tự động.
  • Không trộn các chế độ đóng gói — Một gói hàng duy nhất không thể trộn các hàng dạng hộp chỉ định (có kích thước hộp) và các hàng dạng hộp tự động (không có kích thước hộp). Tất cả các hàng cho một gói hàng phải dùng cùng một chế độ.
  • Chuẩn hóa mã HS — Mã HS được tự động định dạng khi nhập. Các ký tự không phải chữ và số (dấu chấm, dấu gạch ngang, khoảng trắng) bị loại bỏ và mã được chuẩn hóa thành định dạng số chữ số chẵn.

Nhập gói hàng + mục danh mục 

Tạo cả mục danh mục VÀ gói hàng trong một lần tải lên duy nhất. Sử dụng tùy chọn này khi các mục thành phần của bạn chưa tồn tại trong danh mục — chúng sẽ được tạo hoặc cập nhật tự động.

  1. Đi tới Dashboard > Products > Bundles.
  2. Nhấp vào Manage > Import bundles + catalog items.
  3. Tải xuống mẫu CSV — chọn định dạng Assigned box hoặc Auto-box.
  4. Điền một hàng cho mỗi mục thành phần, bao gồm các cột chi tiết mục (tên, mã HS, quốc gia xuất xứ, số đo).
  5. Tải lên tệp CSV đã hoàn thành của bạn và nhấp vào Import.

Quá trình nhập trước tiên tạo hoặc cập nhật các mục danh mục con, sau đó tạo các gói hàng tham chiếu đến chúng. Nếu một mục có cùng SKU hoặc ID sản phẩm đã tồn tại, chi tiết của nó sẽ được cập nhật bằng các giá trị từ CSV. Mã HS được tự động chuẩn hóa trong quá trình nhập (các ký tự không phải chữ và số bị loại bỏ và mã được định dạng theo tiêu chuẩn số chữ số chẵn).

Các trường CSV kết hợp 

Bao gồm tất cả các trường CSV của gói hàng cộng với các cột chi tiết mục:

CộtMô tả
Bundle SKUSKU của gói hàng.
Bundle Product IDID sản phẩm của gói hàng.
Bundle NameTên của gói hàng.
Bundle DescriptionMô tả về gói hàng.
Bundle Image URLURL hình ảnh cho gói hàng.
Bundle AmountTổng giá của gói hàng.
Bundle CurrencyTiền tệ của giá gói hàng, ví dụ: USD.
Box NumberHộp nào mà thành phần này được gửi.
Box LengthChiều dài của hộp.
Box WidthChiều rộng của hộp.
Box HeightChiều cao của hộp.
Box Dimensional UnitĐơn vị kích thước, ví dụ: INCH.
Box Weight CapacityDung lượng trọng lượng của hộp.
Box Weight UnitĐơn vị trọng lượng, ví dụ: POUND.
Item SKUSKU của mục thành phần.
Item Product IDID sản phẩm của mục thành phần.
Item NameTên hiển thị cho mục danh mục.
Item DescriptionMô tả của mục.
Item HS CodeMã Hệ thống hài hòa (HS) dùng để phân loại hải quan.
Item Country of OriginMã quốc gia hai chữ cái nơi mục được sản xuất, ví dụ: CN.
Item WeightTrọng lượng của mục.
Item Weight UnitĐơn vị trọng lượng, ví dụ: POUND.
Item LengthChiều dài của mục.
Item WidthChiều rộng của mục.
Item HeightChiều cao của mục.
Item Dimensional UnitĐơn vị kích thước cho các số đo của mục, ví dụ: INCH.
Item QuantityCó bao nhiêu đơn vị của thành phần này trong gói hàng.
Item AmountGiá của mục thành phần riêng lẻ. Được dùng khi tạo hoặc cập nhật mục danh mục.
Item CurrencyTiền tệ của giá mục, ví dụ: USD.
Item Packing PreferenceCách mục này nên được đóng gói. Dùng ASSIGNED_BOX cho các mục được đóng trong hộp đã chỉ định, CONSOLIDATED cho cartonization, hoặc SHIPS_ALONE cho các mục phải được gửi riêng. Tùy chọn — mặc định là ASSIGNED_BOX khi có các cột hộp.
  1. Đi tới Dashboard > Products > Bundles.
  2. Nhấp vào Manage > Export.
  3. Chọn một tùy chọn xuất:
    • Export all bundles — xuất mọi gói hàng
    • Export assigned box bundles — chỉ xuất các gói hàng có hộp được gán trước
    • Export auto bundles — chỉ xuất các gói hàng dạng hộp tự động
  4. Nhấp vào Export. Tệp CSV sẽ được gửi qua email cho bạn khi sẵn sàng.

Ghi chú: Các chỉnh sửa đối với gói hàng chỉ ảnh hưởng đến các đơn hàng trong tương lai. Các đơn hàng đã được đặt và hoàn thành không bị ảnh hưởng.

  1. Đi tới Dashboard > Products > Bundles.
  2. Nhấp vào gói hàng bạn muốn chỉnh sửa.
  3. Cập nhật các trường và nhấp vào Save.

Bạn có thể thay đổi chế độ đóng gói, thêm hoặc xóa thành phần, cập nhật gán hộp, và sửa đổi giá gói hàng.

Để xóa một gói hàng duy nhất, hãy mở gói hàng và nhấp vào Delete.

Để xóa nhiều gói hàng cùng một lúc:

  1. Chọn các gói hàng bạn muốn xóa bằng các hộp kiểm.
  2. Nhấp vào Delete selected.
  3. Xác nhận việc xóa.

Để xóa tất cả các gói hàng trên trang hiện tại, nhấp vào Manage > Delete page.

Bạn có thể thêm gói hàng vào một báo giá trực tiếp từ trình báo giá để xem trước chi phí đã hạ cánh trước khi đặt hàng.

  1. Trong trình báo giá, chuyển sang tab Search bundles trong phần Items.
  2. Tìm kiếm một gói hàng theo tên, SKU, hoặc ID sản phẩm.
  3. Chọn một gói hàng. Zonos sẽ tự động:
    • Mở rộng gói hàng thành các mục thành phần riêng lẻ trong danh sách mục, mỗi mục có mã HS, quốc gia xuất xứ, và giá chiết khấu riêng.
    • Điền các hộp (chỉ đối với gói hàng dạng hộp chỉ định) — các hộp đã được xác định trước của gói hàng được thêm vào phần Boxes với kích thước được điền sẵn.
    • Bỏ qua việc điền hộp (đối với gói hàng dạng hộp tự động) — cartonization sẽ xác định hộp khi báo giá được tính toán.
  4. Các mục thành phần xuất hiện được nhóm dưới tên gói hàng trong danh sách mục.
  5. Tính toán báo giá. Chi phí đã hạ cánh phản ánh cấu trúc gói hàng thực tế — thuế quan, thuế, và vận chuyển cho từng thành phần dựa trên kích thước hộp thực tế hoặc được xác định tự động.

Bạn có thể thêm nhiều gói hàng và các mục độc lập vào cùng một báo giá. Mỗi gói hàng mở rộng độc lập.

Tại sao gói hàng quan trọng đối với chi phí đã hạ cánh 

Nếu không có gói hàng, Zonos sẽ chỉ thấy một mục dòng duy nhất (ví dụ: "Truck Tire 4-Pack — 1.000 USD") mà không có khả năng thấy bên trong có gì. Điều này gây ra các vấn đề:

  • Không có mã HS trên từng mục — Zonos không thể phân loại các thành phần để tính tỷ lệ thuế chính xác
  • Không có kích thước hộp thực tế — chi phí vận chuyển được ước tính bằng thuật toán đóng gói tự động thay vì các hộp thực tế của thương nhân
  • Không có giá trên từng mục — toàn bộ giá gói hàng được dùng để tính thuế thay vì giá chiết khấu theo từng thành phần

Gói hàng giải quyết cả ba vấn đề bằng cách cung cấp cho Zonos bảng phân tích thành phần, gán hộp (hoặc nhóm hộp tự động), và phân bổ giá ngay từ đầu. Kết quả là một báo giá chi phí đã hạ cánh phản ánh đúng những gì khách hàng sẽ thực sự phải trả tại biên giới.

Tỷ lệ giá và giá từng thành phần 

Khi một gói hàng được bán, Zonos cần biết giá trị riêng của từng thành phần. Điều này là do các lô hàng quốc tế yêu cầu một giá trị khai báo cho mỗi mục trên hoá đơn thương mại, và thuế/thuế quan được tính riêng cho từng mục.

priceRatio kiểm soát cách tổng giá của gói hàng được chia cho các thành phần của nó. Bạn không cần tự đặt giá trị này — nếu bạn để trống, Zonos sẽ tự động chia đều giá cho tất cả các thành phần.

Ví dụ, một gói hàng 1.000 USD với 4 lốp xe và không đặt tỷ lệ giá sẽ tự động khai báo mỗi lốp xe ở mức 250 USD (0,25 mỗi lốp). Nếu các thành phần của bạn có giá trị khác nhau — chẳng hạn 2 lốp cao cấp và 2 lốp tiêu chuẩn — bạn có thể tự đặt tỷ lệ như 0,35 và 0,15 để phản ánh sự khác biệt giá trị thực tế.

Zonos tự động chuẩn hóa các tỷ lệ để bạn không cần lo về việc tính toán:

  • Nếu bạn để trống một số tỷ lệ, giá trị còn lại sẽ được chia đều cho các thành phần đó
  • Nếu các tỷ lệ không cộng lại đúng bằng 1,0, Zonos sẽ điều chỉnh chúng theo tỷ lệ tương ứng
  • Các tỷ lệ cuối cùng luôn cộng lại đúng bằng 1,0

Cartonization và nhãn 

Các thành phần của gói hàng dạng hộp chỉ định sử dụng hộp do thương nhân xác định thay vì thuật toán đóng gói bin tiêu chuẩn. packingPreference của mỗi thành phần được đặt thành ASSIGNED_BOX, cho biết cartonization đặt nó vào hộp được chỉ định bởi packageOptionIdpackageOptionIdIndex.

Đây là ưu điểm cốt lõi của gói hàng dạng hộp chỉ định — thương nhân biết chính xác cách sản phẩm của họ được gửi, vì vậy kích thước hộp và trọng lượng được dùng để tính chi phí đã hạ cánh là chính xác, không phải ước tính.

Mỗi hộp trong một gói hàng tạo ra nhãn vận chuyển riêng với số theo dõi riêng của nó. Một gói hàng có hai hộp tạo ra hai nhãn.

Đơn hàng hỗn hợp

Các mục không phải gói hàng trong cùng một đơn hàng được đóng gói riêng biệt bằng thuật toán cartonization tiêu chuẩn, bất kể gói hàng dùng chế độ đóng gói nào.

Đơn hàng gói hàng hỗn hợp 

Một đơn hàng duy nhất có thể chứa nhiều gói hàng và các mục độc lập cùng một lúc. Ví dụ, một đơn hàng với:

  • 1x gói hàng 4 cái với hộp chỉ định (được gửi trong 2 hộp)
  • 1x gói hàng 3 mục dạng hộp tự động (cartonization xác định cách đóng gói)
  • 1x một mục độc lập

Zonos mở rộng mỗi gói hàng độc lập. Việc tính toán chi phí đã hạ cánh bao gồm tất cả các hộp với kích thước chính xác và tất cả các giá thành phần riêng lẻ. Mỗi hộp nhận nhãn riêng của nó.

Tích hợp Shopify 

Các gói hàng có hành vi cụ thể khi được sử dụng với các cửa hàng Shopify.

Thiết lập

ID sản phẩm của gói hàng trong Zonos Catalog phải khớp với ID biến thể Shopify của sản phẩm gói hàng. Đây là cách Zonos khớp mục dòng Shopify với định nghĩa gói hàng. Bạn có thể tìm ID biến thể trong URL quản trị Shopify khi xem biến thể sản phẩm.

Luồng đơn hàng

Khi khách hàng đặt hàng một gói hàng trên cửa hàng Shopify:

  1. Shopify gửi một mục dòng duy nhất cho gói hàng cha (ví dụ: "Truck Tire 4-Pack x 1").
  2. Zonos khớp ID biến thể của mục dòng với ID sản phẩm của gói hàng trong danh mục của bạn.
  3. Zonos mở rộng gói hàng thành các thành phần riêng lẻ của nó để tính chi phí đã hạ cánh — mã HS, quốc gia xuất xứ, và giá chiết khấu của mỗi thành phần được dùng để tính thuế quan và thuế chính xác.
  4. Đơn hàng Shopify vẫn hiển thị mục dòng gói hàng duy nhất — việc mở rộng thành phần hoàn toàn do Zonos xử lý.

Hoàn thành đơn hàng

Khi tạo các lần hoàn thành, Zonos ánh xạ các thành phần gói hàng đã mở rộng trở lại mục dòng gói hàng Shopify gốc. Thương nhân thấy gói hàng cha được hoàn thành trong Shopify (ví dụ: "Truck Tire 4-Pack x 1 fulfilled"), trong khi hoá đơn thương mại và tài liệu hải quan liệt kê từng thành phần riêng biệt.

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

Trang này có hữu ích không?