oTMS logo 开放平台
Documentation Help

分享链接

订单导出接口供客户系统接入并生成分享链接。

版本号 文档 说明
0.1 当前版本文档

配置说明

oTMS同时在生产环境和测试环境中提供Web Service接口,其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。

注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况,会对API账号的调用进行限制,甚至停用。

目前对该接口的调用限制为每个公司每秒最多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失败。
2402Erp 单号和oTMS单号都为空。
2403Erp 单号和oTMS单号都存在值。
2404oTMS单号不存在。
2405Erp 单号不存在。
2406生成分享链接出错。

API工具