获取税款所属期接口

1、接口描述

该接口用于获取申报信息

2、接口地址

POST /v1/FPRZ/sbxx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为 JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
      "req_id":"fc6e9064721f439588986cfdc1ef5d09",
      "success":true,
      "time":304,
      "timestamp":1632834876429
  },
  "value": {
      "skssq":"", -- 税款所属期  (格式为YYYYMM，例如202109)
      "skssqJzrq":"", -- 税款所属期截止日 （格式为YYYYMMDD，例如20210930）
      "nsrsbh":"",-- 纳税人识别号
      "gxfw":"", -- 勾选范围 （格式为YYYYMMDD-YYYYMMDD，例如20210913-20210930）
      "sbxx":"", -- 申报状态 0未申报 1已申报 2未知 3撤销申报
  }
}

#失败返回结果示例
//登录信息有误
{
    "result":{
        "req_id":"05dd10651926411f864f29374a3d45b3",
        "success":true,
        "time":1397,
        "timestamp":1701931734978
    },
    "value":{
        "code":"FprzTaxLoginFailed",
        "message":"【登录身份为： 办税员】+【用户名或手机号为：13*******59】在电子税务局不存在，请检查【登录身份】或【用户名或手机号】是否维护正确！"
    }
}

{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

{
    "result":{
        "req_id":"d8c90d3f5ce74487b3a5e1d3c923a2bc",
        "success":false,
        "time":54,
        "timestamp":1658470784891
    },
    "error":{
        "code":"FprzSbxxIsNull",
        "message":"企业申报信息为空"
    }
}

• 字段说明

5、错误码

进项发票取数

1、接口描述

该接口用于获取企业电子发票服务平台的进项发票信息

2、接口地址

POST /v1/FPRZ/jxfpqs  HTTP/1.1

3、请求参数

• 参数说明

请求参数为 JSON 格式。

注：当取已勾选发票时，税款所属期起止必填，其他情况开票日期起止必填；

当取未勾选发票时，入库时间起止和开票日期起止两者其中之一必填，不可同时为空；

分页信息说明

• 示例参数

{
    "nsrsbh":"***************",
    "skssqq":"202110",
    "skssqz":"202110",
    "kprqq":"20211201",
    "kprqz":"20211230",
    "rksjq":"20220307",
    "rksjz":"20220308",
    "glzt":"",
    "gxzt":"0",
    "fplx":"01,08,03",  //可传多个发票类型，以英文逗号隔开（01,08,03），也可只串单个（01）或不传，不传默认取所有发票类型
    "fpzt":"0,1,2", //可传多个发票状态，以英文逗号隔开（0,1,2），也可只传单个（0）或不传，不传默认取所有发票状态
    "page":{
        "currentPage":1,
        "pageSize":50
    }
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": {
    "skssq": "", -- 当前税款所属期，格式 yyyyMM
    "kgxKprqq": "", -- 可勾选开票日期起，格式 yyyyMMdd
    "kgxKprqz": "", -- 可勾选开票日期止，格式 yyyyMMdd
    "gxjzrq": "", -- 勾选截止日期，格式 yyyyMMdd
    "list": [{ -- 发票信息列表
        "fplx": "01", -- 发票类型，具体见字段说明
        "fply": "2", -- 发票来源  3-增值税发票管理系统;  4-电子发票服务平台
        "fpdm": "", -- 发票代码
        "fphm": "", -- 发票号码
        "jym": "", -- 校验码
        "kprq": "", -- 开票日期，格式 yyyyMMdd

        "gfsbh": "", -- 购买方纳税人识别号
        "xfsbh": "", -- 销售方纳税人识别号
        "xfmc": "", -- 销售方名称

        "je": 100.0, -- 金额
        "se": 13.0, -- 税额

        "fpzt": "0", -- 发票状态代码，具体见字段说明
        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxlx": "", -- 勾选类型，具体见字段说明
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM
        "yskssq": "", -- 原税款所属期，格式 yyyyMM，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期

        "sfdbts": "0", -- 是否代办退税，0否 1是
        "yqkgxbz": "0", -- 逾期可勾选标志 0可勾选逾期 1不可勾选逾期
        "glzt": "0", -- 管理状态 0正常 1非正常 2疑似非正常
        "yclx": "", -- 异常类型，具体见字段说明
        "bdkyy": "", -- 不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "", -- 不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
        "hzsdbz": "", -- 红字锁定标志，0-false 1-true
        "ncpfpbz ": "" -- 农产品发票标志，0-false 1-true
      }, { -- 全电发票信息
        "fplx": "01", -- 发票类型，具体见字段说明
        "fply": "2", -- 发票来源  1-增值税发票管理系统;  2-电子发票服务平台
        "fpdm": "", -- 发票代码
        "fphm": "", -- 发票号码
        "qdfphm": "", -- 全电发票号码
        "jym": "", -- 校验码
        "kprq": "", -- 开票日期，格式 yyyyMMdd

        "gfsbh": "", -- 购买方纳税人识别号
        "xfsbh": "", -- 销售方纳税人识别号
        "xfmc": "", -- 销售方名称

        "je": 100.0, -- 金额
        "se": 13.0, -- 税额

        "fpzt": "0", -- 发票状态代码，具体见字段说明
        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxlx": "", -- 勾选类型，具体见字段说明
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM
        "yskssq": "", -- 原税款所属期，格式 yyyyMM，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期

        "sfdbts": "0", -- 是否代办退税，0否 1是
        "yqkgxbz": "0", -- 逾期可勾选标志 0可勾选逾期 1不可勾选逾期
        "glzt": "0", -- 管理状态 0正常 1非正常 2疑似非正常
        "yclx": "", -- 异常类型，具体见字段说明
        "bdkyy": "", -- 不抵扣原因 1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "", -- 不抵扣原因描述   1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
        "hzsdbz": "", -- 红字锁定标志，0-false 1-true
        "ncpfpbz ": "" -- 农产品发票标志，0-false 1-true
      },
    ],
    "page": { -- 分页结果信息
      "totalCount": 1, -- 总数
      "totalPage": 1, -- 总页数
      "pageSize": 10, -- 分页大小
      "currentPage": 1 -- 当前页
    }
  }
}

