oTMS-openapi
  1. oTMS API
oTMS-openapi
  • oTMS API
    • 订单导入
      PUT
    • 订单导出/追踪
      POST
    • 提送货点导入
      PUT
    • 提送货点删除
      DELETE
    • 卡车和司机导入
      PUT
    • 订单分配司机
      POST
    • 运输单导入
      PUT
    • 运输单删除
      PUT
    • 订单外部追踪
      POST
    • 订单召回
      POST
    • 订单分享链接
      PUT
    • 承运商导出
      POST
    • h5链接
      PUT
    • 订单更新
      PUT
    • 订单费用更新
      POST
    • 订单分配
      POST
    • 车辆信息
      POST
    • 订单撤销
      PUT
    • 运输单分配司机
      PUT
    • 订单评分
      POST
    • 订单交接创建
      PUT
    • 订单自定义文本字段更新
      POST
    • 订单快速交接
      POST
    • 价格文件匹配
      POST
    • 收货方/发货方导出
      POST
    • 运输单导出/追踪
      POST
    • 运输单召回
      PUT
    • 文件上传
      POST
    • 订单事件推送
      PUT
    • 运输单事件推送
      PUT
    • 拒收导出
      POST
    • 收货码查询
      POST
    • 便携式设备导入
      POST
  1. oTMS API

订单分配司机

POST
https://login.otms.cn/ws/assignDriver

订单分配司机#

通过该接口，外部系统能够在oTMS系统中将订单直接分配给司机和卡车。
版本号文档说明
0.1当前版本文档

配置说明#

oTMS同时在生产环境和测试环境中提供Web Service接口，其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。
注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况，会对API账号的调用进行限制，甚至停用。
目前对该接口的调用限制为每个公司每秒最多3个请求（如需增加可选购增值服务）

接口说明#

公共参数#

环境HTTP请求方法HTTPS请求地址请求主体MIME类型响应主体MIME类型
正式环境POSThttps://login.otms.cn/ws/assignDriverapplication/xmlapplication/xml
沙箱环境POSThttps://demo.otms.cn/ws/assignDriverapplication/xmlapplication/xml

请求参数#

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

错误码解释#

全局反馈代码#

反馈代码说明
0客户验证失败。
1不支持的请求版本。

单个请求反馈代码#

反馈代码说明
1101请求数据未通过检查。
1102客户代码不存在（仅适用于供应商账户）。
1103客户代码与订单不匹配（仅适用于供应商账户）。
1105调用者没有该地区的权限（适用于地区用户）。
1106未找到地区。
1110未提供订单信息。
1111未找到订单。
1112匹配到多条订单。
1113提供的oTMS订单号与ERP单号不匹配。
1115地区与订单地区不匹配。
1116订单不在待分配状态（收件箱，已释放，或者确认分配）。
1120未匹配到拆分后的子订单。可以是无法通过地区名匹配到，或订单已经被分配了。
1130未提供卡车与司机信息。
1131未找到司机。
1132找到多个司机。
1133未找到卡车。
1139卡车或司机未与其他司机/卡车连接，或匹配到的卡车和司机未连接。
1140卡车不适用于订单。
1141匹配到的司机已在途，且绑定的卡车不匹配。
1148订单已在运单中，不能单独分配司机给该订单，只能分配给整个运单。
1200其他错误。

请求参数

Body 参数application/xml

示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assignDriverRequest version="0.1" login="username" password="password">
    <driverAssignments>
        <driverAssignment sequence="1">
            <orderNumber>DYZZWDNW004702</orderNumber>
            <driverTruckInfos>
                <driverTruckInfo>
                    <truckPlate>沪A08081</truckPlate>
                    <driverName></driverName>
                    <driverMobile>18811112222</driverMobile>
                </driverTruckInfo>
            </driverTruckInfos>
        </driverAssignment>
    </driverAssignments>
</assignDriverRequest>

返回响应

🟢200成功
application/xml
successful operation
Body

示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assignDriverResponse version="0.1">
    <responseCode></responseCode>
    <successfulAssignments>1</successfulAssignments>
    <assignResults>
        <assignResult sequence="1">
            <assignStatus>DISPATCHED</assignStatus>
            <assignedOrders>1</assignedOrders>
            <orderNumbers>
                <orderNumber>DYZZWDNW004702</orderNumber>
            </orderNumbers>
            <responseInfos>
                <responseInfo>
                    <truckPlate>沪A08081</truckPlate>
                    <driverName>huhu</driverName>
                    <driverMobile>18811112222</driverMobile>
                </responseInfo>
            </responseInfos>
        </assignResult>
    </assignResults>
</assignDriverResponse>
上一页
卡车和司机导入
下一页
运输单导入
Built with