Files
shanxia2.0/backend/app/schemas/pl/freight.py
T
2026-06-21 09:19:07 +08:00

107 lines
4.7 KiB
Python

"""运输计划管理 - 运费结算 Schema"""
from datetime import date, datetime
from decimal import Decimal
from typing import Optional
from pydantic import BaseModel, Field
# =============================================================================
# 运费结算 Schema
# =============================================================================
class FreightSettlementBase(BaseModel):
total_freight: Decimal = Field(default=Decimal("0.00"), alias="totalFreight", description="运费合计")
invoice_amount: Optional[Decimal] = Field(default=None, alias="invoiceAmount", description="发票金额")
invoice_no: Optional[str] = Field(default=None, max_length=50, alias="invoiceNo", description="发票号")
invoice_date: Optional[date] = Field(default=None, alias="invoiceDate", description="开票日期")
settlement_status: str = Field(default="pending", alias="settlementStatus", description="结算状态")
remark: Optional[str] = None
class FreightSettlementCreate(BaseModel):
transport_ids: list[str] = Field(..., alias="transportIds", description="运输ID列表")
model_config = {"populate_by_name": True}
class FreightSettlementUpdate(BaseModel):
invoice_amount: Optional[Decimal] = Field(default=None, alias="invoiceAmount")
invoice_no: Optional[str] = Field(default=None, max_length=50, alias="invoiceNo")
invoice_date: Optional[date] = Field(default=None, alias="invoiceDate")
settlement_status: Optional[str] = Field(default=None, alias="settlementStatus")
remark: Optional[str] = None
model_config = {"populate_by_name": True}
class FreightSettlementRead(FreightSettlementBase):
id: str
settlement_no: str = Field(alias="settlementNo")
tenant_no: str = Field(alias="tenantNo")
order_num: Optional[int] = Field(default=None, alias="orderNum")
create_by: Optional[str] = Field(default=None, alias="createBy")
create_dept_id: Optional[str] = Field(default=None, alias="createDeptId")
create_time: datetime = Field(alias="createTime")
update_by: Optional[str] = Field(default=None, alias="updateBy")
update_time: datetime = Field(alias="updateTime")
del_flag: int = Field(default=0, alias="delFlag")
model_config = {"from_attributes": True, "populate_by_name": True}
class FreightSettlementWithTransports(FreightSettlementRead):
transports: list = []
class FreightSettlementTransportRead(BaseModel):
id: str
settlement_id: str = Field(alias="settlementId")
transport_id: str = Field(alias="transportId")
freight_amount: Decimal = Field(alias="freightAmount")
tenant_no: str = Field(alias="tenantNo")
create_time: datetime = Field(alias="createTime")
model_config = {"from_attributes": True, "populate_by_name": True}
# =============================================================================
# 汇款凭证 Schema
# =============================================================================
class RemittanceVoucherCreate(BaseModel):
settlement_id: str = Field(..., alias="settlementId", description="结算单ID")
remittance_date: Optional[date] = Field(default=None, alias="remittanceDate", description="汇款日期")
remittance_amount: Optional[Decimal] = Field(default=None, alias="remittanceAmount", description="汇款金额")
voucher_urls: Optional[list[str]] = Field(default=None, alias="voucherUrls", description="凭证文件URLs")
remark: Optional[str] = None
model_config = {"populate_by_name": True}
class RemittanceVoucherRead(BaseModel):
id: str
settlement_id: str = Field(alias="settlementId")
voucher_no: Optional[str] = Field(default=None, alias="voucherNo")
remittance_date: Optional[date] = Field(default=None, alias="remittanceDate")
remittance_amount: Optional[Decimal] = Field(default=None, alias="remittanceAmount")
voucher_urls: Optional[str] = Field(default=None, alias="voucherUrls")
tenant_no: str = Field(alias="tenantNo")
create_time: datetime = Field(alias="createTime")
model_config = {"from_attributes": True, "populate_by_name": True}
# =============================================================================
# 列表查询
# =============================================================================
class FreightSettlementListQuery(BaseModel):
q: Optional[str] = Field(default=None, description="模糊搜索")
settlement_status: Optional[str] = Field(default=None, alias="settlementStatus", description="结算状态")
page: int = Field(default=1, ge=1)
page_size: int = Field(default=20, ge=1, le=100, alias="pageSize")
model_config = {"populate_by_name": True}
class FreightSettlementListResponse(BaseModel):
total: int
list: list[FreightSettlementRead]