凭证模版-列表查询接口(分页优化)
业务场景说明
通过此接口,查询凭证模板生成数据列表数据。
特殊说明
与凭证模版-列表查询接口的区别:返回参数不再返回统计总数,而是返回是否存在下一页标记
接口地址:
/api/openapi/dingtalk/voucher/info/v2/list
请求方式:
POST
请求参数说明:
参数说明
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
financeVersion | string | 是 | 凭证模板版本号;SYSTEM_V1(系统集成专用模板_V1)、U8V12、T+、K3Cloud、K3V14等编码对照表 |
setOfBooks | string | 否 | 账套编码 |
startDate | string | 否 | 凭证生成开始日期yyyy-MM-dd(若为空,则默认为当前时间90天前)(对应系统“凭证生成时间”列) |
endDate | string | 否 | 凭证生成结束日期yyyy-MM-dd(若为空,则默认取当前日期) (对应系统“凭证生成时间”列) |
pageNo | number | 否 | 第几页默认:1 |
pageSize | number | 否 | 每页条数。默认:10,最大值 :100 |
status | string | 否 | 当前批次外部调用方回写的导入状态,状态值调用方可自定义。 系统占用字段: - init表示还未被回写过的 - all或空值表示所有状态的 - success 推送成功 - fail 推送失败 - complete 导入完成 - error 导入错误 |
formCodes | array<string> | 否 | 单据号,限制10条 |
voucherCodes | array<string> | 否 | 凭证编码 |
voucherTypes | array<string> | 否 | 凭证类型 - ALL:支付凭证 - PAYABLE:应付凭证 - AMORTIZATION:摊销凭证 - ACCRUAL:预提凭证 - ACCRUAL_COVERED:冲预提凭证 - EXPECTED_ACTUAL_VARIANCE:预实差异凭证 - REFUND:支付退回凭证 - PAY_FOR_REFUND:重新支付凭证 - SPLIT_PAYMENT:支付拆分凭证 - ASSET_INITIAL_RECOGNITION:初始计量凭证 - ASSET_DEPRECIATION:资产折旧凭证 - ASSET_INTEREST_EXPENSES:利息费用凭证 - ASSET_LEASE_PAYMENT:租赁付款凭证 - ASSET_CHANGE:租赁变更调整凭证 - ASSET_DEACTIVATE:租赁停用凭证 |
documentStartDate | string | 否 | 制单日期/凭证日期,开始日期格式:2021-09-01(对应系统“凭证日期”列) |
documentEndDate | string | 否 | 制单日期/凭证日期,结束日期格式:2021-10-29(对应系统“凭证日期”列) |
invalid | boolean | 否 | 作废标识。true:已经作废,false:未作废 |
sortOrder | object | 否 | 排序,不传系统会默认排序(倒序) |
sortOrder
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
name | string | 是 | 排序字段,目前支持voucherCode |
mode | string | 是 | 排序方式 asc 正序 desc 倒序 |
参数示例:
{
"financeVersion": "SYSTEM_V1",
"startDate": "2019-07-01",
"endDate": "2019-07-30",
"pageNo": 1,
"pageSize": 10,
"status": "success",
"formCodes": ["MK190716010", "MK21050019"],
"voucherCodes": ["VIN1907261N8NQCJK"],
"documentStartDate": "2021-09-01",
"documentEndDate": "2021-10-29",
"sortOrder": {
"name": "voucherCode",
"mode": "desc"
}
}
响应参数:
参数说明
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
code | string | 是 | 响应结果,ACK表示接口正常.NACK表示接口异常 |
message | string | 是 | 提示 |
data | data | 是 | 返参 |
data.list | List | 是 | 凭证对象数组 |
data.hasNextPage | boolean | 是 | 是否存在下一页 |
errorCode | string | 是 | 错误提示 |
success | boolean | 是 | 请求结果 |
data.list参数说明
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
voucherCode | string | 是 | 凭证内码 |
entCode | string | 是 | 企业编码 |
batchNum | string | 是 | 凭证生成批次号(已过时) |
formCodes | List≶String> | 是 | 来源单据号数组 |
voucherDate | string | 是 | 凭证日期yyyy-MM-dd |
voucherType | string | 是 | 凭证类型 ALL支付凭证 PAYABLE应付凭证 AMORTIZATION摊销凭证 ACCRUAL预提凭证 ACCRUAL_COVERED冲预提凭证 REFUND支付退回凭证 PAY_FOR_REFUND重新支付凭证 SPLIT_PAYMENT支付拆分凭证 ASSET_INITIAL_RECOGNITION初始计量凭证 ASSET_DEPRECIATION资产折旧凭证 ASSET_INTEREST_EXPENSES利息费用凭证 ASSET_LEASE_PAYMENT租赁付款凭证 ASSET_CHANGE租赁变更调整凭证 ASSET_DEACTIVATE租赁停用凭证 |
voucherWord | string | 是 | 凭证字 |
voucherNumber | string | 是 | 凭证号 |
status | string | 是 | 外部调用方回写的导入状态。 系统占用字段: - init表示还未被回写过的 - all或空值表示所有状态的 - success 推送成功 - fail 推送失败 - complete 导入完成 - error 导入错误 |
resultMessage | string | 是 | 外部调用方回写结果信息 |
resultWordAndNumber | string | 是 | 财务系统中的外部凭证号 |
invalid | boolean | 是 | 作废标识。true:已经作废,false:未作废 |
响应参数示例:
{
"code": "ACK",
"message": null,
"data": {
"list": [
{
"voucherCode": "VIN41206144649141325",
"entCode": "maycur001",
"batchNum": "00116921510207165508",
"formCodes": [
"BXD23080077"
],
"voucherDate": "2023-08-16",
"voucherType": "ALL",
"voucherWord": "记",
"voucherNumber": "43",
"createdBy": "UI2012221C97WQDC",
"bookCode": null,
"bookName": null,
"legalEntityList": null,
"auxiliaryDataCode": null,
"financeCode": null,
"exportStatus": null,
"exportAt": null,
"exportDate": null,
"invalid": false,
"invalidAt": null,
"invalidBy": null,
"invalidByName": null,
"documentMakerCode": null,
"documentMakerBizCode": null,
"documentMakerName": null,
"syncStatus": null,
"syncMsg": null,
"syncAt": null,
"syncDate": null,
"syncVoucherWord": null,
"syncVoucherNumber": null,
"voucherGenerateTime": 0,
"baseAmount": {
"currency": "CNY",
"name": "人民币",
"amount": 0,
"fromExchangeRate": 1
},
"submitUserCode": null,
"submitUserName": null,
"status": "",
"resultMessage": "",
"resultWordAndNumber": ""
}
],
"hasNextPage": false
},
"errorCode": null,
"success": true
}
更新日志
2023-09-19: 新增接口 2023-12-12:列表查询支持租赁类型凭证 2024-02-22:列表查询支持租赁变更调整凭证 2024-03-14:列表查询支持租赁停用凭证