开放平台

Appearance

申报提交 S003 ​

申报提交接口，用于客户提交申报请求报文。批量请求接口请避开每月一号凌晨（0点-2点）时段。
注意：为了申报安全，在申报截止日期最后一天（0点-24点），申报通道提交类型接口暂时关闭。

请求参数 ​

参数名称描述备注类型是否必填
appKey客户唯一标识用户申请，后台自动分配string(32)必填
jsonData请求参数参数请求体json必填
serviceId服务ID选择对应的接口服务，参考接口列表string必填
nsrsbh纳税人识别号请求参数，位置在jsonData里面string必填
sbzlbh申报种类编码请求参数，位置在jsonData里面，具体值参考码表string必填
nsqxdm纳税期限代码01按次、02月度、03季度、04年度、05半年度string必填
skssqq所属期起格式yyyy-MM-dd，按次的日期格式补充说明，参考注意事项string必填
skssqz所属期止格式yyyy-MM-ddstring必填
bizXml提交报文需要Base64加密，具体内容参考：报表管理->报表前置->报文查询string必填
wybh唯一编号按次及部分税种需要传，存在校验；按月、季度、年度无需传值string必填
isZeroDeclare零申报标记"0"正常申报，需传bizXml；"1"零申报，无需传bizXmlstring必填
sqbz申请标志1代表申请，平台不会真正处理任务；为空或0直接提交税局string条件必填
tdztsbdq特定主体申报地区针对特定主体申报任务，参考地区码表string条件必填
zgswjg主管税务机关房产税、城镇土地使用税分不同主管税务机关时填写string条件必填
scjydz生产经营地址跨区域办税-税源登记选择时必填string条件必填
kqybs跨区域办税传递节点及子字段：kqybslx、zgswjg、scjydz、byglbhjson条件必填
tdztbs特定主体办税传递节点及子字段：tdztlx、tdztdq、tdztzh、tdztmmjson条件必填

响应参数 ​

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

请求示例 ​

json
{
    "appKey": "16e7c0b041054649a0526107c701451c",
    "serviceId": "S003",
    "jsonData": {
        "nsrsbh": "税号",
        "sbzlbh": "申报种类编码,如10101",
        "nsqxdm": "纳税期限代码,如：02",
        "skssqq": "所属期起,2019-10-01",
        "skssqz": "所属期止,2019-10-31",
        "bizXml": "提交报文Base64加密字符串",
        "wybh": "唯一编号,部分税种需要",
        "isZeroDeclare": "零申报标记,如：0",
        "sqbz": "申请标志,如：1",
        "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
}

注意事项 ​

  • 申报提交状态：返回编码T0000表示成功（平台状态：受理成功，对应状态编码C1），其他编码表示异常信息。
  • 后续操作：受理成功后，需使用S004接口获取申报反馈结果。
  • 其他编码含义：
    • S0003：未查询到企业登记信息，请进行登记。
    • S0004：参数值不合规，请核实。
    • D0006：申报提交报文Base64转换失败，请核实。
    • D0002：当前申报状态不允许操作，请核实。
    • D0007：申报提交失败，数据入库失败。
  • 按次申报补充说明：
    • 所属期起和所属期止的值应相等，格式为yyyy-MM-dd。
    • 通过wybh确定记录唯一性。
  • 零申报补充说明：
    • 零申报的应纳税额必须为0，否则返回校验信息。
    • 零申报流程类似客户零申报操作，并非全部填写0的申报。