财资云开放平台（开发版）

票据贴现对外接口

测试中

POST

/v3/bill/discount/apply

业务错误码

错误码	错误描述（详情请看返回响应示例）	解决方案
000000	操作成功
300000	业务处理异常	根据详细提示检查信息或联系相关技术人员进行排查
400001	入参校验错误	请检查入参信息（必填，格式，匹配值，长度等）
400000	业务处理异常，详细错误信息会在data中	请检查入参信息（相关信息是否维护，数据是否可操作等）
400002	当前来源批次号重复	请检查入参来源批次号信息（来源批次号是否存在并发操作）
400003	数据库来源批次号重复	请检查入参来源批次号信息（来源批次号是否已经操作过）
400004	批次内流水号重复	请检查入参批次内流水号信息（批次内流水号是否重复）
400005	数据库批内流水号重复	请检查入参批次内流水号信息（批次内流水号是否已经操作过）
400006	票据不可贴现	请检查要贴现的票据信息（票据状态是否可贴现，是否允许贴现等）或联系相关技术人员进行排查
400007	云信票据不支持贴现	云信票据不支持贴现
400008	(某某信息)不存在；例如：贴入账号不存在	根据详细提示检查是否在财资云系统维护或联系相关技术人员进行排查
400009	(某某信息)重复；例如：票据号[xxx]重复	根据详细提示检查信息或联系相关技术人员进行排查
400010	(某某信息)错误；例如：票据号[xxx]持票人账号错误	根据详细提示检查信息或联系相关技术人员进行排查
400011	票据可用金额不足	请检查票据金额是否满足

请求参数

Body 参数application/json

source_batch_no

string

来源批次号

必需

来源批次号，租户内同一业务系统唯一

<= 128 字符

receiver

object

接收人信息

必需

name

string | null

接收人名称（交易对手名称）

可选

<= 128 字符

account_name

string | null

接收人户名

可选

<= 128 字符

account_number

string | null

接收人账号

可选

<= 32 字符

bank_branch_name

string

接收人开户行

必需

接收人开户行名（根据开户行自动带出银行）

<= 128 字符

bank_branch_code

string

接收人开户联行号

必需

接收人开户联行号

<= 32 字符

social_credit_code

string | null

接收人社会信用代码

可选

<= 32 字符

is_online_settlement

enum<integer> | enum<null>

是否线上清算

可选

是否线上清算（1:是， 0: 否），默认1

枚举值:

10

默认值:

1

discount_account_number

string

贴入账号

必需

贴入账号(需要先在财资云维护)；
会根据账号自动带出银行、开户行、开户行号等信息

<= 32 字符

discount_rate

string

贴现利率

必需

贴现利率（支持填写至小数点后六位）

handling_fee

string | null

手续费

可选

手续费（支持填写至小数点后两位）

handling_fee_rate

string | null

手续费费率

可选

手续费费率（支持填写至小数点后六位）

discount_kind

enum<integer> | enum<null>

是否可回购式贴现

可选

是否可回购式贴现（1:是， 0: 否），默认0

枚举值:

10

默认值:

0

is_discount_quick

integer

是否极速贴现

必需

是否极速贴现（1:是， 0: 否），默认0

pay_interest_way

enum<integer>

付息方式（卖方付息、买方付息、协议付息）

必需

字典说明
1-卖方付息
2-买方付息
3-协议付息

枚举值:

123

pay_interest_account_number

string | null

付息账号

可选

<= 32 字符

pay_interest_rate

string | null

付息比例

可选

付息比例(付息方式选择“协议付息”，必填)

buy_back_agreement_no

string | null

买方付息合作协议编号

可选

买方付息合作协议编号（付息方式选择“买方付息”，并且是兴业银行，
则增加必填字段“买方付息合作协议编号“ ）

<= 64 字符

buy_back_start_date

string <date> | null

回购期限开始日期

可选

回购期限开始日期(日期格式：yyyy-MM-dd)（回购式贴现为是，必填）

示例值:

2024-08-24

buy_back_end_date

string <date> | null

回购期限结束日期

可选

回购期限结束日期(日期格式：yyyy-MM-dd)（回购式贴现为是，必填）

示例值:

2024-10-24

buy_back_rate

string | null

回购利率

可选

回购利率（支持填写至小数点后六位）

remark

string | null

备注

可选

discount_invoice_list

array [object {7}] | null

贴现发票

可选

发票信息集合（若有数据则必填，若无数据，则整栏无需必填）

invoice_type

enum<string>

发票类型

必需

发票类型（枚举值：004-专票、007-普票、026-电子发票、025-卷票、005-机动车、14-通行费、31-全电专票、32-全电普票)

<= 12 字符

枚举值:

004007026025143132

invoice_number

string

发票号码

必需

<= 30 字符

invoice_code

string | null

发票代码

可选

非全电专票和全电普票时必输

<= 30 字符

amount

string | null

发票金额（含税）

可选

发票金额（含税）,全电专票和全电普票时必输；小数点后两位

total_amount

string | null

发票金额（不含税）

可选

发票金额（不含税），非全电专票和全电普票时必输；小数点后两位

invoicing_date

string <date>

开票日期

可选

开票日期(日期格式：yyyy-MM-dd)

示例值:

2024-09-27

verification_code

