国税发票查验API接口说明

本文详细介绍了国税发票的API接口,包括请求地址、数据项、支持的发票类型、发票状态和票种标志。提供了增值税专用发票、机动车销售统一发票等不同类型的发票响应报文说明,适用于进行发票信息的查验和处理。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

目录

 

1.请求地址与数据项说明

1.1. 请求说明

1.2. other项说明

1.3. 支持发票类型[fpzl]

1.4. 发票状态说明[fpzt] 

1.5. 票种标志说明[pzbz]

2. 响应报文说明

2.1. 增值税专用发票、增值税普通发票、增值税电子普通发票、增值税普通发票(卷票)、电子发票(增值税专用发票)、电子发票(增值税普通发票)电子发票(航空电子客票)电子发票(铁路电子客票)

2.2. 增值税电子专用发票 

2.3. 机动车销售统一发票 

2.4. 二手车销售统一发票 

2.5. 增值税电子普通发票(通行费) 

2.6. 电子发票(航空电子客票 )

2.7. 电子发票(铁路电子客票) 

 

技术沟通、业务合作请加QQ1576813605

 

1.请求地址与数据项说明

1.1. 请求说明

      接口地址:http://xxxxxxx/v1/fpcy

      请求格式:application/json

      请求报文:

  {
    "data": "发票信息base64编码",
    "global": {
        "enterpriseCode": "",
        "sqid": "test",
        "uuid": "32位随机数",
        "version": "V1.0"
    },
    "sqxx": {
        "appSec": "test",
        "appKey": "test"
    }
}

 

data节点解析:

 {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "fprq": "开票格式[yyyyMMdd]",
    "other": "校验码/不含税金额/价税合计"
}

将上述信息做base64赋值到data节点

1.2. other项说明

    当发票种类为 01,02,03,15,08,31,32,83,61 时此项为金额:
        且当 01,02,03 填写发票不含税金额,
        且当15 填写发票车价合计;
        且当31,32,83,61时填写发票价税合计;
    发票种类为 04,10,11,14 时此项为校验码后6位; 

1.3. 支持发票类型[fpzl]

    增值税专用发票:01
    机动车销售统一发票:03
    增值税普通发票:04
    增值税专用发票(电子):08
    增值税普通发票(电子):10
    增值税普通发票(卷式):11
    增值税普通发票(通行费):14
    二手车销售统一发票:15
    全电发票专票:31
    全电发票普票:32
    全电发票纸专:01[可根据sfqd字段 用于区分 普通 01 类型]
    全电发票纸普:04[可根据sfqd字段 用于区分 普通 04 类型,校验码为对应的全电发票号码]
    铁路电子客票:83
    航空电子客票:61

1.4. 发票状态说明[fpzt] 

    0-正常
    2-作废
    3-红冲
    7-部分红冲
    8-全额红冲

1.5. 票种标志说明[pzbz]

    01-成品油
    02-稀土
    03-通行费
    04-机动车
    05-建筑服务 

2. 响应报文说明

2.1. 增值税专用发票、增值税普通发票、增值税电子普通发票、增值税普通发票(卷票)、电子发票(增值税专用发票)、电子发票(增值税普通发票)

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "qdbz": "作废标志",
        "cycs": "查验次数",
        "fpzl": "发票类型",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fprq": "发票日期",
        "jym": "校验码",
        "hjje": "合计金额[不含税]",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "jqbh": "机器编码",
        "fpzt": "发票状态",
        "pzbz": "票种标志"
        "bz": "备注",
        "sfqd":"是否全电[可区分全电纸普、专 与 普通纸专]"
        "buyer": {
            "name": "购买方名称",
            "nsrsbh": "购买方识别号",
            "dzdh": "购买方地址电话",
            "yhzh": "购买方银行账号"
        },
        "seller": {
            "name": "销售方名称",
            "nsrsbh": "销售方识别号",
            "dzdh": "销售方地址电话",
            "yhzh": "销售方银行账号"
        },
        "mx": [
            {
                "xh": 序号,
                "mc": "项目名称",
                "ggxh": "规格型号",
                "dw": "单位",
                "shul": "数量",
                "dj": "单价",
                "je": "金额",
                "sl": "税率",
                "se": "税额"
            }
        ]
    }
}
 

2.2. 增值税电子专用发票 

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "qdbz": "清单标志",
        "cycs": "查验次数",
        "sfqd": "是否全电",
        "fpzl": "发票类型",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fprq": "发票日期",
        "url": "板式文件地址",
        "jym": "校验码",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "jqbh": "机器编码",
        "pzbz": "票种标志",
        "fpzt": "发票状态",
        "bz": "备注",
        "seller": {
            "name": "销售方名称",
            "nsrsbh": "销售方识别号",
            "dzdh": "销售方地址电话",
            "yhzh": "销售方银行账号"
        },
        "buyer": {
            "name": "购买方名称",
            "nsrsbh": "购买方识别号",
            "dzdh": "购买方地址电话",
            "yhzh": "购买方银行账号"
        },
        "mx": [
            {
                "xh": 序号,
                "mc": "项目名称",
                "ggxh": "规格型号",
                "dw": "单位",
                "shul": "数量",
                "dj": "单价",
                "je": "金额",
                "sl": "税率",
                "se": "税额"
            }
        ]
    }
}

