WuYongJie/CaiWuXiTong
1
0
Fork 0
Code Issues Pull Requests 2 Packages Projects Releases Wiki Activity

附加费结算导入核验：只填单号+类型，自动匹配快递并按报价核算 #391

Merged
zhoushengchen merged 1 commits from feature/zhoushengchen-settlement-import-auto-quote into main 2026-10-19 16:44:51 +08:00
Conversation 0 Commits 1 Files Changed 5 +820 -25
zhoushengchen commented 2026-10-19 16:44:47 +08:00
Collaborator
Copy Link

变更内容

  • 导入模板改为只含「单号」「附加费类型」（「金额」仍可选，用于差异对比），不再要求填「快递名称」。
  • 没有结算行时按单号自动核算：
    • 超长费：按单号回销售出库单（JianSun）取实际快递、明细与商品资料长宽高，匹配启用的超长费规则（阈值/单价），命中则正常结，未超阈值给出不结原因；
    • 退回费/拦截费：按单号复用查件扣单上下文（快递、扣单类型、商品、退货进仓），按固定单价/按重量规则核算；未退回计 0 并给出原因。
  • 已匹配结算行的行仍以结算表为准；取不到上下文时保留原有的不结原因兜底。
  • 批量防护：超长费单号回查上限 200 个、扣单上下文上限 100 个，均分批查询。

修改文件

  • app/Http/Controllers/Business/Pages.php
  • modules/EcommerceFinance/Repositories/CourierSurchargeSettlementMirrorRepository.php
  • resources/views/business/pages/courier-payables/courier-surcharge-settlement.blade.php
  • tests/Unit/EcommerceFinance/CourierSurchargeSettlementMirrorRepositoryTest.php
  • tests/Feature/Business/CourierSurchargeSettlementPageTest.php

验证

  • 17 项测试 / 145 断言全过（新增超长费与退回/拦截费两条自动核算用例）。
  • 真实数据：单号 DPK301944193544（未生成结算行）自动匹配「常州德邦」、按规则 #42 算出 7 元、正常结；DPK317250463352 自动匹配「曹县德邦小件」、按退回费规则计算，无进仓时正确返回 0/不结。
  • 本地 HTTP 导入实测返回 xlsx：超长费行结算金额 7、快递名称自动带出。

影响范围

  • 无数据库迁移；仅导入核验逻辑、模板与提示文案。
## 变更内容 - 导入模板改为只含「单号」「附加费类型」（「金额」仍可选，用于差异对比），不再要求填「快递名称」。 - 没有结算行时按单号自动核算： - 超长费：按单号回销售出库单（JianSun）取实际快递、明细与商品资料长宽高，匹配启用的超长费规则（阈值/单价），命中则正常结，未超阈值给出不结原因； - 退回费/拦截费：按单号复用查件扣单上下文（快递、扣单类型、商品、退货进仓），按固定单价/按重量规则核算；未退回计 0 并给出原因。 - 已匹配结算行的行仍以结算表为准；取不到上下文时保留原有的不结原因兜底。 - 批量防护：超长费单号回查上限 200 个、扣单上下文上限 100 个，均分批查询。 ## 修改文件 - app/Http/Controllers/Business/Pages.php - modules/EcommerceFinance/Repositories/CourierSurchargeSettlementMirrorRepository.php - resources/views/business/pages/courier-payables/courier-surcharge-settlement.blade.php - tests/Unit/EcommerceFinance/CourierSurchargeSettlementMirrorRepositoryTest.php - tests/Feature/Business/CourierSurchargeSettlementPageTest.php ## 验证 - 17 项测试 / 145 断言全过（新增超长费与退回/拦截费两条自动核算用例）。 - 真实数据：单号 DPK301944193544（未生成结算行）自动匹配「常州德邦」、按规则 #42 算出 7 元、正常结；DPK317250463352 自动匹配「曹县德邦小件」、按退回费规则计算，无进仓时正确返回 0/不结。 - 本地 HTTP 导入实测返回 xlsx：超长费行结算金额 7、快递名称自动带出。 ## 影响范围 - 无数据库迁移；仅导入核验逻辑、模板与提示文案。
zhoushengchen added 1 commit 2026-10-19 16:44:48 +08:00
zhoushengchen merged commit 528701fdec into main 2026-10-19 16:44:51 +08:00
zhoushengchen deleted branch feature/zhoushengchen-settlement-import-auto-quote 2026-10-19 16:44:53 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aaron chenxi DoDo jj404877757 limeng qiuxiang renshen shanshi sumu wangshu yueyang yutu zhoushengchen WuYongJie
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#391
No description provided.
Delete Branch "feature/zhoushengchen-settlement-import-auto-quote"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?