票据查询接口 - 财资云开放平台（开发版）

票据通用查询接口

请求参数

Body 参数application/json

page_no

integer

当前页码

可选

page_size

integer

分页大小

可选

behavior_ids

array[integer]

票据行为id

可选

ticket_types

array[integer]

票据类型

可选

ticket_behavior_types

array[integer]

票据行为

可选

query_types

array[integer]

可选

查询类型：0-全部、1-持票、2-待核实、3-历史

source_batch_nos

array[string]

来源批次号

可选

source_serial_numbers

array[string]

来源流水号

可选

apply_ids

array[integer]

票据申请 id

可选

behavior_date_start

string

行为日期开始

可选

behavior_date_end

string

行为日期结束

可选

hold_date

string

持票日期

可选

bill_handle_results

array[integer]

票据结果

可选

invalidate_state

integer

可选

作废状态
1 - 未作废、0 - 已作废

ticket_code_infos

array[object (TicketCodeInfo) {3}]

票据包信息

必需

ticket_code

string

票据号

必需

range_bgn

string

开始区间

可选

range_end

string

结束区间

可选

open_ticket_date_start

string

可选

出票日开始
yyyy-MM-dd

open_ticket_date_end

string

可选

出票日结束
yyyy-MM-dd

end_ticket_date_start

string

可选

到期日开始
yyyy-MM-dd

end_ticket_date_end

string

可选

到期日结束
yyyy-MM-dd

amount_min

string

最小票据（包）金额

可选

amount_max

string

最大票据（包）金额

可选

drawer_account_numbers

array[string]

出票人账号

可选

drawer_account_names

array[string]

出票人户名

可选

drawer_institution_codes

array[string]

出票人社会信用代码

可选

acceptors_account_numbers

array[string]

承兑人账号

可选

acceptors_account_names

array[string]

承兑人户名

可选

acceptor_bank_codes

array[string]

承兑银行编码

可选

payees_account_numbers

array[string]

收款人账号

可选

payees_account_names

array[string]

收款人户名

可选

payees_institution_codes

array[string]

收款人社会信用代码

可选

hold_previous_account_numbers

array[string]

上一手持票人账号

可选

hold_previous_account_names

array[string]

上一手持票人户名

可选

hold_previous_institution_codes

array[string]

可选

上一手持票人社会信用代码

org_codes

array[string]

本方组织编码

可选

org_sub_sharing

integer

可选

是否下级共享
0-否、1-是，不填默认否

our_account_numbers

array[string]

本方账号

可选

our_bank_codes

array[string]

本方银行编码

可选

online_type

integer

可选

直联标记
1-直联操作、0-非直联操作，不填默认全部

is_allow_endorse

integer

可选

是否可流转
0-否、1-是，不填默认全部

split_flag

integer

可选

是否可拆分
0-否、1-是，不填默认全部

back_ticket_flag

integer

可选

是否回头票
0-否、1-是，不填默认全部

acceptor_label_name

string

承兑标签名称

可选

is_front_back_path

integer

可选

是否打印正背面信息
0-否、1-是，不填默认全部

示例

