数电发票开接不地产租赁蓝字发票接口

2.23. 开具不动产租赁蓝字全电发票
2.23.1. 调用说明
项目说明内容备注
调用关系第三方平台调用票通平台
调用方式https POST 方式提交
接口地址测试地址http://fpkj.testnw.vpiaotong.cn/tp/openapi/invoiceBlue.pt
正式地址：https://fpkj.vpiaotong.com/tp/openapi/invoiceBlue.pt
字符编码UTF-8
2.23.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) 否特殊票种，默认为空。
06：不动产经营租赁服务。如果不传，会根据税收分类编码自动适配特殊票种。
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
位小数)
否该商品行的折扣金额，传负数
discountTaxRateAmount
折扣税额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 时必填，填免税、
不征税、简易征收等
特定业务--不动产经营租赁服务（realEstateRentalService），不动产经营租赁服务相关的税收分类
编码，必填
realEstateRentalService 不动产经营租赁服务
Object 是特定业务不动产经营租赁服务
必填
region 省市（县）区String（4-50） 是不动产所在省市（县）区。
例如：上海市黄浦区/四川省绵
阳市涪城区/广东省河源市和
平县
detailedAddress 详细地址String（1-100
字符）
是不动产详细地址。例如：东江
北路68 号
areaUnit 面积单位String 是面积单位。
米（铁路线与管道等使用）
平方千米
平方米
公顷
亩
h ㎡
k ㎡
㎡
crossCitySign 跨地(市)标志String(1) 是跨地(市)标志。
0：否；
1：是
leaseTerm 租赁期起止String(21) 是租赁期起止。例如
2022-12-01 2022-12-12
titleNo 产权证书/不动产权号
String（0-40 字
符）
否产权证书/不动产权号。
若没有证书填写“无”。
报文示例：
{
"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",
"itemList": [{
"goodsName": "停车费",
"taxClassificationCode": "3040502020200000000",
"specificationModel": "",
"meteringUnit": "",
"quantity": "1.00",
"includeTaxFlag": "1",
"unitPrice": "100",
"invoiceAmount": "100.00",
"taxRateValue": "0.09"
}],
"realEstateRentalService": {
"region": "四川省绵阳市涪城区",
"detailedAddress": "东江北路68 号",
"areaUnit": "㎡",
"crossCitySign": "0",
"leaseTerm": "2022-12-01 2022-12-12",
"titleNo": "无"
}
}
2.23.3. 响应报文
响应参数-业务报文部分：字段名称类型必填说明
invoiceReqSerialNo 发票请求流水号
String(20) 是4 位平台简称+16 位随机数
qrCodePath 二维码url String 否不定长，Base64 字符串，电子发票该值必传
qrCode 二维码图片String 否扫码查看发票开票状态，二维
票通数电发票接口文档
Base64 字符串码的内容是qrCodePath，电子
发票该值必传
报文示例：
{
"invoiceReqSerialNo": "XXXX5678901234567890",
"qrCodePath": "xxxxxxxxxxxxx",
"qrCode": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
2.23.4. 业务错误码
从业务中抽取代码并进行定义
错误码（code） 含义说明（msg）
9997 纳税人识别号无效
8993 开票请求处理失败(对应参考返回的详细信息)
8996 业务异常，请联系运维
8995 数据校验不通过(对应参考详细信息)
8004 找不到对应的开票企业信息，请检查税号
8005 找不到对应的税收分类编码，请参照税收分类编码表，检查编码号
8006 找不到对应的税率，请输入正确的税率
8007 折扣金额不可大于对应商品行金额/折扣金额和折扣率不匹配
8008 优惠政策不为空时，增值税特殊管理不能为空
8009 企业注册/修改中不能开票
8011 税额与税率不匹配
8012 差额开票抵扣金额过大，不能超过价税合计金额
8013 差额开票只允许单个商品行
8014 税率为0 时，零税率标示必须选择
8015 不存在对应的零税率标示
8016 单价数量金额不匹配
8017 折扣税额和税率不匹配
8021 发票请求流水号已存在，请更换发票请求流水号
8040 该发票请求流水号正在处理中，请稍后查询开票结果
2.23.5. 适用税收分类编码
税收分类编码商品和服务名称商品和服务分类简称增值税税率征收率
3040501030000000000 不动产融资租赁服务融资租赁9% 5%
3040502020101000000 公共住房租赁经营租赁9% 5%
3040502020102000000 个人出租住房经营租赁9% 5%
3040502020199000000 其他住房租赁服务经营租赁9% 5%
票通数电发票接口文档
3040502020200000000 车辆停放服务经营租赁9% 5%
3040502020400000000 商业营业用房经营租赁服务经营租赁9% 5%
3040502029901000000 军队空余房产租赁服务经营租赁9% 5%
3040502029902000000 其他情形不动产经营租赁服务经营租赁9% 5%