1 接口介绍

接口支持查询实体组织、单个往来明细科目、单个币别或综合本位币、指定核算维度类型和值、某个账龄段的账龄。

1.1 接口参数说明

参考以下建立参数类，将查询参数封装好，详细参数见“账龄查询参数”注释。

账龄查询参数：

package kd.fi.gl.reciprocal.agingservice;

import java.util.Date;

import java.util.Map;

import java.util.Set;

/**

 * @Description: 账龄查询参数

 */

public class AgingQueryParam {

    /**

     * 实体组织id（必录）

     */

    private long orgId;

    /**

     * 账簿类型id（必录）

     */

    private long bookTypeId;

    /**

     * 科目表id（非必录）

     */

    private long accountTableId;

    /**

     * 科目masterId（必录）

     */

    private long accountMasterId;

    /**

     * 期间类型id（非必录）

     */

    private Long periodType;

    /**

     * 币别id，查询综合本位币时传入：0（必录）

     */

    private long currencyId;

    /**

     * 核算维度度Map<flexfield, set<value>>（非必录）

     */

    private Map<String, Set<Long>> assgrp;

    /**

     * 记账日期（必录）

     */

    private Date bookedDate;

    /**

     * 截止日期（必录）

     */

    private Date expireDate;

    /**

     * 账龄从..天,（必录）

     */

    private int agingDayFrom;

    /**

     * 到..天,为0表示无限，比如30天以上账龄传参，agingDayFrom：30 agingDayTo：0 。agingDayFrom：0 agingDayTo：0表示0天以上账龄。（必录）

     */

    private int agingDayTo;

    /**

     * 账龄规则， 按到期日：1，按业务日期：-1（必录）

     */

    private Integer caculateRule;

    /**

     * 账龄显示，按余额显示账龄：true，按实际核销显示账龄：false（必录）

     */

    private boolean showByAmount;

    public long getOrgId() {

        return orgId;

    }

    public void setOrgId(long orgId) {

        this.orgId = orgId;

    }

    public long getBookTypeId() {

        return bookTypeId;

    }

    public void setBookTypeId(long bookTypeId) {

        this.bookTypeId = bookTypeId;

    }

    public long getAccountTableId() {

        return accountTableId;

    }

    public void setAccountTableId(long accountTableId) {

        this.accountTableId = accountTableId;

    }

    public long getAccountMasterId() {

        return accountMasterId;

    }

    public void setAccountMasterId(long accountMasterId) {

        this.accountMasterId = accountMasterId;

    }

    public Long getPeriodType() {

        return periodType;

    }

    public void setPeriodType(Long periodType) {

        this.periodType = periodType;

    }

    public long getCurrencyId() {

        return currencyId;

    }

    public void setCurrencyId(long currencyId) {

        this.currencyId = currencyId;

    }

    public Map<String, Set<Long>> getAssgrp() {

        return assgrp;

    }

    public void setAssgrp(Map<String, Set<Long>> assgrp) {

        this.assgrp = assgrp;

    }

    public Date getBookedDate() {

        return bookedDate;

    }

    public void setBookedDate(Date bookedDate) {

        this.bookedDate = bookedDate;

    }

    public Date getExpireDate() {

        return expireDate;

    }

    public void setExpireDate(Date expireDate) {

        this.expireDate = expireDate;

    }

    public int getAgingDayFrom() {

        return agingDayFrom;

    }

    public void setAgingDayFrom(int agingDayFrom) {

        this.agingDayFrom = agingDayFrom;

    }

    public int getAgingDayTo() {

        return agingDayTo;

    }

    public void setAgingDayTo(int agingDayTo) {

        this.agingDayTo = agingDayTo;

    }

    public Integer getCaculateRule() {

        return caculateRule;

    }

    public void setCaculateRule(Integer caculateRule) {

        this.caculateRule = caculateRule;

    }

    public boolean isShowByAmount() {

        return showByAmount;

    }

    public void setShowByAmount(boolean showByAmount) {

        this.showByAmount = showByAmount;

    }

}

long currencyId 币别id，为0时，查询综合本位币。

Map<String, Set<Long>> assgrp    //核算维度:[ 核算维度值id1,核算维度值id2] >
核算维度：核算维度取值自t_bas_flex_property(系统库)的fflexfield的值，是该维度的唯一标识。

核算维度值：如fflexfield = ‘f0001’是客户，value是客户A在表t_bd_customer的fid值。

账龄要带上所有核算维度明细的话，核算维度参数不能为空。若为空，则为科目的账龄。

int agingDayFrom  账龄从..天

int agingDayTo  到..天

30账龄：agingDayFrom:0  agingDayTo:30   31-60天账龄：agingDayFrom:31  agingDayTo:60

61天以上账龄：agingDayFrom:61  agingDayTo:0 

1.2 注意事项

1)   往来科目有核销方案则使用匹配的核销方案。 没有匹配的核销方案时，会默认一个核销方案，默认的核销方案的核销模式为：按业务日期先进先出核销。

1.3接口返回结果说明

参考“CommonResult”建立返回结果类，接收微服务返回结果。

CommonResult内容如下：

package kd.fi.gl.report;

import java.io.Serializable;

/**

 * @Des: 返回结果

 */

public class CommonResult<T> implements Serializable {

    private static final long serialVersionUID = -451463358628060086L;

    private long code;

    private String message;

    private T data;

    public CommonResult() {

    }

    public long getCode() {

        return code;

    }

    public void setCode(long code) {

        this.code = code;

    }

    public String getMessage() {

        return message;

    }

    public void setMessage(String message) {

        this.message = message;

    }

    public T getData() {

        return data;

    }

    public void setData(T data) {

        this.data = data;

    }

}

状态码code: 200：成功  202：返回数据超过上限10万  500：发生异常。

Message: 提示信息。

data: fieldList是数据列，列数是不固定的。列包含有：

overdue: 超期原币账龄overduelocal: 超期本位币账龄

undue: 未到期原币账龄unduelocal: 未到期本位币账龄

如果查询综合本位币，则不返回overdue和 undue列。其余列为核算维度类型，列数不固定，如科目有f0001 和f0002两个往来核算维度类型，且参数都包含这两个核算维度类型，则返回的列中就包含有f0001 和f0002这两列，没有则不返回。

rowData：为fieldList中列对应的数据。

2  使用案例

3常见问题汇总 

微服务怎么调用？

答：微服务调用方式：String result = DispatchServiceHelper.invokeBizService("fi", "gl", "BalanceService", "getBalance", param.toString())。