整体思路类似镖局

 

追踪：

如果ledi的服务商没有物流系统

1. 选择了平台内置的派送商，直接调用label-ex查询物流信息【需要手动加上入口、出库等追踪信息】
2. 没选中平台内置的，显示官网供查询

如果ledi的服务商有物流系统，配置了追踪接口

1. 直接调用接口查询物流信息

 

 

## ledi对接17feia

1、2、3步是一气呵成的

1. ledi通知17feia有新订单
url：http://api.17feia.com/eship-api/v1/acceptLediRequest【17feia提供】
method：post
postBody：
{
“appId”: “”,  【供17feia回调鉴权用的】
“appSecret”: “”

“appKey”: “”,【调用17feia，17feia鉴权的】
“appToken”: “”
}

response:
{
“flag” : true
“msg” : “success”
}

2. 查询ledi服务商的新订单【17feia查询后在自己系统下单，将服务商的appId和appSecret保存在订单中】
url：http://api.ledi.com/platform/api/v1/orders/newlist
method: post
postBody：
{
“appId”: “”, 【来自通知url传过来的参数】
“appSecret”: “”
}

response:
{
total:1
rows: [
{
…【每个订单的信息】
}
{
…
}
]
}

3. 17feia下单成功通知ledi
url：http://api.ledi.com/platform/api/v1/orders/shipment_success
method: post
postBody：
{
“appId”: “”, 【来自通知url传过来的参数】
“appSecret”: “”,
“insideNumber” : “” 【ledi的内单号，查询新订单的时候返回的参考号】

“logisticsOrderNumber” : “” 【17feia内单号】

“logisticsOrderPdfUrl” : “” 【17feia内单标签url】
}

response:
{
“flag” : true
“msg” : “success”
}

4. 17feia回传重量给ledi
url：http://api.ledi.com/platform/api/v1/orders/weight
method: post
postBody：
{
“appId”: “”, 【来自订单】
“appSecret”: “”,
“insideNumber” : “”, 【ledi的内单号，17feia的参考号】
“boxs” : [
{
weight: 1, 【单位kg】
length: 20, 【单位cm】
width: 20,
height: 10
},
{

}
]
}

response:
{
“flag” : true
“msg” : “success”
}

response:
{
“flag” : false,
“msg” : “error”,
“obj” : [
{
…
},
{
…
}
]
}

5. 17feia回传派送单号，url
url：http://api.ledi.com/platform/api/v1/orders/transport
method：post
postBody：
{
“appId”: “”, 【来自订单】
“appSecret”: “”,
“insideNumber” : “”, 【ledi的内单号，17feia的参考号】
“deliveryNumber” : “”, 【派送单号】
“deliveryPdfUrl” : “”, 【派送标签地址】
}

response:
{
“flag” : true
“msg” : “success”
}

6. 17feia订单发货，签收，回传给状态ledi
url：http://api.ledi.com/platform/api/v1/orders/status
method：post
postBody：
{
“appId”: “”, 【来自订单】
“appSecret”: “”,
“insideNumber” : “”, 【ledi的内单号，17feia的参考号】
“status” : “DELIVERED”, 【更新为已发货DELIVERED，已签收COMPLETED，国内退货DOMESTIC_RETURN，已取消CANCELED】修改状态是有条件的，不能随便修改
}

response:
{
“flag” : true
“msg” : “success”
}

7. ledi追踪17feia信息
url：http://api.17feia.com/eship-api/v1/tracking?orderNo=Feiash1700000001yq【17feia提供】
method：get

response:
{
“flag” : true
“msg” : “success”
rows: [
{
“createTime” : “2019-03-21 17:05:09”, 【界面显示】
“status” : “IN_TRANSIT”, 【状态值，根据状态值，可以画流程】
“statusDesc” : “in transit”, 【界面显示】
“location” : “Germany Neuenstein”, 【界面显示】
“description” : “The parcel has reached the parcel center and was sorted manually.”, 【界面显示】
},
{

}
]
}

status:
TAKE_DELIVERY(“仓库收货”),
DELIVERED(“已出库”),
TAKE_OFF(“飞机起飞”),
LANDING(“飞机落地”),
CLEARANCE(“清关中”),
IN_TRANSIT(“运输途中”),
WAIT_TO_PICKUP(“到达待取”),
DELIVERY_FAILED(“投递失败”),
SIGNING_SUCCESS(“成功签收”),
POSSIBLE_ABNORMALITY(“可能异常”),
LONG_TRANSPORT(“运输过久”),
FOREIGN_RETURN(“国外退件”),
LOST(“包裹丢失”),
TRACKING_ENDED(“跟踪结束”)