puzhibing
2026-09-29 e665bc906ba6ef715acfa55ebe3ad2370154626d
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
package com.ruoyi.account.api.feignClient;
 
import com.ruoyi.account.api.factory.CompanyAllocateRecordFallbackFactory;
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);
                             }