DOCS

Request a landed cost

/

landed cost 요청하기

landed cost 요청에서 키/값 쌍 찾기.

Zonos Landed Cost는 항목의 설명만으로도 정확한 landed cost를 제공할 수 있지만, 제공되는 정보가 많을수록 landed cost 견적이 더 정확해집니다. 아래는 필수 및 선택 입력 사항이며, 가능한 한 많은 선택 필드를 채우는 것이 좋습니다.

HS 코드는 강력히 권장됩니다. 기본 landed cost와 달리, 완전한 landed cost는 HS 코드별 세금률의 항목 수준 세부 정보를 포함합니다.

속성 

요청 본문의 JSON 키/값 쌍

POST | https://api.zonos.com/v1/landed_cost

HEADER zonos-version: 2019-11-21

위의 헤더는 이 landed cost 요청이 성공적으로 완료되기 위한 필수 입력 사항입니다.

필드노트
currency 필수기본 통화 문자열로, 3자리 ISO 코드로 표현됩니다.
discounts 선택 사항할인과 관련된 정보로, ID, 금액 및 기타 세부 정보를 포함합니다.
discounts.id 선택 사항상인 또는 수출업체를 위한 고유 할인 식별자입니다.
discounts.amount 선택 사항달러와 센트로 표시된 할인 금액의 소수입니다.
discounts.detail 선택 사항할인에 대한 추가 기능, 속성 또는 설명입니다.
items 필수수출되는 항목의 목록입니다. hash
items.id 필수상인 또는 수출업체를 위한 고유 항목 식별자입니다.
items.amount 필수달러와 센트로 표시된 단일 항목의 총액입니다.
items.amount_discount 선택 사항항목에 적용되는 할인 금액입니다.
items.brand 선택 사항항목의 브랜드, 예: "Leatherman."
items.category 선택 사항항목의 카테고리 설명, 예: "의류."
items.color 선택 사항항목의 색상입니다.
items.country_of_origin 선택 사항제조 또는 생산 국가로, 2자리 ISO 코드로 표현됩니다. 가장 정확한 견적을 위해 권장됩니다. 원산지가 수신되지 않으면, 최혜국(MFN) rate가 사용됩니다.
items.description_customs 선택 사항상업 송장에 대한 상품의 제안된 설명입니다. 이 설명은 일반적으로 소매 설명과 다르며, 일반적으로 그것이 무엇인지, 무엇으로 만들어졌는지, 무엇에 사용되는지를 포함합니다.
items.description_retail 선택 사항항목의 소매 설명입니다.
items.detail 선택 사항항목에 대한 추가 기능, 속성 또는 설명입니다.
items.dimensions 선택 사항배송의 크기입니다. 이는 항목의 크기에 따라 세금이 영향을 받는 국가에 가장 정확한 견적을 얻기 위해 권장됩니다. hash
items.dimensions.height 선택 사항항목의 높이에 대한 소수입니다.
items.dimensions.length 선택 사항항목의 길이에 대한 소수입니다.
items.dimensions.unit 선택 사항항목 치수의 측정 단위입니다. 가능한 값은 inch, centimeter, millimeter, 및 null입니다. null일 경우, inch가 사용됩니다.
items.dimensions.width 선택 사항항목의 너비에 대한 소수입니다.
items.duty_tax_fee_free 선택 사항항목이 landed cost 계산에 포함되지 않아야 함을 지정하는 문자열입니다. 요청에 exclude가 전송되면, 항목은 API 응답의 removed_items에 표시됩니다.
items.hs_code 선택 사항항목 HS 코드, 2~10자리입니다.
items.image_url 선택 사항이미지 URL입니다.
items.quantity 필수항목의 수량을 나타내는 정수입니다.
items.upc_code 선택 사항항목의 UPC 코드 문자열입니다.
items.weight 선택 사항항목의 무게에 대한 소수입니다.
items.weight_unit 선택 사항무게에 대한 측정 단위 문자열입니다. 가능한 값은 pound, ounce, kilogram, 및 null입니다. null일 경우, pound가 사용됩니다.
landed_cost 선택 사항landed cost에 대한 요청 유형입니다. 가능한 값으로는 delivery_duty_paiddelivery_duty_unpaid가 있습니다. landed cost의 수수료는 DDP 또는 DDU로 발송되는지에 따라 다를 수 있습니다. null인 경우 DDP 요청으로 간주됩니다. DDP 요청이 이루어지고 DDP를 사용할 수 없는 경우, 제공된 서비스 수준에 대해 DDP를 사용할 수 없다는 메시지와 함께 400 오류가 반환됩니다. DDP와 DDU는 일반적으로 각 서비스 수준 내에서 모두 사용 가능하므로, 계정 수준이 아닌 서비스 수준별로 구성할 수 있도록 해야 합니다.
sale_type 선택 사항판매 유형의 지표입니다. 가능한 값으로는 not_for_resalefor_resale가 있습니다. null인 경우 not_for_resale 요청으로 간주됩니다.
ship_from_country 필수발송 국가 문자열로, 두 글자 ISO 코드로 표현됩니다.
ship_to 필수목적지 주소입니다. hash
ship_to.city 선택 사항*고객의 주소 도시, 마을, 구역, 교외 또는 마을을 위한 문자열입니다. 수입 국가에 따라 이 필드는 필수일 수 있습니다.
ship_to.country 필수은행 계좌가 위치한 목적지 국가의 문자열로, 두 글자 ISO 코드로 표현됩니다.
ship_to.postal_code 선택 사항*목적지 우편 번호를 위한 문자열입니다. 이 필드는 북아일랜드와 유럽 연합 간의 배송 시 필요할 수 있습니다.
ship_to.state 선택 사항*사용 가능한 경우 목적지 주 코드에 대한 문자열입니다. 수입 국가가 브라질 또는 캐나다인 경우 이 필드는 필수입니다.
shipping 필수운송 세부정보로, 금액, 할인 금액 및 운송업체와의 서비스 수준이 포함됩니다. hash
shipping.amount 필수배송 비용의 총합을 나타내는 소수점입니다. 달러와 센트로 표현됩니다.
shipping.amount_discount 선택 사항배송에 적용되는 할인 금액을 나타내는 소수점입니다.
shipping.service_level 필수운송업체와의 서비스 수준입니다. 사용 가능한 서비스 수준의 전체 목록은 운송업체 문서를 참조하십시오.

