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

签名

sub_business_type

品类

string

N

子品类，201：国内酒店，202：国内机票，204：国际酒店，203：火车票，205：国际机票，531：增值手工单

settle_type

品类

string

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的发票类型，不填，按照默认类型开具；
根据“当月票据方案”设置判断如何开票；只有费用类型可以开数电专票、普电普票时，才根据本字段传参开票。 特殊费用类型如下：
国内酒店：12-代订住宿费、15-旅游服务费，固定开“数电普票”
国内机票：21-行程单，由滴滴根据订单判断开“数电行程单”还是“纸质行程单”；22-代订机票费，23-差额发票，24-退票手续费固定开“数电普票”；
火车票：41-火车票票款、42-改签手续费、43-差价退票费是火车票票根

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_no

开票请求编号

string

yes

开票请求编号（接入方唯一标识）

sub_business_type

子品类

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来填写； 网约车、代驾、出租车为空； 201国内酒店（11-代订房费，12-代订住宿费，13-平台使用费， 14-会议服务费， 15-旅游服务费）202国内机票（21-行程单，22-代订机票费，23-差额发票，24-退票手续费，25-平台使用费）
204国际酒店（11-代订房费， 12-代订住宿费， 13-平台使用费）
203火车票（41-火车票票款、42-改签手续费、43-差价退票费、44-平台服务费、 45-退改手续费、 46-抢票服务费）
205国际机票（22-代订机票费，25-平台使用费）
531增值手工单（31-增值服务费、32-附加产品费）

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

发票类型（4：数电普票，5：数电专票，6:机票行程单，7：火车票，8:invoice），优先取invocie_info的发票类型，不填，按照默认类型开具；
根据“当月票据方案”设置判断如何开票；只有费用类型可以开数电专票、普电普票时，才根据本字段传参开票。
特殊费用类型如下：
国内酒店：12-代订住宿费、15-旅游服务费，固定开“数电普票”
国内机票：21-行程单，由滴滴根据订单判断开“数电行程单”还是“纸质行程单”；22-代订机票费，23-差额发票，24-退票手续费固定开“数电普票”；
火车票：41-火车票票款、42-改签手续费、43-差价退票费是火车票票根

invoice_amount

开票金额

string

no

开票金额，为空则全额开票。注：机票行程单、火车票根只能全额开票；默认保留两位小数（单位是元）

errno

string

0表示成功，非0表示失败

errmsg

string

errno=0时为常量"SUCCESS"，errno!=0时为错误信息

data

object

返回数据

invoice_id

string

申请发票id(同一申请发票id可能对应多张发票)

batch_id

string

批次id，同一批次多张发票

invoice_no

string

开票请求编号（接入方唯一标识）

sub_business_type

string

子品类，201：国内酒店，202：国内机票，204：国际酒店，203：火车票，205：国际机票，531：增值手工单

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时为错误信息

2024.11.01

徐宸

新增

2024.10.23

2025.2.21

戴松

入参的invoice_type字段（包括invoice_info的invoice_type）完善说明：
不开增值税发票，只开机票行程单、火车票票根也填写4；
根据“当月票据方案”设置判断如何开票；只有费用类型可以开数电专票、普电普票时，才根据本字段传参开票。
特殊费用类型如下：
国内酒店：12-代订住宿费、15-旅游服务费，固定开“数电普票”
国内机票：21-行程单，由滴滴根据订单判断开“数电行程单”还是“纸质行程单”；22-代订机票费，23-差额发票，24-退票手续费固定开“数电普票”；
火车票：41-火车票票款、42-改签手续费、43-差价退票费是火车票票根

2024.10.23

2025.5.7

关珺丹

入参：新增字段settle_type，新接入使用，旧字段sub_business_type逐步废弃；入参receiver_email更新为非必填，不传默认发送给didi公邮；invoice_type更新非必填； 出参：新增字段settle_type，新接入使用，旧字段sub_business_type逐步废弃；

2025.5.7