xst
73b93bdf0c
Implements the "运输流程" collection from yun8.postman_collection.json as a Python pipeline: driver-side order accept/load/unload -> freight accounting -> payment, with SQL writes, driven by yun8_sync/config.yaml (api/auth/accounting/payment/database/sql/dianyuntong sections).
241 lines
9.6 KiB
Markdown
241 lines
9.6 KiB
Markdown
# yun8 运输流程完整自动化
|
||
|
||
将 `yun8.postman_collection.json` 中 **"运输流程"** 全部 18 个接口 + SQL 写入实现为 Python 流水线。
|
||
|
||
---
|
||
|
||
## 流程概览
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ 阶段 A: 司机端 (Step 01-05) │
|
||
│ 查询货源 → 接单 → 查询待运输单 → 装货 → 卸货 │
|
||
│ 变量: mainOrderCode → code / vehicleCode / orderCode │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ 阶段 B: 运费核算 (Step 06-09) │
|
||
│ 查询运单 → 运单详情 → 核算试算 → 核算提交 │
|
||
│ 变量: 30+ 核算字段 + ticketImageUrls │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ 阶段 C: 审核 & 付款 (Step 10-14) │
|
||
│ 查询审核 → 审核通过 → 油卡充值 → 司机打款 → 货主打款 │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ 阶段 D: 回单文件 + SQL (Step 15-18) │
|
||
│ 运单上传(payNo) → 打款记录 → 文件名前缀 → INSERT → 上报运单 │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ 阶段 E: ETC 开票 SQL (Step 22-23) │
|
||
│ 写入 base_etc_invoice → 写入 tms_order_etc_push │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 上下游变量传递
|
||
|
||
| 步骤 | 产出变量 | 消费步骤 |
|
||
|------|---------|---------|
|
||
| 01 查询货源 | `mainOrderCode`, `residueNumber` | 02, 09 |
|
||
| 03 查询待运输单 | `code`, `vehicleCode`, `orderCode` | 04-18 |
|
||
| 06 运费核算 | 30+ 字段 (branchCode, oilFee, ...) | 09, 12 |
|
||
| 07 运单详情 | `deliveryCashFee`, `driverActualFreight`, ... | 09, 13 |
|
||
| 08 核算试算 | `ticketImageUrls` | 09 |
|
||
| 15 运单上传 | `payNo` (sendMsg 正则提取) | SQL |
|
||
| 16 打款记录 | 所有 `code` | 17 |
|
||
| 17 文件名前缀 | `filePrefix` | SQL |
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
cd yun8_sync
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
---
|
||
|
||
## 配置
|
||
|
||
编辑 `config.yaml`：
|
||
|
||
### Token（二选一）
|
||
```yaml
|
||
auth:
|
||
driver_token: "Bearer xxx" # 写在配置文件
|
||
admin_token: "Bearer yyy"
|
||
```
|
||
或命令行传入 `--auth-driver` / `--auth-admin`（命令行优先）。
|
||
|
||
### 重量模式
|
||
```yaml
|
||
driver_params:
|
||
weight_mode: "fixed" # fixed=固定值 / random=每次随机 1.0~10.0
|
||
per_weight: "10" # fixed 模式：接单单位重量
|
||
weight: "10" # fixed 模式：装货/卸货重量
|
||
```
|
||
- **fixed**: 使用配置的固定值
|
||
- **random**: 每次循环随机生成 1.0~10.0 小数（一位小数），`per_weight` 和 `weight` 自动保持一致
|
||
|
||
### 核算/付款参数
|
||
```yaml
|
||
accounting:
|
||
branch_code: "49adb23841asw3118yunnanchenggang"
|
||
business_type_code: "1003999"
|
||
payee_code: "16d0c260f7e34967b36113c770e03486"
|
||
shipment_phone: "15198908093"
|
||
shipment_party_code: "ce8b73b38cf6450d84740cf23aa4ed52"
|
||
settlement_type: "2"
|
||
|
||
payment:
|
||
pay_types: "3,4,5,9,10,11"
|
||
pay_platform: "3"
|
||
sms_code: "1234"
|
||
phone: "13888888888"
|
||
pay_type: "arpa_2"
|
||
```
|
||
> 注：`branchCode` / `businessTypeCode` / `payeeCode` / `shipmentPhone` / `shipmentPartyCode` 会优先从 step06 返回值中读取，配置仅作兜底。
|
||
|
||
### 数据库
|
||
```yaml
|
||
database:
|
||
host: "36.137.133.24"
|
||
port: 3306
|
||
user: "root"
|
||
password: "Rgxi3!kD9jjXpgzx"
|
||
database: "ntocc"
|
||
charset: "utf8mb4"
|
||
```
|
||
|
||
### SQL 模板
|
||
```yaml
|
||
sql:
|
||
file_name_template: "{file_prefix}_1_signed.pdf"
|
||
template: |
|
||
INSERT INTO `ntocc`.`base_gd_mft_file` (...) VALUES (...)
|
||
```
|
||
占位符 `{file_prefix}` 和 `{pay_no}` 由流水线自动填充。
|
||
|
||
---
|
||
|
||
## 使用
|
||
|
||
### 命令行参数
|
||
|
||
| 参数 | 说明 | 默认值 |
|
||
|------|------|--------|
|
||
| `--config` | 配置文件路径 | `./config.yaml` |
|
||
| `--auth-driver` | 司机端 Bearer Token | 读取 config |
|
||
| `--auth-admin` | 管理端 Bearer Token | 读取 config |
|
||
| `--stage` | 运行阶段: `all` / `driver` / `accounting` / `payment` / `receipt` | `all` |
|
||
| `--dry-run` | 仅预览 SQL，不写库 | `False` |
|
||
| `--repeat` | 循环执行次数 | `1` |
|
||
| `--delay` | 每次循环间隔秒数 | `0` |
|
||
|
||
### 分阶段运行
|
||
|
||
```bash
|
||
# 完整流程（18步）
|
||
python main.py --auth-driver "Bearer xxx" --auth-admin "Bearer yyy"
|
||
|
||
# 仅跑司机端 (Step 01-05)
|
||
python main.py --stage driver --auth-driver "Bearer xxx" --auth-admin "Bearer yyy"
|
||
|
||
# 仅跑运费核算 (Step 06-09)
|
||
python main.py --stage accounting --auth-driver "Bearer xxx" --auth-admin "Bearer yyy"
|
||
|
||
# 仅跑审核付款 (Step 10-14)
|
||
python main.py --stage payment --auth-driver "Bearer xxx" --auth-admin "Bearer yyy"
|
||
|
||
# 仅跑回单+SQL+上报 (Step 15-18)
|
||
python main.py --stage receipt --auth-driver "Bearer xxx" --auth-admin "Bearer yyy"
|
||
```
|
||
|
||
> 独立运行 `payment` 或 `receipt` 阶段时，会自动从 admin 端补全前置数据（code/orderCode），无需手动指定。
|
||
|
||
### 循环执行
|
||
|
||
```bash
|
||
# 完整流程循环 10 次，每次间隔 5 秒
|
||
python main.py --repeat 10 --delay 5
|
||
|
||
# 仅 receipt 阶段循环 100 次
|
||
python main.py --stage receipt --repeat 100 --delay 2
|
||
|
||
# 配合 random 重量模式，每次自动换新重量
|
||
python main.py --repeat 50 --delay 3
|
||
```
|
||
|
||
每次循环独立创建 Pipeline，变量上下文重置。某次失败不中断后续循环，`Ctrl+C` 随时停止。
|
||
|
||
### 预览模式
|
||
|
||
```bash
|
||
# 不写数据库，仅打印 SQL
|
||
python main.py --dry-run
|
||
|
||
# 循环预览
|
||
python main.py --repeat 5 --dry-run
|
||
```
|
||
|
||
### Token 从配置文件读取（无需命令行）
|
||
|
||
在 `config.yaml` 中填写 `auth.driver_token` 和 `auth.admin_token`，然后：
|
||
|
||
```bash
|
||
python main.py --repeat 100
|
||
```
|
||
|
||
---
|
||
|
||
## 故障处理
|
||
|
||
| 现象 | 处理方式 |
|
||
|------|---------|
|
||
| WAF 拦截 (SQL注入误判) | 已内置：直连服务器 + 手工 query string 编码 |
|
||
| "运单正被处理中" | 已内置：自动重试 5 次，间隔递增 5~13s |
|
||
| "货运单不存在" | Token 过期或运单状态不对，检查 admin token |
|
||
| 独立阶段提示 code 为空 | 已内置：自动从 admin 端补全 |
|
||
| GBK 编码报错 | 已修复：全部输出使用纯 ASCII 字符 |
|
||
|
||
---
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
yun8_sync/
|
||
├── config.yaml # 配置文件 (API / Auth / 重量 / 核算 / 付款 / DB / SQL)
|
||
├── client.py # HTTP 客户端 (18 个接口 + Pre/Post 脚本逻辑)
|
||
├── pipeline.py # 流程编排 (Postman 变量上下文 + 步骤串联 + 重试)
|
||
├── db.py # 数据库操作 (INSERT)
|
||
├── main.py # CLI 入口 (分阶段 + 循环 + dry-run)
|
||
├── requirements.txt # Python 依赖
|
||
└── README.md # 本文件
|
||
```
|
||
|
||
---
|
||
|
||
## 接口对照表
|
||
|
||
| Step | 名称 | 方法 | 路径 | Auth |
|
||
|------|------|------|------|------|
|
||
| 01 | 查询货源 | GET | `/ntocc-tms-api/order/orderHallList` | Driver |
|
||
| 02 | 接单 | POST | `/ntocc-tms-api/orderDetail/receive` | Driver |
|
||
| 03 | 查询待运输单 | GET | `/ntocc-tms-api/orderDetail` | Driver |
|
||
| 04 | 装货 | PUT | `/ntocc-tms-api/orderDetail/fill` | Driver |
|
||
| 05 | 卸货 | PUT | `/ntocc-tms-api/orderDetail/uploadTicketImage` | Driver |
|
||
| 06 | 运费核算查询运单 | GET | `/ntocc-tms-api/orderDetail/orderDetailHandlePageList` | Admin |
|
||
| 07 | 查询运单详情 | POST | `/ntocc-tms-api/orderDetail/getOrderDetailExpensesParamList` | Admin |
|
||
| 08 | 核算试算 | PUT | `/ntocc-tms-api/orderDetail/calculateOrderDetail` | Admin |
|
||
| 09 | 核算提交 | PUT | `/ntocc-tms-api/orderDetail/orderHandleEditSubmitHandle` | Admin |
|
||
| 10 | 查询运单审核 | GET | `/ntocc-basic-api/dytBusiness/orderDetail` | Admin |
|
||
| 11 | 核算审核通过 | POST | `/ntocc-tms-api/orderDetail/auditOrderDetail` | Admin |
|
||
| 12 | 单油卡充值 | POST | `/ntocc-tms-api/finance/singleOil` | Admin |
|
||
| 13 | 垫资-财务打款 | POST | `/ntocc-tms-api/arpaTransfer/payToDriver` | Admin |
|
||
| 14 | 垫资-货主打款 | POST | `/ntocc-tms-api/orderDetail/applicationForPayment` | Admin |
|
||
| 15 | 查询运单上传 | GET | `/ntocc-basic-api/dytBusiness/orderDetail?status=5` | Admin |
|
||
| 16 | 查询打款记录 | GET | `/ntocc-tms-api/remitDefinite` | Admin |
|
||
| 17 | 查询文件名前缀 | GET | `/ntocc-tms-api/centralizedPayment/downLoadElectronicReceipt` | Admin |
|
||
| 18 | 上报运单 | POST | `/ntocc-basic-api/dytBusiness/reportOrderDetail` | Admin |
|
||
| — | SQL INSERT | — | `ntocc.base_gd_mft_file` | — |
|
||
| 22 | ETC 开票信息写入 | SQL INSERT | — | `ntocc.base_etc_invoice` | — |
|
||
| 23 | ETC 推送记录写入 | SQL INSERT | — | `ntocc.tms_order_etc_push` | — |
|
||
|
||
> 步骤 22/23 的 `order_code`/`order_no` 取步骤 03 的 `orderCode`，`push_order_no` 为其后追加 `-1`，`order_detail_code` 取步骤 03 的 `code`，两个表的 `code` 按现有数据规则（32 位十六进制）自动生成，随 receipt 阶段执行（`--dry-run` 仅预览不写库）。
|