Files
QaAutomationHub/requirements/安徽运八需求.md
T
xst acdb441507 feat: /qe-fleet run 安徽运八需求 + 系统坑修复
系统修复:
- fleet_runner.py: Windows UTF-8 编码兼容(reconfigure stdout/stderr)
- fleet_runner.py: run 命令自动生成合并清单供导出使用
- fleet_manifest.py: 新增 save_merged_manifest() 保存统一清单
- fleet_config.yml: 修复 YAML keywords 格式(block sequence → flow sequence)
- 恢复被误删的知识库文件(payment_flow_cases, marketing_activity_cases)

QE Fleet 产物 (安徽运八需求):
- 153个测试点 + 53条可执行测试用例
- 需求分析/风险评估/测试策略/质量裁决(PASS)
- Excel 导出 + 版本快照 v2
- 确认结论文件已归档
2026-07-13 09:49:54 +08:00

175 lines
14 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.
# 安徽运八需求
> 文档角色:正式维护版需求
> 原始来源:`source_docs\requirements_raw\安徽运八需求.docx`
> 标准化来源:`output\normalized_inputs\安徽运八需求\requirement.md`
> 输入类型:`docx`
## 维护信息
- 当前维护文件:`requirements\安徽运八需求.md`
- 最近维护说明:暂无
## 技术方案来源
- 未关联技术方案
## 正式维护内容
安徽运八需求
一、需求概述
根据国家税务总局及交通运输部对网络货运平台合规的监管要求,平台需将运单相关数据分阶段上报至省级网络货运信息监测系统(安徽运八)。上报分为三个阶段:装货完成上报、打款完成上报、开票完成上报,以及ETC发票上传。本功能模块旨在实现上报流程的自动化管理,并提供异常监控与向平台发起申诉的能力。
二、功能说明
2.1 上报运单看板
· 功能描述
上报运单看板是系统的首页,集中展示所有上报阶段运单的汇总状态,支持按条件筛选、查看详情和发起申诉。
· 查询条件
运单号/托运单号/货源单号:模糊搜索
上报阶段:全部 / 第一次上报 / 第二次上报 / 第三次上报
核验状态:全部 / 异常 / 通过
申诉状态:全部 / 未申诉 / 申诉中 / 申诉通过 / 申诉驳回
操作按钮:查询、重置、导出
· 列表字段
货源单号、运单号、托运单号、车牌号、司机姓名、
托运方名称、上报阶段、核验状态、申诉状态、异常项、
货物名称、合同金额、最新核验时间、操作(申诉/进度/详情)
2.2 第一次上报(装货完成)
功能描述
第一次上报在运单装货完成后自动触发,上报数据包含运单信息、托运方信息、收货方信息、司机信息、车辆信息、货物信息、保险信息等。
特殊说明
• 上报完成后,若安徽运八平台核验通过,系统会自动调用“修改第一次上报部分字段”接口,更新装货后可能发生变化的字段(如实际里程),无需人工干预。
• 若上报失败,系统需要自动重试(最多3次),若仍失败则通过系统站内信或者其他方式通知运营人员。
• 第一次上传是后续两次上传的基础,若失败会导致后续上报无法进行,需重点关注。
上报状态规则
| 状态 | 说明 | 操作按钮 | 标签颜色 |
| 上传中 | 数据正在上报中 | 无 | 蓝色 |
| 已上传 | 上报成功 | 无 | 绿色 |
| 上传失败 | 上报超时 | 手动上传 | 红色 |
| 异常 | 数据校验不通过 | 详情查看异常原因 | 橙色 |
列表字段
货源单号、运单号、托运单号、车牌号、司机姓名、托运方名称、业务类型、货物名称、装货地址、卸货地址、运输里程、合同编号、上报状态、操作(详情)
详情弹窗字段分组
详情弹窗按以下子对象分组展示:
建单信息(必选,13字段):上游企业委托运输单号、本运单单号、托运人建单时间、网络货运经营者名称、统一社会信用代码、道路运输经营许可证编号、业务类型代码、运输组货方式代码、司机接单时间、司机起运时间、承运合同编号、委托合同编号(可选)、运输里程(可选)
托运人信息(必选,7字段):托运人名称、托运人统一社会信用代码、框架合同编号(可选)、装货地点、装货经度、装货纬度、装货地行政区划代码
收货方信息(必选,5字段):收货方名称、收货方统一社会信用代码/身份证号、收货地点、收货经度、收货纬度
司机信息(必选,13字段):司机姓名、身份证号、驾驶证号、驾驶证发证机关、从业资格证号、从业资格证有效期起、从业资格证有效期至、税务登记证号、手机号、驾驶证有效期起、驾驶证有效期至、准驾车型、省份代码
接单车辆信息(必选,19字段):车牌号、车牌颜色编码、号牌种类、车辆识别代号VIN)、车主姓名/单位名称、车主证件号、使用性质、车辆类型、能源类型、注册日期、发证日期、发证机关、核定载质量吨)、总质量吨)、道路运输证号、挂车牌照号(可选)、行驶证档案编号(可选)、道路运输证有效期起(可选)、道路运输证有效期至(可选)
货物信息(必选,可多条,4字段):货物名称、货物类型代码、货物量、计量单位
保险信息(可选,2字段):保险单号、保险公司名称
异常信息:核验状态、异常原因、异常时间、处理状态
2.3 第二次上报(打款完成)
功能描述
第二次上报在运费支付完成后系统自动触发,上报数据包含运抵信息、货主资金流水、承运人资金流水、承运合同信息、委托合同信息、车辆轨迹信息等。
特殊说明
• 第二次上传核验项最多,是最容易出现异常的环节,需要重点关注。
• 若资金流水单号重复,会导致上报失败,系统会自动检查并提示。
• 车辆轨迹点位数量不足或偏差过大,会导致"车辆轨迹合规"核验异常,可通过"补传轨迹"功能补充轨迹数据。
• 若上报失败,系统会自动重试(最多3次),若仍失败则告警通知运营人员。
列表字段
货源单号、运单号、托运单号、车牌号、司机姓名、托运方名称、承运运费、总金额、付款方式、付款时间、收款人、收款账号、收款账号类型、核验状态、异常项、上报状态、操作(上报/详情)
收款账号类型说明
• 个人账户:司机个人银行卡账号,标签为蓝色
• 对公账户:企业银行账号,标签为绿色
详情弹窗字段分组
1)运单信息(必选):同第一次上报
(2)托运方信息(必选):同第一次上报
(3)收货方信息(必选):同第一次上报
(4)资金流水信息(必选):支付金额、支付方式、支付时间、付款方名称、收款方名称、收款人、收款账号、收款账号类型、流水号、支付状态
(5)车辆轨迹信息(必选,可多条,2~2000个点):定位类型、定位时间、定位地点、经度、纬度、轨迹类型
(6)异常信息:核验状态、异常原因、异常时间、处理状态
核验内容(监管平台自动核验,异常时可发起申诉)
| 核验项 | 说明 |
| 运单重复核验 | 检查同一运单是否重复上报 |
| 车辆资质核验 | 检查车辆道路运输证是否在有效期内 |
| 司机资质核验 | 检查司机从业资格证是否在有效期内 |
| 集中支付核验 | 检查资金流水是否通过网货平台集中支付 |
| 资金流水核验 | 检查资金流水单号是否重复、金额是否匹配 |
| 合同核验 | 检查运输合同和委托合同是否有效 |
| 车辆轨迹合规核验 | 检查车辆轨迹是否真实、与运单路线是否匹配 |
2.4 第三次上报(开票完成)
功能描述
第三次上报在发票开具完成后触发,上报数据包含运单信息(托运单号数组)、发票信息、油气发票信息等。
特殊说明
• 第三次上传需要在运单完成第二次上传后方可进行。
• 若增值税发票验证失败,会导致上报失败,需检查发票信息是否正确。
• 若上报失败,系统会自动重试(最多3次),若仍失败则告警通知运营人员。
列表字段
货源单号、运单号、托运单号、车牌号、司机姓名、托运方名称、发票号码、发票金额、开票日期、核验状态、异常原因、上报状态、操作(详情)
详情弹窗字段分组
1)运单信息(必选):同第一次上报
(2)发票信息(必选,17字段):托运单号数组、发票号码、发票代码号、发票金额价税合计)、开票日期、销售方名称、销售方纳税人识别号、销售方地址、销售方电话、销售方开户行、销售方银行账户、受票方名称、受票方纳税人识别号、受票方地址、受票方电话、受票方开户行、受票方银行卡号
(3)油气发票信息(可选,可多条):油气托运单号、油气发票文件
(4)异常信息:核验状态、异常原因、异常时间、处理状态
2.5 ETC发票上传
功能描述
ETC发票上传用于上报车辆通行高速公路的ETC发票信息,作为税务抵扣凭证。
特殊说明
• ETC发票上传需要在税务抵扣完成后进行,否则会导致上报失败。
• 若ETC发票验证失败,会导致上报失败,需检查发票信息是否正确。
• 若上报失败,系统会自动重试(最多3次),若仍失败则告警通知运营人员。
列表字段
货源单号、运单号、托运单号、车牌号、司机姓名、托运方名称、ETC发票号码、发票金额、税率、上传状态、操作(详情)
详情弹窗字段分组
(1)运单信息:运单号、货源单号、托运单号、车牌号、司机姓名、托运方名称、收货方名称
(2)ETC发票信息(每张发票18字段):ETC发票号码、ETC发票代码、开票时间、发票金额、税率、税额、价税合计、销售方名称、销售方税号、受票方名称、受票方税号、入口收费站、出口收费站、交易时间、交易金额、交易匹配时间、交易流水号、ETC发票文件
(3)异常信息:核验状态、异常原因、异常时间、处理状态
2.6 异常申诉功能
运单完成第二次上传后,安徽省管理平台自动进行 7 大类核验(车辆资质、司机资质、资金流水、合同、轨迹等)。如核验结果为异常时,运营人员可通过申诉机制向平台说明情况并申请重新核验。
本模块补全“异常查询 → 发起申诉 → 跟踪监管平台反馈 → 合规判断”的完整闭环。
当上报数据被核验为异常时,运营人员可发起申诉,向安徽监管平台说明情况并申请重新核验。申诉记录管理页面展示所有申诉记录及省平台反馈结果。
列表字段
运单号、托运单号、车牌号、司机姓名、托运方名称、上报阶段、核验状态、异常项、申诉状态、申诉时间、申诉人、省平台反馈结果、监管平台反馈时间、操作(详情/重新申诉)
详情弹窗字段分组
(1)申诉信息:申诉单号、上报阶段、异常项、申诉原因、申诉状态、申诉时间、申诉人、申诉附件
(2)运单信息:运单号、托运单号、车牌号、司机姓名、托运方名称
(3)异常信息:核验状态、异常原因、异常时间
(4)省平台反馈信息:反馈结果、反馈时间、反馈意见
(5)处理记录:操作人、操作时间、操作类型、操作内容(时间线展示)
申诉复核说明
(注:申诉由安徽监管平台复核,非我方审核)
(复核不通过时,可补充材料后重新发起申诉)
异常代码一览表
2.7 上报日志
功能描述
上报日志记录所有上报接口的调用记录,用于问题排查和审计。
查询条件
• 运单号/托运单号/货源单号:模糊搜索
• 上报阶段:全部 / 第一次上报 / 第二次上报 / 第三次上报 / ETC上传
• 上报结果:全部 / 成功 / 失败
• 开始时间 ~ 结束时间:时间范围筛选
列表字段
序号、货源单号、运单号、托运单号、上报阶段、上报结果、接口URL、HTTP状态码、响应时间、上报时间、操作(弹窗详情查看完整请求/响应报文)
三. 数据字段说明
3.1 第一次上报字段(装货完成)
核心子对象及必选字段:
• waybillInfo(建单信息):originalDocumentNumber、shippingNoteNumber、documentCreateTime、carrier、unifiedSocialCreditIdentifier、permitNumber、businessTypeCode、goodsArrangementTypeCode、orderReceivingTime、departureTime、commercialContractNumber、contractNumber、mileage
• consignorInfo(托运人信息):consignor、consignorId、frameContractNumber、placeOfLoading、loadingLongitude、loadingLatitude、loadingCountrySubdivisionCode
• consigneeInfo(收货方信息):consignee、consigneeId、goodsReceiptPlace、unLoadingLongitude、unLoadingLatitude
• driverInfo(司机信息):driverName、drivingIdNumber、drivingLicense、issuingOrganizations、qualificationCertificate、qualificationCertificateFrom、qualificationCertificateTo、taxRegistrationCertificate、telephone、validPeriodFrom、validPeriodTo、vehicleClass、provinceCode
• carInfo(接单车辆信息):vehicleNumber、vehiclePlateColorCode、LicensePlateTypeCode、vin、owner、ownerId、useCharacter、vehicleType、vehicleEnergyType、registerDate、issueDate、issuingOrganizations、vehicleTonnage、grossMass、roadTransportCertificateNumber、trailerVehiclePlateNumber、vehicleLicenseNumbe、roadTransportSocialCreditFrom、roadTransportSocialCreditTo
• goodsInfos(货物信息,可多条):descriptionOfGoods、cargoTypeClassificationCode、quantity、unit
• insuranceInformation(保险信息,可选):policyNumber、insuranceCompany
3.2 第二次上报字段(打款完成)
新增字段说明:
• 收款人(自定义扩展字段):对应资金流水中的收款方名称recipient)
• 收款账号(自定义扩展字段):对应资金流水中的收款账号receiptAccount)
• 收款账号类型(自定义扩展字段):个人账户 / 对公账户,为我方自定义列
3.3 第三次上报字段(开票完成)
核心字段:
• 发票号码(invoiceNo):增值税发票号码
• 发票代码(invoiceCode):增值税发票代码
• 发票金额(invoiceAmount):价税合计(保留2位小数)
(注:第三次上传的invoice无税率字段,税率仅出现在ETC发票上传中)
• 销售方名称(sellerName):开票方企业名称
• 受票方名称(buyerName):托运人/货主企业名称
3.4 ETC发票字段
核心字段:
• ETC发票号码(etcInvoiceNo):高速公路通行费电子发票号码
• 入口收费站(entryStation):通行入口
• 出口收费站(exitStation):通行出口
• 税额(taxAmount):可抵扣税额(税率3%)
详细数据接口字段请查阅上报接口:
https://www.showdoc.com.cn/2210641821476236/9919735893682511
密码:szjj@2023
原型:
接口文档: