2.5.4电票二维码生成接口


生产环境:https://vsp.allinpay.com/cusapi/tlinvoice/generateInvoiceQR

测试环境:https://syb-test.allinpay.com/vsppcusapi/tlinvoice/generateInvoiceQR

使用场景:

商户调用接口生成电票二维码,此接口需要商户自行管理开票品类并上送。 

请求参数:

参数

参数名称

取值

可空

最大长度

备注

cusid

商户号

平台分配的商户号

15

 

orgid

机构号

平台分配的机构商户号

如果非机构号,则填空

15

 

appid

应用ID

平台分配的机构APPID

8

 

amt

金额

 

8

单位:元

fapiaobilltype

发票类型

 

 

body开具的数电发票类型,如果不传,默认开具数电普票
示例值:COMM_FAPIAO_BILL_TYPE:数电普票|VAT_FAPIAO_BILL_TYPE:数电专票

prodcode

商品编码

 

32

 

goodsname

商品名称

 

64

 

quantity

数量

 

Int

数量,展示在发票中间的数量列, 100000000表示数量为1。
默认值:100000000

policycode

优惠政策标识

 

Int

1:简易征收;2:稀土产品;3:免税;4:不征税;5:先征后退;6:100%先征后退;7:50%先征后退;8:按3%简易征收;9:按 5%简易征收;10:按5%简易征收减按1. 5%计征;11:即征即退30%;12:即征即退50%;13:即征即退70%;14:即征即退100%;15:超税负3%即征即退;16:超税负8%即征即退:17:超税负12%即征即退;18:超税负6%即征即退,数电发票模式特有字段
示例值:1

unit

单位

 

10

单位,展示在发票中间的单位列
示例值:次

specification

规格型号

 

10

规格型号,展示在发票中间的规格型号列。
示例值:A4

rate

税率

 

Int

税率,单位为万分之一,如1300代表13%。
现在支持的税率为0、1%、1.5%、3%、5%、6%、9%、10%、11%、13%、16%、17%
示例值:1300

remark

备注

 

100

 

notifyurl

通知地址

若不为空,则开具成功后会发起通知,详见2.5.9

 

 

version

版本号

接口版本号

2

默认填12

randomstr

随机字符串

商户自行生成的随机字符串

32

 

sign

签名

 

32

详见安全规范

响应参数:

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

 

8

此字段是通信标识,非交易结果

retmsg

返回码说明

 

100

 

以下信息只有当retcode为SUCCESS时有返回

qrurl

电票链接

 

100

 

applyid

发票申请单号

 

50

发票唯一标识,后续查询、冲红需要用此字段

sign

签名

 

32

详见详见安全规范


yinjr 2025年8月28日 17:02 收藏文档