客户余额加账单核销

2026-09-16 15:19:05 +08:00
parent f3be74b7a4
commit 2e39440540
15 changed files with 1639 additions and 5 deletions
@@ -0,0 +1,111 @@
+package com.ruoyi.web.controller.customer.customermoney;
+
+import java.util.Collections;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import com.ruoyi.ar.domain.ArBalanceWriteoff;
+import com.ruoyi.ar.domain.ArBill;
+import com.ruoyi.ar.service.IArBalanceWriteoffService;
+import com.ruoyi.ar.service.IArBillService;
+import com.ruoyi.common.annotation.Log;
+import com.ruoyi.common.core.controller.BaseController;
+import com.ruoyi.common.core.domain.AjaxResult;
+import com.ruoyi.common.core.page.TableDataInfo;
+import com.ruoyi.common.enums.BusinessType;
+
+/**
+ * 客户余额核销应收账单 / 账单只读查询 Controller
+ *
+ * @author ruoyi
+ * @date 2026-09-16
+ */
+@RestController
+@RequestMapping("/customersupplier/customerbill")
+public class CustomerBillController extends BaseController
+{
+    @Autowired
+    private IArBalanceWriteoffService balanceWriteoffService;
+
+    @Autowired
+    private IArBillService billService;
+
+    /**
+     * 查询客户可核销账单（已确认/部分核销，未核销额大于0）
+     */
+    @PreAuthorize("@ss.hasPermi('customersupplier:customerinfo:list')")
+    @GetMapping("/unsettled/{customerId}")
+    public AjaxResult unsettled(@PathVariable("customerId") Long customerId)
+    {
+        return success(balanceWriteoffService.selectUnsettledBills(customerId));
+    }
+
+    /**
+     * 查询余额核销记录（分页）
+     */
+    @PreAuthorize("@ss.hasPermi('customersupplier:customerinfo:list')")
+    @GetMapping("/writeoff/list")
+    public TableDataInfo writeoffList(ArBalanceWriteoff query)
+    {
+        if (query == null || query.getCustomerId() == null || query.getCustomerId() == 0L)
+        {
+            return getDataTable(Collections.emptyList());
+        }
+        startPage();
+        List<ArBalanceWriteoff> list = balanceWriteoffService.selectWriteoffList(query);
+        return getDataTable(list);
+    }
+
+    /**
+     * 用客户账户余额核销账单
+     */
+    @PreAuthorize("@ss.hasPermi('customer:bill:writeoff')")
+    @Log(title = "余额核销账单", businessType = BusinessType.UPDATE)
+    @PostMapping("/writeoff")
+    public AjaxResult writeoff(@RequestBody ArBalanceWriteoff cmd)
+    {
+        cmd.setCreateBy(getUsername());
+        return success(balanceWriteoffService.writeoff(cmd));
+    }
+
+    /**
+     * 反核销（取消一笔有效余额核销）
+     */
+    @PreAuthorize("@ss.hasPermi('customer:bill:writeoff:cancel')")
+    @Log(title = "余额核销反核销", businessType = BusinessType.UPDATE)
+    @PutMapping("/writeoff/{writeoffId}/cancel")
+    public AjaxResult cancelWriteoff(@PathVariable("writeoffId") Long writeoffId,
+        @RequestBody(required = false) ArBalanceWriteoff body)
+    {
+        balanceWriteoffService.cancelWriteoff(writeoffId, body == null ? null : body.getCancelRemark());
+        return success();
+    }
+
+    /**
+     * 账单查看：分页查询应收账单（只读，供客户侧账单查看页使用）
+     */
+    @PreAuthorize("@ss.hasPermi('customer:bill:list')")
+    @GetMapping("/list")
+    public TableDataInfo billList(ArBill query)
+    {
+        startPage();
+        return getDataTable(billService.selectArBillList(query));
+    }
+
+    /**
+     * 账单查看：账单详情（含订单明细/费用明细）
+     */
+    @PreAuthorize("@ss.hasPermi('customer:bill:query')")
+    @GetMapping("/{arBillId}")
+    public AjaxResult billInfo(@PathVariable("arBillId") Long arBillId)
+    {
+        return success(billService.selectArBillById(arBillId));
+    }
+}