{
    "page_no": 0,
    "page_size": 0,
    "behavior_ids": [
        0
    ],
    "ticket_types": [
        0
    ],
    "ticket_behavior_types": [
        0
    ],
    "query_types": [
        0
    ],
    "source_batch_nos": [
        "string"
    ],
    "source_serial_numbers": [
        "string"
    ],
    "apply_ids": [
        0
    ],
    "behavior_date_start": "string",
    "behavior_date_end": "string",
    "hold_date": "string",
    "bill_handle_results": [
        0
    ],
    "invalidate_state": 0,
    "ticket_code_infos": [
        {
            "ticket_code": "string",
            "range_bgn": "string",
            "range_end": "string"
        }
    ],
    "open_ticket_date_start": "string",
    "open_ticket_date_end": "string",
    "end_ticket_date_start": "string",
    "end_ticket_date_end": "string",
    "amount_min": "string",
    "amount_max": "string",
    "drawer_account_numbers": [
        "string"
    ],
    "drawer_account_names": [
        "string"
    ],
    "drawer_institution_codes": [
        "string"
    ],
    "acceptors_account_numbers": [
        "string"
    ],
    "acceptors_account_names": [
        "string"
    ],
    "acceptor_bank_codes": [
        "string"
    ],
    "payees_account_numbers": [
        "string"
    ],
    "payees_account_names": [
        "string"
    ],
    "payees_institution_codes": [
        "string"
    ],
    "hold_previous_account_numbers": [
        "string"
    ],
    "hold_previous_account_names": [
        "string"
    ],
    "hold_previous_institution_codes": [
        "string"
    ],
    "org_codes": [
        "string"
    ],
    "org_sub_sharing": 0,
    "our_account_numbers": [
        "string"
    ],
    "our_bank_codes": [
        "string"
    ],
    "online_type": 0,
    "is_allow_endorse": 0,
    "split_flag": 0,
    "back_ticket_flag": 0,
    "acceptor_label_name": "string",
    "is_front_back_path": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open-api/standard-interface/v1/ticket/get' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page_no": 0,
    "page_size": 0,
    "behavior_ids": [
        0
    ],
    "ticket_types": [
        0
    ],
    "ticket_behavior_types": [
        0
    ],
    "query_types": [
        0
    ],
    "source_batch_nos": [
        "string"
    ],
    "source_serial_numbers": [
        "string"
    ],
    "apply_ids": [
        0
    ],
    "behavior_date_start": "string",
    "behavior_date_end": "string",
    "hold_date": "string",
    "bill_handle_results": [
        0
    ],
    "invalidate_state": 0,
    "ticket_code_infos": [
        {
            "ticket_code": "string",
            "range_bgn": "string",
            "range_end": "string"
        }
    ],
    "open_ticket_date_start": "string",
    "open_ticket_date_end": "string",
    "end_ticket_date_start": "string",
    "end_ticket_date_end": "string",
    "amount_min": "string",
    "amount_max": "string",
    "drawer_account_numbers": [
        "string"
    ],
    "drawer_account_names": [
        "string"
    ],
    "drawer_institution_codes": [
        "string"
    ],
    "acceptors_account_numbers": [
        "string"
    ],
    "acceptors_account_names": [
        "string"
    ],
    "acceptor_bank_codes": [
        "string"
    ],
    "payees_account_numbers": [
        "string"
    ],
    "payees_account_names": [
        "string"
    ],
    "payees_institution_codes": [
        "string"
    ],
    "hold_previous_account_numbers": [
        "string"
    ],
    "hold_previous_account_names": [
        "string"
    ],
    "hold_previous_institution_codes": [
        "string"
    ],
    "org_codes": [
        "string"
    ],
    "org_sub_sharing": 0,
    "our_account_numbers": [
        "string"
    ],
    "our_bank_codes": [
        "string"
    ],
    "online_type": 0,
    "is_allow_endorse": 0,
    "split_flag": 0,
    "back_ticket_flag": 0,
    "acceptor_label_name": "string",
    "is_front_back_path": 0
}'

返回响应

🟢200成功

application/json

Body

code

string

响应code

可选

msg

string

失败信息

可选

data

object (StandardInterfaceResponseTicketInfoResponseRecords)

响应数据

可选

page_no

integer

当前页码

可选

page_size

integer

分页大小

可选

total

integer

总记录数

可选

total_pages

integer

总页数

可选

records

array[object (TicketInfoResponseRecords) {29}]

查询记录

可选

示例

