开具发票二维码

接口名称:/open/invoice/invoiceQrCode

请求参数:

字段 类型 必填项 描述
merchantCode text 机构商户号
tradeNo text 交易流水号
tradeTime text 交易时间 yyyy-MM-dd HH:mm:ss格式
amount text 开票金额(含税)
invoiceType text 10:增值税电子普通发票, 04:增值税普通发票, 01:增值税专用发票,9:区块链电子发票,08:增值税电子专用发票(成品油),81:电子发票(增值税专用发票),82:电子发票(普通发票)
outTransNo text 商户外部流水号,全局唯一最长50位(必填)
qrcodeNo text 最多20位,后面将弃用
specialInvoiceKind text 成品油票需要传:08,收购发票需要传:02(注:收购发票只能开具税率为 0、免税、不征税的发票),其他票种可以为空
expireTime text 二维码过期时间,不传默认7天,yyyy-MM-dd HH:mm:ss格式
notifyUrl text 开票结果后台通知地址
items Json Array 开票项目列表

开票项目列表:

字段 类型 必填项 描述
taxClassificationCode text 税收分类编码
itemName text 开票项目名称
taxRateValue text 税率(0.13,小数点后2位)
quantity text 数量(小数点后 8 位,如果不传值,将根据项目金额、单价计算该值。如果单价也没传值,数量将默认为 1。为 0 时票面数量显示为空。单价数量必须同时为 0 或同时不为 0)
meteringUnit text 单位
specificationModel text 对应规格型号
unitPrice text 单价(精确到8位小数) 如果不传值,将根据项目金额、数量计算该值。为 0 时票面单价显示为空。
zeroTaxFlag text 非零税率传"",0:出口零税,1:免税,2:不征税,3:普通零税率
invoiceItemDisAmount text 小数点后 2 位,只能为负数。开票金额需减去折扣金额
invoiceItemAmount text 开票项目金额(小数点后 2 位,以元为单位精确 到分(=单价*数量))
preferentialPolicyFlag text 优惠政策标识,空:不使用,1:使用
vatSpecialManage text 增 值 税 特 殊 管 理,preferentialPolicyFlag 优惠政策标识位1 时必填

响应:

extractCode text 提取码
shortUrl text 电子发票短链接
invoiceUrl text 电子发票链接
outTransNo text 商户外部流水号

后台通知:

通知类型 event: InvoiceNotify

code text 发票状态码:0000:开票成功;6666:未开票(撤回开票中发票);9999:开票失败。
msg text 发票状态描述(成功/失败原因)
invoiceType text 开票类型1:蓝票;2:红票;3:蓝废;4:红废。
reqSerialNo text 发票请求流水号,旧
invoiceReqSerialNo text 发票请求流水号
outTransNo text 商户外部流水号
tradeNo text 订单号,开票成功时必传,失败时不传
invoiceCode text 发票代码,开票成功时必传,失败时不传
invoiceNo text 发票号码,开票成功时必传,失败时不传
invoiceDate text 开票日期,开票成功时必传yyyy-MM-dd HH:mm:ss,失败时不传
downloadUrl text 发票下载Url,电子发票开票成功时,即发票种类代码为 10 或 08 时必传,失败时不传,不定长,Base64字符串,其他发票种类不传
securityCode text 效验码,开票成功时必传,失败时不传
buyerName text 购买方名称
buyerTaxpayerNum text 购买方纳税人识别号
buyerAddress text 购买方地址
buyerTel text 购买方电话
buyerBankName text 购买方开户行
buyerBankAccount text 购买方银行账号

接入商接收到异步通知后,响应“SUCCESS”这7个大写字母即表示通知成功,不成功的将会在下次尝试通知,通知频率为5s/10s/15s ······,最多通知20次