发票申请
接口说明
- 仅支持电子发票
- 仅支持按行程(订单)开票(新增按照金额开票需要特殊处理)
- 仅支持2年内的订单申请开票
- 每张发票行程不超过30个行程
- 电子发票单张发票最高不超过10000元(按照金额开票无此限制,扣企业额度)
- 仅支持渠道个人用车开发票;企业用车是线下对账开票
- 即时用车的高速费、停车费暂不支持开发票;一口价内已经包含高速费、停车费,可以开发票
- 发票字段做好限制
- 发票抬头:长度不能超过80个字符,不能包含特殊字符,如:∏,¥,§,℅,€,℃,£,℉,№,℡,‰,$,¢,∮,※,?,?,<,>,[,],',&,/r,/n,/t; 不能有空格
- 纳税人识别号:
- 渠道需要提示用户:非政府部门用户不填纳税人识别号可能无法正常报销(发票抬头是政府机构的没有纳税人识别号)
- 位数限制:只能是15、18、20位
- 不能有中文
- 不能有空格
- 发票备注:长度小于80个字
- 发票作废:数电发票支持PDF、OFD、XML三种格式,若申请发票作废会将所有格式发票全部作废
接口地址
https:// <SQYC_DOMAIN>/touch/partner/postInvoiceTravel
请求方式
POST
请求参数
名称 |
类型 |
是否必选 |
说明 |
invoiceTitle |
String |
yes |
发票抬头 |
invoiceContent |
Integer |
yes |
发票内容:5-客运服务费 |
phone |
String |
yes |
联系电话:是必填的 |
orderNo |
String |
yes(按订单) |
订单号(多个订单将合并成一个发票,逗号分割最大30条)P12345,P12346 |
invoiceType |
Integer |
yes |
2-电子发票 |
invoiceEmail |
String |
yes |
邮箱(电子发票为必传),校验:前后不能有空格 |
taxIDNumber |
String |
no |
纳税人识别号 |
invoiceNum |
Integer |
no |
发票张数,按订单开票可不传,默认为1 |
perAmount |
BigDecimal |
yes(按金额) |
发票金额。Ps:按金额开票为必传。按行程开票可不传 |
sign |
String |
yes |
参见sign生成算法 |
channel |
String |
yes |
渠道名称,首汽提供 |
registAddress |
String |
no |
注册地址(长度小于255个字) |
registPhone |
String |
no |
注册电话(长度小于255个字) |
openBank |
String |
no |
开户银行(长度小于255个字) |
bankAccount |
String |
no |
银行账号(长度小于255个字) |
invoiceRemark |
String |
no |
发票备注(长度小于80个字) |
isSendMail |
Integer |
no |
是否发送邮件(0-发送,1-不发送) |
routeInvoice |
Integer |
no |
1.按金额开票;2、按订单开票, 默认2 |
requestNo |
String |
no |
routeInvoice=1时(需要按照requestNo幂等) |
cpRequestNo |
String |
no |
高德发票申请幂等请求编号 |
realName |
String |
no |
出行人姓名(数电才有) |
certType |
Integer |
no |
出行人证件类型,201:身份证, 208:护照(数电才有) |
certNo |
String |
no |
出行人证件号码(数电才有) |
返回数据
名称 |
类型 |
说明 |
result |
string |
0:成功非0 :失败原因编号 |
errmsg |
string |
失败原因描述,若成功则值为空 |
data |
json |
成功时不为空 |
trackNum |
string |
发票跟踪码 |
返回示例
{
"result": "0",
"errmsg": "SUCCESS",
"data": {
"trackNum": "TEC85289B0236B2FF"
}
}
返回码说明
code |
说明 |
0 |
成功 |
1000 |
开票失败 |
7001 |
入参验证失败 |
7003 |
失败,部分订单重复申请 |
7007 |
申请开票金额小于10 |
7009 |
申请开票金额小于等于0 |
7015 |
所有订单已存在发票申请 |
7016 |
部分订单重复申请 |
7020 |
请求流水号已存在发票申请 |
7021 |
机构账户不存在 |
7023 |
账户可开票额度不足 |
7024 |
查询订单开票金额异常 |
7028 |
订单开票时间超限 |
7200 |
订单可开票金额小于等于0 |
8001 |
企业不存在 |
8002 |
用户证件号码错误 |
8003 |
用户证件类型错误 |