属性
| 字段↕ | 备注↕ |
|---|---|
id STRING | 对象的唯一标识符。评级对象的 id 始终以 ship 为前缀。 |
currency HASH | 提供请求中发送的基础货币信息和响应中提供的信息的哈希表。 |
currency.id STRING | 货币对象的唯一标识符。 |
currency.base STRING | 评级请求中发送的基础货币，由三字母 ISO 代码表示。评级对象中的所有金额都以基础货币列出。 |
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 始终以 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 | 与运输商的 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 | 包含运费金额明细信息的哈希表。 |
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 | 包裹对象的唯一标识符。 |
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
}
评级对象
探索评级对象的功能和特性。
评级对象将按服务级别提供运费报价，并详细说明构成报价的附加费、费用和协议折扣。