//失败返回结果示例
//登录信息有误
{
    "result":{
        "req_id":"05dd10651926411f864f29374a3d45b3",
        "success":true,
        "time":1397,
        "timestamp":1701931734978
    },
    "value":{
        "code":"FprzTaxLoginFailed",
        "message":"【登录身份为： 办税员】+【用户名或手机号为：13*******59】在电子税务局不存在，请检查【登录身份】或【用户名或手机号】是否维护正确！"
    }
}
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

• 字段说明

5、错误码

海关缴款书取数

1、接口描述

该接口用于获取企业电子发票服务平台的海关缴款书信息

2、接口地址

POST /v1/FPRZ/hgjksqs  HTTP/1.1

3、请求参数

• 参数说明

请求参数为 JSON 格式。

注：当取已勾选发票时，税款所属期起止必填，其他情况开票日期起止必填

分页信息说明

• 示例参数

{
  "nsrsbh": "xxx",
  "kprqq": "20210901",
  "kprqz": "20210930"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": {
    "skssq": "", -- 当前税款所属期，格式 yyyyMM
    "kgxKprqq": "", -- 可勾选开票日期起，格式 yyyyMMdd
    "kgxKprqz": "", -- 可勾选开票日期止，格式 yyyyMMdd
    "gxjzrq": "", -- 勾选截止日期，格式 yyyyMMdd
    "list": [{ -- 海关缴款书
        "fplx": "17", -- 发票类型
        "jkshm": "", -- 海关缴款书号码
        "kprq": "", -- 填发日期，格式 yyyyMMdd

        "gfsbh": "", -- 缴款单位税号
        "gfmc": "", -- 缴款单位名称

        "se": 13.0, -- 税款金额

        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxlx": "", -- 勾选类型，具体见字段说明
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM

        "yqkgxbz": "0", -- 逾期可勾选标志 0可勾选逾期 1不可勾选逾期
        "glzt": "0", -- 管理状态 0正常 1非正常 2疑似非正常
        "yclx": "", -- 异常类型，具体见字段说明
        "sflrbfx": "" -- 是否录入不符项 0-否 1-是（不允许勾选）
        "bdkyy": "", -- 不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "" -- 不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
      }
    ],
    "page": { -- 分页结果信息
      "totalCount": 1, -- 总数
      "totalPage": 1, -- 总页数
      "pageSize": 10, -- 分页大小
      "currentPage": 1 -- 当前页
    }
  }
}

