1.注意:只适用于在线支付个人支付情况的订单,企业支付不会开小票,只会开 具大发票 2.需要在预定后,员工在页面发起开票申请;或者在前台统一发起开票申请 3.调用流程:先调用下方的 "申请开票" 接口 ,再调用下方的 "发票查询" 接口
参数名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
partnerCode | String | 企业编码 | 是 |
invoiceTitle | String | 发票抬头 | 是 |
socialCreditCode | String | 纳税人识别号码 | 是 |
orders | [Object] | 需要开具发票的订单。仅出票单号和改签单号(正单);退票单号(退单)无需提供。 | 是 |
参数名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
orderId | Long | 订单号 | 是 |
travellers | [Object] | 接收电子发票方式 | 否 |
参数名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
userName | String | 用户姓名 | 是 |
String | 接收电子发票邮箱 | 否 |
订单号参数中如果有部分订单已开票,返回错误,已申请过的订单但未开票则会更新申请信息
{
"error": "0",
"error_description": "success"
}
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
error | String | 响应码,0 则成功 | 是 |
error_description | String | 响应信息 | 是 |
参数名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
orderIds | [Long] | 订单号 | 否 |
startTime | String | 开票时间-起始,格式 "2019-10-12 12:22:33" | 否 |
endTime | String | 开票时间-结束,格式 "2019-10-12 12:22:33" | 否 |
bizType | String | 业务类型,FLIGHT-国内机票,HOTEL-国内酒店,INTL_FLIGHT-国际机票,INTL_HOTEL-国际酒店 | 否 |
empCode | String | 员工编码 | 否 |
invoiceTitle | String | 发票抬头 | 否 |
socialCreditCode | String | 社会信用代码 | 否 |
officialInvoice | Boolean | true-因公订单的发票,false-因私订单的发票,不提供则不区分因公因私 | 否 |
{
"error":"0",
"error_description":"success",
"data":[
{
"orderId":123,
"bizType":"FLIGHT",
"invoiceNo":"kjg;aj",
"invoiceCode":"jojhkgq",
"invoiceUrl":"https://invoice.com",
"invoiceType":"VALID",
"invoiceCheckCode":"falkjfa",
"taxControlCode":"alfjajf",
"invoiceAmount":10000,
"invoiceDate":"2020-07-23 00:00:00",
"invoiceTitle":"发票抬头",
"socialCreditCode":"纳税人识别号",
"userAmount":[
{
"userName":"张三",
"amount": 100.00,
"empCode":"001"
}
]
}
]
}
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
error | String | 返回码,0 则成功 | 是 |
error_description | String | 返回信息 | 是 |
data | [Object] | 返回数据集合 | 是 |
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
orderId | Long | 订单号 | 是 |
bizType | String | 业务类型 FLIGHT:国内机票; HOTEL:国内酒店; TRAIN:火车票; GENERAL:需求单; INSURANCE:保险; CAR:用车; INTL_FLIGHT:国际/中国港澳台机票; INTL_HOTEL:国际/中国港澳台酒店; INTL_TRAIN:国际火车票; FLIGHT_CHEAP:国内机票(廉航); SERVICE_FEE:服务费; TRAIN_TICKET_SERVICE:火车票代打; FLIGHT_REFUND_FEE:机票退票费; INTL_FLIGHT_REFUND_FEE:国际机票退票费; HOTEL_PROTOCOL:酒店(协议); INTL_HOTEL_PROTOCOL:国际酒店(协议); TRAIN_REFUND_CHANGE_FEE:火车票退改费; TRAIN_GRAB_FEE:火车票抢票费; | 是 |
invoiceNo | String | 电子发票号码 | 是 |
invoiceCode | String | 电子发票代码,注:数电票没有此值 | 否 |
invoiceUrl | String | 电子发票 URL | 是 |
invoiceType | String | 开票类型,VALID-有效票、RED-红冲票、INVALID-被红冲票 | 是 |
invoiceMode | String | 开票模式:ZENG_PU:普票 ZENG_ZHUAN:专票 E_AIR_TRANSPORT:电子行程单 E_TRAIN_TRANSPORT:火车数电票 | 是 |
invoiceCheckCode | String | 校验码,注:数电票没有此值 | 否 |
taxControlCode | String | 税控码,注:数电票没有此值 | 否 |
invoiceAmount | Double | 开票金额(分) | 是 |
invoiceDate | String | 开票日期 | 是 |
invoiceTitle | String | 发票抬头 | 是 |
socialCreditCode | String | 纳税人识别号码 | 是 |
userAmount | [Object] | 出行人及金额,到分 | 是 |
electronicItinerary | [Object] | 电子行程单信息(电子行程单信息由于扫描识别的原因,每个字段都有可能缺失的情况) | 否 |
trainTicketFormatSupport | [Object] | 火车数电票信息(火车数电票信息由于扫描识别的原因,每个字段都有可能缺失的情况) | 否 |
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
userName | String | 出行人姓名 | 是 |
empCode | String | 出行人编码(非员工为空) | 否 |
amount | String | 开票金额(元) | 是 |
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
orgInvoiceNo | String | 原票号 | 否 |
openStatus | String | 开票状态 | 否 |
travellerName | String | 出行人姓名 | 是 |
idNo | String | 证件号码 | 是 |
changeRemark | String | 签注 | 否 |
ticketPrice | String | 票价(分) | 否 |
fuelCharge | String | 燃油附加费(分) | 否 |
vatRate | String | 增值税率(分) | 是 |
vatTax | String | 增值税税额(分) | 是 |
civilAviationDevelopmentFund | String | 民航发展基金(分) | 否 |
otherTax | String | 其他税费(分) | 否 |
total | String | 合计(分) | 是 |
ticketNo | String | 电子客票号码 | 是 |
checkCode | String | 验证码 | 否 |
insurance | String | 保险费 | 否 |
saleNetCode | String | 销售网点代号 | 否 |
fillUnit | String | 填开单位 | 否 |
fillDate | String | 填开日期 | 否 |
buyerName | String | 购买方名称 | 是 |
taxpayerId | String | 统一社会信用代码/纳税人识别号 | 是 |
invoiceNo | String | 发票号码 | 是 |
itineraryList | [Object] | 行程信息 | 否 |
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
index | String | 顺序 | 是 |
flightSegment | String | 顺序 | 是 |
itineraryStart | String | 行程 -自 | 是 |
itineraryEnd | String | 行程 -至 | 是 |
carrier | String | 承运人 | 是 |
flightNo | String | 航班号 | 是 |
seatLevel | String | 座位等级 | 否 |
travellerDate | String | 出行日期 | 是 |
travellerTime | String | 出行时间 | 是 |
customLevel | String | 客票级别/客票类别 | 否 |
effectDate | String | 客票生效日期 | 否 |
effectEndDate | String | 有效截止日期 | 否 |
freeBaggage | String | 免费行李 | 是 |
字段名称 | 数据类型 | 说明 | 必须 |
---|---|---|---|
invoiceNo | String | 发票号码 | 是 |
typeOfVoucher | String | 票种 类型:电子发票(铁路电子客票) | 否 |
fillDate | String | 填开日期:2025-02-19 | 否 |
typeOfBusiness | String | 业务类型:退 、售、改; 退:退票差额、退票费; 售:票价; 改:改签费 | 否 |
departureStation | String | 出发站:苏州北 | 否 |
phonicsOfDepartureStation | String | 出发站拼音 :Suzhoubei | 否 |
destinationStation | String | 到达站 :南昌西 | 否 |
phonicsOfDestinationStation | String | 到达站拼音: Nanchangxi | 否 |
trainNumber | String | 车次:G1377 | 否 |
travelDate | String | 出发日期:2025-02-18 | 否 |
departureTime | String | 出发时间: 08:51 | 否 |
seatLevel | String | 座位等级:一等座 | 否 |
carriage | String | 车厢:02车 | 否 |
seat | String | 座位号:14A号 | 否 |
fare | String | 票价(分) | 否 |
eTicketNumber | String | 电子客票号:6685489086021191422123456 | 否 |
idNumber | String | 乘车人证件号:3101221990****1234 | 否 |
name | String | 乘车人姓名:张三 | 否 |
totalAmountExcludingTax | String | 不含税总金额(分) | 否 |
taxRate | String | 税率:6、9 | 否 |
taxAmount | String | 税费(分) | 否 |
nameOfPurchaser | String | 开票抬头:上海东方明珠电视有限公司 | 否 |
socialCreditCode | String | 开票统一代码: 91512345AB7DY35S6B | 否 |
error | error_description |
---|---|
-1 | 未知异常 |
191104 | 订单号与企业编码不匹配 |
191103 | 无效订单 |
191102 | 电子发票查询失败 |
191101 | 已经申请过 |
191100 | 电子发票申请失败 |
191098 | 企业编码错误 |
191097 | 企业编码不能为空 |
191096 | 订单号不能为空 |
191095 | 发票抬头不能为空 |
191094 | 社会信用代码不能为空 |
191093 | 社会信用代码不正确 |
191092 | 需要开具发票的订单不能为空 |
191091 | 用户姓名不能为空 |
191090 | 订单号数量不超过100 |
191089 | 开票时间不能为空 |
191088 | 开票时间格式错误 |
191087 | 开票起始时间到开票结束时间不能超过7天 |
191086 | 邮箱错误 |
191085 | 开票类型错误 |