DOCS

Bundles

정확한 landed cost와 유연한 포장 옵션으로 Bundle 상품을 판매하세요.

Bundle은 주문 생성 시 개별 구성 요소 상품으로 분해되는 단일 (부모) 단위로 판매되는 상품입니다. 고객이 Bundle을 구매하면 Zonos는 이를 구성 요소로 분해하고, 합계가 부모 Bundle 가격과 일치하도록 각 구성 요소의 가격을 조정하며, 각 개별 구성 요소를 기준으로 관세 및 세금을 계산합니다.

예를 들어, 한 판매자가 셔츠를 개당 $30에 개별 판매하거나 4벌 Bundle로 $100에 판매한다고 가정해 보겠습니다. 고객이 Bundle을 구매하면:

  • 주문 및 상업 송장에는 4벌 셔츠가 각각 $25로 표시됩니다(1개의 $100 Bundle 또는 4벌 각 $30이 아닙니다)
  • 각 셔츠의 HS 코드와 원산지가 landed cost 계산에 사용됩니다
  • 배송 비용은 판매자가 실제로 사용하는 박스 치수를 기준으로 계산됩니다

포장 모드 

Bundle은 상품이 배송을 위해 어떻게 박스에 포장되는지를 결정하는 두 가지 포장 모드를 지원합니다:

지정 박스

판매자가 알려진 치수를 가진 특정 박스에 상품을 미리 할당합니다. 각 박스는 길이, 너비, 높이, 중량 용량으로 정의됩니다. Cartonization은 추정하지 않고 이 정확한 박스를 사용합니다.

적합한 경우: 상품이 어떤 박스로 배송되는지 알고 있거나, 항상 동일한 박스로 배송되는 Bundle.

Auto-box

판매자가 박스를 지정하지 않고 상품을 Bundle로 그룹화합니다. 주문 시점에 Zonos는 상품의 치수와 사용 가능한 포장 옵션을 기반으로 Cartonization 알고리즘을 사용하여 최적의 박스 포장을 결정합니다.

적합한 경우: 포장이 매번 달라지는 Bundle, 유연한 포장이 필요한 상품, 또는 Zonos가 자동으로 박스 선택을 최적화하기를 원하는 경우.

두 모드 모두 Bundle을 상품별 HS 코드, 원산지, 할인 가격이 적용된 개별 구성 요소로 분해합니다. 차이점은 박스가 결정되는 방식뿐입니다.

Bundle의 작동 방식 

Catalog에서 Bundle을 생성할 때 다음을 정의합니다:

  • Bundle SKU 또는 product ID — 스토어와 일치하는 상품 식별자
  • Bundle price — 스토어에 표시되는 총 가격
  • Packing mode — 지정 박스 또는 Auto-box
  • Component items — Bundle에 포함된 각 개별 상품으로, Catalog 상품 ID로 참조됩니다. 구성 요소는 Bundle에 추가하기 전에 이미 Catalog 상품으로 존재해야 합니다.
  • Box assignments (지정 박스 전용) — 각 구성 요소가 어떤 박스로 배송되는지, 실제 치수 및 중량과 함께

Bundle이 포함된 주문이 접수되면 Zonos는 자동으로:

  1. Bundle을 분해하여 개별 구성 요소로 만듭니다
  2. 계산된 price ratio를 사용하여 각 구성 요소를 할인하고 상품별 가격이 Bundle 가격과 일치하도록 합니다
  3. 각 구성 요소의 HS 코드, 원산지, 박스 치수를 사용하여 landed cost를 계산하고 정확한 관세, 세금, 배송 합계를 산출합니다
  4. 라벨을 생성합니다 — 지정 박스 Bundle은 정의된 박스당 하나의 라벨을 받고, Auto-box Bundle은 Cartonization 결과에 따라 라벨을 받습니다

전제 조건 

Bundle을 생성하기 전에 다음을 확인하세요:

  • 모든 구성 요소 상품이 Zonos Catalog에 Catalog 상품으로 존재해야 합니다. Bundle은 Catalog 상품 ID로 구성 요소를 참조하므로 아직 존재하지 않는 상품은 추가할 수 없습니다. 구성 요소는 스토어에서 개별적으로 판매될 필요가 없으며, Catalog 내에 Bundle 부품으로만 존재해도 됩니다.
  • 각 구성 요소에 정확한 HS 코드, 원산지, 측정값(중량 및 치수)이 있어야 합니다. 이는 Bundle이 분해될 때 landed cost 계산에 사용됩니다.
  • Bundle의 SKU 또는 product ID가 전자상거래 플랫폼이 Zonos로 전송하는 식별자 및 Zonos Dashboard의 Item key preference와 일치해야 합니다. Shopify 스토어의 경우, Bundle의 product ID는 반드시 Bundle 상품의 Shopify variant ID여야 합니다.

