运输单导出/追踪

通过运输单导出/追踪接口，客户系统可以接入 oTMS 系统，查询 oTMS 中的运输单信息和状态。

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

配置说明

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

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

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

接口说明

公共参数

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

请求参数

字段名	位置	是否必填	描述	Schema
body	body	是	运输单查询请求。包含用以筛选运输单的查询条件	JobSheetOutboundRequest
Authorization	header	否	Basic Authorization。如果不为空，则优先使用该值作身份认证。否则使用请求报文中的用户名与密码	string

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetOutboundRequest version="0.1" login="login" password="password">
    <queries>
        <query>
            <attribute>jobSheetNumber</attribute>
            <eq>JSYBLHQYHD001203</eq>
        </query>
    </queries>
    <includeOrderInfo>true</includeOrderInfo>
    <orderBy>
        <desc>jobSheetNumber</desc>
    </orderBy>
    <start>1</start>
    <count>10</count>
</jobSheetOutboundRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetOutboundResponse>
    <jobSheets>
        <jobSheet>
            <jobSheetNumber>JSYBLHQYHD001203</jobSheetNumber>
            <quantity>968</quantity>
            <totalVolume>11.128000000</totalVolume>
            <totalWeight>5970.000</totalWeight>
            <transportType>LTL</transportType>
            <cargoType>1</cargoType>
            <packageType>A</packageType>
            <truckType>2</truckType>
            <pickupSla>2025-06-06T23:59:59.000</pickupSla>
            <deliverySla>2025-06-07T23:59:59.000</deliverySla>
            <state>DELIVERY</state>
            <currentStatus>DELIVERED</currentStatus>
            <vendorName>onion.1</vendorName>
            <shipFrom>
                <name>浦东川沙</name>
                <province>上海市</province>
                <town>上海市</town>
                <county>川沙区</county>
            </shipFrom>
            <shipTo>
                <name>静安</name>
                <province>上海市</province>
                <town>上海市</town>
                <county>静安区</county>
            </shipTo>
            <assignedDriver>
                <driverName>梁凉</driverName>
                <mobile>13918580094</mobile>
                <truckPlate>浙A00000</truckPlate>
                <truckLength>5.2</truckLength>
                <mtCapacity>5.0</mtCapacity>
                <cbmCapacity>26.0</cbmCapacity>
            </assignedDriver>
            <customFields>
                <customText1>01</customText1>
                <customText4>82583P1</customText4>
                <customText6>苏州市相城区元和科技园中创路333号 李晓明 0512-65795888-8448</customText6>
                <customText7>0</customText7>
            </customFields>
            <orders>
                <sequence>1</sequence>
                <orderNumber>YBLHQYHD017560</orderNumber>
                <erpNumber>250513001</erpNumber>
            </orders>
            <orders>
                <sequence>2</sequence>
                <orderNumber>YBLHQYHD017561</orderNumber>
                <erpNumber>250513002</erpNumber>
            </orders>
        </jobSheet>
    </jobSheets>
    <start>1</start>
    <count>1</count>
    <total>1</total>
</jobSheetOutboundResponse>

运输单导出/追踪

运输单导出/追踪#

配置说明#

接口说明#

公共参数#

请求参数#

请求参数

返回响应

运输单导出/追踪

配置说明

接口说明

公共参数

请求参数