接口名称

预报订单 (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

认证失败