속성
요청 본문의 JSON 키/값 쌍
POST | https://api.zonos.com/v1/shipment_rating
HEADER zonos-version: 2020-03-04
위의 헤더는 이 등급 요청이 성공적으로 완료되기 위한 필수 입력입니다.
| 필드 | 노트 |
|---|---|
currency 필수 | 기본 통화 문자열로, 3자리 ISO 코드로 표현됩니다. |
items_amount 필수 | 항목 수량을 나타내는 소수입니다. |
packages 필수 | 배송되는 패키지의 수와 치수 목록입니다. hash |
packages.id 필수 | 상인 또는 수출업체의 고유 패키지 식별자입니다. |
packages.dimensions 필수 | 패키지의 치수입니다. hash |
packages.dimensions.height 필수 | 배송 상자의 높이를 나타내는 소수입니다. |
packages.dimensions.length 필수 | 배송 상자의 길이를 나타내는 소수입니다. |
packages.dimensions.unit 필수 | 배송 상자 치수의 측정 단위입니다. 가능한 값은 inch centimeter millimeter null입니다. null일 경우 inch가 사용됩니다. |
packages.dimensions.width 필수 | 배송 상자의 너비를 포함하는 소수입니다. |
packages.insured_amount 선택 사항 | 보험 금액을 나타내는 소수입니다. |
packages.type 선택 사항 | 배송 계산에 사용될 특정 운송업체 박스 유형을 지정하는 문자열입니다. 가능한 값은 FEDEX_BOX입니다. |
packages.weight 필수 | 패키지의 무게를 포함하는 소수입니다. |
packages.weight_unit 필수 | 무게의 측정 단위를 포함하는 문자열입니다. 가능한 값은 pound ounce kilogram null입니다. null일 경우 pound가 사용됩니다. |
pickup_date 필수 | 패키지의 요청된 픽업 날짜로, ISO 8601 형식 YYYY-MM-DDTHH:mm:ss.sssZ입니다. 시간대 정보가 전달되지 않으면 UTC로 간주됩니다. |
service_level 선택 사항 | 운송업체와의 서비스 수준, 예: standard입니다. hash 일반적인 예로는 ups_express, ups_express_saver, ups_expedited, ups_economy, ups_standard, ups_mail_innovations_economy, ups_mail_innovations_priority, dhl_express, dhl_ecommerce_parcel_direct, fedex_priority, fedex_economy, usps_first_class_mail_international, usps_priority_mail_international, landmark_parcel, apc_parcel, point2point_standard, point2point_direct, point2point_packet, 및 fedex_international_ground가 포함됩니다. 전체 서비스 수준 목록은 운송업체 문서를 참조하십시오. |
ship_from 필수 | 출발지 주소입니다. hash |
ship_from.city | 출발지 주소의 도시, 마을, 구역, 교외 또는 마을을 위한 문자열입니다. |
ship_from.country 필수 | 출발지 국가 문자열로, 2자리 ISO 코드로 표현됩니다. |
ship_from.postal_code 필수 | 출발지 주소의 우편번호를 위한 문자열입니다. |
ship_from.state_code 필수 | 가능할 경우 출발지 주소를 위한 문자열입니다. 캐나다와 브라질에서만 필수입니다. |
ship_to 필수 | 목적지 주소입니다. hash |
ship_to.city 필수 | 고객의 주소 도시, 마을, 구역, 교외 또는 마을을 위한 문자열입니다. |
ship_to.country 필수 | 목적지 국가를 위한 문자열로, 2자리 ISO 코드로 표현됩니다. |
ship_to.postal_code 필수 | 목적지 우편번호에 대한 문자열. 수입 국가에 따라 선택 사항입니다. |
ship_to.state_code 필수 | 사용 가능한 경우 목적지 주 코드에 대한 문자열. 캐나다와 브라질에서만 필수입니다. |
ship_to.type 필수 | 목적지 주소의 유형. 가능한 값에는 residential commercial이 포함됩니다. |
예제 요청
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
{
"currency": "USD",
"items_amount": 168.99,
"packages": [
{
"id": "1",
"dimensions": {
"height": 19.0,
"length": 15.0,
"unit": "inch",
"width": 15.0
},
"insured_amount": 33.22,
"type": null,
"weight": 32.0,
"weight_unit": "pound"
}
],
"pickup_date": "2020-07-06T18:47:04.629+0000",
"service_level": null,
"ship_from": {
"city": "St George",
"country": "US",
"postal_code": "84770",
"state_code": "UT"
},
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state_code": "SP",
"type": "residential"
}
}
예시 응답
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
{
"id": "ship_5p67angIDnS91CyfpW55YZ",
"currency": {
"id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
"base": "USD",
"date": "2020-02-04T18:47:04.629+0000",
"rates": []
},
"errors": [
{
"details": {
"id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
"service_level": "FEDEX_EXPRESS_SAVER",
"display_name": "FedEx Express Saver"
},
"message": "[868] Service is not allowed. ",
"type": "fedex_api"
}
],
"quotes": [
{
"id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
"amount_subtotal": 943.18,
"mode": {
"delivery_date_estimate": null,
"display_name": "UPS Expedited ",
"rates": [
{
"amount": 848.31,
"note": "UPS api: standard rate",
"type": "retail_shipping"
},
{
"amount": 64.4,
"note": "UPS api: fuel surcharge",
"type": "fuel_surcharge"
},
{
"amount": 40.0,
"note": "UPS api: extended area",
"type": "carrier_fee"
},
{
"amount": -9.53,
"note": "UPS negotiated discount",
"type": "negotiated_discount"
}
],
"service_level": "UPS_WORLDWIDE_EXPEDITED",
"transit_business_days": null,
"transit_days": null
},
"packages": [
{
"id": "1",
"weight": {
"billable": 32.0,
"dimensional": 30.7554,
"factor": 139,
"weight_unit": "pound"
}
}
],
"weight": {
"billable": 32.0,
"unit": "pound"
}
},
{
"id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
"amount_subtotal": 1058.86,
"weight": {
"billable": 32.0,
"unit": "pound"
},
"mode": {
"delivery_date_estimate": null,
"display_name": "UPS Saver ",
"rates": [
{
"amount": 957.26,
"note": "UPS api: standard rate",
"type": "retail_shipping"
},
{
"amount": 72.3,
"note": "UPS api: fuel surcharge",
"type": "fuel_surcharge"
},
{
"amount": 40.0,
"note": "UPS api: extended area",
"type": "carrier_fee"
},
{
"amount": -10.7,
"note": "UPS negotiated discount",
"type": "negotiated_discount"
}
],
"service_level": "UPS_SAVER",
"transit_business_days": null,
"transit_days": null
},
"packages": [
{
"id": "1",
"weight": {
"billable": 32.0,
"dimensional": 30.7554,
"factor": 139,
"weight_unit": "pound"
}
}
]
}
]
}
배송 등급 요청
배송 등급 요청의 키/값 쌍을 탐색하십시오.귀하의 상점 설정에 구성된 다양한 배송 제공업체에 대한 국제 배송 요금을 요청하십시오. Zonos.