DOCS
Landed Cost•
홈물류 제공업체용 Landed Cost 배송 생성

기존 주문에 대한 배송 생성

Landed Cost를 계산하고 주문을 생성한 후 Zonos API로 배송과 라벨을 생성하세요.

GraphQL

이 가이드는 이미 Zonos API와 통합되어 있으며 자사 시스템의 기존 주문에 대한 배송을 생성해야 하는 사용자를 위해 작성되었습니다. 배송 플랫폼으로서 고객에게 Zonos 배송 생성 기능을 제공하려는 경우에는 배송 API 가이드를 참조하세요.

Zonos API와 통합되어 있고 Dashboard 외부에서 배송하도록 승인된 경우, shipmentCreateWorkflow mutation을 사용해 배송을 생성하고 추적 정보를 제공하세요. 이 mutation을 사용하면 크로스 도킹 시설로 향하는 국내 배송에 대해서도 Zonos에 알릴 수 있습니다.

Note: 추적 번호를 Zonos에 자동으로 동기화하는 플랫폼에서 Duty and Tax 앱을 사용하는 경우, 또는 Dashboard를 통해 직접 배송하는 경우에는 이 mutation이 필요하지 않습니다.

API를 통해 배송 생성하기 

Landed Cost를 계산하고 주문을 생성한 후, API를 통해 추적 번호 및 기타 배송 세부 정보를 Zonos로 전송할 수 있습니다.

기존 주문에 대한 배송을 생성하면서 품목이나 당사자 정보를 수정할 필요가 없을 때 이 워크플로를 사용하세요. 선택적인 추적 번호, 풀필먼트 센터, 서비스 레벨 선택, 신고 가치 보험을 지원합니다.

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 }
38 }
39 }
40}

변수 옵션:

  • Fulfillment Center 사용: 출고지를 지정하려면 "fulfillmentCenter": "fulfillment_center_12345"를 추가하세요
  • Custom Tracking 사용: "generateLabel": false로 설정하고 "trackingNumbers": ["tracking_1", "tracking_2"]를 추가하세요
  • Service Level 사용: 특정 캐리어 서비스를 선택하려면 "serviceLevel": "dhl.express_example"을 추가하세요
  • Declared Value Insurance 사용: 신고 가치 보장을 활성화하려면 "isDeclaredValue": true를 추가하세요

신고 가치

"isDeclaredValue": true를 설정하면 배송 중인 모든 품목에 대해 신고 가치 보장이 활성화됩니다. Zonos는 주문에 제출된 모든 품목의 전체 가치를 자동으로 청구하며, 판매자는 이 금액을 수정할 수 없습니다. 이는 운송 중 분실, 손상, 도난이 발생했을 때 캐리어가 책임지는 최대 배상 한도를 설정합니다. 이 기능은 UPS, FedEx, DHL 배송에서만 지원됩니다. 신고 가치를 활성화하면 Zonos가 해당 캐리어에 대한 API 호출에 적절한 파라미터를 포함하는 등 캐리어별 구현을 자동으로 처리하므로, 캐리어마다 다른 요구 사항을 직접 관리할 필요가 없습니다.

UPS 제한 사항: UPS는 100.01~50,000 USD 사이의 가치만 보장하며, 카턴 단위로 신고 가치를 처리합니다. 카턴이 여러 개인 배송의 경우 판매자는 카턴별로 보장 범위를 지정하기 위해 배송을 분할해야 합니다. 또한 UPS는 신고 가치가 999 USD를 초과하면 라벨과 함께 인쇄해야 하는 추가 보험 양식(UPS Control Log)을 생성합니다.

FedEx 및 DHL: 추가 제한 없이 배송 단위로 신고 가치를 처리합니다.

특수 서비스

카턴에 specialServices를 사용하여 배터리, 드라이아이스, 위험물, 서명 요구 사항 등 특수 취급 요건을 표시하세요. 자세한 내용과 예시는 특수 서비스 가이드를 참조하세요.

배송 취소(Void) 

생성된 라벨을 취소하려면 다음 mutation을 사용해 배송을 void 처리하세요. 연결된 라벨도 자동으로 함께 void 처리됩니다. 배송이 void 처리되면 다시 업데이트하거나 복원할 수 없습니다.

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • API를 통해 배송 생성하기
  • 배송 취소(Void)