03 CUBC-资产组-资产模块-资产操作服务

CUBC-资产组-资产模块-资产操作服务-资产操作接口

因外部不同业务场景需对资产进行增减操作，包含红冲

API接口定义

Result<Void> com.deppon.cubc.asset.client.account.api.AssOperationService.AssOperate(AssOperationRequest assOperationRequest);

核心逻辑

入参数:AssOperationRequest

名词

字段

类型

是否为空

规则

描述

业务操作代码bizCodevarcharN 业务操作代码客户编码customerCodevarcharN

 客户名称customerName    客户类型customerTypeByte  1客户、2部门、3合伙人、4供应商费用类型 productTypeStringY 对应物流交易单中： 产品类型费用名称 productNameStringY 对应物流交易单中： 产品类型的名称业务类型businessTypeStringN 快递、零担、仓储、整车，对应物流交易单中： 业务类型收款部门编码deptCodeStringN  收款部门名称deptNameStringN  单据子类型documentSubTypeStringN 如物流交易单则对应 物流交易子类型，单据类型documentTypeStringN 如物流交易单对应 物流交易单类型金额amountBigDecimalN  操作人编码

operatorCode

StringN  操作人名称

operatorName

StringN  外部单据类型

outBillType

StringN 1物流交易单，2收款单，3付款单、4核销单外部单据子类型

outBillSubType

StringN 

对应单据的子类型，
如对应物流交易单中的付款方式
如收款单付款单的支付方式
如核销单对应核销类型

外部单据子类型名称

outBillSubTypeName

String   外部单据ID

outBillNo

StringN 对应单据的id，如物流交易单则为物流交易单号，收款单号，付款单号，核销单号账务操作备注opRemarkString         

返回结果：AssOperationResponse  

名词

字段

类型

是否为空

规则

描述

是否成功isSuccessbooleanN

 true/fasle

返回此次资产操作是否成功详情errorResponsevarcharN 资产操作失败后返回失败原因

附件：

业务映射科目

用户表（或者表结构如果统一维护，这里只列表名，并给出表统一维护的页面链接）涉及表结构 02表结构汇总

表名--超链接账本余额表账务明细表

外部依赖接口List（可空）

接口API

API描述

所属系统

其他描述

   最好放上：API设计的url        

CUBC-资产组-资产模块-资产操作服务-红冲（作废）资产操作接口

因外部不同业务场景需对资产进行增减操作，包含红冲

核心逻辑

见上图

API接口定义

Result<Void> com.deppon.cubc.asset.client.account.api.AssOperationService.AssOperateUndo(AssOperationRequest assOperationRequest);

入参数:AssOperationRequest

名词

字段

类型

是否为空

规则

描述

业务操作代码bizCodevarcharN 业务操作代码客户编码customerCodevarcharN

 客户名称customerName    客户类型customerTypeByte  1客户、2部门、3合伙人、4供应商费用类型 productTypeStringY 对应物流交易单中： 产品类型费用名称 productNameStringY 对应物流交易单中： 产品类型的名称业务类型businessTypeStringN 快递、零担、仓储、整车，对应物流交易单中： 业务类型收款部门编码deptCodeStringN  收款部门名称deptNameStringN  单据子类型documentSubTypeStringN 如物流交易单则对应 物流交易子类型，单据类型documentTypeStringN 如物流交易单对应 物流交易单类型金额amountBigDecimalN  操作人编码

operatorCode

StringN  操作人名称

operatorName

StringN  外部单据类型

outBillType

StringN 1物流交易单，2收款单，3付款单、4核销单外部单据子类型

outBillSubType

StringN 

对应单据的子类型，
如对应物流交易单中的付款方式
如收款单付款单的支付方式
如核销单对应核销类型

外部单据子类型名称

outBillSubTypeName

String   外部单据ID

outBillNo

StringN 对应单据的id，如物流交易单则为物流交易单号，收款单号，付款单号，核销单号账务操作备注opRemarkString         

CUBC-资产组-资产模块-资产操作服务-账户查询接口

前台业务查询需要的账户信息

API接口定义

public Result<AccountDO> getAccountInfo(String userCode);

核心逻辑

对象编码：当查询的对象为客户时，该编码为客户编码，当查询的对象为部门时，该编码为部门编码

用户类型：用于区分查询的对象

直接查询过滤符合条件的账户信息

入参数:AccountInfoRequest

名词

字段

类型

是否为空

规则

描述

用户编码

userCode

String

  客户/部门编码

返回结果：ResultList<AccountBookDO>

名词

字段

类型

是否为空

规则

描述

结果状态isSuccessbooleanN  数据列表对象 data

AccountDO

N 返回的账本列表

涉及表结构 02表结构汇总

用户表（或者表结构如果统一维护，这里只列表名，并给出表统一维护的页面链接）

表名--超链接账户基础信息表

CUBC-资产组-资产模块-资产操作服务-账本查询接口

前台业务查询需要的账本信息

API接口定义

ResultList<AccountBookDO> getAccountBookListByUserCodes(String[] userCodes);

核心逻辑

传递所有需要查询的用户ID的集合，基本非空校验之后查询符合条件的账本信息

入参数:String  userCodeList

名词

字段

类型

是否为空

规则

描述

用户CodesuserCodesString[]N  客户/部门编码

返回结果：AccountBookResponse

名词

字段

类型

是否为空

规则

描述

isSuccessisSuccessbooleanN  返回对象 datalistAccountBookDON 所属账户的ID

涉及表结构 02表结构汇总

用户表（或者表结构如果统一维护，这里只列表名，并给出表统一维护的页面链接）

表名--超链接账本余额表

CUBC-资产组-资产模块-资产操作服务-账务明细查询接口

前台业务查询需要的账本的账务明细信息

API接口定义

ResultList<AccountBalanceDO> getBalanceListByUserCode(AccountBalanceQuery accountBalanceQuery)；

核心逻辑

传递所有需要查询的账本ID，基本非空校验之后查询符合条件的账务明细查

入参数:AccountBalanceQuery

名词

字段

类型

是否为空

规则

描述

用户编码 userCodeStringN  资产科目assetCodeString   业务代码bizCodeString   收款部门deptCodeString   外部编码outIdString   显示页数pagesnumberY  显示条数rowsnumberY  

返回结果：BillDetailResponse

名词

字段

类型

是否为空

规则

描述

isSuccessisSuccessbooleanN  返回对象 datalistAccountBalanceDON  条数totalInteger                           账本科目subjectvarcharN 信用，余额，代收货款业务代码balancenumberN 业务操作对应的代码发生金额creditLimitnumberN 该交易发生的金额当前余额deptCodevarcharN 该笔交易结束之后的金额业务类型deptNamevarcharN  产品类型createTimedateTimeN  产品名称modifyTimedateTimeN  操作人编码modifyUserCodevarcharN  操作人名称modifyUserNamevarcharN  外部单据类型ExtDocTypevarcharN  外部单据子类型ExtSubDocTypevarcharN  外部单据IDExtDocIdvarcharN  

涉及表结构 02表结构汇总

用户表（或者表结构如果统一维护，这里只列表名，并给出表统一维护的页面链接）

表名--超链接账务明细表