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

74 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)