//失败返回结果示例
//登录信息有误
{
    "result":{
        "req_id":"05dd10651926411f864f29374a3d45b3",
        "success":true,
        "time":1397,
        "timestamp":1701931734978
    },
    "value":{
        "code":"FprzTaxLoginFailed",
        "message":"【登录身份为： 办税员】+【用户名或手机号为：13*******59】在电子税务局不存在，请检查【登录身份】或【用户名或手机号】是否维护正确！"
    }
}
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

• 字段说明

5、错误码

进项发票勾选

1、接口描述

该接口用于进项发票勾选

2、接口地址

POST /v1/FPRZ/jxfpgx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为 JSON 格式。

勾选发票列表

• 示例参数

#勾选抵扣示例参数
{
  "nsrsbh": "xxx",
  "skssq": "202108",
  "gxlx": "1",
  "list": [{
    "fpdm": "",
    "fphm": "",
    "qdfphm": "",
    "yxse": 13.0,
    "zmbh": ""
  }]
}

#多账号时-勾选抵扣示例参数
{
  "nsrsbh": "xxx",
  "accountId": "xxx",
  "skssq": "202108",
  "gxlx": "1",
  "list": [{
    "fpdm": "",
    "fphm": "",
    "qdfphm": "",
    "yxse": 13.0,
    "zmbh": ""
  }]
}

#勾选不抵扣示例参数
{
    "nsrsbh":"xxx",
    "skssq":"202207",
    "gxlx":"4",
    "bdkyy":"5",
    "bdkyyms":"不抵扣原因-其他描述",
    "list":[
        {
            "fpdm":"",
            "fphm":"",
            "qdfphm":"",
            "yxse":13,
            "zmbh":""
        }
    ]
}

#多账号时-勾选不抵扣示例参数
{
    "nsrsbh":"xxx",
    "accountId": "xxx",
    "skssq":"202207",
    "gxlx":"4",
    "bdkyy":"5",
    "bdkyyms":"不抵扣原因-其他描述",
    "list":[
        {
            "fpdm":"",
            "fphm":"",
            "qdfphm":"",
            "yxse":13,
            "zmbh":""
        }
    ]
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": xxx --申请勾选 id，用于查询结果接口
}

//失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

5、错误码

进项发票勾选结果查询

1、接口描述

该接口用于查询进项发票勾选结果

2、接口地址

POST /v1/FPRZ/jxfpgxjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为 JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "reqId": yyy
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": {
    "list": [{ -- 发票信息列表
        "fplx": "01", -- 发票类型，具体见字段说明
        "fpdm": "", -- 发票代码
        "fphm": "", -- 发票号码
        "kprq": "", -- 开票日期，格式 yyyyMMdd

        "zt": "", -- 状态，具体见字段说明
        "cljg": "", -- 申请勾选的处理结果，具体见字段说明
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxlx": "", -- 勾选类型，具体见字段说明
        "je": 113.0, -- 金额
        "se": 13.0, -- 税额
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM
        "yskssq": "", -- 原税款所属期，格式 yyyyMM，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期
        "bdkyy": "", -- 不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "" -- 不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
      }
    ]
  }
}

