生产环境: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开具的数电发票类型,如果不传,默认开具数电普票 |
prodcode |
商品编码 |
|
否 |
32 |
|
goodsname |
商品名称 |
|
否 |
64 |
|
quantity |
数量 |
|
可 |
Int |
数量,展示在发票中间的数量列, 100000000表示数量为1。 |
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%即征即退,数电发票模式特有字段 |
unit |
单位 |
|
可 |
10 |
单位,展示在发票中间的单位列 |
specification |
规格型号 |
|
可 |
10 |
规格型号,展示在发票中间的规格型号列。 |
rate |
税率 |
|
否 |
Int |
税率,单位为万分之一,如1300代表13%。 |
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 |
详见详见安全规范 |