Landed Cost•

플랫폼에서 shipment 생성

고객이 플랫폼에서 Zonos shipment과 label을 생성할 수 있게 합니다.

이 가이드는 고객을 위해 플랫폼에 Zonos shipment 생성 기능을 통합하려는 shipping platform 개발자를 위한 것입니다. 이미 Zonos API를 사용 중이며 기존 order에 대한 shipment만 생성하면 되는 경우 shipment creation guide를 참고하세요.

Zonos 고객의 국제 shipping을 지원하는 shipping platform이라면 shipment 생성을 위해 Zonos와 통합하는 것을 최우선으로 고려해야 합니다. 플랫폼의 기존 기능을 활용하면서 Zonos가 shipment, label 및 관련 customs 문서 생성을 관리하게 하여 merchant와 그들의 고객에게 가장 원활한 경험을 제공할 수 있습니다.

Zonos로 shipment을 생성할 때의 장점은 다음과 같습니다:

관·세금 third-party billing — shipping 요금에는 귀하 또는 merchant의 carrier account number가 사용되고, 관·세금 청구서는 Zonos로 발행되도록 합니다.
유연성 — 플랫폼에서 compliant label을 생성하기 위한 개발 작업 대신 API와 통합하고, 끊임없이 변하는 cross-border compliance는 Zonos에 맡깁니다.
정확한 customs 문서 — Zonos로 label을 생성하면 carrier에 올바른 상세 정보가 전달되어 package가 customs를 신속하게 통과하도록 합니다.

이 가이드는 플랫폼에서 Zonos를 호출하여 shipment을 생성할 수 있는 end-to-end 통합을 구현하는 단계를 안내합니다.

Label printing 활성화

아래 단계에 따라 고객이 플랫폼에서 Zonos label을 조회할 수 있게 합니다.

API credential 허용

Shipment 생성

label을 조회하려면 label과 연결될 shipment을 생성해야 합니다. Zonos는 동일 request에서 shipments와 labels를 생성하는 workflow로 이 과정을 관리합니다. 이 mutation을 수행할 때 serviceLevel을 전달할 필요는 없으며, order에 연결된 landedCost에서 사용된 serviceLevel을 사용합니다. orderId에는 Zonos order ID 또는 시스템에 이미 있을 accountOrderNumber를 사용할 수 있습니다.

shipment과 label이 성공적으로 생성되면 label을 BASE64_ENCODED_IMAGE인 labelImage 또는 label을 가져올 수 있는 url로 반환합니다.

기존 order에 대한 shipment을 생성하고 item 또는 party 상세를 수정할 필요가 없을 때 이 workflow를 사용합니다. 선택적 tracking number, fulfillment center, service level 선택, declared value insurance를 지원합니다.

Shopify merchant

Shopify는 origin party의 person에 null 값을 전달합니다. 따라서 Shopify merchant에게는 orderId만으로는 동작하지 않습니다. 대신 고급 shipment 생성 탭을 사용하고 person을 포함한 전체 party 상세를 제공하세요.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items {

25 item {

26 id

27 amount

28 description

29 }

30 }

31 }

32 label {

33 url

34 trackingNumber

35 id

36 documentFiling

37 }

Variable 옵션:

Fulfillment Center 포함: origin location을 지정하려면 "fulfillmentCenter": "fulfillment_center_12345"를 추가합니다
Custom Tracking 포함: "generateLabel": false로 설정하고 "trackingNumbers": ["tracking_1", "tracking_2"]를 추가합니다
Service Level 포함: 특정 carrier service를 선택하려면 "serviceLevel": "dhl.express_example"를 추가합니다
Declared Value Insurance 포함: declared value coverage를 활성화하려면 "isDeclaredValue": true를 추가합니다
Special Services 포함: battery, dry ice, dangerous goods, signature 옵션은 special services guide를 참고하세요.

Declared value

shipment의 모든 item에 declared value coverage를 활성화하려면 "isDeclaredValue": true로 설정합니다. Zonos는 order에 제출된 모든 item의 전체 가치를 자동으로 claim하며, merchant는 이 금액을 수정할 수 없습니다. 이는 transit 중 분실, 손상, 도난 시 carrier가 수용하는 최대 liability를 설정합니다. 이 기능은 UPS, FedEx, DHL shipment에서만 지원됩니다. declared value를 활성화하면 Zonos가 carrier별 구현을 자동으로 처리하며, 해당 carrier API call에 적절한 parameter를 포함하므로 carrier별 요구사항을 직접 관리할 필요가 없습니다.

UPS 제한사항: UPS는 100–50,000 USD 범위의 가치만 보장하며 declared value를 carton level에서 처리합니다. multi-carton shipment의 경우 merchant는 shipment을 분할하여 carton별 coverage를 지정해야 합니다. UPS는 label과 함께 인쇄해야 하는 추가 insurance form도 생성합니다.

FedEx 및 DHL: 추가 제한 없이 shipment level에서 declared value를 처리합니다.

Special services

carton의 specialServices로 battery, dry ice, dangerous goods 또는 signature 요구사항 등 특수 handling을 표시합니다. 전체 상세 및 예제는 special services guide를 참고하세요.

ShipStation UPS Unlock: Multipiece shipment은 지원되지 않습니다. order가 여러 box로 shipping되면 reference field가 중복되어 backend에서 order number matching이 실패합니다. multipiece shipment이 필요한 merchant는 Zonos Dashboard에서 label을 생성해야 합니다. single-box shipment에는 영향이 없습니다.

Shipment void

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

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

데모 예약하기

플랫폼에서 shipment 생성

Label printing 활성화

API credential 허용

Shipment 생성

Shipment void

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