2.3. 机动车销售统一发票 

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "cycs": "查验次数",
        "fpzl": "发票种类",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fprq": "发票日期",
        "jqbh": "机器编号",
        "cllx": "车辆类型",
        "cpxh": "厂牌型号",
        "cd": "产地",
        "hgzh": "合格证号",
        "hjje": "合计金额",
        "fdjhm": "发动机号码",
        "clsbdh": "车辆识别代号",
        "sl": "税率",
        "se": "税额",
        "zgswjg": "主管税务机关",
        "bhsj": "不含税价",
        "dw": "吨位",
        "xcrs": "限乘人数",
        "fpzt": "发票状态",
        "seller": {
            "name": "销售方名称",
            "dh": "销售方电话",
            "nsrsbh": "销售方识别号",
            "zh": "销售方账号",
            "dz": "销售方地址",
            "khyh": "销售方开户银行"
        },
        "buyer": {
            "name": "购买方名称",
            "nsrsbh": "购买方识别号",
            "sfzh": "身份证号"
        }
    }
}

2.4. 二手车销售统一发票 

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "cycs": "查验次数",
        "fpzl": "发票种类",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fprq": "发票日期",
        "jqbh": "机器编号",
        "cpzh": "车牌证号",
        "djzh": "登记证号",
        "cllx": "车辆类型",
        "cjhj": "车价合计",
        "cjh": "车架号",
        "cpxh": "厂牌型号",
        "zrglsmc": "转入地车辆管理所名称",
        "bz": "备注",
        "fpzt": "发票状态",
        "buyer": {
            "name": "购买方名称",
            "dwdm": "购买方单位代码",
            "mfdw": "购买方买方单位",
            "mfdh": "购买方买方电话"
        },
        "seller": {
            "name": "销售方名称",
            "dwdm": "销售方单位代码",
            "mfdw": "销售方卖方地址",
            "mfdh": "销售方卖方电话"
        },
        "escsc": {
            "sc": "二手车市场名称",
            "nsrsbh": "二手车市场纳税人识别号",
            "dz": "二手车市场地址",
            "khyhzh": "二手车市场开户行银行账号",
            "dh": "二手车市场电话"
        },
        "jypm": {
            "mc": "经营拍卖单位名称",
            "dz": "经营拍卖单位地址",
            "nsrsbh": "经营拍卖单位纳税人识别号",
            "khyhzh": "经营拍卖单位开户行银行账号",
            "dh": "经营拍卖单位电话"
        }
    }
}

2.5. 增值税电子普通发票(通行费) 

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "cycs": "查验次数",
        "fpzl": "发票种类",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fprq": "发票日期",
        "jym": "校验码",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "jqbh": "机器编码",
        "fpzt": "发票状态",
        "bz": "备注",
        "sfdk": "是否代开"[Y:是;N:否],
        "buyer": {
            "name": "购买方名称",
            "nsrsbh": "购买方识别号",
            "dzdh": "购买方地址电话",
            "yhzh": "购买方银行账号"
        },
        "seller": {
            "name": "销售方名称",
            "nsrsbh": "销售方纳税人识别号",
            "dzdh": "销售方地址电话",
            "yhzh": "销售方银行账号"
        },
        "mx": [
            {
                "xh": 序号,
                "mc": "项目名称",
                "cph": "车牌号",
                "lx": "类型",
                "txsjq": "通行时间起",
                "txsjz": "通行时间止",
                "je": "金额",
                "sl": "税率",
                "se": "税额"
            }
        ]
    }
}

2.6. 电子发票(航空电子客票 )

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "cycs": "查验次数",
        "sfqd": "是否全电",
        "fpzl": "发票种类",
        "fphm": "发票号码",
        "kprq": "开票日期",
        "gngjbs": "国内国际标识",
        "gpdh": "GP单号",
        "xm": "姓名",
        "zjhm": "证件号码",
        "jshj": "价税合计",
        "dzkphm": "电子客票号码",
        "se": "税额",
        "gmfmc": "购买方名称",
        "gmfsbh": "购买方识别号",
        "mx": [
            {
                "hd": "航段",
                "sfz": "始发站",
                "mdz": "目的站",
                "cyr": "承运人",
                "hbh": "航班号",
                "zwdj": "座位等级",
                "cyrq": "承运日期",
                "qfsj": "起飞时间",
                "kpjb": "客票级别"
            }
        ]
    }
}

2.7. 电子发票(铁路电子客票) 

{
    "returnStateInfo": {
        "returnCode": "001",
        "returnMessage": "查验成功"
    },
    "invoice": {
        "cycs": "查验次数",
        "sfqd": "是否全电",
        "fpzl": "发票类型",
        "fphm": "发票号码",
        "kprq": "开票日期",
        "ywlx": "业务类型",
        "xm": "香茗",
        "zjhm": "证件号码",
        "jshj": "价税合计",
        "je": "金额",
        "se": "税额",
        "sl": "税率",
        "cfz": "出发站",
        "ddz": "到达站",
        "cc": "车次",
        "ccrq": "乘车日期",
        "cfsj": "出发时间",
        "xb": "席别",
        "cx": "车厢",
        "xw": "席位",
        "pz": "票种",
        "dzkphm": "电子客票号码",
        "kttz": "空调特征",
        "gmfmc": "购买方名称",
        "gmfsbh": "购买方识别号"
    }
}

 

评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值