运输单分配司机

将运输单分配给司机。

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

配置说明

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

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

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

接口说明

公共参数

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

请求参数

字段名	位置	是否必填	描述	Schema
body	body	是	运输单分配司机请求	JobSheetAssignmentRequest
Authorization	header	否	Basic Authorization。如果不为空，则优先使用该值作身份认证。否则使用请求报文中的用户名与密码	string

错误码解释

全局反馈代码

反馈代码	说明
0	客户验证失败。
1	不支持的请求版本。
2	超过最大请求数（100）。
3	请求错误。
4	服务器繁忙。

单个请求反馈代码

反馈代码	说明
100	成功。
101	没有找到运输单。
102	没有找到司机。
103	订单状态错误。
104	订单分配司机失败。
105	运输单分配司机失败。
106	车辆和订单不匹配。
107	推送订单分配事件失败。
108	通知卡车司机失败。
109	运输单状态错误。
110	订单未到已释放状态。

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetAssignmentRequest version="0.1" login="username" password="password">
    <jobSheets>
        <jobSheet sequence="1">
            <jobSheetNumber>JSDYZZWDNW000010</jobSheetNumber>
            <externalShipmentId>2503211</externalShipmentId>
            <truckPlate>粤A00110</truckPlate>
            <driverMobile>13200000000</driverMobile>
        </jobSheet>
    </jobSheets>
</jobSheetAssignmentRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetAssignmentResponse version="0.1">
    <responseCode></responseCode>
    <jobSheets>
        <jobSheet sequence="1">
            <jobSheetNumber>JSDYZZWDNW000010</jobSheetNumber>
            <externalShipmentId>2503211</externalShipmentId>
            <status>SUCCEED</status>
            <code>100</code>
            <msg>Success</msg>
        </jobSheet>
    </jobSheets>
</jobSheetAssignmentResponse>

运输单分配司机

运输单分配司机#

配置说明#

接口说明#

公共参数#

请求参数#

错误码解释#

全局反馈代码#

单个请求反馈代码#

请求参数

返回响应

运输单分配司机

配置说明

接口说明

公共参数

请求参数

错误码解释

全局反馈代码

单个请求反馈代码