EXLIVE平台,大家的平台
GPS车辆监控管理
二次开发案例
当前位置:首页 >> 二次开发 >> 订单接口说明文档
订单接口说明文档


订单接口结合企业管理系统,提供了动态导入订单、查询货物位置、查询派送报表等功能。提供了货场标注、派车单导入、主动回单、位置查询、订单查询等接口。

一、货场标注接口

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>

附录5:GPS设备异常代码

代码 描述
0000      处理成功
1001      请求报文XML不合法
1002      请求报文XML校验错误(如:DTD或Schema校验不通过)
2001      接入代码错误
2002      标识符错误
2003      业务类型不支持
3001      请求内容存在错误
9999      当前查询返回没有结果
5555      数据类型转换失败
4444      您尚未登录,请重新登录
6666      请求数据已经存在
6006      请求服务器次数频繁
6007      查询没有次车辆

 

版权信息
手机产品   |    论坛   |    收藏   |    GPS+   |    帮助   |    建议   |    登录   |    管理(107)
京ICP备09069461号    京公网安备110105002252