基本信息
|
HTTP URL |
/river/Invoice/billbiz |
|---|---|
|
HTTP Method |
POST |
|
权限要求 |
|
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/json |
请求参数
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
client_id |
申请应用时分配的AppKey |
string |
Y |
申请应用时分配的AppKey |
|
access_token |
授权后的access token |
string |
Y |
授权后的access token |
|
timestamp |
当前时间戳 |
bigint |
Y |
当前时间戳 |
|
company_id |
公司编号 |
string |
Y |
公司编号 |
|
sign |
签名 |
string |
Y |
签名 |
|
|
|
|
|
|
|
settle_type |
品类 |
int |
N |
子品类，新接入使用201：国内酒店202：国内机票204：国际酒店203：火车票205：国际机票531：增值手工单新品类字段，旧字段sub_business_type逐步废弃 |
|
receiver |
收件人 |
string |
N |
收件人（如果开机票行程单、火车票票根，必须填写） |
|
receiver_phone |
收件人电话 |
string |
N |
收件人电话（如果开机票行程单、火车票票根，必须填写） |
|
receiver_address |
收件人地址 |
string |
N |
收件人地址（如果开机票行程单、火车票票根，必须填写） |
|
receiver_email |
电子邮箱 |
string |
N |
电子邮箱(接收电子发票)不传默认收件箱为didi公邮 |
|
invoice_title |
发票抬头 |
string |
N |
发票抬头（普票必填，专票不填），优先取invocie_info的发票抬头，当invocie_info为空时必填如果发票抬头不唯一时，几要素可以确认唯一 就传几要素就可以例如1.如果抬头可以确认唯一 就传 invoice_title2.如果抬头和纳税人确认唯一就传 invoice_title+tax_registration_number如invoice_title 不唯一，会返回特定错误码，错误信息 |
|
invoice_qid |
资质id |
string |
N |
资质id（专票必填，普票不填），[专票资质列表api]返回结果中的资质ID，优先取invocie_info的资质ID，当invocie_info为空时必填 |
|
invoice_type |
发票类型 |
int |
N |
发票类型（4：数电普票，5：数电专票，6:机票行程单，7：火车票，8:invoice），优先取invocie_info的发票类型，不填，按照默认类型开具； |
|
invoice_content |
发票内容 |
string |
N |
非必填，settle_type为1时发票内容（*运输服务*客运服务费）40: * 生活服务 * 代驾服务费100: *经纪代理服务 *代订车服务 |
|
specification |
发票规格型号 |
string |
Y |
发票规格型号，默认：1-不展示2-无 |
|
invoice_no |
开票请求编号 |
string |
Y |
开票请求编号（接入方唯一标识），优先取invocie_info的开票请求编号，当invocie_info为空时必填 |
|
invoice_no_process |
是否对invoice_no做处理 |
int |
N |
是否对invoice_no做处理 0 不处理 1 处理 默认是0 |
|
bill_id |
账单id |
string |
Y |
账单id（注：如开通发票拆分，只能输入发票拆分级次的账单id），此字段从https://api.es.xiaojukeji.com/river/Bill/fetchBillable接口中返回值bill_detail_info中的bill_id获取 |
|
remark |
备注 |
string |
N |
备注(长度限制：100个字符) |
|
invoice_info |
开票信息 |
string |
N |
开票信息，如不填写，则按选择的sub_business_type将此账单涉及的费用类型的剩余可开票金额都全额开票 |
invoice_info
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
invoice_no |
开票请求编号 |
string |
yes |
开票请求编号（接入方唯一标识） |
|
|
|
|
|
子品类，201：国内酒店，20211：国内机票，204：国际酒店，203：火车票，205：国际机票，531：增值手工单 |
|
settle_type |
品类 |
string |
N |
子品类，新接入使用201：国内酒店202：国内机票204：国际酒店203：火车票205：国际机票531：增值手工单新品类字段，旧字段sub_business_type逐步废弃， |
|
fee_type |
开票费用类型 |
string |
yes |
开票费用类型，根据business_type来填写； |
|
invoice_title |
发票抬头 |
string |
no |
发票抬头（普票必填，专票不填），优先取invocie_info的发票抬头，当invocie_info为空时必填如果发票抬头不唯一时，几要素可以确认唯一 就传几要素就可以例如1.如果抬头可以确认唯一 就传 invoice_title2.如果抬头和纳税人确认唯一就传 invoice_title+tax_registration_number如invoice_title不唯一，会返回特定错误码，错误信息 |
|
invoice_qid |
资质id |
string |
no |
资质id（专票必填，普票不填），[专票资质列表api]返回结果中的资质ID |
|
invoice_type |
发票类型 |
string |
no |
发票类型 不填，按照默认类型开具 |
|
invoice_amount |
开票金额 |
string |
no |
开票金额，为空则全额开票。注：机票行程单、火车票根只能全额开票；默认保留两位小数（单位是元） |
请求示例
响应参数
|
返回值字段 |
字段类型 |
字段说明 |
|---|---|---|
|
errno |
string |
0表示成功，非0表示失败 |
|
errmsg |
string |
errno=0时为常量"SUCCESS"，errno!=0时为错误信息 |
|
data |
list |
返回数据(2025.07.21字段类型修改为list) |
data
|
参数名称 |
参数类型 |
参数说明 |
|---|---|---|
|
invoice_id |
string |
申请发票id(同一申请发票id可能对应多张发票) |
|
batch_id |
string |
批次id，同一批次多张发票 |
|
invoice_no |
string |
开票请求编号（接入方唯一标识） |
|
|
|
|
|
settle_type |
string |
子品类201：国内酒店202：国内机票204：国际酒店203：火车票205：国际机票531：增值手工单新品类字段，旧字段sub_business_type逐步废弃，新接入使用 |
|
fee_type |
string |
开票费用类型 |
|
invoice_type |
string |
发票类型（4：数电普票，5：数电专票，6：机票行程单，7：火车票票根，8：invoice，9：退改手续费，10：差价退票费，11：改签手续费） |
|
invoice_title |
string |
发票抬头 |
|
invoice_qid |
string |
资质id |
|
invoice_amount |
string |
开票金额 |
|
status |
string |
状态（0开票成功、1开票失败） |
|
errmsg |
string |
status=0时为常量"SUCCESS"，status!=0时为错误信息 |
响应示例
请求成功返回
{
"errno": 0,
"errmsg": "SUCCESS",
"data": [
{
"status": 0,
"invoice_id": "0695ff9266364dcda9a1cxxxxxxxx",
"batch_id": 1125971940000000,
"invoice_no": "222321000000000",
"sub_business_type": 201,
"settle_type": 201,
"fee_type": 11,
"invoice_type": 4,
"invoice_title": "财税代驾测试公司",
"invoice_qid": 490604,
"invoice_amount": 162.5,
"errmsg": "SUCCESS"
},
{
"status": 0,
"invoice_id": "0695ff9266364dcda9a1cxxxxxxxx",
"batch_id": 1125971940000000,
"invoice_no": "22232100000000000",
"sub_business_type": 201,
"settle_type": 201,
"fee_type": 13,
"invoice_type": 4,
"invoice_title": "财税代驾测试公司",
"invoice_qid": 490604,
"invoice_amount": 287.19,
"errmsg": "SUCCESS"
},
{
"status": 0,
"invoice_id": "0695ff9266364dcda9a1cxxxxxxxxxxxxx",
"batch_id": 1125971940000000,
"invoice_no": "22232100000000000",
"sub_business_type": 201,
"settle_type": 201,
"fee_type": 12,
"invoice_type": 4,
"invoice_title": "财税代驾测试公司",
"invoice_qid": 490604,
"invoice_amount": 2175.62,
"errmsg": "SUCCESS"
}
],
"request_id": "b7tL\/EnaLhqbTFl4YyIvuaI2xHjrxxxxxxxxxxTbAzRsPM0R"
}
请求失败返回
{
"errno": 0,
"errmsg": "SUCCESS",
"data": [
{
"status": 12025,
"invoice_id": null,
"batch_id": null,
"invoice_no": "22232100022000000",
"sub_business_type": null,
"settle_type": null,
"fee_type": null,
"invoice_type": null,
"invoice_title": null,
"invoice_qid": null,
"invoice_amount": null,
"errmsg": "账单没有剩余可开票金额"
}
],
"request_id": "7YN9f1zgAR+xxxxxxxxxxxx+dv6z8T9RMxPyKAdkzKwznW\/eZttphTGA5LFj"
}
错误码
50103(该流水号已经开过票了)
invoice_no不能重复，本次传参中的invoice_no已经被使用过，请换一个
版本记录
|
日期 |
更新人 |
更新内容 |
上线时间 |
|---|---|---|---|
|
2024.11.01 |
徐宸 |
新增 |
2024.10.23 |
|
2025.2.21 |
戴松 |
入参的invoice_type字段（包括invoice_info的invoice_type）完善说明： |
2024.10.23 |
|
2025.5.7 |
关珺丹 |
入参：新增字段settle_type，新接入使用，旧字段sub_business_type逐步废弃；入参receiver_email更新为非必填，不传默认发送给didi公邮；invoice_type更新非必填； 出参：新增字段settle_type，新接入使用，旧字段sub_business_type逐步废弃； |
2025.5.7 |
|
2025.8.21 |
周旭 |
入参fee_type字段，火车票品类新增免登服务费 |
2025.8.21 |