DOCS

UPS Unlock

Dashboard 외부에서 처리되는 UPS shipment에 대해 Zonos로 관세 및 세금 billing을 자동화합니다.

UPS Unlock을 사용하면 Zonos Dashboard 대신 자체 shipping platform에서 Zonos-compliant shipment를 생성할 수 있습니다. UPS shipment 처리 시 특정 reference number를 추가하면 UPS가 Zonos를 통해 shipment data(통관 description, HS code, duty account number, tax ID, commodity value 포함)를 자동으로 검증하고 업데이트합니다. 이 정보를 shipping platform에 전달하기 위해 복잡한 rule 또는 integration을 구성할 필요가 없습니다. 대신 UPS가 Zonos에서 data를 직접 가져와 불일치 또는 누락 정보의 위험을 줄이고 수동 설정 및 유지보수 시간을 최소화합니다.

UPS Unlock 설정 

  1. Zonos support에 문의 - UPS Unlock을 활성화하기 전에 Zonos Support에 연락하여 UPS account가 올바르게 구성되었는지 확인하세요. 이 프로세스는 보통 24-48시간이 소요됩니다.
  2. Dashboard에서 UPS Unlock 활성화 - Zonos Dashboard → Settings → Rates → UPS로 이동하여 UPS Unlock을 Enable로 전환합니다
  3. reference number 구성 - reference number 중 하나 이상이 zx 또는 zx-로 시작해야 합니다. 하나 이상의 reference가 zx로 시작하면(값이 zx만이어도) Zonos가 모든 reference number를 스캔하여 일치하는 Zonos order ID 또는 account order number를 찾습니다.
    • 예시:
      • zxORDER123 또는 zx-ORDER123 (merchant order number가 포함된 결합 형식)
      • zxorder_0jy1vh6gygcks 또는 zx-order_0jy1vh6gygcks (Zonos order ID가 포함된 결합 형식)
      • Reference 1: zx, Reference 2: ORDER123 (두 reference 필드에 분할)

작동 방식 

UPS Unlock을 설정하면 UPS shipment가 Zonos order data를 참조합니다. 프로세스는 다음과 같습니다:

  1. UPS가 Zonos를 자동으로 호출하여 제공된 reference field로 order를 검증합니다
  2. Zonos가 검증하고 업데이트된 통관 세부 정보를 UPS에 반환 - Zonos는 다음을 확인하여 shipment가 원래 quote와 일치하는지 검증합니다:
    1. shipment의 item이 quote의 item과 일치
    2. quantity가 quote된 수량 이하
    3. part number가 quote의 product ID 또는 SKU와 일치
    4. destination 세부 정보(국가/주)가 quote와 일치
  3. UPS가 compliance 정보로 shipment를 처리합니다
  4. UPS가 Zonos를 호출하여 tracking number로 shipment record를 생성합니다
  5. Zonos가 order에 shipment를 기록합니다

Reference 매칭 

UPS가 zx-ORDER123과 같은 reference로 Zonos를 호출하면 Zonos는 prefix를 제거하고 order를 검색합니다. prefix 이후 값(이 예시에서는 ORDER123)은 Zonos order의 세 필드와 매칭됩니다:

Field↕Description↕Example↕
Order IDZonos order UUIDorder_0jy1vh6gygcks
Account order numbermerchant order numberORD-12345, #1001
Zonos order IDZonos short identifierzo-1232423

Zonos는 가장 최근의 일치하는 order를 반환합니다. 일치하는 order가 없으면 error가 반환됩니다.

요구 사항

UPS Unlock이 성공하려면 order가 다음 요구 사항을 충족해야 합니다:

  • Landed Cost Guarantee (LCG) - order는 guaranteed landed cost가 있는 Zonos checkout flow를 통해 생성되어야 합니다. Zonos 외부에서 생성된 order는 UPS Unlock과 함께 사용할 수 없습니다.
  • 일치하는 origin/destination - ship-from 및 ship-to 국가가 원래 quote와 일치해야 합니다. Canada 또는 Brazil로의 shipment의 경우 주(province)도 일치해야 합니다.
  • 일치하는 product - part number가 quote의 product ID 또는 SKU와 일치해야 하며 quantity는 quote된 수량을 초과할 수 없습니다.

Error code 

검증이 실패하면 UPS는 Zonos로부터 error response를 받습니다. 일반적인 error code는 다음과 같습니다:

