卡车和司机导入

通过该接口，可以将不同外部系统如ERP系统、WMS系统的司机和卡车数据进行批量的导入。

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

配置说明

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

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

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

接口说明

公共参数

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

请求参数

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

错误码解释

全局反馈代码

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

单个请求反馈代码

反馈代码	说明
2001	请求数据未通过验证。
2002	需导入的数据已存在于系统中。
2010	卡车类型不能为2（两者均可）。
2015	车长未填。
2016	无法匹配到系统中预定义的卡车车长或卡车核载量。
2020	导入的司机名被改为了司机在手机端app上注册的姓名（该返回码不会使导入失败）。
2025	邀请司机失败。
2026	司机身份证号格式异常。
2027	未找到对应司机。
2028	未找到对应车辆。
2100	未列出的其他错误。

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<truckAndDriverImportRequest version="0.1" login="username" password="password">
    <trucks>
        <truck sequence="1">
            <licensedFor>1</licensedFor>
            <truckType>1</truckType>
            <truckLength>9.6</truckLength>
            <truckCbmCapacity>47</truckCbmCapacity>
            <truckMtCapacity>15</truckMtCapacity>
            <trailerPlate>沪D99999</trailerPlate>
            <remarks>remarks</remarks>
        </truck>
        <truck sequence="2">
            <licensedFor>1</licensedFor>
            <truckType>3</truckType>
            <truckMtCapacity>10</truckMtCapacity>
            <truckPlate>沪G99999</truckPlate>
        </truck>
    </trucks>
    <drivers>
        <driver sequence="1">
            <name>Mike1</name>
            <mobile>12345678901</mobile>
            <remarks>remarks</remarks>
            <trustedDriver>true</trustedDriver>
            <idCard>312245199002015123</idCard>
        </driver>
        <driver sequence="2">
            <name>George1</name>
            <mobile>98765430321</mobile>
        </driver>
    </drivers>
    <connects>
        <connect sequence="1">
            <truckPlate>沪D99999</truckPlate>
            <driverMobile>12345678901</driverMobile>
        </connect>
        <connect sequence="2">
            <truckPlate>沪G99999</truckPlate>
            <driverMobile>98765430321</driverMobile>
        </connect>
    </connects>
</truckAndDriverImportRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<truckAndDriverImportResponse version="0.1">
    <responseCode></responseCode>
    <importedTrucks>2</importedTrucks>
    <importedDrivers>2</importedDrivers>
    <bindDriverTrucks>2</bindDriverTrucks>
    <truckDetails>
        <truck sequence="1">
            <importStatus>SUCCEED</importStatus>
            <truckPlate>沪D99999</truckPlate>
        </truck>
        <truck sequence="2">
            <importStatus>SUCCEED</importStatus>
            <truckPlate>沪G99999</truckPlate>
        </truck>
    </truckDetails>
    <driverDetails>
        <driver sequence="1">
            <importStatus>SUCCEED</importStatus>
            <name>Mike1</name>
            <mobile>12345678901</mobile>
        </driver>
        <driver sequence="2">
            <importStatus>SUCCEED</importStatus>
            <name>George1</name>
            <mobile>98765430321</mobile>
        </driver>
    </driverDetails>
    <connects>
        <connect sequence="1">
            <importStatus>SUCCEED</importStatus>
            <mobile>12345678901</mobile>
        </connect>
        <connect sequence="2">
            <importStatus>SUCCEED</importStatus>
            <mobile>98765430321</mobile>
        </connect>
    </connects>
</truckAndDriverImportResponse>

卡车和司机导入

卡车和司机导入#

配置说明#

接口说明#

公共参数#

请求参数#

错误码解释#

全局反馈代码#

单个请求反馈代码#

请求参数

返回响应

卡车和司机导入

配置说明

接口说明

公共参数

请求参数

错误码解释

全局反馈代码

单个请求反馈代码