发票换开
API说明:全额红冲原蓝票,重新按新的购方信息生成一张新的发票。第一次调用内层报文returnCode返回0001(接收订单成功)后,后续同样的报文再次调用即可获取开票结果
调用方式:HTTP协议
API编码:shdzfp.fphk
调用方法:POST
数据格式:json
请求报文规范
{
"ywlsh":"业务流水号(新的流水号)",
"yfpdm":"原发票代码",
"yfphm":"原发票号码",
"gfxx":{
"ghf_nsrsbh":"购买方统一社会信用代码/纳税人识别号/身份证件号码",
"ghfmc":"购买方名称",
"ghf_dz":"购买方地址",
"ghf_dh":"购买方电话",
"ghf_khh":"购买方开户行",
"ghf_zh":"购买方银行账号",
"ghf_email":"购买方邮箱",
"ghf_sj":"购买方手机号码",
"ghfzrrbz":"购买方自然人标志"
}
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| ywlsh | 业务流水号 | varchar | 50 | 是 | 唯一,和外层报文“qqlsh”一致 |
| yfpdm | 原发票代码 | varchar | 12 | 否 | |
| yfphm | 原发票号码 | varchar | 20 | 是 |
gfxx(购方信息)
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| ghf_nsrsbh | 购买方统一社会信用代码/纳税人识别号/身份证件号码 | varchar | 50 | 否 | gmfzrrbz 是N 时必填 |
| ghfmc | 购买方名称 | varchar | 100 | 是 | |
| ghf_dz | 购买方地址 | varchar | 100 | 否 | |
| ghf_dh | 购买方电话 | varchar | 20 | 否 | |
| ghf_khh | 购买方开户行 | varchar | 80 | 否 | |
| ghf_zh | 购买方银行账号 | varchar | 20 | 否 | |
| ghf_email | 购买方邮箱 | varchar | 100 | 否 | |
| ghf_sj | 购买方手机号码 | varchar | 20 | 否 | |
| ghfzrrbz | 购买方自然人标志 | varchar | 1 | 是 | Y:是 N:否 |
返回报文规范
{
"ywlsh":"业务流水号",
"returnCode":"返回代码",
"returnMsg":"返回信息",
"url":"发票文件链接"
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| ywlsh | 业务流水号 | varchar | 50 | 是 | |
| returnCode | 返回代码 | varchar | 4 | 是 | 0000:换开成功(红票开具成功,换开的蓝票开具成功) 0001:接收订单成功 0002:红票开票成功(红票开具成功,换开的蓝票未开具) 0003:红票开票失败(红票开具失败) 0004:蓝票开具失败(红票开具成功,换开的蓝票开具失败) |
| returnMsg | 返回信息 | varchar | 500 | 是 | 返回信息 |
| url | 发票文件链接 | varchar | 500 | 否 | returnCode为0000时返回 |