Browse Source

增加货物追踪订阅说明

gmw 5 years ago
parent
commit
20b77fb5b0
1 changed files with 13 additions and 2 deletions
  1. 13 2
      README.md

+ 13 - 2
README.md

@@ -1192,7 +1192,7 @@
 
 | 参数名 | 必选 | 类型 | 说明 |
 |:----:|:---:|:-----:|:-----:|
-| `states` | 是 | `String` | 601:受理单签收;602(需要`xhkID`):受理单绑定的小黑卡轨迹点上报。多个状态之间用','隔开  |
+| `states` | 是 | `String` | 600:货物追踪;601:受理单签收;602(需要`xhkID`):受理单绑定的小黑卡轨迹点上报。多个状态之间用','隔开  |
 | `callbackUrl` | 是 | `String` | 回调地址,以http://或https://开头,支持每个用户使用不同的回调地址 |
 | `xhkID` | 是 | `String` | 小黑卡公司id,由我方提供,部分订阅状态需要传递此参数 |
 
@@ -1219,6 +1219,17 @@
 - 受理单订阅返回报文:
 
 ```java
+/*订阅600时的回调结果*/
+{
+    "messageTimeStamp": 1573699009, /*消息生成时的时间戳,精确到秒*/
+    "trackContent": "已办理外转", /*货物追踪内容*/
+    "transferOrderNumber": "W1911145D9E467C0006", /*外传单号*/
+    "originalOrderNumber": "0809496759", /*客户单号*/
+    "subscribeState": 600, /*订阅的状态*/
+    "customerOrderNumber": "S1911141034952066", /*受理单号*/
+    "orderState": 2000 /*受理单状态,0:已撤销 1000:待处理 2000:进行中 3000:已完成*/
+}
+
 /*订阅601时的回调结果*/
 {
     "customerOrderNumber": "S1910111512348435", /*受理单号*/
@@ -1959,7 +1970,7 @@ CustomerOrderEntity结构如下:
     "consigneePhone": "", //收货人电话:非必填
     "deliveryTime": 1573178874, //提货时间:非必填,时间戳,精确到秒
     "deliveryType": 1, //提送类型:非必填,1)自提, 2)送货
-    "deviceNumber": "", //绑定设备号:非必填
+    "deviceNumber": "", //绑定设备号:非必填,绑定失败不影响受理单的创建,原因会在返回信息中的message中说明
     "startAddress": "", //起始地:非必填
     "endAddress": "", //目的地:非必填
     //发货方经纬度:非必填