接口名称
预报订单 (Forecast Orders)
接口地址
/api/shipper/v1/parcel/order/forecast
请求方式
POST
接口描述
该接口用于预报（提交）一个或多个订单到物流系统。预报后订单将被发送到物流服务商进行处理。
请求头
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sessionId | String | 是 | 登录会话ID |
language | String | 是 | 语言 |
Content-Type | String | 是 | application/json;charset=UTF-8 |
Accept | String | 是 | application/json, text/plain, / |
语言取值：
值 | 说明 |
|---|---|
zh_CN | 中文 |
en_US | 英文 |
请求参数
请求体为 JSON 数组，包含需要预报的订单 UUID 列表。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Array | 是 | 订单UUID数组 |
请求体示例：
["uuid1", "uuid2", "uuid3"]
请求示例
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/parcel/order/forecast' \ -H 'Accept: application/json, text/plain, */*' \ -H 'Content-Type: application/json;charset=UTF-8' \ -H 'language: zh_CN' \ -H 'sessionId: vP1l43F_OqvoTUWBcaAtyg' \ --data '["wAy1xp0eL5dtQ1W7c9GpUw"]'
返回示例
{
"success": true,
"code": "0",
"data": true,
"errors": []
}
返回字段说明
字段 | 类型 | 说明 |
|---|---|---|
success | Boolean | 请求是否成功 |
code | String | 响应状态码，"0"表示成功 |
data | Boolean | 预报操作结果，true表示预报成功 |
errors | Array | 错误信息列表 |
错误码
错误码 | 说明 |
|---|---|
0 | 成功 |
0014 | 会话超时，需要重新登录 |
0017 | 认证失败 |