-- 全电发票勾选结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": {
    "list": [{ -- 发票信息列表
        "fplx": "81", -- 发票类型，具体见字段说明
        "fpdm": "", -- 发票代码
        "fphm": "", -- 发票号码
        "qdfphm": "", --全电发票号码
        "kprq": "", -- 开票日期，格式 yyyyMMdd

        "zt": "", -- 状态，具体见字段说明
        "cljg": "", -- 申请勾选的处理结果，具体见字段说明
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxlx": "", -- 勾选类型，具体见字段说明
        "je": 113.0, -- 金额
        "se": 13.0, -- 税额
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM
        "yskssq": "", -- 原税款所属期，格式 yyyyMM，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期
        "bdkyy": "", -- 不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "" -- 不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
      }
    ]
  }
}

# 发票云认证用户失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

{
    "result":{
        "req_id":"429a62e2b83b45929bfd58ce9e6d2a4d",
        "success":true,
        "time":72,
        "timestamp":1658484593481
    },
    "value":{
        "list":[
            {
                "yskssq":"",
                "fpdm":"310****130",
                "fplx":"01",
                "cljg":"80",
                "yxse":495.05,
                "gxlx":"1",
                "kprq":"20211008",
                "gxsj":"20211030",
                "zt":"3",
                "gxzt":"1",
                "fphm":"21****85",
                "skssq":"202110"
            }
        ]
    }
}

• 字段说明

5、错误码

海关缴款书勾选

1、接口描述

该接口用于海关缴款书勾选

2、接口地址

POST /v1/FPRZ/hgjksgx  HTTP/1.1

3、请求参数

• 参数说明

  请求参数为 JSON 格式。

勾选海关缴款书

• 示例参数

{
  "nsrsbh": "xxx",
  "skssq": "202108",
  "gxlx": "1",
  "list": [{
    "jkshm": "xxx",
    "tfrq": "xxxx",
    "se": 13.0,
    "yxse": 13.0
  }]
}

//多账号时-勾选入参示例
{
  "nsrsbh": "xxx",
  "accountId": "xxx",
  "skssq": "202108",
  "gxlx": "1",
  "list": [{
    "jkshm": "xxx",
    "tfrq": "xxxx",
    "se": 13.0,
    "yxse": 13.0
  }]
}

4、返回结果

• 返回结果

返回结果为JSON格式

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": xxx --申请勾选 id，用于查询结果接口
}

# 失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

5、错误码

海关缴款书勾选结果查询

1、接口描述

该接口用于查询海关缴款书勾选结果

2、接口地址

POST /v1/FPRZ/hgjksgxjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "reqId": yyy
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value": {
    "list": [{ -- 海关缴款书列表
        "fplx": "17", -- 发票类型，具体见字段说明
        "gfsbh": "", -- 缴款单位税号
        "jkshm": "", -- 海关缴款书号码
        "kprq": "", -- 填发日期，格式 yyyyMMdd

        "zt": "", -- 状态，具体见字段说明
        "cljg": "", -- 申请勾选的处理结果，具体见字段说明
        "gxsj": "", -- 勾选时间，格式 yyyyMMdd
        "gxzt": "0", -- 勾选状态，0未勾选 1已勾选
        "gxlx": "", -- 勾选类型，具体见字段说明
        "yxse": 13.0, -- 有效税额
        "skssq": "", -- 税款所属期，格式 yyyyMM
        "bdkyy": "", -- 不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费  4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": "" -- 不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
      }
    ]
  }
}

# 发票云认证用户失败返回结果示例
{
    "result":{
        "req_id":"429a62e2b83b45929bfd58ce9e6d2a4d",
        "success":true,
        "time":72,
        "timestamp":1658484593481
    },
    "value":{
            "list": [{             -- 海关缴款书列表
            "fplx": "17",         -- 发票类型，具体见字段说明
            "gfsbh": "",         -- 缴款单位税号
            "jkshm": "",         -- 海关缴款书号码
            "kprq": "",         -- 填发日期，格式 yyyyMMdd

            "zt": "",             -- 状态，具体见字段说明
            "cljg": "80",         -- 申请勾选的处理结果，具体见字段说明（注：80为发票云认证用户勾选失败时的返回结果）
            "gxsj": "",         -- 勾选时间，格式 yyyyMMdd
            "gxzt": "0",         -- 勾选状态，0未勾选 1已勾选
            "gxlx": "",         -- 勾选类型，具体见字段说明
            "yxse": 13.0,         -- 有效税额
            "skssq": ""             -- 税款所属期，格式 yyyyMM
          }
        ]
    }
}

