发票换开

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时返回

Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2026-03-24 16:17:51

results matching ""

    No results matching ""