票据出票对外接口

业务错误码

错误码	错误描述（详情请看返回响应示例）	解决方案
000000	操作成功
300000	业务处理异常	根据详细提示检查信息或联系相关技术人员进行排查
400001	入参校验错误	请检查入参信息（必填，格式，匹配值，长度等）
400000	业务处理异常，详细错误信息会在data中	请检查入参信息（相关信息是否维护，数据是否可操作等）
400002	当前来源批次号重复	请检查入参来源批次号信息（来源批次号是否存在并发操作）
400003	数据库来源批次号重复	请检查入参来源批次号信息（来源批次号是否已经操作过）
400004	批次内流水号重复	请检查入参批次内流水号信息（批次内流水号是否重复）
400005	数据库批内流水号重复	请检查入参批次内流水号信息（批次内流水号是否已经操作过）

请求参数

Body 参数application/json

tenant_id

string

租户id

必需

source_batch_no

string

来源批次号

必需

bill_info_rows

array [object {27}]

必需

source_serial_number

string

来源流水号，每一笔票据唯一

必需

bill_type_code

integer

票据类型

必需

枚举值：
1 电子银行承兑汇票，
2 电子商业承兑汇票，
13 云信，
15 供应链票据；

bill_open_way

integer | null

出票方式

必需

云信出票不必填可为空；
枚举值：
1 全额保证金开票，
2 一定比例开票，
3 质押开票，
4 资产池开票，
5 汽车金融开票，
6 商票保贴开票，
7 信用开票；

online_type

integer

是否直联

必需

0-否，1-是

amount

string

出票金额

必需

出票金额必输；小数点后两位

open_bill_date

string

出票日期/开立日期（云信）

必需

日期格式：yyyy-MM-dd；

end_bill_date

string

到期日期/承诺付款日（云信）

必需

日期格式：yyyy-MM-dd；

bill_version_type_code

string

票据版本

必需

枚举值：
BILL01 一代票，
BILL02 二代票；
云信只支持二代票

bill_code

string | null

票据号码

可选

非直联票据必填

is_allow_endorse

integer | null

是否允许流转

必需

0-否，1-是；非云信出票必填；云信出票默认为是

split_flag

integer | null

是否允许拆分

必需

0-否，1-是；非云信出票必填；云信出票默认为是

biz_type_code

string

支付业务类型

必需

sign_date

string | null

对方签收日期

可选

非直联票据必填

is_agent

integer | null

是否集团代理开票

可选

0-否，1-是；默认否

is_occupy_credit_contract

integer | null

是否占用授信

可选

默认否

pay_fee_rate

string | null

费率

可选

承兑为招行时承兑类型为普通承兑时费率必填

acceptor_type

integer | null

承兑类型

可选

招行直联银承出票且出票方式为（全额保证金开票、一定比例保证金开票、资产池开票、信用开票）必填；枚举值：
1 在线承兑，
2 普通承兑；

protocol_no

string | null

协议号

可选

建行出票必填

comment

string

备注

可选

limit_code

string | null

额度编号

可选

云信出票必填；招行电子银行承兑汇票出票且开票方式为信用开票或一定比例保证金开票必填

drawer_info

object

出票人信息

必需

付方信息

payee_info

object

收款人信息

必需

acceptor_info

object | null

承兑人信息

可选

票据类型为电子银行承兑汇票、电子商业承兑汇票时不能为空

quota_info

object | null

云信额度信息

可选

云信出票必填

agent_info

object

集团代理开票信息

可选

集团代理开票时必填

bail_info

object | null

保证金信息

必需

出票方式为：一定比例保证金、全额保证金时必填

credit_info_rows

array [object {1}] | null

占用授信合同信息

必需

出票方式为：信用开票，一定比例保证金出票时选填

示例

