package com.ruoyi.account.api.feignClient;
|
|
import com.ruoyi.account.api.factory.CompanyAllocateRecordFallbackFactory;
|
import com.ruoyi.account.api.vo.CompanyAllocateSummaryVO;
|
import com.ruoyi.common.core.constant.ServiceNameConstants;
|
import com.ruoyi.common.core.domain.R;
|
import org.springframework.cloud.openfeign.FeignClient;
|
import org.springframework.web.bind.annotation.PostMapping;
|
import org.springframework.web.bind.annotation.RequestBody;
|
import org.springframework.web.bind.annotation.RequestParam;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* 公司额度分配记录服务（VIN码充电结算写入消费流水使用）
|
*
|
* @author mxcd
|
*/
|
@FeignClient(contextId = "CompanyAllocateRecordClient", value = ServiceNameConstants.ACCOUNT_SERVICE,
|
fallbackFactory = CompanyAllocateRecordFallbackFactory.class)
|
public interface CompanyAllocateRecordClient {
|
|
/**
|
* 写入消费流水（change_type=2，按订单号+类型幂等，已存在返回 true）
|
*
|
* @param companyId 所属公司ID
|
* @param userType 分配对象类型：1=VIN码，2=刷卡，3=白名单手机号
|
* @param userInfo 分配对象信息（VIN码/卡号/手机号）
|
* @param userName 分配对象名称
|
* @param beforeBalance 消费前账户余额
|
* @param amount 本次变更金额（消费传负数）
|
* @param chargingOrderCode 充电订单号（幂等键之一）
|
* @param remark 备注
|
* @return 是否写入成功（已存在视为成功）
|
*/
|
@PostMapping("/company-allocate-record/inner/record-consume")
|
R<Boolean> recordConsume(@RequestParam("companyId") Integer companyId,
|
@RequestParam("userType") Integer userType,
|
@RequestParam("userInfo") String userInfo,
|
@RequestParam(value = "userName", required = false) String userName,
|
@RequestParam("beforeBalance") BigDecimal beforeBalance,
|
@RequestParam("amount") BigDecimal amount,
|
@RequestParam("chargingOrderCode") String chargingOrderCode,
|
@RequestParam(value = "remark", required = false) String remark);
|
|
/**
|
* 查询已在账户侧落消费流水（change_type=2）的订单号集合（结算幂等判定、订单侧兜底扫描使用）
|
*
|
* @param orderCodes 待判定的充电订单号
|
* @return 已存在消费流水的订单号集合（无匹配返回空集合）
|
*/
|
@PostMapping("/company-allocate-record/inner/list-consumed-order-codes")
|
R<List<String>> listConsumedOrderCodes(@RequestBody List<String> orderCodes);
|
|
/**
|
* 统计公司名下三类主体（VIN码/刷卡/白名单手机号）可用余额与充电锁定金额合计（只读，
|
* 分配模式切换为共享模式前的校验使用）。
|
*
|
* @param companyId 所属公司ID
|
*/
|
@PostMapping("/company-allocate-record/inner/sum-allocated-balance")
|
R<CompanyAllocateSummaryVO> sumAllocatedBalance(@RequestParam("companyId") Integer companyId);
|
|
/**
|
* 回收公司名下三类主体全部分配余额至公司账户（分配模式切换为共享模式时调用）。
|
* 幂等：余额已清零的主体不重复回收、不重复写流水；返回本次实际回收总额。
|
*
|
* @param companyId 所属公司ID
|
* @param operatorName 操作人账号
|
* @param companyName 公司名称（企业账户流水 userInfo 使用，可为空）
|
* @param companyBalanceBefore 回退前公司可用余额（企业账户正数流水 beforeBalance 使用）
|
* @return 本次实际回收总额（元，无余额时返回 0）
|
*/
|
@PostMapping("/company-allocate-record/inner/recycle-allocated-balance")
|
R<BigDecimal> recycleAllocatedBalance(@RequestParam("companyId") Integer companyId,
|
@RequestParam("operatorName") String operatorName,
|
@RequestParam(value = "companyName", required = false) String companyName,
|
@RequestParam("companyBalanceBefore") BigDecimal companyBalanceBefore);
|
}
|
