Files
shanxia2.0/backend/app/services/pl_freight_settlement_service.py
T
2026-06-25 08:06:32 +08:00

862 lines
27 KiB
Python

"""运费结算业务服务"""
from __future__ import annotations
import json
from datetime import date, datetime
from decimal import Decimal
from typing import Any, Dict, List, Optional, Tuple
from fastapi import HTTPException
from sqlalchemy import func, or_
from sqlalchemy.orm import Session
from app.core.utils import generate_uuid
from app.models.models import SysUser
from app.models.pl_models import (
PlFreightSettlement,
PlFreightSettlementApproval,
PlFreightSettlementTransport,
PlPlan,
PlRemittanceVoucher,
PlTransport,
)
from app.schemas.pl.freight import (
FreightSettlementDisburseBody,
FreightSettlementSubmitApprovalBody,
FreightSettlementUpdate,
)
_FMT = "%Y-%m-%d %H:%M:%S"
TAB_STATUS_MAP = {
"bills": ("pending", "approving"),
"disburse": ("approved",),
"settled": ("confirmed",),
}
def _resolve_user_display_name(db: Session, user_id: str) -> str:
uid = (user_id or "").strip()
if not uid:
return ""
u = db.query(SysUser).filter(SysUser.id == uid, SysUser.del_flag == 0).first()
if not u:
return ""
return (u.nick_name or u.user_no or "").strip()
def _occupied_transport_ids_subquery(db: Session, tenant_no: str):
return (
db.query(PlFreightSettlementTransport.transport_id)
.join(
PlFreightSettlement,
PlFreightSettlement.id == PlFreightSettlementTransport.settlement_id,
)
.filter(
PlFreightSettlementTransport.tenant_no == tenant_no,
PlFreightSettlementTransport.del_flag == 0,
PlFreightSettlement.tenant_no == tenant_no,
PlFreightSettlement.del_flag == 0,
)
)
def get_settlement_row(db: Session, tenant_no: str, settlement_id: str) -> PlFreightSettlement:
row = (
db.query(PlFreightSettlement)
.filter(
PlFreightSettlement.id == settlement_id,
PlFreightSettlement.tenant_no == tenant_no,
PlFreightSettlement.del_flag == 0,
)
.first()
)
if not row:
raise HTTPException(status_code=404, detail="结算单不存在")
return row
def list_unsettled_plans(
db: Session,
*,
tenant_no: str,
q: Optional[str] = None,
plan_type: Optional[str] = None,
license_plate: Optional[str] = None,
page: int = 1,
page_size: int = 20,
) -> Tuple[int, List[Dict[str, Any]]]:
occupied = _occupied_transport_ids_subquery(db, tenant_no).subquery()
query = (
db.query(PlPlan, PlTransport)
.join(PlTransport, PlTransport.id == PlPlan.transport_id)
.filter(
PlPlan.tenant_no == tenant_no,
PlPlan.del_flag == 0,
PlPlan.archive_status == "archived",
PlPlan.has_freight == 1,
PlPlan.follow_status != "cancelled",
PlPlan.transport_id.isnot(None),
PlTransport.del_flag == 0,
PlTransport.freight_amount > 0,
~PlPlan.transport_id.in_(occupied),
)
)
if q:
query = query.filter(
or_(
PlPlan.plan_no.contains(q),
PlPlan.customer_name.contains(q),
PlPlan.supplier_name.contains(q),
)
)
if plan_type:
query = query.filter(PlPlan.plan_type == plan_type)
if license_plate:
query = query.filter(PlPlan.license_plate.contains(license_plate))
total = query.count()
rows = (
query.order_by(PlPlan.update_time.desc())
.offset((page - 1) * page_size)
.limit(page_size)
.all()
)
items: List[Dict[str, Any]] = []
for plan, transport in rows:
items.append(
{
"id": plan.id,
"planNo": plan.plan_no,
"planDate": plan.plan_date,
"planType": plan.plan_type,
"customerName": plan.customer_name,
"supplierName": plan.supplier_name,
"licensePlate": plan.license_plate or transport.license_plate,
"transportCompany": transport.carrier_name,
"freightAmount": plan.freight_amount or transport.freight_amount,
"archiveTime": plan.update_time,
}
)
return total, items
def _resolve_transports_for_create(
db: Session, tenant_no: str, *, plan_ids: Optional[List[str]], transport_ids: Optional[List[str]]
) -> List[PlTransport]:
ids: List[str] = []
if plan_ids:
plans = (
db.query(PlPlan)
.filter(
PlPlan.id.in_(plan_ids),
PlPlan.tenant_no == tenant_no,
PlPlan.del_flag == 0,
)
.all()
)
if len(plans) != len(set(plan_ids)):
raise HTTPException(status_code=400, detail="存在无效的计划")
for p in plans:
if p.archive_status != "archived":
raise HTTPException(status_code=400, detail=f"计划 {p.plan_no} 未归档,不能结算")
if int(p.has_freight or 0) != 1:
raise HTTPException(status_code=400, detail=f"计划 {p.plan_no} 无运输费用")
if not p.transport_id:
raise HTTPException(status_code=400, detail=f"计划 {p.plan_no} 未安排运输")
ids.append(p.transport_id)
if transport_ids:
ids.extend(transport_ids)
ids = list(dict.fromkeys(ids))
if not ids:
raise HTTPException(status_code=400, detail="请选择有效的运输单")
occupied = {r[0] for r in _occupied_transport_ids_subquery(db, tenant_no).all()}
conflict = [tid for tid in ids if tid in occupied]
if conflict:
raise HTTPException(status_code=400, detail="所选运输单已纳入其他结算单")
transports = (
db.query(PlTransport)
.filter(
PlTransport.id.in_(ids),
PlTransport.tenant_no == tenant_no,
PlTransport.del_flag == 0,
)
.all()
)
if len(transports) != len(ids):
raise HTTPException(status_code=400, detail="请选择有效的运输单")
return transports
def create_settlement(
db: Session,
*,
tenant_no: str,
plan_ids: Optional[List[str]],
transport_ids: Optional[List[str]],
user_id: str,
dept_id: str,
settlement_no: str,
) -> PlFreightSettlement:
transports = _resolve_transports_for_create(
db, tenant_no, plan_ids=plan_ids, transport_ids=transport_ids
)
total_freight = sum(Decimal(str(t.freight_amount or 0)) for t in transports)
settlement = PlFreightSettlement(
id=generate_uuid(),
tenant_no=tenant_no,
settlement_no=settlement_no,
total_freight=total_freight,
settlement_status="pending",
create_by=user_id,
create_dept_id=dept_id or "",
)
db.add(settlement)
for t in transports:
db.add(
PlFreightSettlementTransport(
id=generate_uuid(),
tenant_no=tenant_no,
settlement_id=settlement.id,
transport_id=t.id,
freight_amount=t.freight_amount,
create_by=user_id,
create_dept_id=dept_id or "",
)
)
db.commit()
db.refresh(settlement)
return settlement
def delete_draft_settlement(db: Session, *, tenant_no: str, settlement_id: str, user_id: str) -> None:
settlement = get_settlement_row(db, tenant_no, settlement_id)
if settlement.settlement_status != "pending":
raise HTTPException(status_code=400, detail="仅草稿结算单可删除")
now = datetime.now()
settlement.del_flag = 1
settlement.update_by = user_id
settlement.update_time = now
links = (
db.query(PlFreightSettlementTransport)
.filter(
PlFreightSettlementTransport.settlement_id == settlement_id,
PlFreightSettlementTransport.del_flag == 0,
)
.all()
)
for link in links:
link.del_flag = 1
link.update_time = now
db.commit()
def _get_transport_ids(db: Session, settlement_id: str) -> List[str]:
return [
r.transport_id
for r in db.query(PlFreightSettlementTransport)
.filter(
PlFreightSettlementTransport.settlement_id == settlement_id,
PlFreightSettlementTransport.del_flag == 0,
)
.all()
]
def _get_plans_for_transports(db: Session, tenant_no: str, transport_ids: List[str]) -> List[PlPlan]:
if not transport_ids:
return []
return (
db.query(PlPlan)
.filter(
PlPlan.tenant_no == tenant_no,
PlPlan.del_flag == 0,
PlPlan.transport_id.in_(transport_ids),
)
.all()
)
def _approval_to_dict(row: PlFreightSettlementApproval) -> Dict[str, Any]:
return {
"id": row.id,
"step": row.step,
"stepName": row.step_name,
"approverId": row.approver_id,
"approverName": row.approver_name,
"approvalType": row.approval_type,
"approvalResult": row.approval_result,
"approvalOpinion": row.approval_opinion,
"approvalTime": row.approval_time,
"isCurrent": row.is_current,
}
def create_settlement_approval_records(
db: Session,
*,
tenant_no: str,
settlement_id: str,
approval_type: str,
approver_ids: List[str],
user_id: str,
dept_id: str,
) -> None:
approval_type = (approval_type or "sequential").strip() or "sequential"
cleaned = [aid.strip() for aid in approver_ids if (aid or "").strip()]
if not cleaned:
raise HTTPException(status_code=400, detail="请选择审批人")
if approval_type in ("parallel", "or"):
step = 1
for idx, aid in enumerate(cleaned):
nick = _resolve_user_display_name(db, aid) or f"用户{aid}"
db.add(
PlFreightSettlementApproval(
id=generate_uuid(),
settlement_id=settlement_id,
step=step,
step_name="会签审批" if approval_type == "parallel" else "或签审批",
approver_id=aid,
approver_name=nick,
approval_type=approval_type,
approval_result="pending",
is_current=1,
tenant_no=tenant_no,
create_by=user_id,
create_dept_id=dept_id or "",
)
)
else:
step = 1
for idx, aid in enumerate(cleaned):
nick = _resolve_user_display_name(db, aid) or f"用户{aid}"
db.add(
PlFreightSettlementApproval(
id=generate_uuid(),
settlement_id=settlement_id,
step=step,
step_name=f"第{step}步审批",
approver_id=aid,
approver_name=nick,
approval_type="sequential",
approval_result="pending",
is_current=1 if idx == 0 else 0,
tenant_no=tenant_no,
create_by=user_id,
create_dept_id=dept_id or "",
)
)
step += 1
db.flush()
def can_user_approve_settlement(db: Session, settlement_id: str, user_id: str) -> bool:
if not settlement_id or not user_id:
return False
approvals = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.del_flag == 0,
)
.order_by(PlFreightSettlementApproval.step.asc())
.all()
)
if not approvals:
return False
user_approval = next((a for a in approvals if a.approver_id == user_id), None)
if not user_approval or user_approval.approval_result != "pending" or user_approval.is_current != 1:
return False
approval_type = user_approval.approval_type or "sequential"
if approval_type == "sequential":
for approval in approvals:
if approval.step == user_approval.step:
break
if approval.approval_result != "approved":
return False
return True
def _settlement_all_approved(db: Session, settlement_id: str) -> bool:
pending = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.approval_result == "pending",
PlFreightSettlementApproval.del_flag == 0,
)
.count()
)
return pending == 0
def _advance_after_approval(
db: Session, settlement: PlFreightSettlement, current: PlFreightSettlementApproval, result: str
) -> None:
now = datetime.now()
if result == "rejected":
settlement.settlement_status = "pending"
settlement.update_time = now
return
approval_type = current.approval_type or "sequential"
step = current.step
if approval_type == "or":
others = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement.id,
PlFreightSettlementApproval.step == step,
PlFreightSettlementApproval.id != current.id,
PlFreightSettlementApproval.del_flag == 0,
)
.all()
)
for row in others:
if row.approval_result == "pending":
row.approval_result = "skipped"
row.is_current = 0
row.update_time = now
elif approval_type == "parallel":
step_pending = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement.id,
PlFreightSettlementApproval.step == step,
PlFreightSettlementApproval.approval_result == "pending",
PlFreightSettlementApproval.del_flag == 0,
)
.count()
)
if step_pending > 0:
return
else:
nxt = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement.id,
PlFreightSettlementApproval.approval_result == "pending",
PlFreightSettlementApproval.step > step,
PlFreightSettlementApproval.del_flag == 0,
)
.order_by(PlFreightSettlementApproval.step.asc())
.first()
)
if nxt:
nxt.is_current = 1
nxt.update_time = now
return
if _settlement_all_approved(db, settlement.id):
settlement.settlement_status = "approved"
settlement.update_time = now
def submit_settlement_approval(
db: Session,
*,
tenant_no: str,
settlement_id: str,
body: FreightSettlementSubmitApprovalBody,
user_id: str,
dept_id: str,
) -> PlFreightSettlement:
settlement = get_settlement_row(db, tenant_no, settlement_id)
if settlement.settlement_status != "pending":
raise HTTPException(status_code=400, detail="仅草稿状态可提交审批")
settlement.settlement_status = "approving"
if body.remark:
settlement.remark = body.remark
settlement.update_by = user_id
db.flush()
create_settlement_approval_records(
db,
tenant_no=tenant_no,
settlement_id=settlement_id,
approval_type=body.approval_type,
approver_ids=body.approver_ids,
user_id=user_id,
dept_id=dept_id,
)
db.commit()
db.refresh(settlement)
return settlement
def process_settlement_approval(
db: Session,
*,
tenant_no: str,
approval_id: str,
action: str,
comment: Optional[str],
user_id: str,
) -> PlFreightSettlement:
approval = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.id == approval_id,
PlFreightSettlementApproval.tenant_no == tenant_no,
PlFreightSettlementApproval.del_flag == 0,
)
.first()
)
if not approval:
raise HTTPException(status_code=404, detail="审批记录不存在")
settlement = get_settlement_row(db, tenant_no, approval.settlement_id)
if settlement.settlement_status != "approving":
raise HTTPException(status_code=400, detail="结算单不在审批中")
if approval.approver_id != user_id:
raise HTTPException(status_code=403, detail="只有审批人才能审批")
if not can_user_approve_settlement(db, settlement.id, user_id):
raise HTTPException(status_code=400, detail="当前不可审批")
result = "approved" if action == "approve" else "rejected"
now = datetime.now()
approval.approval_result = result
approval.approval_opinion = comment or ""
approval.approval_time = now
approval.is_current = 0
approval.update_by = user_id
approval.update_time = now
_advance_after_approval(db, settlement, approval, result)
settlement.update_by = user_id
db.commit()
db.refresh(settlement)
return settlement
def withdraw_settlement_approval(
db: Session, *, tenant_no: str, settlement_id: str, user_id: str
) -> PlFreightSettlement:
settlement = get_settlement_row(db, tenant_no, settlement_id)
if settlement.settlement_status != "approving":
raise HTTPException(status_code=400, detail="仅审批中可撤回")
if settlement.create_by != user_id:
raise HTTPException(status_code=403, detail="仅提交人可撤回")
now = datetime.now()
rows = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.del_flag == 0,
)
.all()
)
for row in rows:
row.del_flag = 1
row.update_time = now
settlement.settlement_status = "pending"
settlement.update_by = user_id
settlement.update_time = now
db.commit()
db.refresh(settlement)
return settlement
def disburse_settlement(
db: Session,
*,
tenant_no: str,
settlement_id: str,
body: FreightSettlementDisburseBody,
user_id: str,
dept_id: str,
) -> PlFreightSettlement:
settlement = get_settlement_row(db, tenant_no, settlement_id)
if settlement.settlement_status != "approved":
raise HTTPException(status_code=400, detail="仅待发放状态可登记")
total = Decimal(str(settlement.total_freight or 0))
amount = Decimal(str(body.remittance_amount))
if amount != total and not (body.remark or "").strip():
raise HTTPException(status_code=400, detail="汇款金额与运费合计不一致时备注必填")
db.add(
PlRemittanceVoucher(
id=generate_uuid(),
tenant_no=tenant_no,
settlement_id=settlement.id,
remittance_date=body.remittance_date,
remittance_amount=body.remittance_amount,
voucher_urls=json.dumps(body.voucher_urls),
remark=body.remark,
create_by=user_id,
create_dept_id=dept_id or "",
)
)
settlement.settlement_status = "confirmed"
settlement.update_by = user_id
db.commit()
db.refresh(settlement)
return settlement
def get_approval_flow(db: Session, settlement_id: str) -> List[Dict[str, Any]]:
rows = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.del_flag == 0,
)
.order_by(PlFreightSettlementApproval.step.asc(), PlFreightSettlementApproval.create_time.asc())
.all()
)
return [_approval_to_dict(r) for r in rows]
def _current_approver_name(db: Session, settlement_id: str) -> Optional[str]:
row = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.approval_result == "pending",
PlFreightSettlementApproval.is_current == 1,
PlFreightSettlementApproval.del_flag == 0,
)
.order_by(PlFreightSettlementApproval.step.asc())
.first()
)
return row.approver_name if row else None
def _current_approval_id(db: Session, settlement_id: str, user_id: str) -> Optional[str]:
if not can_user_approve_settlement(db, settlement_id, user_id):
return None
row = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.approver_id == user_id,
PlFreightSettlementApproval.approval_result == "pending",
PlFreightSettlementApproval.is_current == 1,
PlFreightSettlementApproval.del_flag == 0,
)
.first()
)
return row.id if row else None
def _last_approval_time(db: Session, settlement_id: str) -> Optional[datetime]:
row = (
db.query(PlFreightSettlementApproval)
.filter(
PlFreightSettlementApproval.settlement_id == settlement_id,
PlFreightSettlementApproval.approval_result == "approved",
PlFreightSettlementApproval.del_flag == 0,
)
.order_by(PlFreightSettlementApproval.approval_time.desc())
.first()
)
return row.approval_time if row else None
def enrich_settlement_list_item(
db: Session, settlement: PlFreightSettlement, user_id: str
) -> Dict[str, Any]:
transport_ids = _get_transport_ids(db, settlement.id)
plans = _get_plans_for_transports(db, settlement.tenant_no, transport_ids)
plates = [p.license_plate for p in plans if p.license_plate]
if not plates:
transports = (
db.query(PlTransport)
.filter(PlTransport.id.in_(transport_ids), PlTransport.del_flag == 0)
.all()
if transport_ids
else []
)
plates = [t.license_plate for t in transports if t.license_plate]
voucher = (
db.query(PlRemittanceVoucher)
.filter(
PlRemittanceVoucher.settlement_id == settlement.id,
PlRemittanceVoucher.del_flag == 0,
)
.order_by(PlRemittanceVoucher.create_time.desc())
.first()
)
submitter = _resolve_user_display_name(db, settlement.create_by or "")
item = {
"id": settlement.id,
"settlementNo": settlement.settlement_no,
"totalFreight": settlement.total_freight,
"invoiceAmount": settlement.invoice_amount,
"invoiceNo": settlement.invoice_no,
"invoiceDate": settlement.invoice_date,
"settlementStatus": settlement.settlement_status,
"remark": settlement.remark,
"tenantNo": settlement.tenant_no,
"orderNum": settlement.order_num,
"createBy": settlement.create_by,
"createDeptId": settlement.create_dept_id,
"createTime": settlement.create_time,
"updateBy": settlement.update_by,
"updateTime": settlement.update_time,
"delFlag": settlement.del_flag,
"planCount": len(plans),
"licensePlateSummary": "、".join(plates[:3]) + ("…" if len(plates) > 3 else ""),
"currentApproverName": _current_approver_name(db, settlement.id),
"canApprove": can_user_approve_settlement(db, settlement.id, user_id),
"canWithdraw": settlement.settlement_status == "approving" and settlement.create_by == user_id,
"currentApprovalId": _current_approval_id(db, settlement.id, user_id),
"approvalFinishedTime": _last_approval_time(db, settlement.id),
"disburseTime": voucher.create_time if voucher else None,
"disburseAmount": voucher.remittance_amount if voucher else None,
"submitterName": submitter or None,
}
return item
def list_settlements_enriched(
db: Session,
*,
tenant_no: str,
user_id: str,
q: Optional[str] = None,
settlement_status: Optional[str] = None,
tab: Optional[str] = None,
page: int = 1,
page_size: int = 20,
) -> Tuple[int, List[Dict[str, Any]]]:
query = db.query(PlFreightSettlement).filter(
PlFreightSettlement.tenant_no == tenant_no,
PlFreightSettlement.del_flag == 0,
)
if tab and tab in TAB_STATUS_MAP:
query = query.filter(PlFreightSettlement.settlement_status.in_(TAB_STATUS_MAP[tab]))
elif settlement_status:
query = query.filter(PlFreightSettlement.settlement_status == settlement_status)
if q:
query = query.filter(PlFreightSettlement.settlement_no.contains(q))
total = query.count()
rows = (
query.order_by(PlFreightSettlement.create_time.desc())
.offset((page - 1) * page_size)
.limit(page_size)
.all()
)
return total, [enrich_settlement_list_item(db, r, user_id) for r in rows]
def get_settlement_detail(
db: Session, *, tenant_no: str, settlement_id: str, user_id: str
) -> Dict[str, Any]:
settlement = get_settlement_row(db, tenant_no, settlement_id)
base = enrich_settlement_list_item(db, settlement, user_id)
transport_ids = _get_transport_ids(db, settlement_id)
transports = (
db.query(PlTransport)
.filter(PlTransport.id.in_(transport_ids), PlTransport.del_flag == 0)
.all()
if transport_ids
else []
)
plans = _get_plans_for_transports(db, tenant_no, transport_ids)
plan_summaries = [
{
"id": p.id,
"planNo": p.plan_no,
"planDate": p.plan_date,
"licensePlate": p.license_plate,
"freightAmount": p.freight_amount,
}
for p in plans
]
vouchers = (
db.query(PlRemittanceVoucher)
.filter(
PlRemittanceVoucher.settlement_id == settlement_id,
PlRemittanceVoucher.del_flag == 0,
)
.order_by(PlRemittanceVoucher.create_time.desc())
.all()
)
transport_payload = []
for t in transports:
transport_payload.append(
{
"id": t.id,
"transportNo": t.transport_no,
"licensePlate": t.license_plate,
"driverName": t.driver_name,
"freightAmount": t.freight_amount,
"transportStatus": t.transport_status,
"carrierName": t.carrier_name,
}
)
voucher_payload = []
for v in vouchers:
voucher_payload.append(
{
"id": v.id,
"settlementId": v.settlement_id,
"remittanceDate": v.remittance_date,
"remittanceAmount": v.remittance_amount,
"voucherUrls": v.voucher_urls,
"remark": v.remark,
"createBy": v.create_by,
"createTime": v.create_time,
}
)
base["transports"] = transport_payload
base["plans"] = plan_summaries
base["approvalFlow"] = get_approval_flow(db, settlement_id)
base["vouchers"] = voucher_payload
return base
def update_settlement_draft(
db: Session,
*,
tenant_no: str,
settlement_id: str,
payload: FreightSettlementUpdate,
user_id: str,
) -> PlFreightSettlement:
settlement = get_settlement_row(db, tenant_no, settlement_id)
if settlement.settlement_status != "pending":
raise HTTPException(status_code=400, detail="仅草稿可编辑")
update_data = payload.model_dump(exclude_unset=True, by_alias=False)
for key, value in update_data.items():
setattr(settlement, key, value)
settlement.update_by = user_id
db.commit()
db.refresh(settlement)
return settlement