凭证模版-列表查询接口(分页优化)

业务场景说明

通过此接口,查询凭证模板生成数据列表数据。

特殊说明

与凭证模版-列表查询接口的区别:返回参数不再返回统计总数,而是返回是否存在下一页标记

接口地址:

/api/openapi/dingtalk/voucher/info/v2/list

请求方式:

POST

请求参数说明:

参数说明

字段 类型 必填 描述
financeVersion string 是 凭证模板版本号;SYSTEM_V1(系统集成专用模板_V1)、U8V12、T+、K3Cloud、K3V14等编码对照表
setOfBooks string 否 账套编码
startDate string 否 凭证生成开始日期yyyy-MM-dd(若为空,则默认为当前时间60天前)(对应系统“凭证生成时间”列)
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:未作废
invalidByName string 是 作废人姓名
invalidCode string 是 作废人工号

响应参数示例:

{
  "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": "张三",
        "invalidCode": "12345",
        "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:列表查询支持租赁停用凭证

Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""