2.5.10.2适用不动产租赁行业


接口地址

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

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

使用场景:

商户在交易完成后,调用此接口上送交易及开票信息进行自动开票。此接口为异步接口,调用成功后获取开具状态,需要对接《2.5.9发票开具通知》或《2.5.6发票状态查询》接口。

请求参数:

参数

参数名称

取值

可空

最大长度

备注

cusid

商户号

平台分配的机构商户号

15

 

orgid

机构号

平台分配的机构商户号

如果非机构号,则填空

15

 

appid

应用ID

平台分配的机构APPID

8

 

amt

金额

 

double

总价税合计,所有发票行单行金额合计的累加,展示在发票的价税合计处

单位:元

prodcode

商品信息

Jsonarray格式,字段见下方商品信息字段,请注意不动产行业额外字段

 

最多支持8个商品信息

title

发票抬头

jsonobject格式,字段见下方

发票抬头字段

 

 

tltrxid

通联侧交易流水号

 

 

 

fapiaobilltype

发票类型

COMM_FAPIAO:增值税普通发票

VAT_FAPIAO:增值税专用发票

 

 

remark

备注

 

200

 

version

版本号

接口版本号

2

默认填11

randomstr

随机字符串

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

32

 

sign

签名

 

32

详见安全规范

 

 

响应参数:

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

 

8

此字段是通信标识,非交易结果,开票状态会有延迟。

retmsg

返回码说明

 

100

 

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

applyid

发票申请单号

 

50

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

sign

签名

 

32

详见安全规范


yinjr 2026年1月16日 11:07 收藏文档