# 失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

• 字段说明

5、错误码

申请发票统计、确认签名和撤销

1、接口描述

该接口用于申请发票统计、确认签名和撤销

注意：仅在申报期内、企业未申报时可调用此接口

2、接口地址

POST /v1/FPRZ/sqtjqr  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "ywlx": "1",
  "mxbz":1
}
//多账号时-申请统计入参示例
{
  "nsrsbh": "xxx",
  "accountId": "xxx",
  "ywlx": "1",
  "mxbz":1
}

//申请确认时需要获取用途确认文件入参示例
{
  "nsrsbh": "xxx",
  "ywlx": "3",
  "ytqrfile":true
}

//多账号时-申请确认时需要获取用途确认文件入参示例
{
  "nsrsbh": "xxx",
  "accountId": "xxx",
  "ywlx": "3",
  "ytqrfile":true
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": xxx                                 -- 申请统计确认 id，用于查询结果接口
}
失败返回示例及字段说明
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

{
  "result": {
    "req_id": "c2c3caf3dbac40d499fa65f1ab969d2b",
    "success": false,
    "time": 327,
    "timestamp": 1632881157972
  },
  "error": {
    "code": "FprzYwlxIsNull",                      -- 错误代码
    "message": "申请标识不能为空"                    -- 错误消息
  }
}

• 字段说明

5、错误码

获取发票统计、确认签名和撤销申请结果

1、接口描述

该接口用于获取申请发票统计、确认签名和撤销申请的结果

2、接口地址

POST /v1/FPRZ/tjqrsqjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式，说明如下。

• 示例参数

{
  "nsrsbh": "xxx",
  "id": xxx
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": {
    "id": xx,
    "nsrsbh": "", -- 纳税人识别号
    "skssq": "", -- 税款所属期，格式 yyyyMM
    "ywlx": "", -- 申请标识
    "time": "", -- 操作时间
    "zt": "", -- 统计确认状态，具体见下方字段说明
    "tszt": "", -- 退税状态，具体见下方字段说明
    "cljg": "", -- 申请处理结果，具体见下方字段说明
    "jgzt": "", -- 统计确认结果状态，具体见下方字段说明
    "tsjgzt": "", -- 统计确认结果状态 具体见下方字段说明
    "tjsj": "", -- 统计时间，格式 yyyyMMddHHmmss，申请确认时需要传入
    "jglx": "", -- 机构类型 01 总机构，02分机构 03 机构本身
    "ytqrfileUrl": "http://qxy-oss-test.oss-cn-beijing.aliyuncs.com/SHARE/0/FpYunRz_10001995%E7%A8%8E%E5%8F%B791*************2G_%E5%B1%9E%E6%9C%9F202312%E7%94%A8%E9%80%94%E7%A1%AE%E8%AE%A4%E4%BF%A1%E6%81%AF1703558125779841.xlsx?Expires=1706184686&OSSAccessKeyId=*************&Signature=iEsxSk2fTmMeeqtL72%2FPqXnfsWw%3D",
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": ,-- 不抵扣总有效税额
      "ckznxzmfs": , -- 出口转内销证明有效份数
      "ckznxsehj": , -- 出口转内销证明有效抵扣税额合计
      "qtyxdksehj": , -- 其他有效抵扣税额合计
      "qtfpfs": -- 其他发票份数
    }],
    "tstjxx":[{ -- 退税统计信息
      "hjse":14015177.25000000000,
      "fplx":"01",
      "hjfs":1204
    }],
    "fpxx":[{ -- 发票信息列表，申请接口传入需要明细时返回，非海关缴款书发票字段
      "fplx": "01", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 海关缴款书字段
      "fplx": "17", -- 发票类型，17：海关缴款书 30：出口转内销海关缴款书
      "znxbh": "", -- 转内销证明编号，fplx=30时不为空
      "jkshm": "", -- 海关关缴款书号码
      "se": "", -- 税款金额
      "yxse": "", -- 有效税额
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 全电发票信息
      "fplx": "81", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "qdfphm": "", -- 全电发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, ],
    "tsfpxx":[{ -- 退税发票信息列表
      "fplx":"", -- 发票类型，具体见下方字段说明
      "znxbh":"", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm":"", -- 发票代码
      "fphm":"", -- 发票号码
      "qdfphm":"", -- 全电发票号码
      "fpje":"", -- 金额
      "se":"", -- 税额
      "yxse":"", -- 有效税额
      "fpzt":"", -- 发票状态代码，具体见下方字段说明
      "glzt":"", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx":"", -- 勾选类型，具体见字段说明
      "kprq":"", --开票日期
      "xfmc":"", --销方名称
      "xfnsrsbh":"", --销方纳税人识别号
      "jkshm":"" --缴款书号码
      }],
    "cyfpxx":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表，结构同发票信息列表

    }]
  }
}


