接口地址
生产环境: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 |
详见安全规范 |