分享链接
订单导出接口供客户系统接入并生成分享链接。
| 版本号 | 文档 | 说明 |
|---|---|---|
| 0.1 | 当前版本文档 |
oTMS同时在生产环境和测试环境中提供Web Service接口，其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。
注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况，会对API账号的调用进行限制，甚至停用。
目前对该接口的调用限制为每个公司每秒最多10个请求
注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况，会对API账号的调用进行限制，甚至停用。
目前对该接口的调用限制为每个公司每秒最多10个请求
目前对该接口的调用限制为每个公司每秒最多10个请求
公共参数
| 环境 | HTTP请求方法 | HTTPS请求地址 | 请求主体MIME类型 | 响应主体MIME类型 |
|---|---|---|---|---|
| 正式环境 | PUT | https://login.otms.cn/ws/order/share | application/xml | application/xml |
| 沙箱环境 | PUT | https://demo.otms.cn/ws/order/share | application/xml | application/xml |
请求参数
| 字段名 | 位置 | 是否必填 | 描述 | Schema |
|---|---|---|---|---|
| Authorization | header | Basic Authorization。如果不为空，则优先使用该值作身份认证。否则使用请求报文中的用户名与密码 | string | |
| body | body | 是 | 订单查询请求中包含用以筛选订单的查询条件。 | OrderShareWebService |
响应参数
| 状态码 | 描述 | 响应模型 |
|---|---|---|
| 200 | successful operation | OrderShareResponse |
OrderShareResponse
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| version | string | 否 | 相应版本号 | |
| responseCode | string | 否 | 响应码 | |
| successNum | integer (int32) | 否 | 生成分享链接成功数量 | |
| failNum | integer (int32) | 否 | 生成分享链接失败数量 | |
| responseEntries | array[OrderShareResponseEntry] | 否 | 分享链接列表 |
OrderShareResponseEntry
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| sequence | integer (int32) | 否 | 序列数，用来匹配与请求中对应的记录 | |
| status | string | 否 | 响应状态: SUCCEED - 成功 FAILED - 失败 |
|
| code | string | 否 | 响应码 | |
| erpNumber | string | 否 | Erp单号 | |
| orderNumber | string | 否 | oTMS单号 | |
| url | string | 否 | 分享链接 |
OrderShareWebService
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|
请求示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderShareRequest version="0.1" login="username" password="password">
<orders>
<order sequence="1">
<erpNumber/>
<orderNumber>MZN112003807</orderNumber>
</order>
<order sequence="2">
<erpNumber>PG00003644</erpNumber>
<orderNumber/>
</order>
<order sequence="3">
<erpNumber>PG00003585</erpNumber>
<orderNumber>MZN112003676</orderNumber>
</order>
<order sequence="4">
<erpNumber/>
<orderNumber/>
</order>
<order sequence="5">
<erpNumber/>
<orderNumber>error order number</orderNumber>
</order>
<order sequence="6">
<erpNumber>error erp number</erpNumber>
<orderNumber/>
</order>
</orders>
</orderShareRequest>
响应示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderShareResponse version="0.1">
<responseCode>2401</responseCode>
<successNum>2</successNum>
<failNum>4</failNum>
<orders>
<order sequence="1">
<status>SUCCEED</status>
<code>2400</code>
<orderNumber>MZN112003807</orderNumber>
<url>http://localhost:8080/mp/?tab=ALL#/order-preview/706274/8a3e3a46ad889e652deebb5d0cdb818d</url>
</order>
<order sequence="2">
<status>SUCCEED</status>
<code>2400</code>
<erpNumber>PG00003644</erpNumber>
<url>http://localhost:8080/mp/?tab=ALL#/order-preview/706202/3cfe27e615acf40be584923cc28f980e</url>
</order>
<order sequence="3">
<status>FAILED</status>
<code>2403</code>
</order>
<order sequence="4">
<status>FAILED</status>
<code>2402</code>
</order>
<order sequence="5">
<status>FAILED</status>
<code>2404</code>
</order>
<order sequence="6">
<status>FAILED</status>
<code>2405</code>
</order>
</orders>
</orderShareResponse>
全局反馈代码
| 反馈代码 | 说明 |
| 0 | 身份验证失败。 |
单个请求反馈代码
| 反馈代码 | 说明 |
| 2400 | 成功。 |
| 2401 | 失败。 |
| 2402 | Erp 单号和oTMS单号都为空。 |
| 2403 | Erp 单号和oTMS单号都存在值。 |
| 2404 | oTMS单号不存在。 |
| 2405 | Erp 单号不存在。 |
| 2406 | 生成分享链接出错。 |