失败返回示例及字段说明
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

{
  "result": {
    "req_id": "c0ad0a75cf6e4df887b1920bd3972191",
    "success": false,
    "time": 479,
    "timestamp": 1632882111576
  },
  "error": {
    "code": "FprzIdIsValid", -- 错误代码
    "message": "请传入正确的 id" -- 错误消息
  }
}

# 发票云认证用户失败返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": {
    "id": xx,
    "nsrsbh": "", -- 纳税人识别号
    "skssq": "", -- 税款所属期，格式 yyyyMM
    "ywlx": "", -- 申请标识
    "time": "", -- 操作时间
    "zt": "", -- 统计确认状态，具体见下方字段说明
    "cljg": "80", -- 申请处理结果，具体见下方字段说明
    "jgzt": "", -- 统计确认结果状态，具体见下方字段说明
    "tjsj": "", -- 统计时间，格式 yyyyMMddHHmmss，申请确认时需要传入
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": , -- 不抵扣总有效税额
      "qtyxdksehj": , -- 其他有效抵扣税额合计
      "qtfpfs": -- 其他发票份数
    }],
    "fpxx":[{ -- 发票信息列表，申请接口传入需要明细时返回，非海关缴款书发票字段
      "fplx": "01", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 海关缴款书字段
      "fplx": "17", -- 发票类型，17：海关缴款书 30：出口转内销海关缴款书
      "znxbh": "", -- 转内销证明编号，fplx=30时不为空
      "jkshm": "", -- 海关关缴款书号码
      "se": "", -- 税款金额
      "yxse": "", -- 有效税额
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 全电发票信息
      "fplx": "81", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "qdfphm": "", -- 全电发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, ],
    "cyfpxx":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表，结构同发票信息列表

    }]
  }
}

• 字段说明

5、错误码

获取最新统计确认结果

1、接口描述

该接口用于获取最新统计确认结果

2、接口地址

POST /v1/FPRZ/tjqrjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "nsrsbh": "xxx"
}

4、返回结果

• 返回结果

