Атрибуты
| Поле↕ | Примечания↕ |
|---|---|
id STRING | Уникальный идентификатор объекта. ID объекта rating всегда будет начинаться с ship. |
currency HASH | Хеш, содержащий информацию о базовой валюте, отправленной в запросе, и предоставленной в ответе. |
currency.id STRING | Уникальный идентификатор объекта валюты. |
currency.base STRING | Базовая валюта, отправленная в запросе rating, представленная трёхбуквенным кодом ISO. Все суммы в объекте rating указаны в базовой валюте. |
currency.date TIMESTAMP | Дата, в которую был получен курс валюты, в формате ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. |
currency.rates HASH | Хеш, содержащий валюты и обменные курсы, необходимые для конвертации из базовой валюты. |
errors HASH | Хеш, содержащий детали любых ошибок в запросе. |
errors.type STRING | Источник ошибки. Возможные значения включают fedex_api ups_api dhl_api usps_api internal_error zonos_configuration. |
errors.message STRING | Описательная причина ошибки от соответствующего перевозчика. |
errors.details HASH | Хеш, содержащий детали по уровню обслуживания, который вернул ошибку. |
errors.details.id STRING | Уникальный идентификатор уровня обслуживания. |
errors.details.service_level STRING | Уровень обслуживания у перевозчика, например standard. |
errors.details.display_name STRING | Отображаемое имя уровня обслуживания. |
quotes LIST | Список предложений по доставке в зависимости от уровня обслуживания. |
quotes.id STRING | Уникальный идентификатор объекта. ID объекта quotes всегда будет начинаться с rtqt. |
quotes.amount_subtotal DECIMAL | Общая рассчитанная стоимость доставки для уровня обслуживания. |
quotes.weight HASH | Хеш, содержащий информацию о весе, используемом для рассчитанной стоимости доставки. |
quotes.weight.billable DECIMAL | Оплачиваемый вес посылки, используемый для предложения по доставке. |
quotes.weight.unit STRING | Единица измерения веса. Возможные значения: pound, ounce, kilogram и null. Когда null, будет использоваться pound. |
quotes.mode HASH | Хеш, содержащий подробную информацию об уровне обслуживания. |
quotes.mode.service_level STRING | Уровень обслуживания у перевозчика, например 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 | Хеш, содержащий подробную информацию о разбивке суммы ставки доставки. |
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 STRING | Уникальный идентификатор объекта packages. |
quotes.packages.weight 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": null52
},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": null100
},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
}
Объект Rating
Изучите возможности и функции объекта Rating.
Объект Rating предоставит предложения по доставке в зависимости от уровня обслуживания с разбивкой по надбавкам, сборам и согласованным скидкам по ставкам, которые составляют предложение.