DOCS
Landed Cost•
홈물류 제공업체용 Landed Cost Landed cost 계산 - GraphQL

Landed cost 계산하기

GraphQL로 관세, 세금, 수수료를 계산하세요.

GraphQL

Zonos는 international shipment에 대한 관세, 세금, 그리고 customs, broker, carrier가 부과하는 추가 수수료를 포함한 전체 landed cost를 계산합니다. 대부분의 경우 Zonos가 final bill을 직접 지불하고 계산된 금액만 청구하여 이 계산을 보증합니다. 경우에 따라 보증 없이 landed cost를 사용할 수도 있으며, 이 경우 계산 금액과 실제 청구 금액의 차이에 대한 책임은 고객이 부담합니다.

Request 준비 

Landed cost API를 계산하려면 여러 input이 필요하며, 이를 workflow로 구성했습니다. 준비가 완료되면 shipping destination, cart의 item, shipping 정보를 기반으로 단 한 번의 request로 landed cost를 반환받을 수 있습니다.

각 workflow에는 고유한 필수 input이 있습니다. GraphQL에서는 필요한 것보다 더 많은 data를 전달할 수 있지만, landed cost를 반환하는 데 실제로 필요한 field는 정해져 있습니다. 가능한 모든 field는 API reference에 명확하게 표시되어 있습니다.

계산이 보증되기를 원한다면 일부 field는 조건에 따라 필수가 된다는 점에 유의하세요.

아래에 보증된 landed cost를 계산하는 데 필요한 모든 field를 정리했습니다. Request를 보내기 전에 이 정보가 모두 포함되어 있는지 확인하세요.

API로 Landed cost 요청하기 

필요한 input data를 모두 준비했다면, 원하는 client library나 도구를 사용해 API endpoint로 GraphQL mutation을 전송하세요. 다음은 mutation을 구성하는 방법의 예시입니다.

Landed cost request의 일부로 Zonos가 shipping cost를 계산하도록 할 때 이 request를 사용하세요. 목적지 국가에서 shipping에 관세와 세금이 부과되는 경우 이를 함께 계산합니다.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

다음 단계: Order 생성

Landed cost를 계산하고 API response에서 landedCostId를 받은 후에는 Zonos 시스템에서 transaction을 완료하기 위해 order를 생성해야 합니다. orderCreate mutation을 사용하고 quote의 landedCostId를 전달하세요. 자세한 내용은 order 생성하기를 참고하세요.

Dashboard에서 Landed cost 요청하기 

API 없이도 Zonos Dashboard에서 직접 landed cost를 계산할 수 있습니다. 계산 테스트, 팀 교육, 고객 문의용 빠른 quote 제공에도 유용합니다.

Dashboard는 위에서 설명한 것과 동일한 API endpoint를 사용하므로 결과는 직접 API call과 일치합니다. API 통합을 검증하거나 input이 계산에 미치는 영향을 탐색하기에 좋습니다.

Dashboard calculator 사용

Dashboard의 landed cost calculator로 계산된 shipping rate가 포함된 quote를 받거나, 알려진 shipping cost로 quote를 만들거나, 여러 quote를 bulk로 처리할 수 있습니다.

shipment의 shipping service level과 cost를 알고 있을 때 이 flow를 사용합니다.

  1. Dashboard → Orders → **Quotes**로 이동합니다
  2. New quote를 클릭합니다
  3. 선택 — ship-from address location을 수정합니다
  4. dropdown에서 Destination country를 선택합니다
  5. shipping amount를 입력합니다
    • service level은 선택 사항이며, 추가하면 applicable carrier fee를 계산할 수 있습니다
  6. shipment의 item 상세를 추가합니다
    • description을 입력하면 product를 자동 분류하고 HS code를 생성합니다
    • 필요하면 생성된 HS code를 덮어쓸 수 있습니다
    • 여러 item이면 Save and add another를 클릭하고, 그렇지 않으면 Save를 클릭합니다
  7. 선택 — More options를 클릭하여 변경합니다:
    • Sale type을 For resale로
    • Delivery mode를 Delivery duties unpaid로
  8. Get quote를 클릭합니다
    • 변경하려면 Edit form을 클릭하고 상세를 수정합니다
    • 업데이트하려면 Get quote를 다시 클릭합니다

오른쪽에 product, shipping, import cost가 포함된 landed cost quote가 표시됩니다. quote를 펼치면 item, shipping, duty, tax, fee의 상세 breakdown을 볼 수 있습니다. 모든 quote는 quotes page에 저장됩니다.

기존 quote 편집: 처음부터 시작하지 않고 기존 quote를 수정하려면 오른쪽 상단의 Quote again을 클릭합니다.

Dashboard 사용의 이점

  • Coding 불필요 — user-friendly interface로 quote를 생성합니다
  • 팀 교육 — 비기술 팀원이 landed cost 구성 요소를 이해하도록 돕습니다
  • API 검증 — API 통합이 예상 결과를 생성하는지 확인합니다
  • 고객 지원 — 고객 문의용 quote를 빠르게 생성합니다
  • Bulk processing — 여러 계산을 효율적으로 처리합니다(출시 예정)

Dashboard quote에는 API와 동일한 상세 breakdown이 포함되어 자동화된 통합을 보완하기에 적합합니다.

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

ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Landed cost 계산하기
  • Request 준비
  • API로 Landed cost 요청하기
  • Dashboard에서 Landed cost 요청하기