返回的结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": {
    "nsrsbh": "", -- 纳税人识别号
    "skssq": "", -- 税款所属期，格式 yyyyMM
    "tjsj": "", -- 统计时间，格式 yyyyMMddHHmmss
    "jgzt": "", -- 统计确认结果状态，具体见下方字段说明
    "jglx": "", -- 机构类型 01 总机构，02分机构 03 机构本身
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": ,-- 不抵扣总有效税额
      "ckznxzmfs": , -- 出口转内销证明有效份数
      "ckznxsehj": , -- 出口转内销证明有效抵扣税额合计
       "qtyxdksehj": , -- 其他有效抵扣税额合计
      "qtfpfs": -- 其他发票份数
    }],
    "fpxx":[{ -- 发票信息列表，申请接口传入需要明细时返回，非海关缴款书发票字段
      "fplx": "01", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 海关缴款书字段
      "fplx": "17", -- 发票类型，17-海关缴款书 30-出口转内销海关缴款书
      "znxbh": "", -- 转内销证明编号，fplx=30时不为空
      "jkshm": "", -- 海关关缴款书号码
      "se": "", -- 税款金额
      "yxse": "", -- 有效税额
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 全电发票信息
      "fplx": "81", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "qdfphm": "", -- 全电发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, ],
    "tsfpxx":[{ -- 退税发票信息列表
      "fplx":"", -- 发票类型，具体见下方字段说明
      "znxbh":"", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm":"", -- 发票代码
      "fphm":"", -- 发票号码
      "qdfphm":"", -- 全电发票号码
      "fpje":"", -- 金额
      "se":"", -- 税额
      "yxse":"", -- 有效税额
      "fpzt":"", -- 发票状态代码，具体见下方字段说明
      "glzt":"", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx":"", -- 勾选类型，具体见字段说明
      "kprq":"", --开票日期
      "xfmc":"", --销方名称
      "xfnsrsbh":"", --销方纳税人识别号
      "jkshm":"" --缴款书号码
      }],
    "cyfpxx":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表
    }]
  }
}

失败返回示例及字段说明
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}

{
    "result": {
        "req_id": "0a1f6454147f46b5ad8b3a5db9990812",
        "success": false,
        "time": 88,
        "timestamp": 1686296593623
    },
    "error": {
        "code": "FprzNotSupportDq",
        "message": "暂不支持该地区进行发票云认证！"
    }
}

{
  "result": {
    "req_id": "f70eee9620534a58b8b5f5262eaec270",
    "success": false,
    "time": 705,
    "timestamp": 1632880471472
  },
  "error": {
    "code": "FprzTjqrIsNull", -- 错误代码
    "message": "企业统计确认数据为空" -- 错误消息
  }
}

# 发票云认证用户统计失败返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": {
    "id": xx,
    "nsrsbh": "", -- 纳税人识别号
    "skssq": "", -- 税款所属期，格式 yyyyMM
    "ywlx": "", -- 申请标识
    "time": "", -- 操作时间
    "zt": "", -- 统计确认状态，具体见下方字段说明
    "cljg": "80", -- 申请处理结果，具体见下方字段说明
    "jgzt": "", -- 统计确认结果状态，具体见下方字段说明
    "tjsj": "", -- 统计时间，格式 yyyyMMddHHmmss，申请确认时需要传入
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": , -- 不抵扣总有效税额
      "qtyxdksehj": , -- 其他有效抵扣税额合计
      "qtfpfs": -- 其他发票份数
    }],
    "fpxx":[{ -- 发票信息列表，申请接口传入需要明细时返回，非海关缴款书发票字段
      "fplx": "01", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 海关缴款书字段
      "fplx": "17", -- 发票类型，17：海关缴款书 30：出口转内销海关缴款书
      "znxbh": "", -- 转内销证明编号，fplx=30时不为空
      "jkshm": "", -- 海关关缴款书号码
      "se": "", -- 税款金额
      "yxse": "", -- 有效税额
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, { -- 全电发票信息
      "fplx": "81", -- 发票类型，具体见下方字段说明
      "znxbh": "", -- 转内销证明编号，fplx=24、80时不为空
      "fpdm": "", -- 发票代码
      "fphm": "", -- 发票号码
      "qdfphm": "", -- 全电发票号码
      "fpje": "", -- 金额
      "yxse": "", -- 有效税额
      "fpzt": "", -- 发票状态代码，具体见下方字段说明
      "glzt": "", -- 管理状态，0正常 1非正常 2疑似非正常
      "gxlx": "", -- 勾选类型，具体见字段说明
      "kprq":"",--开票日期
      "xfmc":"",--销方名称
      "xfnsrsbh":""--销方纳税人识别号
    }, ],
    "cyfpxx":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表，结构同发票信息列表

    }]
  }
}

• 字段说明

5、错误码