속성
요청 본문의 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_paid 및 delivery_duty_unpaid 가 있습니다. landed cost의 수수료는 DDP 또는 DDU로 발송되는지에 따라 다를 수 있습니다. null 인 경우 DDP 요청으로 간주됩니다. DDP 요청이 이루어지고 DDP를 사용할 수 없는 경우, 제공된 서비스 수준에 대해 DDP를 사용할 수 없다는 메시지와 함께 400 오류가 반환됩니다. DDP와 DDU는 일반적으로 각 서비스 수준 내에서 모두 사용 가능하므로, 계정 수준이 아닌 서비스 수준별로 구성할 수 있도록 해야 합니다. |
sale_type 선택 사항 | 판매 유형의 지표입니다. 가능한 값으로는 not_for_resale 및 for_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"
}
]
}
landed cost 요청하기
landed cost 요청에서 키/값 쌍 찾기.Zonos Landed Cost는 항목의 설명만으로도 정확한 landed cost를 제공할 수 있지만, 제공되는 정보가 많을수록 landed cost 견적이 더 정확해집니다. 아래는 필수 및 선택 입력 사항이며, 가능한 한 많은 선택 필드를 채우는 것이 좋습니다.