DOCS
홈API 참조 Rating REST API Rating object

Rating object

Rating object의 기능과 역할을 알아보세요.

Rating object는 할증료, 수수료 및 협상 요금 할인으로 구성된 견적의 세부 내역과 함께 서비스 레벨별 배송 견적을 제공합니다.

Attributes 

Field↕Notes↕
id STRING객체의 고유 식별자입니다. rating object의 id는 항상 ship으로 시작합니다.
currency HASH요청에서 전송되고 응답에서 제공되는 기준 통화에 대한 정보를 제공하는 hash입니다.
currency.id STRING통화 객체의 고유 식별자입니다.
currency.base STRINGrating 요청에서 전송된 기준 통화로, 3자리 ISO 코드로 표시됩니다. rating object의 모든 금액은 기준 통화로 나열됩니다.
currency.date TIMESTAMP통화 환율이 조회된 날짜입니다. ISO 8601 형식 YYYY-MM-DDTHH:mm:ss.sssZ.
currency.rates HASH기준 통화에서의 환산에 필요한 통화 및 환율을 포함하는 hash입니다.
errors HASH요청의 오류 세부 정보를 포함하는 hash입니다.
errors.type STRING오류의 출처입니다. 가능한 값: fedex_api ups_api dhl_api usps_api internal_error zonos_configuration.
errors.message STRING해당 운송사의 오류에 대한 설명 이유입니다.
errors.details HASH오류를 반환한 서비스 레벨에 대한 세부 정보를 포함하는 hash입니다.
errors.details.id STRING서비스 레벨의 고유 식별자입니다.
errors.details.service_level STRING운송사의 service level입니다. 예: standard.
errors.details.display_name STRING서비스 레벨의 표시 이름입니다.
quotes LIST서비스 레벨별 배송 견적 목록입니다.
quotes.id STRING객체의 고유 식별자입니다. quotes object의 id는 항상 rtqt로 시작합니다.
quotes.amount_subtotal DECIMAL서비스 레벨의 계산된 총 배송 비용입니다.
quotes.weight HASH견적 배송 비용에 사용된 무게에 대한 정보를 제공하는 hash입니다.
quotes.weight.billable DECIMAL배송 견적에 사용된 패키지의 청구 무게입니다.
quotes.weight.unit STRING무게의 측정 단위입니다. 가능한 값: pound, ounce, kilogram, null. null이면 pound가 사용됩니다.
quotes.mode HASH서비스 레벨에 대한 상세 정보를 포함하는 hash입니다.
quotes.mode.service_level STRING운송사의 service_level입니다. 예: standard. 일반적인 예: 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. 운송사 문서에서 운송사별 사용 가능한 서비스 레벨 전체 목록을 확인하세요.
quotes.mode.display_name STRING서비스 레벨의 표시 이름입니다.
quotes.mode.delivery_date_estimate TIMESTAMP서비스 레벨의 예상 배송일입니다. ISO 8601 형식 YYYY-MM-DDTHH:mm:ss.sssZ. 운송사 API에서 사용 가능한 경우 반환됩니다.
quotes.mode.transit_business_days INTEGER서비스 레벨의 예상 운송 일수(영업일만 운송일로 계산)입니다. 운송사 API에서 사용 가능한 경우 반환됩니다.
quotes.mode.transit_days INTEGER서비스 레벨의 예상 운송 일수입니다. 운송사 API에서 사용 가능한 경우 반환됩니다.
quotes.mode.rates HASH배송 요금 금액 내역에 대한 상세 정보를 포함하는 hash입니다.
quotes.mode.rates.amount DECIMAL특정 요금 항목의 금액입니다.
quotes.mode.rates.note STRING요금 항목 금액이 나타내는 내용에 대한 추가 세부 정보입니다.
quotes.mode.rates.type STRING요금 항목의 유형입니다. 가능한 값: retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LIST배송되는 패키지에 대한 세부 정보 목록입니다.
quotes.packages.id STRINGpackages object의 고유 식별자입니다.
quotes.packages.weight HASH패키지 무게 세부 정보를 포함하는 hash입니다.
quotes.packages.weight.billable DEMICAL패키지의 청구 무게입니다.
quotes.packages.weight.dimensional DECIMAL패키지의 부피 무게입니다.
quotes.packages.weight.factor INTEGER패키지의 부피 무게를 계산하는 데 사용되는 국제 무게 계수입니다.
quotes.packages.weight.weight_unit STRING무게의 측정 단위를 나타내는 문자열입니다. 가능한 값: pound ounce kilogram null. null이면 pound가 사용됩니다.
1{
2 "id": "ship_5p67angIDnS91CyfpW55YZ",
3 "currency": {
4 "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
5 "base": "USD",
6 "date": "2020-02-04T18:47:04.629+0000",
7 "rates": []
8 },
9 "errors": [
10 {
11 "details": {
12 "id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
13 "display_name": "FedEx Express Saver",
14 "service_level": "FEDEX_EXPRESS_SAVER",
15 "message": "[868] Service is not allowed. ",
16 "type": "fedex_api"
17 }
18 }
19 ],
20 "quotes": [
21 {
22 "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
23 "amount_subtotal": 943.18,
24 "mode": {
25 "delivery_date_estimate": null,
26 "display_name": "UPS Expedited ",
27 "rates": [
28 {
29 "amount": 848.31,
30 "note": "UPS api: standard rate",
31 "type": "retail_shipping"
32 },
33 {
34 "amount": 64.4,
35 "note": "UPS api: fuel surcharge",
36 "type": "fuel_surcharge"
37 },
38 {
39 "amount": 40,
40 "note": "UPS api: extended area",
41 "type": "carrier_fee"
42 },
43 {
44 "amount": -9.53,
45 "note": "UPS negotiated discount",
46 "type": "negotiated_discount"
47 }
48 ],
49 "service_level": "UPS_WORLDWIDE_EXPEDITED",
50 "transit_business_days": null,
51 "transit_days": null
52 },
53 "packages": [
54 {
55 "id": "1",
56 "weight": {
57 "billable": 32,
58 "dimensional": 30.7554,
59 "factor": 139,
60 "weight_unit": "pound"
61 }
62 }
63 ],
64 "weight": {
65 "billable": 32,
66 "unit": "pound"
67 }
68 },
69 {
70 "id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
71 "amount_subtotal": 1058.86,
72 "mode": {
73 "delivery_date_estimate": null,
74 "display_name": "UPS Saver ",
75 "rates": [
76 {
77 "amount": 957.26,
78 "note": "UPS api: standard rate",
79 "type": "retail_shipping"
80 },
81 {
82 "amount": 72.3,
83 "note": "UPS api: fuel surcharge",
84 "type": "fuel_surcharge"
85 },
86 {
87 "amount": 40,
88 "note": "UPS api: extended area",
89 "type": "carrier_fee"
90 },
91 {
92 "amount": -10.7,
93 "note": "UPS negotiated discount",
94 "type": "negotiated_discount"
95 }
96 ],
97 "service_level": "UPS_SAVER",
98 "transit_business_days": null,
99 "transit_days": null
100 },
101 "packages": [
102 {
103 "id": "1",
104 "weight": {
105 "billable": 32,
106 "dimensional": 30.7554,
107 "factor": 139,
108 "weight_unit": "pound"
109 }
110 }
111 ],
112 "weight": {
113 "billable": 32,
114 "unit": "pound"
115 }
116 }
117 ]
118}

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Rating object
  • Attributes