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