接口名称:/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次