landed cost에서 Bundle이 중요한 이유 

Bundle이 없으면 Zonos는 단일 라인 상품(예: "Truck Tire 4-Pack — $1,000")만 인식하며 내부 구성을 파악할 수 없습니다. 이는 다음과 같은 문제를 일으킵니다:

  • 상품별 HS 코드 없음 — Zonos가 정확한 관세율을 위해 구성 요소를 분류할 수 없습니다
  • 실제 박스 치수 없음 — 판매자의 실제 박스 대신 자동 포장 알고리즘을 사용하여 배송 비용이 추정됩니다
  • 상품별 가격 없음 — 할인된 구성 요소별 가격 대신 Bundle 전체 가격이 관세 계산에 사용됩니다
  • **상업 송장의 잘못된 정보 - 상업 송장에 각 개별 상품 대신 1개의 상품만 표시됩니다
  • **일반적인 포장 명세서 - 포장 명세서에 주문에 포함될 각 상품이 표시되지 않고 Bundle 전체에 대한 단일 라인 상품만 표시됩니다

Bundle은 구성 요소 분해, 박스 할당(또는 Auto-box 그룹화), 가격 배분 정보를 Zonos에 미리 제공함으로써 이 다섯 가지 문제를 모두 해결합니다. 그 결과 고객이 국경에서 실제로 지불하게 될 금액을 반영한 landed cost 견적과 상업 송장을 얻을 수 있습니다.

Price ratio와 구성 요소 가격 

Bundle이 판매되면 Zonos는 각 구성 요소의 개별 가치를 알아야 합니다. 국제 배송에서는 상업 송장에 상품별 신고 가격이 필요하며, 관세/세금은 각 상품별로 개별 계산되기 때문입니다.

priceRatio는 Bundle의 총 가격이 구성 요소 간에 어떻게 분배되는지를 결정합니다. 직접 설정할 필요는 없습니다 — 비워 두면 Zonos가 모든 구성 요소에 가격을 균등하게 자동 분배합니다.

예를 들어, price ratio를 설정하지 않은 타이어 4개짜리 $1,000 Bundle은 자동으로 각 타이어를 $250(각각 0.25)으로 신고합니다. 프리미엄 타이어 2개와 일반 타이어 2개처럼 구성 요소의 가치가 서로 다른 경우, 실제 가치 차이를 반영하도록 0.35와 0.15 같은 비율을 직접 설정할 수 있습니다.

Zonos는 비율을 자동으로 정규화하므로 계산을 신경 쓸 필요가 없습니다:

  • 일부 비율을 비워 두면 남은 값이 해당 구성 요소들 사이에 균등하게 분배됩니다
  • 비율의 합이 정확히 1.0이 되지 않으면 Zonos가 비례적으로 조정합니다
  • 최종 비율의 합은 항상 정확히 1.0입니다

Cartonization과 라벨 

지정 박스 Bundle의 구성 요소는 표준 bin-packing 알고리즘 대신 판매자가 정의한 박스를 사용합니다. 각 구성 요소의 packingPreference는 ASSIGNED_BOX로 설정되며, 이는 Cartonization에게 packageOptionId와 packageOptionIdIndex로 지정된 박스에 배치하도록 지시합니다.

이는 지정 박스 Bundle의 핵심 장점입니다 — 판매자가 상품이 어떻게 배송되는지 정확히 알고 있으므로, landed cost 계산에 사용되는 박스 치수와 중량이 추정치가 아닌 정확한 값입니다.

Bundle의 각 박스는 고유한 추적 번호가 있는 자체 배송 라벨을 생성합니다. 박스가 2개인 Bundle은 2개의 라벨을 생성합니다.

혼합 주문

동일한 주문 내의 Bundle이 아닌 상품은 Bundle이 사용하는 포장 모드와 관계없이 표준 Cartonization 알고리즘을 사용하여 별도로 포장됩니다.

혼합 Bundle 주문 

하나의 주문에는 여러 Bundle과 독립 상품이 동시에 포함될 수 있습니다. 예를 들어, 다음을 포함하는 주문:

  • 지정 박스를 사용하는 1개의 4팩 Bundle (2개의 박스로 배송)
  • 1개의 3상품 Auto-box Bundle (Cartonization이 포장을 결정)
  • 1개의 단독 상품

Zonos는 각 Bundle을 독립적으로 분해합니다. landed cost 계산은 정확한 치수를 가진 모든 박스와 모든 개별 구성 요소 가격을 포함합니다. 각 박스에는 고유한 라벨이 부여됩니다.

플랫폼 연동 

각 이커머스 플랫폼은 Bundle을 서로 다르게 처리합니다. 아래 섹션에서는 지원되는 각 플랫폼에서 Zonos Bundle이 어떻게 동작하는지 설명합니다.

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

이 페이지가 도움이 되었나요?