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

业务场景说明

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

特殊说明

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

接口地址:

/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:列表查询支持租赁停用凭证

Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""