查询银行电子回单单个 - 统一开放平台（正式）

请求参数

Query 参数

appId

string

必需

对接系统的appId

示例值:

1602951251824349184

command

string

接口指令码

必需

示例值:

yocyl.account.receipt.singleQuery

version

string

调用的接口版本

必需

示例值:

1.0.0

timestamp

string

必需

发送请求的时间，格式"yyyyMMddHHmmss",请求时间10分钟内有效

charset

string

仅支持UTF-8

必需

示例值:

UTF-8

format

string

仅支持json

必需

示例值:

json

signType

string

必需

签名算法类型，目前支持RSA2，RSA，SM2，推荐使用RSA2

示例值:

RSA2

sign

string

请求参数的签名串

必需

notifyUrl

string

必需

主动通知企业业务系统服务器里指定的页面http/https路径

Body 参数application/json

accountNumber

string

银行账号

可选

startDate

string

开始日期

可选

格式yyyyMMdd

endDate

string

截止日期

可选

格式yyyyMMdd

accountTransId

string

银行交易明细ID

可选

transNoteCode

string

资金交易单号

可选

例：单笔支付单号、批量支付单批次号+支付序列号、工资代发单支付批次号、应收单据号

originalNoteCode

string

原始单据号

可选

例：关联单笔支付原始单据号（如OA推送的付款申请单号）、关联批量支付原始单据号（外部系统推送的付款单号）、关联工资代发单原始单据号（外部系统推送的付款单号）

pageNo

number

页码

可选

留空表示第一页，默认20个结果为一页

pageSize

number

每页记录数

可选

默认20，最大100

示例

{
    "accountNumber": "string",
    "startDate": "string",
    "endDate": "string",
    "accountTransId": "string",
    "transNoteCode": "string",
    "originalNoteCode": "string",
    "pageNo": 0,
    "pageSize": 0
}

示例代码

Java

Shell

JavaScript

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi-pre.yocyl.com/api?appId=1602951251824349184&command=yocyl.account.receipt.singleQuery&version=1.0.0&timestamp=&charset=UTF-8&format=json&signType=RSA2&sign=&notifyUrl=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountNumber": "string",
    "startDate": "string",
    "endDate": "string",
    "accountTransId": "string",
    "transNoteCode": "string",
    "originalNoteCode": "string",
    "pageNo": 0,
    "pageSize": 0
}'

返回响应

🟢200成功

application/json

Body

yocyl_account_receipt_singleQuery_response

object

必需

code

string

响应码

必需

msg

string

响应信息

必需

currentPageNo

integer

当前页码

必需

pageSize

integer

页大小

必需

total

integer

总记录数

必需

totalPages

integer

总页数

必需

records

array [object {20}]

电子回单信息列表

必需

示例

{
    "yocyl_account_receipt_singleQuery_response": {
        "code": "string",
        "msg": "string",
        "currentPageNo": 0,
        "pageSize": 0,
        "total": 0,
        "totalPages": 0,
        "records": [
            {
                "id": "string",
                "accountNumber": "string",
                "accountName": "string",
                "bankCode": "string",
                "transDate": "string",
                "transDatetime": "string",
                "transWay": 0,
                "currencyCode": "string",
                "transAmount": 0,
                "transAmountView": "string",
                "oppBank": "string",
                "oppAccountNumber": "string",
                "oppAccountName": "string",
                "purpose": "string",
                "bankSerialNumber": "string",
                "filePath": "string",
                "receiptCode": "string",
                "accountTransId": "string",
                "transNoteCode": "string",
                "originalNoteCode": "string"
            }
        ]
    }
}