*이 필드는 수입 국가의 주소 필드 요구 사항에 따라 선택 사항입니다.

예제 요청

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
{
  "currency": "USD",
  "discounts": [
    {
      "id": "sale124",
      "amount": 43.0,
      "detail": null
    }
  ],
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "amount_discount": 0,
      "brand": null,
      "category": "Women's Clothing",
      "color": null,
      "country_of_origin": "FR",
      "description_customs": null,
      "description_retail": "Hoka One Running Shoe - Women's",
      "detail": null,
      "dimensions": {
        "height": 4,
        "length": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": null,
      "hs_code": "6116.10.00",
      "image_url": "https://zonos.com/images/handbag.png",
      "quantity": 1,
      "upc_code": null,
      "weight": 10,
      "weight_unit": "pound"
    },
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "detail": null,
      "dimensions": {
        "height": 4,
        "lenght": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": "exclude",
      "hs_code": "6217.10",
      "image_url": null,
      "note": null,
      "quantity": 1,
      "upc_code": null,
      "weight": 1,
      "weight_unit": "pound"
    }
  ],
  "landed_cost": "delivery_duty_paid",
  "sale_type": "not_for_resale",
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  },
  "shipping": {
    "amount": 14.23,
    "amount_discount": 0,
    "service_level": "ups_express_saver"
  },
  "tariff_rate": "zonos_preferred"
}

예시 응답

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
{
  "id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
  "amount_subtotal": {
    "duties": 27.74,
    "fees": 15.33,
    "taxes": 16.23
  },
  "currency": {
    "id": "curr_8fb20952-d",
    "base": "USD",
    "date": "2019-11-04T20:42:40.999+0000",
    "rates": [
      {
        "currency": "BRL",
        "rate": 0.2274
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 32.0,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Women's Tennis Shoe",
        "description_retail": "Hoka One Running Shoe - Women's",
        "detail": null,
        "dimensions": {
          "height": 4.0,
          "length": 6.0,
          "unit": "inch",
          "width": 11.0
        },
        "hs_code": "6116.10.00",
        "hs_code_source": "account_default",
        "image_url": "https://zonos.com/images/handbag.png",
        "note": null,
        "quantity": 1,
        "upc_code": null,
        "weight": 10.0,
        "weight_unit": "pound"
      }
    ],
    "ship_to_country": "BR",
    "shipping_amount": 14.23
  },
  "de_minimis": [
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "duty"
    },
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [
    {
      "amount": 19.2,
      "description": "duty",
      "formula": "60%",
      "item_id": "294395",
      "note": "Duty is 60% of the items total.",
      "type": "item"
    },
    {
      "amount": 8.54,
      "description": "Duty",
      "formula": "60%",
      "item_id": null,
      "note": null,
      "type": "shipping"
    }
  ],
  "fees": [
    {
      "amount": 22.0,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "formula": "15 USD",
      "item_id": null,
      "note": null,
      "type": "ddp_service_fee"
    },
    {
      "amount": 0.33,
      "description": "UPS Currency Conversion Fee",
      "formula": ".75% of the amount converted",
      "item_id": null,
      "note": null,
      "type": "currency_conversion_fee"
    }
  ],
  "removed_items": [
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "hs_code": "6217.10",
      "hs_code_source": "account_default",
      "note": null,
      "quantity": 1
    }
  ],
  "remittance": [],
  "taxes": [
    {
      "amount": 7.02,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": "294395",
      "note": null,
      "type": "item"
    },
    {
      "amount": 3.12,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 6.09,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "duty"
    }
  ]
}

이 페이지가 도움이 되었습니까?


질문 있으세요?

문의하세요.

Zonos을 보세요

정책 및 계약
이 페이지에서: