获取税款所属期接口

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": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "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,14,03,24",  //可传多个发票类型，以英文逗号隔开（01,08,14,03,24），也可只串单个（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", -- 发票类型，具体见字段说明
        "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": "" -- 异常类型，具体见字段说明
      }, {    -- 通行费发票
        "xfsbh":"91110302801126463F",        -- 销售方纳税人识别号
        "gfsbh":"91110105MA04BDRR90",        -- 购买方纳税人识别号
        "fpdm":"011001700112",    -- 发票代码
        "jym": "",             -- 校验码
        "fplx":"14",        -- 发票类型，具体见字段说明
        "yqkgxbz":"0",        --逾期可勾选标志  0-可勾选逾期1-不可勾选逾期
        "gxlx":"",            -- 勾选类型，具体见字段说明
        "yclx":"",            -- 异常类型，具体见字段说明
        "glzt":"0",            --管理状态 0正常 1非正常 2疑似非正常
        "se":0.11,            --税额
        "fpzt":"0",            -- 发票状态代码，具体见字段说明
        "kprq":"20221121",    --开票日期
        "sfdbts":"0",        --是否代办退税，0否 1是
        "je":3.64,            --金额
        "gxzt":"0",            -- 勾选状态，0未勾选 1已勾选
        "xfmc":"招商局公路网络科技控股股份有限公司京津塘高速分公司",    -- 销售方名称
        "fphm":"46095748",    -- 发票号码
        "jym":"586032"        --校验码
    },  { -- 转内销发票
        "fplx": "24", -- 发票类型，具体见字段说明
        "fpdm": "", -- 发票代码
        "fphm": "", -- 发票号码
        "zmbh": "", -- 出口转内销证明编号
        "jym": "", -- 校验码
        "kprq": "", -- 开票日期，格式 yyyyMMdd

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

        "je": 100.0, -- 转内销金额
        "se": 13.0, -- 转内销税额

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

        "glzt": "0" -- 管理状态 0正常 1非正常 2疑似非正常
      }, { -- 全电发票信息
        "fplx": "01", -- 发票类型，具体见字段说明
        "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": "" -- 异常类型，具体见字段说明
      },
    ],
    "page": { -- 分页结果信息
      "totalCount": 1, -- 总数
      "totalPage": 1, -- 总页数
      "pageSize": 10, -- 分页大小
      "currentPage": 1 -- 当前页
    }
  }
}

#失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "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-是（不允许勾选）
      }, { -- 海关缴款书出口转内销
        "fplx": "30", -- 发票类型
        "jkshm": "", -- 海关缴款书号码
        "zmbh": "", -- 出口转内销证明编号
        "kprq": "", -- 填发日期，格式 yyyyMMdd

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

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

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

        "glzt": "0" -- 管理状态 0正常 1非正常 2疑似非正常
      }
    ],
    "page": { -- 分页结果信息
      "totalCount": 1, -- 总数
      "totalPage": 1, -- 总页数
      "pageSize": 10, -- 分页大小
      "currentPage": 1 -- 当前页
    }
  }
}

#失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "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": ""
  }]
}

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": "未查询到该企业信息！"
    }
}

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，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期
      }
    ]
  }
}

-- 全电发票勾选结果示例
{
  "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，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期
      }
    ]
  }
}

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

• 字段说明

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,
    "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": "未查询到该企业信息！"
    }
}

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
      }
    ]
  }
}

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

• 字段说明

5、错误码

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

1、接口描述

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

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

2、接口地址

POST /v1/FPRZ/sqtjqr  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "ywlx": "1"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "success": true,
    "req_id": "b763b8603aa34dcb874e16fc31e22d28",
    "timestamp": 1606804799800,
    "time": 170
  },
  "value": xxx                                 -- 申请统计确认 id，用于查询结果接口
}
失败返回示例及字段说明
{
  "result": {
    "req_id": "c2c3caf3dbac40d499fa65f1ab969d2b",
    "success": false,
    "time": 327,
    "timestamp": 1632881157972
  },
  "error": {
    "code": "FprzYwlxIsNull",                      -- 错误代码
    "message": "申请标识不能为空"                    -- 错误消息
  }
}

#失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "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，申请确认时需要传入
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": -- 不抵扣总有效税额
    }],
    "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":[{ -- 退税发票信息列表
      "znxbh":null,
      "fpdm":"3300222130",
      "fplx":"01",
      "qdfphm":null,
      "yxse":"27143.55",
      "gxlx":"2",
      "glzt":"0",
      "se":null,
      "fpzt":"0",
      "fpje":"208796.51",
      "kprq":"20230625",
      "xfmc":"浙江丹丹制衣厂",
      "xfnsrsbh":"91330782147636548B",
      "fphm":"38859585",
      "jkshm":null}],
    "cyfpxx":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表，结构同发票信息列表

    }]
  }
}
失败返回示例及字段说明
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}
{
  "result": {
    "req_id": "c0ad0a75cf6e4df887b1920bd3972191",
    "success": false,
    "time": 479,
    "timestamp": 1632882111576
  },
  "error": {
    "code": "FprzIdIsValid", -- 错误代码
    "message": "请传入正确的 id" -- 错误消息
  }
}

• 字段说明

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": "", -- 统计确认结果状态，具体见下方字段说明
    "tjxx":[{ -- 统计信息
      "fplx": "", -- 发票类型，具体见下方字段说明，99 代表合计
      "dkfpfs": 1, -- 抵扣发票份数
      "dkzje": , -- 抵扣总金额
      "dkzyxse": , -- 抵扣总有效税额
      "bdkfpfs": , -- 不抵扣发票份数
      "bdkzje": , -- 不抵扣总金额
      "bdkzyxse": -- 不抵扣总有效税额
    }],
    "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":[{ -- 差异发票信息列表，通过其他途径（例如发票综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表
    }]
  }
}
失败返回示例及字段说明
{
  "result": {
    "req_id": "f70eee9620534a58b8b5f5262eaec270",
    "success": false,
    "time": 705,
    "timestamp": 1632880471472
  },
  "error": {
    "code": "FprzTjqrIsNull", -- 错误代码
    "message": "企业统计确认数据为空" -- 错误消息
  }
}

• 字段说明

5、错误码

季报企业切换税款所属期

1、接口描述

该接口用于季报企业切换税款所属期

2、接口地址

POST /v1/FPRZ/sqqh  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx"
}

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": "未查询到该企业信息！"
    }
}

• 字段说明

5、错误码

季报企业切换税款所属期的结果查询

1、接口描述

该接口用于查询季报企业切换税款所属期的结果

2、接口地址

POST /v1/FPRZ/sqqhjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

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

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
    "req_id": "e7a7555a79eb4eb5b914ca6dab5e864a",
    "success": true,
    "time": 574,
    "timestamp": 1632471594368
  },
  "value":true 一个bool值，true或者false
}

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

5、错误码

获取企业信息

1、接口描述

该接口用于获取企业信息

2、接口地址

POST /v1/FPRZ/daxx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON 格式。

• 示例参数

{
  "nsrsbh": "xxx"
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
  "result": {
      "req_id":"35b7539acbc44d709ef4fb732d0999ea",
      "success":true,
      "time":492,
      "timestamp":1632834522937
  },
  "value": {
      "qymc":"", -- 企业名称
      "qyxz":"", -- 企业性质（SC-生产,WM-外贸,ZF-外综服,ZC-正常）
      "tdqybs":"", -- 特定企业标识
      "sbzq":"", -- 申报周期（0-月1-季）
      "ys_nsrsbh":"", -- 原始税号
      "ysnsrxz":"", -- 原始纳税人性质(8-小规模 5-转登记 其他为一般纳税人)
      "nsrsbh":"", -- 税号
      "nsrxz":"", -- 纳税人性质 (8-小规模 5-转登记 其他为一般纳税人)
      "xydj":"", -- 信用等级
      "ptmm_qybz":"", -- 平台密码启用标志（0-不起用1-启用）
      "datbsj":"", -- 档案同步时间        
  }
}

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

• 字段说明

5、错误码

申请海关缴款书采集

1、接口描述

该接口用于申请海关缴款书采集（缺少或双抬头的发票采集）

2、接口地址

POST /v1/FPRZ/sqhgjkscj  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

sqhgjkscjList内容

• 示例参数

{
    "nsrsbh":"xxx",
    "type":"x",
    "sqhgjkscjList":[
        {
            "jkshm":"xxx",
            "se":xx,
            "tfrq":"xxxxxxxx"
        },
        {
            "jkshm":"xxx",
            "se":xx,
            "tfrq":"xxxxxxxx"
        },
        {
            "jkshm":"xxx",
            "se":xx,
            "tfrq":"xxxxxxxx"
        }
    ]
}

4、返回结果

• Response Body

返回结果为JSON格式。

# 成功返回结果示例
{
    "result":{
        "req_id":"xxxxxxxxxxxxxxxxxxxx",
        "success":xxxx,
        "time":xxx,
        "timestamp":xxxxxxxxxx
    },
    "value":xxxxxxxxxxxxxxxxx           --申请海关缴款书采集请求id，用于查询结果接口
}


#失败返回结果示例
{
    "result": {
        "success": false,
        "req_id": "8798cf78f442442f96ac9ec1207e0024",
        "timestamp": 1686294558486,
        "time": 29
    },
    "error": {
        "code": "FprzOrgIsNull",
        "message": "未查询到该企业信息！"
    }
}
{
    "result":{
        "req_id":"cffdc2425e0943b3a86881dfd337b392",
        "success":false,
        "time":5,
        "timestamp":1634196561196
    },
    "error":{
        "code":"ParamIsNull",                -- 错误代码
        "message":"传入参数不能为空！"            -- 错误消息
    }
}
{
    "result":{
        "req_id":"cffdc2425e0943b3a86881dfd337b392",
        "success":false,
        "time":5,
        "timestamp":1634196561196
    },
    "error":{
        "code":"NsrsbhIsNull",                                    -- 错误代码
        "message":"传入的参数-企业纳税人识别号nsrsbh不能为空！"        -- 错误消息
    }
}
{
    "result":{
        "req_id":"df8eda31d46f444da390635ba813da7d",
        "success":false,
        "time":267,
        "timestamp":1634196598903
    },
    "error":{
        "code":"TypeIsNull",                    -- 错误代码
        "message":"业务类型type不能为空"            -- 错误消息
    }
}
{
    "result":{
        "req_id":"e1675902504c4113839f4903cf03fa71",
        "success":false,
        "time":248,
        "timestamp":1634196480750
    },
    "error":{
        "code":"ListIsNull",                        -- 错误代码
        "message":"传入参数中的list数据不能为空"         -- 错误消息
    }
}
{
    "result":{
        "req_id":"465c9f23b6e44deb9d350135c87df434",
        "success":false,
        "time":252,
        "timestamp":1634196656066
    },
    "error":{
        "code":"JkshmIsNull",                                -- 错误代码
        "message":"参数list中，海关缴款书号码Jkshm不能为空"        -- 错误消息
    }
}
{
    "result":{
        "req_id":"712dcf60df2f4857a81bc517e6d9834c",
        "success":false,
        "time":344,
        "timestamp":1634196688333
    },
    "error":{
        "code":"TfrqIsNull",                                    -- 错误代码
        "message":"参数list中，填发日期tfrq不能为空"                -- 错误消息
    }
}
{
    "result":{
        "req_id":"712dcf60df2f4857a81bc517e6d9834c",
        "success":false,
        "time":344,
        "timestamp":1634196688333
    },
    "error":{
        "code":"SeIsNull",                                        -- 错误代码
        "message":"参数list中，税款金额se不能为空"                    -- 错误消息
    }
}

• 字段说明

5、错误码

海关缴款书采集结果查询接口

1、接口描述

该接口用于查询海关缴款书采集结果

2、接口地址

POST /v1/FPRZ/hgjkscjjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

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

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
    "result":{
        "req_id":"34bb08ee382046a2bf410f2981ad414b",
        "success":true,
        "time":276,
        "timestamp":1634353263529
    },
    "value":[
        {
            "cjsj":"2021-10-16 00:00:00",       --采集时间
            "se":122.7,                         --税款金额
            "sqhdzt":"0",                       --申请核对状态 0-未申请  1-已申请
            "tfrq":"2021-10-12 00:00:00",       --填发日期
            "cljg":"2",                         --处理结果
            "hcjg":"1",                         --核查结果0允许抵扣/退税  1-不允许抵扣/退税
            "cjly":"1",                         --采集来源 1-通道（长软）2-其它
            "jhjg":"2",                         --稽核结果 0-稽核中 1-相符 2-不符 3-缺联 4-重号
            "sqzt":"2",                         --申请状态 1处理中，2处理完成
            "jkshm":"666",                      --海关缴款书号码
            "jkdsh":"136787e"                   --缴款单位税号(购方纳税人识别号)
        }
    ]
}

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

{
    "result":{
        "req_id":"fefd3771f291467da66b092db949a3d1",
        "success":false,
        "time":320,
        "timestamp":1634353586708
    },
    "error":{
        "code":"ResultIsNull",                            --错误代码
        "message":"申请海关缴款书采集结果为空"            --错误信息
    }
}
{
    "result":{
        "req_id":"90aeec419ad84b56bf2ea756272b3c84",
        "success":false,
        "time":5,
        "timestamp":1634353741148
    },
    "error":{
        "code":"505063",                                --错误代码
        "message":"请填写传递纳税人识别号!"                --错误信息
    }
}

• 字段说明

5、错误码

注销勾选申请接口

1、接口描述

该接口用于注销勾选申请

2、接口地址

POST /v1/FPRZ/zxgx  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

{
  "nsrsbh": "xxx",
  "sqlx": "1"                               --申请类型 1-注销勾选  2-撤销注销
}

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
    "result": {
        "req_id": "43fffc2352bf40a083a2edc4624e7822", 
        "success": true, 
        "time": 91, 
        "timestamp": 1666938472790
    }, 
    "value": 430538480618048                --申请注销 id，用于查询结果接口
}

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

• 字段说明

5、错误码

获取注销勾选结果接口

1、接口描述

该接口用于获取注销勾选结果

2、接口地址

POST /v1/FPRZ/zxgxjg  HTTP/1.1

3、请求参数

• 参数说明

请求参数为JSON格式。

• 示例参数

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

4、返回结果

• 返回结果

返回结果为JSON格式。

# 成功返回结果示例
{
    "result": {
        "req_id": "00abce54f81c4a5c96871b9718ac1fb3", 
        "success": true, 
        "time": 113, 
        "timestamp": 1666939366906
    }, 
    "value": {
        "zxgxlx": "1",    -- 申请注销勾选的类型 1 注销勾选 2 撤销注销勾选
        "nsrsbh": "91371400679201692X", 
        "cljg": "4",     -- 处理结果，1 成功 2 无此税号 3 已申请(注销/撤销注销勾选) 4 已注销/撤销注销勾选 99其他异常
        "zt": 3,            -- 状态 1申请处理中，2申请处理失败,3申请处理完成
        "skssq": "202210"       -- 税款所属期  (格式为YYYYMM，例如202109)
    }
}

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

• 字段说明

5、错误码