个付电子发票查询

💡

对接前须知

1.
注意：只适用于在线支付个人支付情况的订单，企业支付不会开小票，只会开具大发票
2.
需要在预定后，员工在页面发起开票申请；或者在前台统一发起开票申请
3.
调用流程:先调用下方的 "申请开票" 接口，再调用下方的 "发票查询" 接口

1. 申请开票

接口调用
请求方法：POST
请求地址：https://openapi.z-trip.cn/tmc/v1/invoice/request?access_token=ACCESS_TOKEN

请求参数说明

参数名称	数据类型	说明	必须
partnerCode	String	企业编码	是
invoiceTitle	String	发票抬头	是
socialCreditCode	String	纳税人识别号码	是
orders	[Object]	需要开具发票的订单。仅出票单号和改签单号（正单）；退票单号（退单）无需提供。	是

【orders】需要开具发票的订单

参数名称	数据类型	说明	必须
orderId	Long	订单号	是
travellers	[Object]	接收电子发票方式	否

【travellers】接收电子发票方式

参数名称	数据类型	说明	必须
userName	String	用户姓名	是
email	String	接收电子发票邮箱	否

💡

订单号参数中如果有部分订单已开票，返回错误，已申请过的订单但未开票则会更新申请信息

响应结果示例

{
    "error": "0",
    "error_description": "success"
}

响应结果字段说明

字段名称	数据类型	说明	必须
error	String	响应码，0 则成功	是
error_description	String	响应信息	是

2. 发票查询

接口调用
请求方法：POST
请求地址：https://openapi.z-trip.cn/tmc/v1/invoice/list?access_token=ACCESS_TOKEN

请求参数说明

参数名称	数据类型	说明	必须
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-因私订单的发票，不提供则不区分因公因私	否

> 查询条件，单次查询订单号数量不超过100，开票时间范围跨度不超过 7 天，每次查询最多1000条数据

响应结果示例

{
    "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	开票类型错误

个付电子发票查询

对接前须知#

1. 申请开票#

2. 发票查询#

对接前须知

1. 申请开票

2. 发票查询