| | |
| | | package cn.iocoder.yudao.module.erp.service.finance; |
| | | |
| | | import cn.iocoder.yudao.framework.common.pojo.PageResult; |
| | | import cn.iocoder.yudao.module.erp.api.finance.dto.ErpFinancePaymentRedFlushCreateReqDTO; |
| | | import cn.iocoder.yudao.module.erp.controller.admin.finance.vo.payment.ErpFinancePaymentPageReqVO; |
| | | import cn.iocoder.yudao.module.erp.controller.admin.finance.vo.payment.ErpFinancePaymentSaveReqVO; |
| | | import cn.iocoder.yudao.module.erp.dal.dataobject.finance.ErpFinancePaymentDO; |
| | | import cn.iocoder.yudao.module.erp.dal.dataobject.finance.ErpFinancePaymentItemDO; |
| | | import jakarta.validation.Valid; |
| | | |
| | | import java.math.BigDecimal; |
| | | import java.util.Collection; |
| | | import java.util.List; |
| | | import java.util.Map; |
| | | |
| | | /** |
| | | * ERP 付款单 Service 接口 |
| | |
| | | void updateFinancePayment(@Valid ErpFinancePaymentSaveReqVO updateReqVO); |
| | | |
| | | /** |
| | | * 更新付款单的状态 |
| | | * 提交付款单审批 |
| | | * |
| | | * @param id 编号 |
| | | * @param status 状态 |
| | | * @param processDefinitionKey 流程定义的编号 |
| | | * @param userId 用户编号 |
| | | */ |
| | | void updateFinancePaymentStatus(Long id, Integer status); |
| | | void submitFinancePayment(Long id, String processDefinitionKey, Long userId); |
| | | |
| | | /** |
| | | * 获得付款单审批流程定义列表 |
| | | * |
| | | * @return 流程定义列表 |
| | | */ |
| | | List<Map<String, Object>> getFinancePaymentApproveProcessDefinitionList(); |
| | | |
| | | /** |
| | | * 更新付款单的审批状态(由 BPM 流程实例的回调触发) |
| | | * |
| | | * @param id 编号 |
| | | * @param bpmResult BPM 审批结果 |
| | | */ |
| | | void updateFinancePaymentAuditStatus(Long id, Integer bpmResult); |
| | | |
| | | /** |
| | | * 删除付款单 |
| | |
| | | * @param ids 编号数组 |
| | | */ |
| | | void deleteFinancePayment(List<Long> ids); |
| | | |
| | | /** |
| | | * 创建采购退货负数冲红付款单 |
| | | * |
| | | * 该单据不校验来票、不占用来票可付金额,直接置为已审核;金额按负数入账。 |
| | | * 同一来源退货单重复调用时,返回已生成的冲红单编号(幂等)。 |
| | | * |
| | | * @param reqDTO 创建信息 |
| | | * @return 付款单编号 |
| | | */ |
| | | Long createRedFlushPayment(ErpFinancePaymentRedFlushCreateReqDTO reqDTO); |
| | | |
| | | /** |
| | | * 获得付款单 |
| | |
| | | */ |
| | | PageResult<ErpFinancePaymentDO> getFinancePaymentPage(ErpFinancePaymentPageReqVO pageReqVO); |
| | | |
| | | /** |
| | | * 统计每张来票已付款金额(未审核 + 审批中 + 已审核,排除作废) |
| | | * |
| | | * @param invoiceIds 来票编号列表 |
| | | * @return key 为来票编号,value 为已付款金额 |
| | | */ |
| | | Map<Long, BigDecimal> getPaymentPriceMapByInvoiceId(Collection<Long> invoiceIds); |
| | | |
| | | // ==================== 付款单项 ==================== |
| | | |
| | | /** |