zeyi / open-doc

Compare View

switch
from
...
to
 
Commits (2)
Showing 1 changed file   Show diff stats
order/order.md 0 → 100644
  Diff comments   View file @a45e5b2
@@ -0,0 +1,1364 @@ @@ -0,0 +1,1364 @@
  1 +
  2 +
  3 +[则一订单对接API](#则一订单对接api)
  4 +
  5 +[白名单](#白名单)
  6 +
  7 +[数据加签](#数据加签)
  8 +
  9 +[数据加密](#数据加密)
  10 +
  11 +[获取访问凭证](#获取访问凭证)
  12 +
  13 +[概述](#概述-1)
  14 +
  15 +[接口信息](#接口信息-1)
  16 +
  17 +[请求方式：](#请求方式-1)
  18 +
  19 +[请求地址：](#请求地址-1)
  20 +
  21 +[Body参数](#body参数-1)
  22 +
  23 +[返回参数](#返回参数)
  24 +
  25 +[请求示例](#请求示例-1)
  26 +
  27 +[Http方式](#http方式)
  28 +
  29 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-1)
  30 +
  31 +[返回示例](#返回示例-1)
  32 +
  33 +[下单](#下单)
  34 +
  35 +[接口信息](#接口信息-2)
  36 +
  37 +[请求方式：](#请求方式-2)
  38 +
  39 +[请求地址：](#请求地址-2)
  40 +
  41 +[Headers参数](#headers参数-1)
  42 +
  43 +[Body参数](#body参数-2)
  44 +
  45 +[请求示例](#请求示例-2)
  46 +
  47 +[Java-sdk方式 下载SDK](#java-sdk方式----下载sdk)
  48 +
  49 +[返回示例](#返回示例-2)
  50 +
  51 +[确认中标](#确认中标)
  52 +
  53 +[接口信息](#接口信息-3)
  54 +
  55 +[请求方式：](#请求方式-3)
  56 +
  57 +[请求地址：](#请求地址-3)
  58 +
  59 +[Headers参数](#headers参数-2)
  60 +
  61 +[Body参数](#body参数-3)
  62 +
  63 +[请求示例](#请求示例-3)
  64 +
  65 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-2)
  66 +
  67 +[返回示例](#返回示例-3)
  68 +
  69 +[取消订单](#取消订单)
  70 +
  71 +[接口信息](#接口信息-4)
  72 +
  73 +[请求方式：](#请求方式-4)
  74 +
  75 +[请求地址：](#请求地址-4)
  76 +
  77 +[Headers参数](#headers参数-3)
  78 +
  79 +[Body参数](#body参数-4)
  80 +
  81 +[请求示例](#请求示例-4)
  82 +
  83 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-3)
  84 +
  85 +[返回示例](#返回示例-4)
  86 +
  87 +[查询车辆定位](#查询车辆定位)
  88 +
  89 +[接口信息](#接口信息-5)
  90 +
  91 +[概述](#概述-2)
  92 +
  93 +[请求方式：](#请求方式-5)
  94 +
  95 +[请求地址：](#请求地址-5)
  96 +
  97 +[Headers参数](#headers参数-4)
  98 +
  99 +[Body参数](#body参数-5)
  100 +
  101 +[请求示例](#请求示例-5)
  102 +
  103 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-4)
  104 +
  105 +[返回示例](#返回示例-5)
  106 +
  107 +[查询车辆历史轨迹](#查询车辆历史轨迹)
  108 +
  109 +[接口信息](#接口信息-6)
  110 +
  111 +[概述](#概述-3)
  112 +
  113 +[请求方式：](#请求方式-6)
  114 +
  115 +[请求地址：](#请求地址-6)
  116 +
  117 +[Headers参数](#headers参数-5)
  118 +
  119 +[Body参数](#body参数-6)
  120 +
  121 +[请求示例](#请求示例-6)
  122 +
  123 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-5)
  124 +
  125 +[返回示例](#返回示例-6)
  126 +
  127 +[查询订单操作记录](#查询订单操作记录)
  128 +
  129 +[接口信息](#接口信息-7)
  130 +
  131 +[概述](#概述-4)
  132 +
  133 +[请求方式：](#请求方式-7)
  134 +
  135 +[请求地址：](#请求地址-7)
  136 +
  137 +[Headers参数](#headers参数-6)
  138 +
  139 +[Body参数](#body参数-7)
  140 +
  141 +[请求示例](#请求示例-7)
  142 +
  143 +[Java-sdk方式 下载SDK](#java-sdk方式---下载sdk-6)
  144 +
  145 +[返回示例](#返回示例-7)
  146 +
  147 +[以下接口需要对接方提供](#以下接口需要对接方提供)
  148 +
  149 +[报价接口](#报价接口)
  150 +
  151 +[接口信息](#接口信息-8)
  152 +
  153 +[概述](#概述-5)
  154 +
  155 +[请求方式：](#请求方式-8)
  156 +
  157 +[请求路径：](#请求路径-1)
  158 +
  159 +[Body参数](#body参数-8)
  160 +
  161 +[返回示例](#返回示例-8)
  162 +
  163 +[接单接口](#接单接口)
  164 +
  165 +[接口信息](#接口信息-9)
  166 +
  167 +[概述](#概述-6)
  168 +
  169 +[请求方式：](#请求方式-9)
  170 +
  171 +[请求路径：](#请求路径-2)
  172 +
  173 +[Body参数](#body参数-9)
  174 +
  175 +[推送司机车辆信息](#推送司机车辆信息)
  176 +
  177 +[接口信息](#接口信息-10)
  178 +
  179 +[概述](#概述-7)
  180 +
  181 +[请求方式：](#请求方式-10)
  182 +
  183 +[请求路径：](#请求路径-3)
  184 +
  185 +[Body参数](#body参数-10)
  186 +
  187 +[返回示例](#返回示例-9)
  188 +
  189 +[推送发车信息](#推送发车信息)
  190 +
  191 +[接口信息](#接口信息-11)
  192 +
  193 +[概述](#概述-8)
  194 +
  195 +[请求方式：](#请求方式-11)
  196 +
  197 +[请求路径：](#请求路径-4)
  198 +
  199 +[Body参数](#body参数-11)
  200 +
  201 +[返回示例](#返回示例-10)
  202 +
  203 +[推送到车信息](#推送到车信息)
  204 +
  205 +[接口信息](#接口信息-12)
  206 +
  207 +[概述](#概述-9)
  208 +
  209 +[请求方式：](#请求方式-12)
  210 +
  211 +[请求路径：](#请求路径-5)
  212 +
  213 +[Body参数](#body参数-12)
  214 +
  215 +[返回示例](#返回示例-11)
  216 +
  217 +[Java-sdk下载](#java-sdk下载)
  218 +
  219 +[2022-03-09更新日志](#2022-03-09更新日志)
  220 +
  221 +**则一订单对接API**
  222 +
  223 +则一提供了不同规范的API，调用则一订单服务端API前，需了解开发前须知及调用流程。本文提供了调用则一订单服务端API示例，供开发者参考。
  224 +
  225 +**白名单**
  226 +
  227 +则一服务端API接口访问有IP白名单限制，需要接口调用方提供调用API的服务器IP地址。
  228 +
  229 +**数据加签**
  230 +
  231 +采用md5(32位小写)算法生成签名
  232 +
  233 +appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(请求数据)
  234 +
  235 +**数据加密**
  236 +
  237 +数据加密采用AES算法
  238 +
  239 +加密模式： CBC
  240 +
  241 +填充方式：PKCS5Padding
  242 +
  243 +偏移量：iv(则一提供)
  244 +
  245 +加密内容：appKey(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(加密数据)
  246 +
  247 +密钥： appSecret(则一提供)
  248 +
  249 +输出：base64
  250 +
  251 +字符集：utf-8
  252 +
  253 +注：无敏感数据则无需加密
  254 +
  255 +**获取访问凭证**
  256 +
  257 +**概述**
  258 +
  259 +调用则一服务API时，都需要先获取对应权限类型的访问凭证accessToken。访问凭证（accessToken）是由则一权限系统颁发的，用来校验调用者的身份信息，确保调用者具有要执行的操作的权限。
  260 +
  261 +**说明**： 在使用accessToken时，请注意：
  262 +
  263 +- accessToken的有效期默认为30天，有效期内重复获取会返回相同结果，过期后获取会返回新的accessToken。
  264 +- 开发者需要缓存accessToken，用于后续接口的调用。不能频繁调用获取accessToken接口，否则会受到频率拦截。
  265 +- 当调用业务API时，如果返回状态码为401，则说明accessToken不正确或已过期，这时需要重新获取accessToken后再调用对应的API。
  266 +
  267 +**接口信息**
  268 +
  269 +**请求方式：**
  270 +
  271 +post
  272 +
  273 +**请求地址：**
  274 +
  275 +- 生产：<https://gw.shjiuze.cn/auth-service-api/login/password>
  276 +- 测试：<https://test.shjiuze.cn/auth-service-api/login/password>
  277 +
  278 +**Body参数**
  279 +
  280 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  281 +| :- | :- | :- | :- | :- |
  282 +|username|String|是|zhangsan|用户名，则一提供|
  283 +|password|String|是|password123|密码，则一提供|
  284 +**返回参数**
  285 +
  286 +|**名称**|**类型**|**示例值**|**描述**|
  287 +| :- | :- | :- | :- |
  288 +|success|boolean|true|成功标识: true 成功，false 失败|
  289 +|businessException|boolean|false|业务异常标识: true 业务异常，false 正常|
  290 +|errorCode|String|200|错误码: 200 业务异常，500 系统异常， 空表示无错误|
  291 +|message|String|订单号不能为空|错误信息，无错误则返回空|
  292 +|result|ZYTokenDto| |accessToken结果数据|
  293 +|`    `accessToken|String|000626f15b4b41bba6fe56216a5d2f73|accessToken|
  294 +|`    `expiresIn|Integer|2060|有效期限单位秒，accessToken在2060秒后过期|
  295 +|`    `tokenType|String|bearer|token类型|
  296 +**请求示例**
  297 +
  298 +**Http方式**
  299 +
  300 +
  301 +
  302 +POST /auth-service-api/login/password HTTP/1.1
  303 +
  304 +Host:test.shjiuze.cn
  305 +
  306 +Content-Type:application/json
  307 +
  308 +{
  309 +
  310 +` `"username" : "zeyi",
  311 +
  312 +` `"password" : "test1111"
  313 +
  314 +}
  315 +
  316 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  317 +
  318 +
  319 +
  320 +public class Sample {
  321 +
  322 +`    `public static void main(String[] args\_) {
  323 +
  324 +`        `String appKey = "appkey";
  325 +
  326 +`        `String appSecret = "appSecret";
  327 +
  328 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  329 +
  330 +`        `ZYTokenRequestDto zyTokenRequest = new ZYTokenRequestDto();
  331 +
  332 +`        `zyTokenRequest.setUsername("zeyi");
  333 +
  334 +`        `zyTokenRequest.setPassword("test1111");
  335 +
  336 +`        `String body = gson.toJson(zyTokenRequest);
  337 +
  338 +`        `HttpResponseData httpResponseData = zyClient.doPost(Constants.TEST\_HOST + Constants.TOKEN\_PATH, body);
  339 +
  340 +`        `if(httpResponseData == null) {
  341 +
  342 +`            `throw new TokenException("则一Token请求失败,返回为空!");
  343 +
  344 +`       `}
  345 +
  346 +`        `ZYResponse<ZYTokenDto> zyResponse = gson.fromJson(httpResponseData.getBody(), new      TypeToken<ZYResponse<ZYTokenDto>>(){}.getType());
  347 +
  348 +`        `if(!Boolean.TRUE.equals(zyResponse.isSuccess())) {    
  349 +
  350 +`            `throw new TokenException("则一Token请求返回失败!" + zyResponse.getMessage());
  351 +
  352 +`       `}
  353 +
  354 +`        `if(zyResponse.getResult() == null) {    
  355 +
  356 +`            `throw new TokenException("则一Token请求返回失败,返回结果为空!" + zyResponse.getMessage());
  357 +
  358 +`       `}
  359 +
  360 +`        `if(StringUtils.isBlank(zyResponse.getResult().getAccessToken())) {    
  361 +
  362 +`            `throw new TokenException("则一Token请求返回数据异常,AccessToken为空!" + zyResponse.getMessage());
  363 +
  364 +`       `}
  365 +
  366 +`        `// 结果 zyResponse.getResult();
  367 +
  368 +`   `}
  369 +
  370 +}
  371 +
  372 +**返回示例**
  373 +
  374 +
  375 +
  376 +{
  377 +
  378 +`    `"success": true,
  379 +
  380 +`    `"businessException": false,
  381 +
  382 +`    `"errorCode": null,
  383 +
  384 +`    `"message": null,
  385 +
  386 +`    `"result": {
  387 +
  388 +`        `"accessToken": "64d7f367-609b-4f7d-a84d-a3d2a0b5ad85",
  389 +
  390 +`        `"expiresIn": 602105,
  391 +
  392 +`        `"tokenType": "bearer"
  393 +
  394 +`   `}
  395 +
  396 +}
  397 +
  398 +**下单**
  399 +
  400 +**接口信息**
  401 +
  402 +**请求方式：**
  403 +
  404 +post
  405 +
  406 +**请求地址：**
  407 +
  408 +- 生产：<https://gw.shjiuze.cn/oms-service-api/order/add>
  409 +- 测试：<https://test.shjiuze.cn/oms-service-api/order/add>
  410 +
  411 +**Headers参数**
  412 +
  413 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  414 +| :- | :- | :- | :- | :- |
  415 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  416 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  417 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  418 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  419 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  420 +**Body参数**
  421 +
  422 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  423 +| :- | :- | :- | :- | :- |
  424 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  425 +|customerSn|String|否|220101000001|客户委托单号|
  426 +|placeOrderTime|Number|是|1643251533306|下单时间，时间戳毫秒值|
  427 +|loadTime|Number|是|1643251533306|装货时间，时间戳毫秒值|
  428 +|expectArrivalTime|Number|否|1643251533306|期望送达时间，时间戳毫秒值|
  429 +|receiptType|String|否|ELECTRON\_TYPE|回单类型：ELECTRON\_TYPE/电子回单,PAPER\_TYPE/纸质回单,NONE/无|
  430 +|receiptNumber|Number|否|1|回单张数|
  431 +|receiptCode|String|否|A2022012602278|回单号|
  432 +|payType|String|否|PAY\_IN\_CASH|付款方式：PAY\_IN\_CASH/现付,PAY\_ON\_DELIVERY/到付,PAY\_ARREARS/欠付,PAY\_MONTH/月结,PAY\_BACK/回付,PAY\_MULTIPLE/多笔付,PAY\_FREE/免费|
  433 +|lineName|String|否|上海-天津-北京|线路名称|
  434 +|remark|String|否|需要雨布和尾板|订单备注|
  435 +|station|OrderStation[]|是| |订单经停点|
  436 +|`    `stationId|String|否|123abc|站点id|
  437 +|`    `stationName|String|否|上海顺丰青浦站点|站点名称|
  438 +|`    `provinceCode|String|否|310000|省份编号|
  439 +|`    `provinceName|String|是|上海|省份名称|
  440 +|`    `cityCode|String|否|310100|城市编号|
  441 +|`    `cityName|String|是|上海市|城市名称|
  442 +|`    `areaCode|String|否|310118|区域编号|
  443 +|`    `areaName|String|是|青浦区|区域名称|
  444 +|`    `address|String|是|纪鹤公路1988号|详细地址|
  445 +|`    `lat|String|是|36.221825|纬度|
  446 +|`    `lng|String|是|120.632908|经度|
  447 +|`    `contactName|String|否|张三|联系人|
  448 +|`    `contactMobile|String|否|18801000001|联系人电话|
  449 +|`    `loadFlag|String|是|true|装货标识|
  450 +|`    `unloadFlag|String|是|false|卸货标识|
  451 +|`    `expectArrivalTime|Number|否|1643251533306|预计到达时间，时间戳毫秒值|
  452 +|`    `expectDepartTime|Number|否|1643251533306|预计发车时间，时间戳毫秒值|
  453 +|`    `sort|Number|否|1|经停点顺序，如果不传则默认按数组顺序|
  454 +|goods|OrderGoods[]|否| |订单货物信息|
  455 +|`    `barCode|String|否|21616162626|商品条码|
  456 +|`    `skuId|String|否|1223233536436|商品sku\_id|
  457 +|`    `name|String|是|鞋子|货物名称|
  458 +|`    `packageType|String|否| |包装规格|
  459 +|`    `piece|Number|否|200|件数|
  460 +|`    `weight|Number|否|200000|重量|
  461 +|`    `volume|Number|否|50|体积|
  462 +|addService|OrderAddService[]|否| |增值服务|
  463 +|`    `serviceName|String|是|包装服务|服务名称|
  464 +|tags|OrderTag[]|否| |订单标签|
  465 +|`  `tagName|String|是|易碎物品|标签名称|
  466 +|vehicleDemands|OrderVehicleDemand[]|否| |车辆需求|
  467 +|`  `demandVanType|String|是|MOTOR\_VAN|需求厢型：MOTOR\_VAN/厢车,GAOLAN\_VAN/高栏,SLAB\_VAN/平板,REFRIGERATOR\_CAR/冷藏,IVECO/依维柯,JINBEI/金杯,MINI\_VAN/小面包,ELSE\_VAN/其他|
  468 +|demandSpecification|String|是|9.6|需求车型：2.7/3.8/4.2/6.8/7.6/9.6/11/12.5/13.5/15/16.5/17.5/19/21|
  469 +|`  `demandNumber|Number|否|1|为空则默认1|
  470 +|`  `vehicleDemand|String|否|车辆需要带雨布|车辆要求描述|
  471 +**请求示例**
  472 +
  473 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  474 +
  475 +
  476 +
  477 +public class Sample {
  478 +
  479 +`    `public static void main(String[] args\_) {
  480 +
  481 +`        `String appKey = "appkey";
  482 +
  483 +`        `String appSecret = "appSecret";
  484 +
  485 +`        `String jsonData = "下单Body参数JSON数据";
  486 +
  487 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  488 +
  489 +`        `HttpResponseData httpResponseData =
  490 +
  491 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/order/add", "accessToken", jsonData);
  492 +
  493 +`        `if(httpResponseData == null) {    
  494 +
  495 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  496 +
  497 +`         `}
  498 +
  499 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  500 +
  501 +`        `//重新获取token再次请求    
  502 +
  503 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  504 +
  505 +`        `"/oms-service-api/order/add", "accessToken", jsonData);
  506 +
  507 +`       `}
  508 +
  509 +`   `}
  510 +
  511 +}
  512 +
  513 +**返回示例**
  514 +
  515 +
  516 +
  517 +{
  518 +
  519 +`    `"success": true,
  520 +
  521 +`    `"businessException": false,
  522 +
  523 +`    `"errorCode": null,
  524 +
  525 +`    `"message": null,
  526 +
  527 +`    `"result": {
  528 +
  529 +`        `"code": "则一订单号",
  530 +
  531 +`        `"customerOrderCode": "客户订单号"
  532 +
  533 +`   `}
  534 +
  535 +}
  536 +
  537 +**确认中标**
  538 +
  539 +**接口信息**
  540 +
  541 +**请求方式：**
  542 +
  543 +post
  544 +
  545 +**请求地址：**
  546 +
  547 +- 生产：<https://gw.shjiuze.cn/oms-service-api/order/confirmBid>
  548 +- 测试：<https://test.shjiuze.cn/oms-service-api/order/confirmBid>
  549 +
  550 +**Headers参数**
  551 +
  552 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  553 +| :- | :- | :- | :- | :- |
  554 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  555 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  556 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  557 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  558 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  559 +**Body参数**
  560 +
  561 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  562 +| :- | :- | :- | :- | :- |
  563 +|code|String|否|220101000001|则一订单号|
  564 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  565 +|confirmId|String|是|220101000001|中标报价id|
  566 +|quotePrice|Number|是|10000|中标价格|
  567 +**请求示例**
  568 +
  569 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  570 +
  571 +
  572 +
  573 +public class Sample {
  574 +
  575 +`    `public static void main(String[] args\_) {
  576 +
  577 +`        `String appKey = "appkey";
  578 +
  579 +`        `String appSecret = "appSecret";
  580 +
  581 +`        `String jsonData = "确认中标Body参数JSON数据";
  582 +
  583 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  584 +
  585 +`        `HttpResponseData httpResponseData =
  586 +
  587 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/order/confirmBid", "accessToken", jsonData);
  588 +
  589 +`        `if(httpResponseData == null) {    
  590 +
  591 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  592 +
  593 +`         `}
  594 +
  595 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  596 +
  597 +`        `//重新获取token再次请求    
  598 +
  599 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  600 +
  601 +`        `"/oms-service-api/order/confirmBid", "accessToken", jsonData);
  602 +
  603 +`       `}
  604 +
  605 +`   `}
  606 +
  607 +}
  608 +
  609 +**返回示例**
  610 +
  611 +
  612 +
  613 +{
  614 +
  615 +`    `"success": true,
  616 +
  617 +`    `"businessException": false,
  618 +
  619 +`    `"errorCode": null,
  620 +
  621 +`    `"message": null,
  622 +
  623 +`    `"result": {
  624 +
  625 +`        `"code": "则一订单号",
  626 +
  627 +`        `"customerOrderCode": "客户订单号",
  628 +
  629 +`        `"confirmId": "中标报价id",
  630 +
  631 +`        `"quotePrice": "中标价格"
  632 +
  633 +`   `}
  634 +
  635 +}
  636 +
  637 +**取消订单**
  638 +
  639 +**接口信息**
  640 +
  641 +**请求方式：**
  642 +
  643 +post
  644 +
  645 +**请求地址：**
  646 +
  647 +- 生产：<https://gw.shjiuze.cn/oms-service-api/order/cancel>
  648 +- 测试：<https://test.shjiuze.cn/oms-service-api/order/cancel>
  649 +
  650 +**Headers参数**
  651 +
  652 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  653 +| :- | :- | :- | :- | :- |
  654 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  655 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  656 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  657 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  658 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  659 +**Body参数**
  660 +
  661 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  662 +| :- | :- | :- | :- | :- |
  663 +|code|String|否|220101000001|则一订单号|
  664 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  665 +|cancelRemark|String|否|货量不足|取消原因|
  666 +**请求示例**
  667 +
  668 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  669 +
  670 +
  671 +
  672 +public class Sample {
  673 +
  674 +`    `public static void main(String[] args\_) {
  675 +
  676 +`        `String appKey = "appkey";
  677 +
  678 +`        `String appSecret = "appSecret";
  679 +
  680 +`        `String jsonData = "取消订单Body参数JSON数据";
  681 +
  682 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  683 +
  684 +`        `HttpResponseData httpResponseData =
  685 +
  686 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/order/cancel", "accessToken", jsonData);
  687 +
  688 +`        `if(httpResponseData == null) {    
  689 +
  690 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  691 +
  692 +`         `}
  693 +
  694 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  695 +
  696 +`        `//重新获取token再次请求    
  697 +
  698 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  699 +
  700 +`        `"/oms-service-api/order/cancel", "accessToken", jsonData);
  701 +
  702 +`       `}
  703 +
  704 +`   `}
  705 +
  706 +}
  707 +
  708 +**返回示例**
  709 +
  710 +
  711 +
  712 +{
  713 +
  714 +`    `"success": true,
  715 +
  716 +`    `"businessException": false,
  717 +
  718 +`    `"errorCode": null,
  719 +
  720 +`    `"message": null,
  721 +
  722 +`    `"result": {
  723 +
  724 +`        `"code": "则一订单号",
  725 +
  726 +`        `"customerOrderCode": "客户订单号"
  727 +
  728 +`   `}
  729 +
  730 +}
  731 +
  732 +**查询车辆定位**
  733 +
  734 +**接口信息**
  735 +
  736 +**概述**
  737 +
  738 +可以通过该接口查询车辆当前位置，该接口为收费接口。
  739 +
  740 +**请求方式：**
  741 +
  742 +post
  743 +
  744 +**请求地址：**
  745 +
  746 +- 生产：<https://gw.shjiuze.cn/oms-service-api/vehicle/location>
  747 +- 测试：<https://test.shjiuze.cn/oms-service-api/vehicle/location>
  748 +
  749 +**Headers参数**
  750 +
  751 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  752 +| :- | :- | :- | :- | :- |
  753 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  754 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  755 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  756 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  757 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  758 +**Body参数**
  759 +
  760 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  761 +| :- | :- | :- | :- | :- |
  762 +|code|String|是|D220101000001|则一订单号|
  763 +|waybillCode|String|是|Y220101000001|则一运单号|
  764 +|customerOrderCode|String|是|220101000001|客户订单号，订单唯一标识|
  765 +|licenseNumber|String|是|沪DP2312|车牌号|
  766 +**请求示例**
  767 +
  768 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  769 +
  770 +
  771 +
  772 +public class Sample {
  773 +
  774 +`    `public static void main(String[] args\_) {
  775 +
  776 +`        `String appKey = "appkey";
  777 +
  778 +`        `String appSecret = "appSecret";
  779 +
  780 +`        `String jsonData = "车辆位置查询Body参数JSON数据";
  781 +
  782 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  783 +
  784 +`        `HttpResponseData httpResponseData =
  785 +
  786 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/vehicle/location", "accessToken", jsonData);
  787 +
  788 +`        `if(httpResponseData == null) {    
  789 +
  790 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  791 +
  792 +`         `}
  793 +
  794 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  795 +
  796 +`        `//重新获取token再次请求    
  797 +
  798 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  799 +
  800 +`        `"/oms-service-api/vehicle/location", "accessToken", jsonData);
  801 +
  802 +`       `}
  803 +
  804 +`   `}
  805 +
  806 +}
  807 +
  808 +**返回示例**
  809 +
  810 +
  811 +
  812 +{
  813 +
  814 +`    `"success":true,
  815 +
  816 +`    `"businessException":false,
  817 +
  818 +`    `"result":{
  819 +
  820 +`        `"lng":"106.1722328011559", //经度
  821 +
  822 +`        `"lat":"37.94834927106783", //纬度
  823 +
  824 +`        `"speed":0, //速度，km/h
  825 +
  826 +`        `"time":"2022-02-07 19:33:19", //定位时间
  827 +
  828 +`        `"address":"宁夏回族自治区吴忠市利通区清二沟,东方向,296.5米" //定位地点
  829 +
  830 +`   `}
  831 +
  832 +}
  833 +
  834 +**查询车辆历史轨迹**
  835 +
  836 +**接口信息**
  837 +
  838 +**概述**
  839 +
  840 +可以通过该接口查询车辆历史运行轨迹数据，该接口为收费接口。
  841 +
  842 +**请求方式：**
  843 +
  844 +post
  845 +
  846 +**请求地址：**
  847 +
  848 +- 生产：<https://gw.shjiuze.cn/oms-service-api/vehicle/track>
  849 +- 测试：<https://test.shjiuze.cn/oms-service-api/vehicle/track>
  850 +
  851 +**Headers参数**
  852 +
  853 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  854 +| :- | :- | :- | :- | :- |
  855 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  856 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  857 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  858 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  859 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  860 +**Body参数**
  861 +
  862 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  863 +| :- | :- | :- | :- | :- |
  864 +|code|String|是|D220101000001|则一订单号|
  865 +|waybillCode|String|是|Y220101000001|则一运单号|
  866 +|customerOrderCode|String|是|220101000001|客户订单号，订单唯一标识|
  867 +|licenseNumber|String|是|沪DP2312|车牌号|
  868 +|startTime|Number|是|1643251533306|开始时间|
  869 +|endTime|Number|是|1643251533308|结束时间|
  870 +**请求示例**
  871 +
  872 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  873 +
  874 +
  875 +
  876 +public class Sample {
  877 +
  878 +`    `public static void main(String[] args\_) {
  879 +
  880 +`        `String appKey = "appkey";
  881 +
  882 +`        `String appSecret = "appSecret";
  883 +
  884 +`        `String jsonData = "车辆轨迹查询Body参数JSON数据";
  885 +
  886 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  887 +
  888 +`        `HttpResponseData httpResponseData =
  889 +
  890 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/vehicle/track", "accessToken", jsonData);
  891 +
  892 +`        `if(httpResponseData == null) {    
  893 +
  894 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  895 +
  896 +`         `}
  897 +
  898 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  899 +
  900 +`        `//重新获取token再次请求    
  901 +
  902 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  903 +
  904 +`        `"/oms-service-api/vehicle/track", "accessToken", jsonData);
  905 +
  906 +`       `}
  907 +
  908 +`   `}
  909 +
  910 +}
  911 +
  912 +**返回示例**
  913 +
  914 +
  915 +
  916 +{
  917 +
  918 +`    `"success":true,
  919 +
  920 +`    `"businessException":false,
  921 +
  922 +`    `"result":[
  923 +
  924 +`       `{
  925 +
  926 +`            `"lon":"116.6709722499687", //经度
  927 +
  928 +`            `"lat":"39.64092201495669", //纬度
  929 +
  930 +`            `"gtm":"2022-02-07 18:55:13", //gps时间
  931 +
  932 +`            `"spd":"249", //速度 除以10为km/h
  933 +
  934 +`            `"hgt":"4", //海拔m
  935 +
  936 +`            `"agl":"257" //正北方向夹角
  937 +
  938 +`       `},
  939 +
  940 +`       `{
  941 +
  942 +`            `"lon":"116.66919560752942",
  943 +
  944 +`            `"lat":"39.64070361333219",
  945 +
  946 +`            `"gtm":"2022-02-07 18:55:33",
  947 +
  948 +`            `"spd":"272",
  949 +
  950 +`            `"hgt":"6",
  951 +
  952 +`            `"agl":"260"
  953 +
  954 +`       `}
  955 +
  956 +`   `]
  957 +
  958 +}
  959 +
  960 +**查询订单操作记录**
  961 +
  962 +**接口信息**
  963 +
  964 +**概述**
  965 +
  966 +可以通过该接口查询订单的操作记录。
  967 +
  968 +**请求方式：**
  969 +
  970 +post
  971 +
  972 +**请求地址：**
  973 +
  974 +- 生产：<https://gw.shjiuze.cn/oms-service-api/order/getOperateList>
  975 +- 测试：<https://test.shjiuze.cn/oms-service-api/order/getOperateList>
  976 +
  977 +**Headers参数**
  978 +
  979 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  980 +| :- | :- | :- | :- | :- |
  981 +|Authorization|String|是    |Bearer a2c5680001|调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。|
  982 +|appKey|String|是|0867ef5f23ef6483749e19e1692b|则一提供|
  983 +|timestamp|String|是|1643251533306|当前时间戳毫秒值|
  984 +|nonce|String|是|gdst9t|6位小写字母数字组合随机串|
  985 +|sign|String|是|fa3ed338d6dfe18e7273c8692234ee70|签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成|
  986 +**Body参数**
  987 +
  988 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  989 +| :- | :- | :- | :- | :- |
  990 +|code|String|否|220101000001|则一订单号|
  991 +|customerOrderCode|String|是|220101000001|客户订单号，订单唯一标识|
  992 +**请求示例**
  993 +
  994 +**Java-sdk方式 [下载SDK**](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)**
  995 +
  996 +
  997 +
  998 +public class Sample {
  999 +
  1000 +`    `public static void main(String[] args\_) {
  1001 +
  1002 +`        `String appKey = "appkey";
  1003 +
  1004 +`        `String appSecret = "appSecret";
  1005 +
  1006 +`        `String jsonData = "订单操作记录Body参数JSON数据";
  1007 +
  1008 +`        `ZYClient zyClient = new ZYClient(appKey, appSecret);
  1009 +
  1010 +`        `HttpResponseData httpResponseData =
  1011 +
  1012 +zyClient.doPost(Constants.TEST\_HOST + "/oms-service-api/orderOperateRecord/getList", "accessToken", jsonData);
  1013 +
  1014 +`        `if(httpResponseData == null) {    
  1015 +
  1016 +`            `throw new BusinessException("则一请求失败,返回结果为空!");
  1017 +
  1018 +`         `}
  1019 +
  1020 +`        `if(httpResponseData.getStatus() == HttpURLConnection.HTTP\_UNAUTHORIZED) {  
  1021 +
  1022 +`        `//重新获取token再次请求    
  1023 +
  1024 +`        `httpResponseData = zyClient.doPost(Constants.TEST\_HOST +
  1025 +
  1026 +`        `"/oms-service-api/orderOperateRecord/getList", "accessToken", jsonData);
  1027 +
  1028 +`       `}
  1029 +
  1030 +`   `}
  1031 +
  1032 +}
  1033 +
  1034 +**返回示例**
  1035 +
  1036 +
  1037 +
  1038 +{
  1039 +
  1040 +`    `"success": true,
  1041 +
  1042 +`    `"businessException": false,
  1043 +
  1044 +`    `"errorCode": null,
  1045 +
  1046 +`    `"message": null,
  1047 +
  1048 +`    `"result": [
  1049 +
  1050 +`       `{
  1051 +
  1052 +`            `"orderCode": "220101000001",
  1053 +
  1054 +`            `"operateType": "ORDER\_XXX",
  1055 +
  1056 +`            `"operateContent": "操作详情XXXX1",
  1057 +
  1058 +`            `"operateTime": "2022-02-10 18:23:30",
  1059 +
  1060 +`            `"operateUser": "张三"
  1061 +
  1062 +`       `},
  1063 +
  1064 +`       `{
  1065 +
  1066 +`            `"orderCode": "220101000001",
  1067 +
  1068 +`            `"operateType": "ORDER\_XXX",
  1069 +
  1070 +`            `"operateContent": "操作详情XXXX2",
  1071 +
  1072 +`            `"operateTime": "2022-02-08 12:43:30",
  1073 +
  1074 +`            `"operateUser": "李四"
  1075 +
  1076 +`       `}
  1077 +
  1078 +`   `]
  1079 +
  1080 +}
  1081 +
  1082 +
  1083 +
  1084 +**以下接口需要对接方提供**
  1085 +
  1086 +**报价接口**
  1087 +
  1088 +**接口信息**
  1089 +
  1090 +**概述**
  1091 +
  1092 +则一调用该接口进行报价，可以进行多次报价。
  1093 +
  1094 +**请求方式：**
  1095 +
  1096 +post
  1097 +
  1098 +**请求路径：**
  1099 +
  1100 +/quotePrice
  1101 +
  1102 +**Body参数**
  1103 +
  1104 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  1105 +| :- | :- | :- | :- | :- |
  1106 +|code|String|是|220101000001|则一订单号|
  1107 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  1108 +|quoteId|String|是|1a2111bacd56|报价id，报价唯一标识|
  1109 +|quotePrice|Number|是|10000|报价金额|
  1110 +|contactName|String|否|张三|报价联系人|
  1111 +|contactMobile|String|否|18801000000|报价联系电话|
  1112 +|quoteInvalidTime|Number|否|1643251533306|报价有效期，时间戳毫秒值|
  1113 +|operateTime|Number|是|1643251533306|操作时间戳|
  1114 +**返回示例**
  1115 +
  1116 +
  1117 +
  1118 +{
  1119 +
  1120 +`    `"success": true,
  1121 +
  1122 +`    `"businessException": false,
  1123 +
  1124 +`    `"errorCode": null,
  1125 +
  1126 +`    `"message": null,
  1127 +
  1128 +`    `"result": {
  1129 +
  1130 +`        `"code": "则一订单号",
  1131 +
  1132 +`        `"customerOrderCode": "客户订单号"
  1133 +
  1134 +`   `}
  1135 +
  1136 +}
  1137 +
  1138 +**接单接口**
  1139 +
  1140 +**接口信息**
  1141 +
  1142 +**概述**
  1143 +
  1144 +则一调用该接口推送运单号及参考运费范围。
  1145 +
  1146 +**请求方式：**
  1147 +
  1148 +post
  1149 +
  1150 +**请求路径：**
  1151 +
  1152 +/receiveOrder
  1153 +
  1154 +**Body参数**
  1155 +
  1156 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  1157 +| :- | :- | :- | :- | :- |
  1158 +|code|String|是|220101000001|则一订单号|
  1159 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  1160 +|startTotalPrice|Number|是|18100|参考总金额起始值|
  1161 +|endTotalPrice|Number|是|21000|参考总金额结束值|
  1162 +|WaybillList|Waybill[]|是| |运单集合|
  1163 +|`    `waybillCode|String|是|Y220101000001|则一运单号|
  1164 +|`    `startPrice|Number|是|18100|参考金额起始值|
  1165 +|`    `endPrice|Number|是|21000|参考金额结束值|
  1166 +|`    `vanType|String|是|MOTOR\_VAN|厢型|
  1167 +|`    `specification|String|是|9.6|车型|
  1168 +**返回示例**
  1169 +
  1170 +
  1171 +
  1172 +{
  1173 +
  1174 +`    `"success": true,
  1175 +
  1176 +`    `"businessException": false,
  1177 +
  1178 +`    `"errorCode": null,
  1179 +
  1180 +`    `"message": null,
  1181 +
  1182 +`    `"result": {
  1183 +
  1184 +`        `"code": "则一订单号",
  1185 +
  1186 +`        `"customerOrderCode": "客户订单号"
  1187 +
  1188 +`   `}
  1189 +
  1190 +}
  1191 +
  1192 +
  1193 +
  1194 +**推送司机车辆信息**
  1195 +
  1196 +**接口信息**
  1197 +
  1198 +**概述**
  1199 +
  1200 +则一调用该接口推送订单司机和车辆信息，可以进行多次推送，以操作时间戳最新一次推送的司机车辆信息为准。
  1201 +
  1202 +**请求方式：**
  1203 +
  1204 +post
  1205 +
  1206 +**请求路径：**
  1207 +
  1208 +/assignVehicle
  1209 +
  1210 +**Body参数**
  1211 +
  1212 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  1213 +| :- | :- | :- | :- | :- |
  1214 +|code|String|是|220101000001|则一订单号|
  1215 +|waybillCode|String|是|Y220101000001|则一运单号|
  1216 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  1217 +|driverName|String|是|张三|司机姓名|
  1218 +|driverMobile|String|是|18801000000|司机手机号|
  1219 +|licenseNumber|String|是|沪DP2312|车牌号|
  1220 +|trailerLicenseNumber|String|否|陕K7C72挂|挂车车牌号|
  1221 +|operateTime|Number|是|1643251533306|操作时间戳|
  1222 +|weight|Number|否|200000|重量|
  1223 +|volume|Number|否|16|体积|
  1224 +**返回示例**
  1225 +
  1226 +
  1227 +
  1228 +{
  1229 +
  1230 +`    `"success": true,
  1231 +
  1232 +`    `"businessException": false,
  1233 +
  1234 +`    `"errorCode": null,
  1235 +
  1236 +`    `"message": null,
  1237 +
  1238 +`    `"result": {
  1239 +
  1240 +`        `"code": "则一订单号",
  1241 +
  1242 +`        `"customerOrderCode": "客户订单号"
  1243 +
  1244 +`   `}
  1245 +
  1246 +}
  1247 +
  1248 +
  1249 +
  1250 +**推送发车信息**
  1251 +
  1252 +**接口信息**
  1253 +
  1254 +**概述**
  1255 +
  1256 +则一调用该接口推送发车运输数据。
  1257 +
  1258 +**请求方式：**
  1259 +
  1260 +post
  1261 +
  1262 +**请求路径：**
  1263 +
  1264 +/departVehicle
  1265 +
  1266 +**Body参数**
  1267 +
  1268 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  1269 +| :- | :- | :- | :- | :- |
  1270 +|code|String|是|220101000001|则一订单号|
  1271 +|waybillCode|String|是|Y220101000001|则一运单号|
  1272 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  1273 +|departTime|Number|是|1643251533306|发车时间戳|
  1274 +|operateTime|Number|是|1643251533306|操作时间戳|
  1275 +|weight|Number|否|200000|重量|
  1276 +|volume|Number|否|16|体积|
  1277 +**返回示例**
  1278 +
  1279 +
  1280 +
  1281 +{
  1282 +
  1283 +`    `"success": true,
  1284 +
  1285 +`    `"businessException": false,
  1286 +
  1287 +`    `"errorCode": null,
  1288 +
  1289 +`    `"message": null,
  1290 +
  1291 +`    `"result": {
  1292 +
  1293 +`        `"code": "则一订单号",
  1294 +
  1295 +`        `"customerOrderCode": "客户订单号"
  1296 +
  1297 +`   `}
  1298 +
  1299 +}
  1300 +
  1301 +**推送到车信息**
  1302 +
  1303 +**接口信息**
  1304 +
  1305 +**概述**
  1306 +
  1307 +则一调用该接口推送到达数据。
  1308 +
  1309 +**请求方式：**
  1310 +
  1311 +post
  1312 +
  1313 +**请求路径：**
  1314 +
  1315 +/arriveVehicle
  1316 +
  1317 +**Body参数**
  1318 +
  1319 +|**名称**|**类型**|**必填**|**示例值**|**描述**|
  1320 +| :- | :- | :- | :- | :- |
  1321 +|code|String|是|220101000001|则一订单号|
  1322 +|waybillCode|String|是|Y220101000001|则一运单号|
  1323 +|customerOrderCode|String|是    |220101000001|客户订单号，订单唯一标识|
  1324 +|arriveTime|Number|是|1643251533306|到车时间戳|
  1325 +|operateTime|Number|是|1643251533306|操作时间戳|
  1326 +**返回示例**
  1327 +
  1328 +
  1329 +
  1330 +{
  1331 +
  1332 +`    `"success": true,
  1333 +
  1334 +`    `"businessException": false,
  1335 +
  1336 +`    `"errorCode": null,
  1337 +
  1338 +`    `"message": null,
  1339 +
  1340 +`    `"result": {
  1341 +
  1342 +`        `"code": "则一订单号",
  1343 +
  1344 +`        `"customerOrderCode": "客户订单号"
  1345 +
  1346 +`   `}
  1347 +
  1348 +}
  1349 +
  1350 +**Java-sdk下载**
  1351 +
  1352 +[zy-java-sdk](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  1353 +
  1354 +
  1355 +
  1356 +**2022-03-09更新日志**
  1357 +
  1358 +为了保证接口的通用性，本次涉及到改动的信息如下
  1359 +
  1360 +1. [下单](#下单): 接口返回值移除子单集合，通过接单接口推送。
  1361 +1. [接单接口](#接单接口)：由推送参考价改为接单接口，推送运单集合及每个运单的参考价格。
  1362 +1. 对接接口中子单号subCode参数命名更改为运单号waybillCode。
  1363 +
  1364 +