乐企&数电发票蓝字发票开票接口

2.9. 开具数电蓝字发票
注：价税合计金额=金额+金额*税率
2.9.1.调用说明
项目说明内容备注
调用关系第三方平台调用票通平台
调用方式https POST 方式提交
接口地址测试地址：http://fpkj.testnw.vpiaotong.cn/tp/openapi/invoiceBlue.pt
正式地址：https://fpkj.vpiaotong.com/tp/openapi/invoiceBlue.pt
字符编码UTF-8
2.9.2.请求报文
请求参数-业务报文部分：字段名称类型必填说明
开票基本信息
taxpayerNum 销售方纳税人识别号
String(15-20) 是销售方纳税人识别号,长度校验规则为字符长度，只能包括大写英文字母或数字
invoiceReqSerialNo 发票请求流水号
String(20) 是4 位平台简称+16 位随机数,长度校验规则为字符长度，只能包括英文字母或数字，唯一
invoiceIssueKindCode 开具发票种类String(1-2) 是开具发票种类。
81：数电票（增值税专用发票）
82：数电票（普通发票）
10：增值税电子普通发票
08：增值税电子专用发票
不传值默认10：增值税电子普通发票
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数电发票接口文档接口进行用户登记的账号。不填，随机取已在平台登记的账号。
variableLevyFlag 全电发票差额征税标识
String（1） 否全电发票差额征税标识。
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) 否特殊票种，默认为空。
08：成品油发票
12：自产农产品销售发票，只能开具数电票（普通发票）remark 备注String(0-240) 否票面信息，如果不填写，票面展示为空，如果填入则根据填入信息填入票面信息，长度校验规则为GBK 字节长度definedData 自定义数据String(0-200) 否自定义数据，在发票推送接口中会按照定义返回，长度校验规则为字符长度tradeNo 订单号String(0-200) 否订单号，长度校验规则为字符长度。如果没有传值，平台默认使用发票请求流水号invoiceReqSerialNo 赋值数电发票接口文档shopNum 门店编号String（6-20） 否门店编号，取值集团版门店编号，没有则不用填写。只允许字母、数字开票项目列表信息（itemList）itemList 开票项目列表数组或集合是最大100 行（包括折扣行）goodsName 货物名称String(1-100) 是票面信息，此项不填写时默认为taxClassificationCode 对
应的名称，长度校验规则为GBK字节长度taxClassificationCode对应税收分类编码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 优惠政策标识String(1-50) 否空：不使用，1:使用
lag 零税率标识为1、2 时该值必填1。增值税特殊管理有值时该值必填1。
zeroTaxFlag 零税率标识String(1) 否税率为0 时该值必填。空：非零税率，
1：免税，
2：不征税，
3：普通零税率
vatSpecialManage 增值税特殊管理
String(0-100) 否preferentialPolicyFlag 优惠
政策标识位1 时必填，填免税、
不征税、简易征收等
报文示例：
{
"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": "1010101020000000000",
"specificationModel": "",
"meteringUnit": "袋",
"quantity": "1.00",
"includeTaxFlag": "1",
"unitPrice": "100",
"invoiceAmount": "100.00",
"taxRateValue": "0.13"

},
{
"goodsName": "稻谷商品",
"taxClassificationCode": "1010101010000000000",
"specificationModel": "",
"meteringUnit": "",
"quantity": "1.00",
"includeTaxFlag": "1",
"unitPrice": "2.00",
"invoiceAmount": "2.00",
"taxRateValue": "0.00",
"preferentialPolicyFlag": "1",
"zeroTaxFlag": "1",
"vatSpecialManage": "免税"
}
]
}
2.9.3.响应报文
响应参数-业务报文部分：
字段名称类型必填说明
invoiceReqSerialNo 发票请求流水号
String(20) 是4 位平台简称+16 位随机数
qrCodePath 二维码url String 否不定长，Base64 字符串，电子发票该值必传
qrCode 二维码图片
Base64 字符串
String 否扫码查看发票开票状态，二维码的内容是qrCodePath，电子
发票该值必传
报文示例：
{
"invoiceReqSerialNo": "XXXX5678901234567890",
"qrCodePath": "xxxxxxxxxxxxx",
"qrCode": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
2.9.4.业务错误码
从业务中抽取代码并进行定义
错误码（code） 含义说明（msg）
数电发票接口文档
0000 成功
9999 验签失败
9998 平台编码无效
9997 纳税人识别号无效
8993 开票请求处理失败(对应参考返回的详细信息)
8996 业务异常，请联系运维
8995 数据校验不通过(对应参考详细信息)
8004 找不到对应的开票企业信息，请检查税号
8005 找不到对应的税收分类编码，请参照税收分类编码表，检查编码号
8006 找不到对应的税率，请输入正确的税率
8007 折扣金额不可大于对应商品行金额/折扣金额和折扣率不匹配
8008 优惠政策不为空时，增值税特殊管理不能为空
8009 企业注册/修改中不能开票
8011 税额与税率不匹配
8012 差额开票抵扣金额过大，不能超过价税合计金额
8013 差额开票只允许单个商品行
8014 税率为0 时，零税率标示必须选择
8015 不存在对应的零税率标示
8016 单价数量金额不匹配
8017 折扣税额和税率不匹配
8021 发票请求流水号已存在，请更换发票请求流水号
8040 该发票请求流水号正在处理中，请稍后查询开票结果