数电票开具旅客运输服务蓝字全电发票接口

2.24. 开具旅客运输服务蓝字全电发票
2.24.1. 调用说明
项目说明内容备注
调用关系第三方平台调用票通平台
调用方式https POST 方式提交
接口地址测试地址：
http://fpkj.testnw.vpiaotong.cn/tp/openapi/invoiceBlue.pt
正式地址：
https://fpkj.vpiaotong.com/tp/openapi/invoiceBlue.pt
字符编码UTF-8
2.24.2. 请求报文
请求参数-业务报文部分：
字段名称类型必填说明
开票基本信息
taxpayerNum 销售方纳税人
识别号
String(15-20) 是销售方纳税人识别号,长度校
验规则为字符长度，只能包括
大写英文字母或数字
invoiceReqSerialNo 发票请求流水
号
String(20) 是4 位平台简称+16 位随机数,长
度校验规则为字符长度，只能
包括英文字母或数字，唯一
invoiceIssueKindCode 开具发票种类String(1-2) 是开具发票种类。
81：电子发票（增值税专用发
票）
82：电子发票（普通发票）
buyerName 购买方名称String(1-100) 是票面信息，发票抬头，无默认
长度校验规则为GBK 字节长
度，不能包含<>字符
buyerTaxpayerNum 购买方纳税人
识别号
String(15-20) 否票面信息，无默认,长度校验规
则为字符长度，只能包括大写
英文字母或数字
naturalPersonFlag 是否开具给自
然人
String（1） 否是否开具给自然人。默认0。
0：否；
1：是。电子税局勾选“是”时
票通数电发票接口文档
的提示：请您确认受票方为自
然人，并在纳税人识别号档次
填入“自然人纳税人识别号”
(自然人受票方可登录个人所
得税APP 查看“自然人纳税人
识别号”)，该张发票将在受票
方自然人个人票夹中展示。
buyerAddress 购买方地址String(1-100) 否票面信息，无默认，长度校验
规则为GBK 字节长度，
buyerAddress、buyerTel 两个
字段总长度不超100 位GBK 字
节。
buyerTel 购买方电话String(1-20) 否票面信息，无默认，长度校验
规则为字符长度，只能是数字、
中英文括号、中英文横杠。
buyerAddress、buyerTel 两个
字段总长度不超100 位GBK 字
节。
buyerBankName 购买方开户行String(1-100) 否票面信息，无默认，长度校验
规则为GBK 字节长度。
buyerBankName、
buyerBankAccount 两个字段总
长度不超100 位GBK 字节。
buyerBankAccount 购买方银行账
号
String(1-50) 否票面信息，无默认，长度校验
规则为字符长度。
buyerBankName、
buyerBankAccount 两个字段总
长度不超100 位GBK 字节。
sellerAddress 销货方地址String(1-100) 否票面信息，长度校验规则为GBK
字节长度。如果不传值，取平
台企业开票设置中的企业开票
地址电话信息（如有多条取默
认的，没有默认取最后一条）。
sellerAddress、sellerTel 两
个字段总长度不超100 位GBK
字节。
sellerTel 销货方电话String(1-20) 否票面信息，长度校验规则为字
符长度，只能是数字、中英文
括号、中英文横杠。如果不传
值，取平台企业开票设置中的
企业开票地址电话信息（如有
多条取默认的，没有默认取最
后一条）。
sellerAddress、sellerTel 两
票通数电发票接口文档
个字段总长度不超100 位GBK
字节。
sellerBankName 销货方开户行String(1-100) 否票面信息，长度校验规则为GBK
字节长度。如果不传值，取平
台企业开票设置中的开户行及
银行账号信息（如有多条取默
认的，如有一条则使用该开户
行及银行账号信息）。
sellerBankName、
sellerBankAccount 两个字段
总长度不超100 位GBK 字节。
sellerBankAccount 销货方银行账
号
String(1-50) 否票面信息，长度校验规则为字
符长度。如果不传值，取平台
企业开票设置中的开户行及银
行账号信息（如有多条取默认
的，如有一条则使用该开户行
及银行账号信息）。
sellerBankName、
sellerBankAccount 两个字段
总长度不超100 位GBK 字节。
showBuyerBank 是否显示购方
开户行及账号
到发票备注
String(1) 否是否显示购方开户行及账号到
发票备注，默认0 不显示
0:不显示
1:显示
showSellerBank 是否显示销方
开户行及账号
到发票备注
String(1) 否是否显示销方开户行及账号到
发票备注，默认0 不显示
0:不显示
1:显示
注：最终版式文件销方银行账
户取税局维护的开户行及账号
account 开票人税局账
号
String(50) 否电子税局登录账号（手机号或
身份证号），必须是通过2.1
接口进行用户登记的账号。如
果不填，随机取已在票通平台
登记的账号。
casherName 收款人名称String(1-16) 否票面信息，如果不填写，则默
认开票设置中的收款人（如果
设置了多条，取默认的，没有
默认的则为空；如果有一条，
则使用该收款人）；如果填入
则根据填入信息填入票面信
息，长度校验规则为GBK 字节
长度
reviewerName 复核人名称String(1-16) 否票面信息，如果不填写，则默
票通数电发票接口文档
认开票设置中的复核人（如果
设置了多条，取默认的，没有
默认的则为空；如果有一条，
则使用该复核人）；如果填入
则根据填入信息填入票面信
息，长度校验规则为GBK 字节
长度
takerName 收票人名称String(1-10) 否客户信息，长度校验规则为字
符长度
takerTel 收票人手机号String(11) 否客户信息，长度校验规则为字
符长度
takerEmail 收票人邮箱String(4-50) 否客户信息，填写后，票通会给
客户发送发票邮件，不填写则
不发送，长度校验规则为字符
长度
specialInvoiceKind 特殊票种String(2) 否特殊票种，默认为空。
09：旅客运输服务。
如果不传，会根据税收分类编
码自动适配特殊票种。
remark 备注String(0-240) 否票面信息，如果不填写，票面
展示为空，如果填入则根据填
入信息填入票面信息，长度校
验规则为GBK 字节长度
definedData 自定义数据String(0-200) 否自定义数据，在发票推送接口
中会按照定义返回，长度校验
规则为字符长度
tradeNo 订单号String(0-200) 否订单号，长度校验规则为字符
长度。如果没有传值，票通平
台默认使用发票请求流水号
invoiceReqSerialNo 赋值
shopNum 门店编号String（6-20） 否门店编号，取值集团版门店编
号，没有则不用填写。只允许
字母、数字
开票项目列表信息（itemList）,只能一行
itemList 开票项目列表数组或集合是只能一行
goodsName 货物名称String(1-100) 是票面信息，此项不填写时默认
为taxClassificationCode 对
应的名称，长度校验规则为GBK
字节长度
taxClassificationCo
de
对应税收分类
编码
String(1-50) 是统一编码表的信息，长度校验
规则为字符长度
specificationModel 对应规格型号String(1-40) 否票面信息，无默认，长度校验
规则为GBK 字节长度
meteringUnit 单位String(1-20) 否票面信息，无默认，长度校验
票通数电发票接口文档
规则为GBK 字节长度
quantity 数量16 位(精确到8
位小数)
否票面信息，支持到小数点前8
位。
includeTaxFlag 含税标示String(1) 否0：不含税，1：含税，默
认为0 不含税
unitPrice 单价16 位(精确到8
位小数)
否票面信息，支持到小数点前8
位,默认为不含税，可通过含税
标示includeTaxFlag，定义此
字段为含税。
invoiceAmount 金额10 位(精确到2
位小数)
是票面信息，支持到小数点前8
位,默认为不含税，可通过含税
标示includeTaxFlag，定义此
字段为含税。
taxRateValue 税率4 位(精确到2 位
小数)
是票面信息，例：0.13
taxRateAmount 税额10 位(精确到2
位小数)
否票面信息，如果不填写，默认
会根据税率计算税额，如果填
写此值会直接使用此税额,可
通过含税标示
includeTaxFlag，定义此字段
为含税
discountAmount 折扣金额10 位(精确到2
位小数)
否该商品行的折扣金额，传负数
discountTaxRateAmou
nt
折扣税额10 位(精确到2
位小数)
否票面信息，使用折扣金额进行
计算
preferentialPolicyF
lag
优惠政策标识String(1-50) 否空：不使用，1:使用
零税率标识为0、1、2 时该值
必填1。
zeroTaxFlag 零税率标识String(1) 否税率为0 时该值必填。空：非
零税率，
1：免税，
2：不征税，
3：普通零税率
vatSpecialManage 增值税特殊管
理
String(0-100) 否preferentialPolicyFlag 优惠
政策标识位1 时必填，例如填
免税、不征税、简易征收
出行人信息列表passengerTransportList
passengerTransportList 出行人信息列
表
数组或集合否出行人信息列表，非必填，如
填写，列表数据对应必填项必
填
traveler 出行人String（1-20 字
符）
是出行人
travelDate 出行日期String（10） 是出行日期。格式yyyy-MM-dd
travelerIdType 出行人证件类String（3） 是出行人证件类型。见码表3.1
票通数电发票接口文档
型旅客运输服务出行人证件类型
travelerIdNo 出行人证件号
码
String(1-20 字
符)
是出行人证件号码。提醒：证件
号码需要符合规则，切勿随意
填写。
departurePlace 出发地String(1-100) 是出发地。省市（县）区。例如：
上海市黄浦区/四川省绵阳市
涪城区/广东省河源市和平县
destinationPlace 到达地String(1-100) 是到达地。省市（县）区。例如：
上海市黄浦区/四川省绵阳市
涪城区/广东省河源市和平县
vehicleType 交通工具类型String(1) 是交通工具类型。
1:飞机；2:火车；3:长途汽车；
4:公共交通；5:出租车； 6:汽
车；7:船舶；9:其他
seatClass 等级String 否等级。
【飞机】：则值为公务舱、头
等舱、经济舱的其中一种。
【火车】：则值为一等座、二
等座、软席（软座、软卧）、
硬席（硬座、硬卧）的其中一
种。
【船舶】：则值为一等舱、二
等舱、三等舱的的其中一种。
报文示例：
{
"taxpayerNum": "91XXXXXXXXXXXXX31",
"invoiceReqSerialNo": "XXXX5678901234567890",
"invoiceIssueKindCode ": "82",
"buyerName": "北京XXXXX 技术有限公司",
"buyerTaxpayerNum": "9211XXXXXXX365M",
"buyerAddress": "北京市海淀区XXXXXX15 号5 层",
"buyerTel": "010 - 1234567 ",
"buyerBankName": "XXXX 银行",
"buyerBankAccount": "9878XXXXXX45666",
"sellerAddress": "北京海淀区XXX 路15 号",
"sellerTel": "010-7654321",
"sellerBankName": "XXXXX 银行",
"sellerBankAccount": "6217XXXXXXX0678",
"remark": "备注",
"tradeNo": "DEMO1111111111",
"definedData": "自定义数据",
"account": "185XXXXXXXX",
"takerName": "XXX",
票通数电发票接口文档
"takerTel": "XXXXXXX",
"takerEmail": "XXXXX@qq.com",
"specialInvoiceKind": "09",
"itemList": [{
"goodsName": "车费",
"taxClassificationCode": "3010101020101010000",
"specificationModel": "",
"meteringUnit": "",
"quantity": "1.00",
"includeTaxFlag": "1",
"unitPrice": "100",
"invoiceAmount": "100.00",
"taxRateValue": "0.09"
}],
"passengerTransportList": [{
"traveler": "张三",
"travelDate": "2022-12-30",
"travelerIdType": "201",
"travelerIdNo": "101101198811119018",
"departurePlace": "上海市黄浦区",
"destinationPlace": "广东省河源市和平县",
"vehicleType": "3",
}, {
"traveler": "李四",
"travelDate": "2022-12-30",
"travelerIdType": "201",
"travelerIdNo": "101101198811119019",
"departurePlace": "上海市黄浦区",
"destinationPlace": "广东省河源市和平县",
"vehicleType": "3",
}]
}
2.24.3. 响应报文
响应参数-业务报文部分：
字段名称类型必填说明
invoiceReqSerialNo 发票请求流水
号
String(20) 是4 位平台简称+16 位随机数
qrCodePath 二维码url String 否不定长，Base64 字符串，电子
发票该值必传
qrCode 二维码图片
Base64 字符串
String 否扫码查看发票开票状态，二维
码的内容是qrCodePath，电子
票通数电发票接口文档
发票该值必传
报文示例：
{
"invoiceReqSerialNo": "XXXX5678901234567890",
"qrCodePath": "xxxxxxxxxxxxx",
"qrCode": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
2.24.4. 业务错误码
从业务中抽取代码并进行定义
错误码（code） 含义说明（msg）
9997 纳税人识别号无效
8993 开票请求处理失败(对应参考返回的详细信息)
8996 业务异常，请联系运维
8995 数据校验不通过(对应参考详细信息)
8004 找不到对应的开票企业信息，请检查税号
8005 找不到对应的税收分类编码，请参照税收分类编码表，检查编码号
8006 找不到对应的税率，请输入正确的税率
8007 折扣金额不可大于对应商品行金额/折扣金额和折扣率不匹配
8008 优惠政策不为空时，增值税特殊管理不能为空
8009 企业注册/修改中不能开票
8011 税额与税率不匹配
8012 差额开票抵扣金额过大，不能超过价税合计金额
8013 差额开票只允许单个商品行
8014 税率为0 时，零税率标示必须选择
8015 不存在对应的零税率标示
8016 单价数量金额不匹配
8017 折扣税额和税率不匹配
8021 发票请求流水号已存在，请更换发票请求流水号
8040 该发票请求流水号正在处理中，请稍后查询开票结果
2.24.5. 适用税收分类编码
税收分类编码商品和服务名称
商品和服务
分类简称
增值税税率征收率
3010101010100000000 国内铁路旅客运输服务运输服务9% 3%
3010101010200000000 国际铁路旅客运输服务运输服务9% 3%
3010101010300000000 港澳台铁路旅客运输服务运输服务9% 3%
3010101020101010000 国内长途汽车旅客运输服务运输服务9% 3%
票通数电发票接口文档
3010101020101020000 国际长途汽车旅客运输服务运输服务9% 3%
3010101020101030000 港澳台长途汽车旅客运输服务运输服务9% 3%
3010101020102000000 其他公路旅客运输服务运输服务9% 3%
3010101020201000000 公共电汽车客运服务运输服务9% 3%
3010101020202000000 城市轨道交通服务运输服务9% 3%
3010101020203000000 出租汽车客运服务运输服务9% 3%
3010101020204000000 索道客运服务运输服务9% 3%
3010101020299000000 其他城市旅客公共交通服务运输服务9% 3%
3010201010000000000 国内水路旅客运输服务运输服务9% 3%
3010201020000000000 国际水路旅客运输服务运输服务9% 3%
3010201030000000000 港澳台水路旅客运输服务运输服务9% 3%
3010203010000000000 水路旅客运输期租业务运输服务9% 3%
3010204010000000000 水路旅客运输程租业务运输服务9% 3%
3010301010100000000 国内航空旅客运输服务运输服务9% 3%
3010301010200000000 国际航空旅客运输服务运输服务9% 3%
3010301010300000000 港澳台航空旅客运输服务运输服务9% 3%
3010301030100000000 航空旅客运输湿租业务运输服务9% 3%
3010502010100000000 无运输工具承运铁路旅客运输服务运输服务9% 3%
3010502020100000000 无运输工具承运道路旅客运输服务运输服务9% 3%
3010503010000000000 无运输工具承运水路旅客运输服务运输服务9% 3%
3010504010000000000 无运输工具承运航空旅客运输服务运输服务9% 3%
3010506010000000000 无运输工具承运旅客联运运输服务运输服务9% 3%
3010599010000000000 其他无运输工具承运旅客运输业务运输服务9% 3%
3010601000000000000 旅客联运服务运输服务9% 3%
3019901000000000000 其他旅客运输服务运输服务9% 3%