{
  "code": "",
  "msg": "",
  "data": {
    "page_no": 0,
    "page_size": 0,
    "total": 0,
    "total_pages": 0,
    "records": [
      {
        "behavior_id": 0,
        "apply_id": 0,
        "invalidate_state": 0,
        "ticket_code": "",
        "range_bgn": "",
        "range_end": "",
        "ticket_behavior_type": 0,
        "ticket_state": 0,
        "amount": "",
        "available_amount": "",
        "is_allow_endorse": 0,
        "split_flag": 0,
        "back_ticket_flag": 0,
        "sign_date": "",
        "comment": "",
        "biz_type_code": "",
        "online_type": 0,
        "acceptor_label_name": "",
        "ticket_front_info": {
          "ticket_type": 0,
          "currency_code": "",
          "open_ticket_date": "",
          "end_ticket_date": "",
          "drawer_info": {
            "drawer_account_number": "",
            "drawer_account_name": "",
            "drawer_bank_code": "",
            "drawer_cnaps": "",
            "drawer_bank_location": "",
            "drawer_institution_code": ""
          },
          "acceptor_info": {
            "acceptor_account_number": "",
            "acceptor_account_name": "",
            "acceptor_bank_code": "",
            "acceptor_cnaps": "",
            "acceptor_bank_location": ""
          },
          "payee_info": {
            "payee_account_number": "",
            "payee_account_name": "",
            "payee_bank_code": "",
            "payee_cnaps": "",
            "payee_bank_location": "",
            "payee_institution_code": ""
          },
          "transaction_contract_no": 0,
          "acceptor_date": ""
        },
        "hold_previous_info": {
          "hold_previous_account_number": "",
          "hold_previous_account_name": "",
          "hold_previous_institution_code": 0
        },
        "our_info": {
          "our_org_id": "",
          "our_org_name": "",
          "our_org_code": "",
          "our_bank_code": "",
          "our_account_number": "",
          "our_account_name": "",
          "our_cnaps": "",
          "ourAccountNumber": ""
        },
        "opp_info": {
          "opp": "",
          "opp_ctrpty_id": "",
          "opp_bank_code": "",
          "opp_account_number": "",
          "opp_account_name": "",
          "opp_bank_location": "",
          "opp_cnaps": ""
        },
        "discount_ext_info": {
          "is_discount_quick": "",
          "discount_apply_rate": "",
          "discount_type": 0,
          "discount_prcd_trial_amount": "",
          "discount_prcd_real_amount": "",
          "discount_prcd_real_type": 0,
          "pay_interest_way": 0,
          "pay_interest_account_number": "",
          "pay_interest_rate": "",
          "discount_prcd_bank_code": "",
          "discount_prcd_account_number": "",
          "discount_prcd_account_name": "",
          "discount_prcd_bank_location": "",
          "discount_prcd_cnaps": "",
          "discount_prcd_institution_code": "",
          "handling_fee": "",
          "handling_fee_rate": ""
        },
        "transaction_info": {
          "transaction_amount": "",
          "behavior_date": "",
          "business_status": 0,
          "business_stage": 0,
          "bill_handle_result": 0,
          "auto_sign_status": 0,
          "auto_sign_message": "",
          "source_batch_no": "",
          "source_serial_number": ""
        },
        "split_info": {
          "ticket_split_record": {
            "ticket_code": "",
            "amount": "",
            "range_bgn": "",
            "range_end": "",
            "split_status": 0,
            "sub_rows": [
              {
                "ticket_code": "",
                "amount": "",
                "range_bgn": "",
                "range_end": "",
                "split_status": 0
              }
            ]
          },
          "present_ticket_split_record": {
            "ticket_code": "",
            "amount": "",
            "range_bgn": "",
            "range_end": "",
            "split_status": 0,
            "sub_rows": [
              {
                "ticket_code": "",
                "amount": "",
                "range_bgn": "",
                "range_end": "",
                "split_status": 0
              }
            ]
          }
        },
        "attachment_infos": [
          {
            "attachment_title": "",
            "attachment_size": "",
            "attachment_url": "",
            "attachment_id": "",
            "attach_type": 0,
            "attach_sub_type": 0
          }
        ],
        "addition_info": {
          "drawer_handle_channel": "",
          "acceptor_handle_channel": "",
          "payee_handle_channel": "",
          "drawer_guarantor_name": "",
          "drawer_guarantor_institution_code": "",
          "drawer_guarantor_account_name": "",
          "drawer_guarantor_handle_channel": "",
          "drawer_guarantor_account_number": "",
          "drawer_guarantor_bank_code": "",
          "drawer_guarantor_bank_location": "",
          "drawer_guarantor_bank_location_code": "",
          "acceptor_guarantor_name": "",
          "acceptor_guarantor_institution_code": "",
          "acceptor_guarantor_account_name": "",
          "acceptor_guarantor_handle_channel": "",
          "acceptor_guarantor_account_number": "",
          "acceptor_guarantor_bank_code": "",
          "acceptor_guarantor_bank_location": "",
          "acceptor_guarantor_bank_location_code": "",
          "endorser_guarantor_name": "",
          "endorser_guarantor_institution_code": "",
          "endorser_guarantor_account_name": "",
          "endorser_guarantor_handle_channel": "",
          "endorser_guarantor_account_number": "",
          "endorser_guarantor_bank_code": "",
          "endorser_guarantor_bank_location": "",
          "endorser_guarantor_bank_location_code": "",
          "ticket_mark_name1": "",
          "ticket_mark_content1": "",
          "ticket_mark_name2": "",
          "ticket_mark_content2": "",
          "ticket_mark_name3": "",
          "ticket_mark_content3": "",
          "mark_operation_info1": "",
          "mark_operation_business_info1": "",
          "mark_operation_info2": "",
          "mark_operation_business_info2": "",
          "mark_operation_info3": "",
          "mark_operation_business_info3": ""
        },
        "ticket_back_infos": [
          {
            "serial_number": 0,
            "ticket_code": "",
            "range_bgn": "",
            "range_end": "",
            "transfer_type": 0,
            "response_date": "",
            "acc_account_name": "",
            "acc_account_number": "",
            "acc_bank_location": "",
            "acc_cnaps": "",
            "next_account_name": "",
            "next_account_number": "",
            "next_bank_location": "",
            "next_cnaps": "",
            "redemption_open_date": "",
            "redemption_end_date": "",
            "refuse_pay_flag": 0,
            "refuse_pay_other": "",
            "recourse_type": 0,
            "recourse_date": "",
            "agree_liquidate_date": "",
            "is_allow_endorse": "",
            "guarantor_address": ""
          }
        ],
        "ticket_front_back_path": [
          {
            "url": "",
            "id": "",
            "type": ""
          }
        ]
      }
    ]
  }
}