{
    "tenant_id": "21",
    "source_batch_no": "proident eu pariatur cupidatat commodo",
    "bill_info_rows": [
        {
            "source_serial_number": "38",
            "bill_type_code": 13,
            "bill_open_way": 6,
            "online_type": 1,
            "amount": 800,
            "open_bill_date": "2025-10-15",
            "end_bill_date": "2024-10-19",
            "bill_version_type_code": "BILL02",
            "bill_code": "65",
            "is_allow_endorse": 1,
            "split_flag": 1,
            "biz_type_code": "HK",
            "sign_date": "2024-01-22",
            "is_agent": 0,
            "is_occupy_credit_contract": 0,
            "pay_fee_rate": 73,
            "acceptor_type": 42,
            "protocol_no": "proident voluptate eu elit",
            "comment": "consectetur nostrud",
            "limit_code": "41",
            "drawer_info": {
                "account_number": "75",
                "org_name": "邓锐专用",
                "org_code": "100011"
            },
            "payee_info": {
                "payee": "ex",
                "account_name": "着交只",
                "account_number": "28",
                "bank_branch_name": "层层接",
                "bank_branch_code": "16",
                "social_credit_code": "66"
            },
            "acceptor_info": {
                "acceptor": null,
                "account_number": "33",
                "account_name": "将什理",
                "bank_branch_name": "况安相",
                "bank_branch_code": "1"
            },
            "quota_info": {
                "core_entpay_type": 13
            },
            "agent_info": {
                "org_name": "根且九",
                "org_code": "19",
                "account_number": "61",
                "account_name": "节身养",
                "bank_branch_name": "为月见",
                "bank_branch_code": "4"
            },
            "bail_info": null,
            "credit_info_rows": [
                {
                    "occupy_credit_no": "elit minim pariatur id ullamco"
                },
                {
                    "occupy_credit_no": null
                }
            ],
            "bill_attachment_rows": null
        }
    ]
}

示例代码

Java

Shell

JavaScript

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v3/bill/draw/apply' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tenant_id": "21",
    "source_batch_no": "proident eu pariatur cupidatat commodo",
    "bill_info_rows": [
        {
            "source_serial_number": "38",
            "bill_type_code": 13,
            "bill_open_way": 6,
            "online_type": 1,
            "amount": 800,
            "open_bill_date": "2025-10-15",
            "end_bill_date": "2024-10-19",
            "bill_version_type_code": "BILL02",
            "bill_code": "65",
            "is_allow_endorse": 1,
            "split_flag": 1,
            "biz_type_code": "HK",
            "sign_date": "2024-01-22",
            "is_agent": 0,
            "is_occupy_credit_contract": 0,
            "pay_fee_rate": 73,
            "acceptor_type": 42,
            "protocol_no": "proident voluptate eu elit",
            "comment": "consectetur nostrud",
            "limit_code": "41",
            "drawer_info": {
                "account_number": "75",
                "org_name": "邓锐专用",
                "org_code": "100011"
            },
            "payee_info": {
                "payee": "ex",
                "account_name": "着交只",
                "account_number": "28",
                "bank_branch_name": "层层接",
                "bank_branch_code": "16",
                "social_credit_code": "66"
            },
            "acceptor_info": {
                "acceptor": null,
                "account_number": "33",
                "account_name": "将什理",
                "bank_branch_name": "况安相",
                "bank_branch_code": "1"
            },
            "quota_info": {
                "core_entpay_type": 13
            },
            "agent_info": {
                "org_name": "根且九",
                "org_code": "19",
                "account_number": "61",
                "account_name": "节身养",
                "bank_branch_name": "为月见",
                "bank_branch_code": "4"
            },
            "bail_info": null,
            "credit_info_rows": [
                {
                    "occupy_credit_no": "elit minim pariatur id ullamco"
                },
                {
                    "occupy_credit_no": null
                }
            ],
            "bill_attachment_rows": null
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应code

必需

6位自定义错误码

msg

string

响应信息

必需

success

boolean

是否成功

必需

data

object

响应数据

必需

source_batch_no

string

来源批次号

必需

fail_data

object

失败数据集合

必需

示例

异常示例异常示例成功示例

{
    "code": "400001",
    "msg": "参数校验失败:[是否直联[online_type]取值范围为[0-否,1-是],票据版本类型[bill_version_type_code]取值范围为[BILL01-一代票、BILL02-二代票],是否允许流转[is_allow_endorse]取值范围为[0-否,1-是],是否允许拆分[split_flag]取值范围为[0-否,1-是]]",
    "data": null
}

业务错误码#

请求参数

示例代码

返回响应

业务错误码