订单交接创建

通过订单交接创建接口，可以将外部系统如ERP系统、WMS系统的批量订单打包为一个交接订单，作为一个整体方便后续提送货操作。

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

配置说明

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

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

目前对该接口的调用限制为每个公司每秒最多3个请求（如需增加可选购增值服务）

接口说明

公共参数

环境	HTTP请求方法	HTTPS请求地址	请求主体MIME类型	响应主体MIME类型
正式环境	PUT	`https://login.otms.cn/ws/handoverCreate`	application/xml	application/xml
沙箱环境	PUT	`https://demo.otms.cn/ws/handoverCreate`	application/xml	application/xml

请求参数

字段名	位置	是否必填	描述	Schema
body	body	是	订单交接创建请求	HandoverCreateRequest
Authorization	header	否	Basic Authorization。如果不为空，则优先使用该值作身份认证。否则使用请求报文中的用户名与密码	string

错误码解释

全局反馈代码

反馈代码	说明
0	身份验证失败。
1	版本不正确。
2	请求内容超出最大限制。
3	错误的请求。

单个请求反馈代码

反馈代码	说明
999	创建批量订单交接码失败。
1000	未找到client code所对应的公司。
1109	未找到对应的订单。
1127	拆分的订单不支持创建交接码。
1128	一单多车的订单不支持创建交接码。
1129	订单的当前节点不支持创建交接码。
1112	匹配到多个订单。
1113	请求中缺少client code。
1134	订单交接功能未启用。
1100	其他错误。

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="utf-8"?>
<handoverCreateRequest login="username" version="0.1" password="password">
<handoverOrders>
  <order sequence="1">
    <orderNumber>DYZZWDNW004661</orderNumber>
  </order>
  <order sequence="2">
    <erpNumber>250321005</erpNumber>
    <clientCode>AXDHBMAV</clientCode>
  </order> 
</handoverOrders>
</handoverCreateRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<handoverCreateResponse version="0.1">
    <responseCode>200</responseCode>
    <handoverCode>WOURGBUZ533WC2UUZEIRBPN5</handoverCode>
    <orders>
        <order sequence="1">
            <orderNumber>DYZZWDNW004661</orderNumber>
            <status>SUCCEED</status>
            <responseCodes/>
        </order>
        <order sequence="2">
            <erpNumber>250321005</erpNumber>
            <orderNumber>DYZZWDNW004662</orderNumber>
            <status>SUCCEED</status>
            <responseCodes/>
        </order>
    </orders>
</handoverCreateResponse>

订单交接创建

订单交接创建#

配置说明#

接口说明#

公共参数#

请求参数#

错误码解释#

全局反馈代码#

单个请求反馈代码#

请求参数

返回响应

订单交接创建

配置说明

接口说明

公共参数

请求参数

错误码解释

全局反馈代码

单个请求反馈代码