string | null

发票校验码

可选

发票校验码（当发票类型为专票或普票时必填，输入框，最长6位）

<= 6 字符

bill_info_rows

array [object {8}]

票据信息

必需

票据信息集合

source_serial_number

string

来源流水号

必需

来源流水号，外部系统票据唯一标识

<= 128 字符

transaction_amount

string

交易金额

必需

bill_code

string

票据号码

必需

<= 40 字符

range_bgn

string | null

子区间开始

可选

子区间开始(二代票必填)

<= 12 字符

range_end

string | null

子区间结束

可选

子区间结束(二代票必填)

<= 12 字符

hold_account_number

string | null

持票人账号

可选

<= 32 字符

hold_account_name

string | null

持票人户名

可选

<= 128 字符

transaction_date

string <date> | null

签收日期

可选

签收日期 :线下票据必填，线上票据填写无用(日期格式：yyyy-MM-dd)

示例值:

2024-09-29

示例

{
    "source_batch_no": "YFKD20240930141000000004",
    "tenant_id": "528875",
    "receiver": {
        "name": "",
        "account_name": "",
        "account_number": "",
        "bank_branch_name": "中国工商银行股份有限公司北京崇文门外大街支行",
        "bank_branch_code": "102100000056",
        "social_credit_code": ""
    },
    "is_online_settlement": 1,
    "discount_account_number": "8110701014001498774",
    "discount_rate": 12.0001,
    "handling_fee": null,
    "handling_fee_rate": null,
    "discount_kind": 1,
    "pay_interest_way": 3,
    "pay_interest_account_number": "19048101046428876",
    "pay_interest_rate": 7.0,
    "buy_back_agreement_no": "",
    "buy_back_start_date": "2024-10-12",
    "buy_back_end_date": "2024-10-18",
    "buy_back_rate": null,
    "remark": "haha_esse consequat veniam quis",
    "discount_invoice_list": [
        {
            "invoice_type": "004",
            "invoice_number": "010101011000001",
            "invoice_code": "222000101001111",
            "amount": 167.4,
            "total_amount": null,
            "invoicing_date": "2024-09-27",
            "verification_code": "112091"
        }
    ],
    "bill_info_rows": [
        {
            "source_serial_number": "LSH001111010110000",
            "transaction_amount": 100000059,
            "bill_code": "610233100227020240701101717364",
            "range_bgn": "1",
            "range_end": "65000",
            "hold_account_number": "",
            "hold_account_name": "",
            "transaction_date": null
        },
        {
            "source_serial_number": "LSH001111010110001",
            "transaction_amount": 59,
            "bill_code": "YX20240812-000023",
            "range_bgn": null,
            "range_end": null,
            "hold_account_number": "913505005673244367",
            "hold_account_name": "九牧厨卫股份有限公司",
            "transaction_date": "2024-09-07"
        }
    ]
}

示例代码

Java

Shell

JavaScript

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v3/bill/discount/apply' \
--header 'Content-Type: application/json' \
--data-raw '{
    "source_batch_no": "YFKD20240930141000000004",
    "tenant_id": "528875",
    "receiver": {
        "name": "",
        "account_name": "",
        "account_number": "",
        "bank_branch_name": "中国工商银行股份有限公司北京崇文门外大街支行",
        "bank_branch_code": "102100000056",
        "social_credit_code": ""
    },
    "is_online_settlement": 1,
    "discount_account_number": "8110701014001498774",
    "discount_rate": 12.0001,
    "handling_fee": null,
    "handling_fee_rate": null,
    "discount_kind": 1,
    "pay_interest_way": 3,
    "pay_interest_account_number": "19048101046428876",
    "pay_interest_rate": 7.0,
    "buy_back_agreement_no": "",
    "buy_back_start_date": "2024-10-12",
    "buy_back_end_date": "2024-10-18",
    "buy_back_rate": null,
    "remark": "haha_esse consequat veniam quis",
    "discount_invoice_list": [
        {
            "invoice_type": "004",
            "invoice_number": "010101011000001",
            "invoice_code": "222000101001111",
            "amount": 167.4,
            "total_amount": null,
            "invoicing_date": "2024-09-27",
            "verification_code": "112091"
        }
    ],
    "bill_info_rows": [
        {
            "source_serial_number": "LSH001111010110000",
            "transaction_amount": 100000059,
            "bill_code": "610233100227020240701101717364",
            "range_bgn": "1",
            "range_end": "65000",
            "hold_account_number": "",
            "hold_account_name": "",
            "transaction_date": null
        },
        {
            "source_serial_number": "LSH001111010110001",
            "transaction_amount": 59,
            "bill_code": "YX20240812-000023",
            "range_bgn": null,
            "range_end": null,
            "hold_account_number": "913505005673244367",
            "hold_account_name": "九牧厨卫股份有限公司",
            "transaction_date": "2024-09-07"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

响应code

必需

响应code (6位自定义错误码)

<= 6 字符

默认值:

000000

msg

string

响应信息

必需

响应信息

data

object | null

响应数据

可选

响应数据

source_batch_no

string

来源批次号

必需

fail_datas

array [object {3}]

错误信息集合

必需

{
    "code": "000000",
    "msg": "操作成功",
    "data": null
}

对方是否签收状态查询

票据出票对外接口