开放平台

申报初始化 S002

申报初始化接口，用于发起初始化请求。此接口非必须，可直接使用提交接口推送数据。该接口主要用于获取税种的期初信息（部分税种可能不需要调用）。建议避开每月一号凌晨（0点-2点）时段进行批量请求。

请求参数

参数名称	描述	备注	类型	是否必填
`appKey`	客户唯一标识	用户申请，后台自动分配	string	必填
`jsonData`	请求参数	参数请求体	json	必填
`serviceId`	服务ID	选择对应的接口服务，参考接口列表	string	必填
`nsrsbh`	纳税人识别号	请求参数，位置在`jsonData`里面	string	必填
`sbzlbh`	申报种类编码	请求参数，位置在`jsonData`里面，具体值参考码表	string	必填
`nsqxdm`	纳税期限代码	请求参数，位置在`jsonData`里面，`01`按次、`02`月度、`03`季度、`04`年度、`05`半年度	string	必填
`skssqq`	所属期起	请求参数，位置在`jsonData`里面，格式`yyyy-MM-dd`	string	必填
`skssqz`	所属期止	请求参数，位置在`jsonData`里面，格式`yyyy-MM-dd`	string	必填
`wybh`	唯一编号	请求参数，位置在`jsonData`里面，按次及部分税种需要，存在校验	string	非必填

响应参数

参数名称	描述	备注	类型	是否必定返回
`status`	状态编码：`200`表示正常	无	string	必定返回
`code`	业务编码：`T0000`表示成功，其他编码均为异常编码	无	string	必定返回
`msg`	消息描述	无	string	必定返回
`stackTrace`	错误堆栈信息	无	string	必定返回
`data`	返回对象	无	json	必定返回

请求示例

json

{
    "appKey": "16e7c0b041054649a0526107c701451c",
    "serviceId": "S002",
    "jsonData": {
        "nsqxdm": "02",
        "nsrsbh": "税号",
        "sbzlbh": "10101",
        "skssqq": "2019-10-01",
        "skssqz": "2019-10-31",
        "wybh": "部分税种需要",
        "tdztsbdq": "特定主体申报地区，如：11",
        "kqybs": {
            "kqybslx": "2",
            "zgswjg": "国家税务总局上海市普陀区税务局第十五税务所",
            "scjydz": "上海市普陀区河西路026号",
            "byglbh": "582196247841"
        },
        "tdztbs": {
            "tdztlx": "跨区域办税类型，如：2",
            "tdztdq": "特定主体地区，如：31",
            "tdztzh": "特定主体登录账号，如：18865500145",
            "tdztmm": "特定主体登录密码，如：admin123"
        }
    }
}

响应示例

json

{
    "status": 200,
    "code": "T0000",
    "msg": "请求成功!",
    "stackTrace": null,
    "data": null
}

注意事项

初始化接口为异步接口:存在【初始化中、初始化成功、初始化失败】3个状态; 当返回编码T0000表示请求成功,此时对应的平台状态为【初始化中】,获取初始化的结果需要使用【S004查询接口】来获取! 参考查询接口：获取当状态为初始化成功时候的初始化报文其他编码含义: 01.返回编码(code):S0003返回信息（msg) :未查询到该企业的登记信息,请进行登记! 02.返回编码(code):S0004返回信息（msg) :【具体参数名称】,该值不合规! 03.返回编码(code):D0002返回信息（msg) :当前申报状态【具体申报状态】,不允许进行该操作,请核实! 04.返回编码(code):S0022 返回信息（msg）:初始化成功,请通过查询接口获取对应信息!

申报初始化 S002 ​

请求参数 ​

响应参数 ​

请求示例 ​

响应示例 ​