Code↕Message↕Cause↕
10001Shipper number not foundUPS shipper number가 Zonos에 등록되지 않음
10002No Zonos order found for any of the provided reference IDsprefix 제거 후 reference와 일치하는 order 없음
10003Invalid reference IDs. No prefix of zx- foundreference 중 zx 또는 zx- prefix가 없음
10006The requested order is not guaranteedorder는 존재하지만 Landed Cost Guarantee 없음
10010ShipFrom.CountryCode mismatchship-from 국가가 quote origin과 일치하지 않음
10011ShipTo.CountryCode mismatchship-to 국가가 quote destination과 일치하지 않음
10012ShipTo.StateProvinceCode mismatchCA/BR shipment의 경우 주가 일치하지 않음
10013No matching Product on quote with PartNumberorder에서 product SKU/productId를 찾을 수 없음
10015Quantity exceeds the quoted quantity요청 quantity가 quote된 수량보다 큼

ShipStation 통합 

ShipStation 사용자는 upstream(API를 통해 order가 ShipStation에 도달하기 전) 또는 ShipStation 내에서 Label Messages 및 Automation Rules 구성을 사용하여 zx prefix를 추가하여 UPS Unlock을 구성할 수 있습니다. ShipStation을 통해 처리되는 UPS shipment에 zx prefix와 order ID가 포함되어 UPS Unlock이 트리거됩니다. 초기 설정 단계를 완료한 후 ShipStation을 UPS Unlock과 함께 작동하도록 구성할 수 있습니다.

upstream에 zx 추가

upstream(order가 ShipStation에 도달하기 전)에 zx prefix를 추가할 수 있으면 Label Messages를 구성하여 zx order number를 표시하기만 하면 됩니다:

Label Messages 구성

  1. Label Messages 설정 액세스: Settings → Printing → Printing Setup으로 이동한 후 Label의 Document Options를 클릭합니다
  2. Label Messages 구성: Label Messages 섹션에서 UPS label의 reference number로 표시될 최대 3개의 custom message를 정의할 수 있습니다. Label Messages는 „Custom Field 1“, „Order #“ 등 preset 값만 허용합니다.
  3. Order Number를 사용하도록 Message 설정: Message #1을 [Order #]로 설정합니다. #1이 이미 있으면 #2 또는 #3을 추가합니다
  4. 구성을 적용하려면 Save Settings를 클릭합니다

완료되면 ShipStation이 구성한 zx prefix가 포함된 order number를 label에 자동으로 표시합니다.

ShipStation에서 zx 추가

upstream에 zx prefix를 추가할 수 없으면 Label Messages와 Automation Rules를 구성하여 두 개의 별도 Label Message로 zx prefix와 order number를 표시해야 합니다:

1단계: Label Messages 구성

prefix와 order number를 모두 표시하도록 Label Messages를 구성합니다:

  1. Label Messages 설정 액세스: Settings → Printing → Printing Setup으로 이동한 후 Label의 Document Options를 클릭합니다
  2. Label Messages 구성: Label Messages 섹션에서 UPS label의 reference number로 표시될 최대 3개의 custom message를 정의할 수 있습니다.
  3. Message 설정:
    • Message #1을 [Custom Field 1]로 설정(automation rule으로 „zx“가 채워짐)
    • Message #2를 [Order #]로 설정(드롭다운에서 선택)
  4. 구성을 적용하려면 Save Settings를 클릭합니다

2단계: Automation Rules 구성

Label Messages 설정 후 Custom Field 1에 zx prefix를 채우는 automation rule을 생성합니다. Settings → Automation → Automation Rules로 이동하여 Create a Rule을 클릭합니다.

Zonos UPS order용 rule:

  1. Name: „Zonos UPS Unlock“
  2. Active Rule이 켜져 있는지 확인
  3. Orders match these specific criteria 선택
  4. criteria 설정: „International Order“ = „True“ AND „Carrier“ + „Includes“ + „UPS“

Note: trigger criteria는 ShipStation 구성에 따라 다를 수 있습니다. 이는 권장 시작점이며, UPS Unlock이 적절한 order에만 적용되도록 특정 workflow 및 preference에 따라 조건을 사용자 지정하세요.

  1. action 설정:
    • Action Type: „Set Custom Field 1...“ 선택
    • Custom Field 1: zx (prefix 설정)
  2. Save Rule 클릭

완료되면 ShipStation이 international UPS order에 대해 Custom Field 1에 zx를, Message #2에 order number를 자동으로 채웁니다. UPS label에 두 개의 별도 reference line으로 표시됩니다.

Important: ShipStation의 Label Message 구성은 모든 carrier에 영향을 미치는 전역 변경입니다. automation rules 접근 방식을 사용하면 다른 shipment에 대해 선호하는 Label Messages를 유지하면서 Zonos order에 대해 UPS Unlock이 원활하게 작동합니다.

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