sl-express/sl-express-ms-web-courier/README.md

74 lines
3.3 KiB
Markdown
Raw Normal View History

2023-09-04 16:40:17 +08:00
# sl-express-ms-web-courier使用手册
## 1.说明
**该模块为快递员端web微服务主要提供快递员端APP各项服务。**<br />主要功能:
- 快递员账号登录
- 用户个人信息、服务范围、查询同网点其他快递员
- 快递员任务查询、数据统计
- 快递员修改订单运费、用户身份验证
- 快递员取件、转单、签收、拒收、取消任务
- 快递运单跟踪
- 订单支付、获取支付状态
- 公告、取件、签收、取消的消息通知
## 2.服务配置
### 2.1配置信息
- 服务需要接入权限系统所以需要配置权限系统应用id
- 快递员取件时,如果寄件人未实名认证,需进行身份校验,所以配置实名认证工具
- 快递员取件时,支持寄件人扫码付款,所以配置微信/支付宝商户号
>实名认证技术https://market.aliyun.com/products/57000002/cmapi026109.html?spm=5176.2020520132.101.1.7c7772181uNceG#sku=yuncode2010900004
```properties
#权限系统应用id
authority.applicationId=981194468570960001
#实名认证(默认关闭)
real-name-registration.enable=false
spring.eidverify.url=https://eid.shumaidata.com/eid/check
spring.eidverify.appCode=你的AppCode
#微信 神领物流商户号
sl.wechat.enterpriseId=1561414331
#支付宝 神领物流商户号
sl.ali.enterpriseId=2088241317544335
```
### 2.2依赖引入
| 依赖服务 | 版本 | 参考文档 |
|----------------------------------|--------------|---------------------------------------------------------------------|
| sl-express-common | 1.1-SNAPSHOT | [sl-express-common](/zh-cn/new-function.md) |
| sl-express-ms-base-api | 1.0-SNAPSHOT | [基础微服务](/zh-cn/modules/sl-express-ms-base.md) |
| sl-express-ms-work-api | 1.0-SNAPSHOT | [work微服务](/zh-cn/modules/sl-express-ms-work.md) |
| sl-express-ms-oms-api | 1.0-SNAPSHOT | [订单微服务](/zh-cn/modules/sl-express-ms-oms.md) |
| sl-express-ms-user-api | 1.0-SNAPSHOT | [用户微服务](/zh-cn/modules/sl-express-ms-user.md) |
| sl-express-ms-carriage-api | 1.0-SNAPSHOT | [运费微服务](/zh-cn/modules/sl-express-ms-carriage.md) |
| sl-express-ms-courier-api | 1.0-SNAPSHOT | [快递员微服务](/zh-cn/modules/sl-express-ms-courier.md) |
| sl-express-ms-service-scope-api | 1.0-SNAPSHOT | [service-scope微服务](/zh-cn/modules/sl-express-ms-service-scope.md) |
| sl-express-ms-transport-info-api | 1.0-SNAPSHOT | [transport-info微服务](/zh-cn/modules/sl-express-ms-transport-info.md) |
| sl-express-ms-trade-api | 1.0-SNAPSHOT | [trade微服务](/zh-cn/modules/sl-express-ms-trade.md) |
## 3.服务架构
### 3.1取件业务流程
![取件业务流程](../../docs/zh-cn/assets/取件业务流程.png)
### 3.2签收业务流程
![签收业务流程](../../docs/zh-cn/assets/签收业务流程.png)
### 3.3拒单业务流程
![拒单业务流程](../../docs/zh-cn/assets/拒单业务流程.png)
### 3.4取消任务流程
![取消任务流程](../../docs/zh-cn/assets/取消任务流程.png)