保证金台账查询接口

说明

查询保证金/押金台账列表。接口为只读查询，数据来源为保证金台账，不处理退还、转费用、坏账等状态写入。

接口限制

• 分页大小最大为 100。
• reimburseCodes、expenseTypeBizCodes、noReceiptSubTypeBizCodes、tradingPartnerBizCodes、legalEntityBizCodes、externalVoucherNos 单次最多 50 个。
• responsibleEmployeeIds 单次最多 20 个。
• 保证金台账仅包含预付款分类为 DEPOSIT、GUARANTEE 的数据。
• OpenAPI 不支持模糊关键字搜索；外部凭证号更新使用单据号 + 保证金编号精确定位。
• 账龄范围查询通过 numberSearches 传入，field 固定为 ageDays。
• 查询结果只返回对外业务编码，不返回台账内码、费用内码、formDataCode、表单定义编码等内部字段。

接口地址

/api/openapi/account-book/deposit/search

请求类型

POST

请求参数

参数说明

DepositBookCustomSearch

参数样例

{
  "statuses": ["PAID", "PARTIALLY_SETTLED"],
  "reimburseCodes": ["MK26040032"],
  "expenseTypeBizCodes": ["bzj001"],
  "noReceiptSubTypeBizCodes": ["BID_DEPOSIT"],
  "noReceiptTypes": ["DEPOSIT", "GUARANTEE"],
  "tradingPartnerBizCodes": ["TP-BIZ-001"],
  "legalEntityBizCodes": ["LE-BIZ-001"],
  "receiptStatuses": ["NOT_RECEIVED"],
  "responsibleEmployeeIds": ["E0001"],
  "paymentDateStart": 1780243200000,
  "paymentDateEnd": 1782835199999,
  "forecastReceiptDateStart": 1796054400000,
  "forecastReceiptDateEnd": 1798732799999,
  "externalVoucherNos": ["EXT26050001"],
  "itemSearches": [
    {
      "field": "CF1001",
      "searchCodeList": ["OPT001", "OPT002"]
    }
  ],
  "numberSearches": [
    {
      "field": "ageDays",
      "min": 30,
      "max": 90
    }
  ],
  "sortField": "forecastReceiptDate",
  "sortDirection": "ASC",
  "pageNo": 1,
  "pageSize": 50
}

响应参数

响应参数说明

OpenApiDepositBook

MonetaryAmount

AttachData

参数样例

{
  "code": "ACK",
  "message": null,
  "data": {
    "list": [
      {
        "depositNo": "MK26040032-A1",
        "reimburseCode": "MK26040032",
        "contractCodes": ["HT26050001"],
        "expenseTypeBizCode": "bzj001",
        "noReceiptSubTypeBizCode": "BID_DEPOSIT",
        "noReceiptType": "DEPOSIT",
        "tradingPartnerBizCode": "TP-BIZ-001",
        "legalEntityBizCode": "LE-BIZ-001",
        "consumeAmount": {
          "amount": 5000.00,
          "currency": "CNY"
        },
        "doneReturnAmount": {
          "amount": 0.00,
          "currency": "CNY"
        },
        "processReturnAmount": {
          "amount": 1000.00,
          "currency": "CNY"
        },
        "doneAmount": {
          "amount": 0.00,
          "currency": "CNY"
        },
        "processAmount": {
          "amount": 0.00,
          "currency": "CNY"
        },
        "nonReceiptAmount": {
          "amount": 5000.00,
          "currency": "CNY"
        },
        "consumeCcy": "CNY",
        "paymentDate": 1780329600000,
        "forecastReceiptDate": 1796140800000,
        "receiptMedium": "ELECTRONIC",
        "receiptStatus": "RECEIVED",
        "status": "PAID",
        "badDebtReason": null,
        "badDebtAmount": null,
        "externalVoucherNo": "EXT26050001",
        "customObject": {
          "CF1001": {
            "detailBusinessCode": "OPT001",
            "businessCode": "REF-BIZ-001",
            "text": "项目A"
          }
        },
        "receiptAttachments": [
          {
            "name": "保证金收据.pdf",
            "url": "https://example.com/deposit-receipt.pdf",
            "pdfUrl": null
          }
        ],
        "createdAt": 1780329600000,
        "createdByEmployeeId": "E0001",
        "ageDays": 0
      }
    ],
    "hasNextPage": false
  },
  "requestId": null,
  "errorCode": null,
  "success": true
}

修改记录

2026-06-30  按最新 OpenAPI 返回口径调整：不返回内部 code；查询入参使用业务编码并移除内码入参；contractCodes 改为数组；收据附件按台账维度返回；补充返回枚举中文描述
2026-06-17  同步开发分支逻辑：移除模糊关键字、成本中心、凭证号，新增公司抬头、共享字段、账龄范围筛选和 customObject 返回
2026-05-29  新增保证金台账查询接口文档