订单接口结合企业管理系统，提供了动态导入订单、查询货物位置、查询派送报表等功能。提供了货场标注、派车单导入、主动回单、位置查询、订单查询等接口。
一、货场标注接口
1.说明：为派车接口提供货场的位置范围
2.请求参数：企业码，加密后的密钥，标注类型：0:地物,1:标注，标注名称，客户号或者标注编号，标注纬度，标注经度，区域左上角纬度，区域左上角经度，区域右下角纬度，区域右下角经度
3.业务类型：MARK
4.请求响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>MARK</businessType>
</head>
<body>
<reqMsg>
<marker>
<entCode>企业码</entCode>
<entKey>加密后的密钥</entKey>
<markType>标注类型：0:地物,1:标注</markType>
<title>标注名称</title>
<markcode>客户号或者标注编号</markcode>
<lat>标注纬度<l/at>
<lng>标注经度</lng>
<area>
<lat1> 区域左上角纬度<lat1>
<lng1>区域左上角经度<lng1>
<lat2> 区域右下角纬度<lat2>
<lng2>区域右下角经度<lng2>
</area>
</marker>
</reqMsg>
<body>
</gps>
5.请求响应的类型：字符串
6.请求的链接：http:xxxx/cargo/services/message.jws?wsdl
7服务器响应：标注成功(客户号或者标注编号，标注名称)/标注失败
8服务器响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>MARK</businessType>
<respCode>处理代码</respCode>
<respDesc>处理描述</respDesc>
</head>
<body>
<respMsg>
<marker>
<markcode>客户号或者标注编号</markcode>
<title>标注名称</title>
</marker>
</resqMsg>
<body>
</gps>
二、派车单接口
1.说明：向GPS系统交替货单信息
2.请求参数：主货单：订单号，车牌号，发车时间，返厂时间，发车地点，返厂地点，派车时间，预计里程，（标注ID，标注名称）子订单：自订单号，箱号，发货人，发货联系人，发货联系电话，收货人，收货人联系电话，地址，门店地址，（标注ID，标注名称）
3.业务类型：ORDER
4.请求响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>ORDER</businessType>
</head>
<body>
<reqMsg>
<order>
<orderId>订单号</orderId>
<vhcCode>车牌号码</vhcCode>
<sendTime>发车时间</sendTime>
<returnTime> 返场时间 </returnTime>
<sendPos>发车地点</sendPos>
<returnPos>返场地点</returnPos>
<orderTime> 派车时间</orderTime>
<predictDis>预计里程</predictDis>
<markerId>标注ID</markerId>
<markerTitle>标注名称</markerTitle >
<sonList>
<sonOrder>
<orderId> 子订单号</orderId>
<boxId> 箱号</boxId>
<sendPer>发货人</sendPer>
<slinkman>发货联系人</slinkman>
<stel> 发货联系电话</stel>
<recvPer>收货人</recvPer>
<rlinkman> 收货人联系人</rlinkman>
<rtel> 收货人联系电话</rtel>
<addr> 地址</addr>
<doorIdAddr>门点地址</doorIdAddr>
<markerId>标注ID</markerId>
<markerTitle>标注名称</markerTitle >
</sonOrder>
.
.
.
.
<sonList>
</order>
</reqMsg>
<body>
</gps>
5.请求响应的类型：字符串
6.请求的链接：http:xxxx/cargo/services/message.jws?wsdl
7服务器响应：货单成功 / 货单失败
8服务器响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>ORDER</businessType>
<respCode>处理代码</respCode>
<respDesc>处理描述</respDesc>
</head>
<body>
<respMsg>
货单成功
</resqMsg>
<body>
</gps>
三、回单接口
1.说明：向GPS提交货单完成信息
2.请求参数：订单号，订单状态：0:未回单，1:回单，2:终止
3.业务类型：ORDERED
4.请求响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>ORDERED</businessType>
</head>
<body>
<reqMsg>
<order>
<orderId> 订单号</orderId>
<orderState> 订单状态 0： 未回单，1： 回单，2:终止 </orderState >
</order>
</reqMsg>
<body>
</gps>
5.请求响应的类型：字符串
6.请求的链接：http:xxxx/cargo/services/message.jws?wsdl
7服务器响应：货单成功（订单号，实际里程，发车时间，返厂时间，实际行驶时间）
8服务器响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>MARK</businessType>
<respCode>处理代码</respCode>
<respDesc>处理描述</respDesc>
</head>
<body>
<respMsg>
<marker>
<markcode>客户号或者标注编号</markcode>
<title>标注名称</title>
</marker>
</resqMsg>
<body>
</gps>
四、位置接口
1.说明：从GPS系统获取车辆的位置信息
2.请求参数：（车牌号码，订单号，子订单号，托运人）
3.业务类型：LOCATION
4.请求响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>LOCATION</businessType>
</head>
<body>
<reqMsg>
<vhc>
<vhcCode>车牌号码</vhcCode>
<orderId>订单号</orderId >
<sonOrderId>子订单号</sonOrderId >
<sendPer>托运人</ sendPer >
</vhc>
</reqMsg>
<body>
</gps>
5.请求响应的类型：字符串
6.请求的链接：http:xxxx/cargo/services/message.jws?wsdl
7服务器响应：订单号，纬度，经度，位置
8服务器响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>LOCATION</businessType>
<respCode>处理代码</respCode>
<respDesc>处理描述</respDesc>
</head>
<body>
<respMsg>
<order>
<orderId>订单号<orderId>
<lat>纬度</lat>
<lng>经度</lng>
<pos>位置</pos>
</order>
</resqMsg>
<body>
</gps>
五、订单查询
1.说明：查询GPS订单的信息
2.请求参数：（车牌号码，订单号）
3.业务类型：ORDERQUERY
4.请求响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>ORDERQUERY</businessType>
</head>
<body>
<reqMsg>
<order>
<vhcCode>车牌号码</vhcCode>
<orderId>订单号</orderId >
</order>
</reqMsg>
<body>
</gps>
5.请求响应的类型：字符串
6.请求的链接：http:xxxx/cargo/services/message.jws?wsdl
7服务器响应：订单号，发车时间，返厂时间，实际行驶公里数，实际行驶时间
8服务器响应格式：
<?xml version="1.0" encoding="UTF-8"?>
<gps>
<head>
<businessType>ORDERQUERY</businessType>
<respCode>处理代码</respCode>
<respDesc>处理描述</respDesc>
</head>
<body>
<respMsg>
<reportsType>订单查询</reportsType>
<reprotsData>
<reports>
<orderQuery>
<orderId>订单号</orderId>
<returnTime>返厂时间</returnTime>
<runDis>实际行驶里程</runDis>
<trafficTime>实际行驶时间</trafficTime>
</orderQuery>
</reports>
</reprotsData>
</resqMsg>
<body>
</gps>
| 代码 | 描述 |
|---|---|
| 0000 | 处理成功 |
| 1001 | 请求报文XML不合法 |
| 1002 | 请求报文XML校验错误（如：DTD或Schema校验不通过） |
| 2001 | 接入代码错误 |
| 2002 | 标识符错误 |
| 2003 | 业务类型不支持 |
| 3001 | 请求内容存在错误 |
| 9999 | 当前查询返回没有结果 |
| 5555 | 数据类型转换失败 |
| 4444 | 您尚未登录，请重新登录 |
| 6666 | 请求数据已经存在 |
| 6006 | 请求服务器次数频繁 |
| 6007 | 查询没有次车辆 |