接口描述
将发票信息及用户信息推送给票据管家
请求方式
POST
生产调用地址
https://service.fpsd.unionpay.com/gateway/prod.do
测试调用地址
http://180.169.111.158:60006/172gateway/prod.do
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 用户信息 | userInfo | string | 256 | M-必填 | 加密传输，用户个人信息，如姓名，手机号，证件号等
|
||
| 流水号 | seqId | string | 64 | M-必填 | 同一接入方内部唯一
|
||
| 票据类型 | invoiceType | string | 32 | M-必填 | F01:普票
F02：专票
|
||
| 行业类型 | indType | string | 2 | M-必填 | F01、交通
F02、餐饮
F03、酒店
F04、运营商
F05、旅游
F06、电商
F07、快递物流
F08、零售自营
F99、其他
|
||
| 票据材质 | invoiceMaterial | string | 2 | M-必填 | 01、纸质
02、电子
|
||
| 红票蓝票 | invoiceColor | string | 2 | M-必填 | 01、蓝票
02、红票
|
||
| 开票时间 | invoiceTime | string | 100 | M-必填 | yyyy-MM-dd
HH:mm:ss格式
|
||
| 票据代码 | invoiceCode | string | 32 | M-必填 |
|
||
| 票据号码 | invoiceNo | string | 32 | M-必填 |
|
||
| 票据总金额 | amt | string | 16 | M-必填 | 单位为分
|
||
| 不含税金额 | taxExceludedAmt | string | 16 | C-按条件必填 | 单位为分，小于发票总金额。
|
||
| 税额 | taxAmt | string | 16 | C-按条件必填 | 单位为分，与不含税金额之合为发票总金额。
|
||
| 校验码 | checkCode | string | 32 | M-必填 | 发票pdf右上角，开票日期下的校验码
|
||
| 发票预览地址 | invoiceImageUrl | string | 256 | C-按条件必填 | 电票必填
|
||
| 发票下载地址 | invoiceFileUrl | string | 256 | C-按条件必填 | 电票必填
|
||
| 发票pdf游览地址 | invoicePdfUrl | string | 256 | O-选填 | 电票选填、纸票不填
|
||
| 抬头类型 | titleType | string | 2 | M-必填 | 01、个人
02、公司
|
||
| 抬头名称 | title | string | 64 | M-必填 |
|
||
| 购方信息 | buyerInfo | string | 256 | C-按条件必填 | 票据类型为专票且抬头类型为公司时必填，加密传输
|
||
| 销方信息 | salerInfo | string | 256 | M-必填 | 销售方信息，加密传输
|
||
| 商品信息 | goodsDetail | string | 15000 | M-必填 | 所售商品信息
|
||
| 优惠政策 | discountPolicyName | string | 64 | C-按条件必填 | 使用优惠政策时必填
|
||
| 是否使用优惠政策 | disCountUsed | string | 1 | M-必填 | 0、未使用
1、使用
|
||
| 原始票据代码 | origInvoiceCode | string | 32 | R-需要返回 | 红票时必填
|
||
| 原始票据号码 | origInvoiceNum | string | 32 | R-需要返回 | 红票时必填
|
||
| 备注 | remark | string | 256 | O-选填 | 发票右下角处
|
||
| 收款人 | payee | string | 64 | O-选填 | 发票左下角处
|
||
| 复核人 | checker | string | 64 | O-选填 |
|
||
| 开票员 | drawer | string | 64 | O-选填 |
|
||
| 预留字段 | reserved | string | 256 | O-选填 |
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 | 平台结果码
|
||
| 应答描述 | respMsg | string | 100 | M-必填 | 平台结果描述
|
||
| 签名 | sign | string | 1024 | M-必填 | 报文应答签名
|
||
| 平台流水号 | seqId | string | 64 | M-必填 | 用于标识平台针对每一笔请求生成的唯一流水号，应答时返回。
|
||
| 版本号 | version | string | 10 | R-需要返回 | 调用api接口的版本，默认是1.0.0。如果不是，会在api接口中有特殊说明。
|
||
| 交易发起时间 | timestamp | string | 14 | R-需要返回 | 格式固定是"yyyyMMddHHmmss"。
|
||
| 业务应答报文 | respContent | string | 10240 | O-选填 | 除公共参数外所有业务应答参数都放在这个参数中传递，具体请参照各业务应答参数,整个respContent中的数据作为一个json字符串来应答。
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
