增量查询会计分录

接口描述

此接口为增量接口用于在给定时间区间内查询未导入的会计分录

请求URI

/api/openapi/ledger/journals

请求方式

GET

请求参数示例

/api/openapi/ledger/journals?page=1&size=50&setOfBookId&transactionStartTime=2020-02-23%2020:47:00&transactionEndTime=2020-05-23%2021:47:00&companyOID=d52b2787-e1c3-49fb-9a12-775c0f249318

请求参数说明

参数名	类型	是否必填	说明
transactionStartTime	DateTime	是	查询开始时间。格式: yyyy-MM-dd HH:mm:ss
transactionEndTime	DateTime	是	查询结束时间。格式: yyyy-MM-dd HH:mm:ss
page	int	是	页码, 第一页的page为1
size	int	是	每页结果数。最大50
companyOID	UUID	否	公司OID 租户级企业秘钥获取token时，companyOID或setOfBookId必填
setOfBookId	Long	否	账套ID

{
    "total": 1,
    "current": 1,
    "pageSize": 50,
    "pages": 1,
    "hasPrevious": false,
    "hasNext": false,
    "data": [
        {
            "journalHeadValueId": 1243164744448253954,            
            "journalLineValueId": 1243164744481808386,
            "department_code": "CIOLounge",
            "amount": "500",
            "business_code": "ER00313285",
            "custom_field_code": "00600001",
            "line_no": "1",
            "description": "事由",
            "type": "expense"
        }
    ]
}

接口返回字段

PageResposne

参数名	类型	说明
total	int	查询结果总个数
current	int	当前页数
pageSize	int	每页结果计
pages	int	查询结果总分页数
hasPrevious	boolean	是否有上一页
hasNext	boolean	是否有下一页
data	Ledger[]	会计分录列表

Ledger

字段名	类型	规则	说明
journalHeadValueId	Long		分录头部ID。例如报销单列表
journalLineValueId	Long		分录行ID。例如报销单中的费用列表
其它字段			所有其他字段均为动态字段，请联系交付工程师确定配置，并获取返回示例

失败示例

{
    "message": "缺少必填项:companyOID",
    "errorCode": "120003"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码

错误代码

errorCode	message	说明
4002	无效的分页参数:{0}
120003	缺少必填项:{0}
120005	传入参数格式异常:{0},正确格式为:{1}