接口文档 - 星云税融API

增值税申报表取数

获取增值税申报表预填数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/vat/fetch

请求示例

JSON

{
    "nsrsbh": "91xxx",
    "skssq": "202604"
}

响应示例

JSON

{"code":200,"data":{"mainTable":{...}}}

增值税申报表保存

保存增值税申报表数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/vat/save

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
data	Object	是	申报表数据

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3,
    "data": {
        "mainTable": []
    }
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	保存结果

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "result": true
    }
}

增值税申报提交

提交增值税纳税申报

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/vat/submit

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "456789012345678"
    }
}

增值税申报结果查询

查询增值税申报结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/vat/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "456789012345678"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功
data.detail	Array	申报结果明细

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3,
        "businessStatusName": "执行成功"
    }
}

企业所得税取数

获取企业所得税申报预填数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cit/fetch

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	季度(1-4)

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 1
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Object	预填数据

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "mainTable": []
    }
}

企业所得税保存

保存企业所得税申报数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cit/save

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	季度
data	Object	是	申报表数据

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 1,
    "data": []
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	保存结果

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "result": true
    }
}

企业所得税提交

提交企业所得税纳税申报

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cit/submit

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	季度

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 1
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "taskId": "456789012345679"
    }
}

企业所得税结果查询

查询企业所得税申报结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cit/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "456789012345679"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3,
        "businessStatusName": "执行成功"
    }
}

财务报表取数

获取财务报表预填数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/financial/fetch

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Object	财报预填数据

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "balanceSheet": [],
        "profitStatement": []
    }
}

财务报表保存

保存财务报表数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/financial/save

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
data	Object	是	财报数据

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3,
    "data": []
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	保存结果

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "result": true
    }
}

财务报表提交

提交财务报表

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/financial/submit

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "taskId": "456789012345680"
    }
}

财务报表结果查询

查询财务报表提交结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/financial/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "456789012345680"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3,
        "businessStatusName": "执行成功"
    }
}

税款缴纳

发起税款缴纳

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/tax/pay

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
detail	Array	是	缴纳明细

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3,
    "detail": [
        {
            "yzpzzlDm": "BDA0610606",
            "taxAmount": 5000
        }
    ]
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "taskId": "456789012345681"
    }
}

税款缴纳结果查询

查询税款缴纳状态

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/tax/pay/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "456789012345681"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3
    }
}

申报作废

作废已申报的报表

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/void

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
yzpzzlDm	String	是	税种代码

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2026,
    "period": 3,
    "yzpzzlDm": "BDA0610606"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	作废结果

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "result": true
    }
}

汇算清缴取数

获取汇算清缴预填数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/annual/fetch

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	汇算年度

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2025
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Object	预填数据

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": []
}

汇算清缴提交

提交汇算清缴申报

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/annual/submit

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	汇算年度
data	Object	是	汇算清缴数据

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2025,
    "data": []
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "taskId": "456789012345682"
    }
}

发起采集企业税务信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/company/start

该接口文档正在完善中，请联系客服获取详细参数说明。

查询企业税务信息状态

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/company/status

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "xxx"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功
data.detail	Object	税务信息

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3
    }
}

查询企业信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/company/info

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id

请求示例

JSON

{
    "aggOrgId": "369161000080320"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.openSjState	Boolean	企业税务信息采集状态，true=采集成功，false=采集失败
data.vatTaxpayer	Integer	纳税人身份：2000010001=一般纳税人，2000010002=小规模纳税人
data.name	String	企业名称
data.sfzxxDtos	Array	税费种信息列表
data.nsxxDto	Object	企业基本信息（纳税人识别号、名称、登记注册类型、行业等）
data.zgrdDtos	Array	资格认定信息列表
data.financeReportSettingDto	Object	会计备案信息
data.zgswjg	Array	主管税务机关信息
data.jjdjxx	Object	加计抵减信息
data.taxPaymentMessageDtos	Array	存款账号备案信息
data.kqyxxDtos	Array	跨区域信息
data.tzfxx	Object	企业信息投资方模型
data.hdzsxx	Object	企业信息核定征收模型

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "reqId": "3292926052d94235b065f87b73061338",
    "data": {
        "openSjState": true,
        "vatTaxpayer": 2000010002,
        "name": "**有限公司",
        "sfzxxDtos": [
            {
                "sbxm": "10101",
                "sbxmName": "增值税",
                "sbpmName": "商业(17%、16%、13%)",
                "nsqxdmName": "季",
                "slhdwse": "0.13",
                "zsfs": "自行申报"
            }
        ],
        "nsxxDto": {
            "nsrsbh": "91***************X8",
            "nsrmc": "***有限公司",
            "djzclxName": "私营有限责任公司",
            "hydl": "职业中介服务",
            "xydj": "B"
        },
        "zgrdDtos": [
            {
                "zgrdlxName": "增值税一般纳税人",
                "yxqksrq": "2021-04-01",
                "yxqjsrq": "9999-12-31"
            }
        ],
        "taxPaymentMessageDtos": [
            {
                "bankName": "中****银行",
                "tripleAgreement": "13******************0",
                "accountNature": "基本存款账户",
                "agreementStatus": "验证通过"
            }
        ]
    }
}

批量设置会计准则制度

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/accounting/set

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
kjzzDm	String	是	会计准则代码
kjzdDm	String	是	会计制度代码

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "kjzzDm": "01",
    "kjzdDm": "01"
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	设置结果

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "result": true
    }
}

发起获取申报条目任务

发起获取申报条目(清册条目)任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/items/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份(yyyy)
period	Integer	是	月份(1-12)
accountId	String	否	账号ID，多账户场景

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "year": 2023,
    "period": 3
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.aggOrgId	String	企业ID
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "456789012345678"
    }
}

查询申报条目任务

查询申报条目任务结果(仅支持当前月份清册查询)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/items/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "taskId": 452111122222440
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	任务状态:3=成功
data.detail	Array	条目明细列表(含sbywbm/taxProjectName/taxProjectCode/fromDate/toDate等)
data.taskId	String	任务ID

响应示例

JSON

{
    "code": "SUCCESS",
    "success": true,
    "data": {
        "businessStatus": 3,
        "businessStatusName": "已成功",
        "serviceCode": "tax-item",
        "detail": [
            {
                "sbywbm": "YBNSRZZS",
                "taxProjectName": "增值税及附加税费申报表",
                "taxProjectCode": "10101",
                "fromDate": "2023-02-01",
                "toDate": "2023-02-28"
            }
        ],
        "aggOrgId": 452681066557440,
        "taskId": 456046345377024
    }
}

上传各税种申报表数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/upload/data

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
year	Integer	是	年
period	Integer	是	月
accountId	String	否	账号id，多账号场景
isDirectDeclare	Boolean	否	是否上传后直接申报，默认false
usePresetDialog	Boolean	否	使用预置弹窗信息，默认true
allowRepeatDeclare	Boolean	否	是否允许重复申报
tdztswjgmc	String	否	特定主体税务机关名称
bsswjg	String	否	跨区域上传省市区，格式：省\|市\|区
kqyswjgmc	String	否	跨区域税局机关名称
jrwc	String	否	是否兼容一分钱尾差，Y兼容/N不兼容，默认N
zdsysfsh	String	否	重点税源是否审核，1=审核
sfxzyhssm	Boolean	否	是否新增印花税税目
zsxmDm	String	否	征收项目代码，工会经费=39900/水利建设专项收入=30221
ybData	Object	否	一般纳税人增值税及附加税报文
xgmData	Object	否	小规模增值税及附加税报文
xgmDqdeData	Object	否	定期定额申报报文
sdsData	Object	否	企业所得税新版报文
whsyjsfData	Object	否	文化事业建设费报文
yhsData	Object	否	印花税按次/按期申报报文
ghjfData	Object	否	通用申报（工会经费和水利建设基金）报文
fssrTysbData	Object	否	非税收入通用申报表报文
xfsData	Object	否	消费税报文
hbsData	Object	否	环境保护税报文
fcsData	Object	否	房产税报文
cztdsData	Object	否	城镇土地使用税报文
zysData	Object	否	资源税报文
szyData	Object	否	水资源报文
cbjData	Object	否	残疾人就业保障金报文
ccsData	Object	否	车船税报文
hsqjData	Object	否	汇算清缴非分支机构报文
hsqjFjgData	Object	否	汇算清缴分机构报文
glywData	String	否	企业年度关联业务往来报告表报文
ccxwshbData	String	否	财产行为税合并纳税申报（房土）报文
zzsyjData	String	否	增值税预缴报文
tdzzsData	String	否	土地增值税报文
optionCodeList	Array	否	多条弹窗设置明细

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "isDirectDeclare": true,
    "period": 3,
    "year": 2023,
    "ybData": []
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业id
data.taskId	String	申报任务id，isDirectDeclare=true时返回，可查询任务状态
data.isDeclared	Boolean	是否上传后直接申报标志
data.message	String	提示信息
data.checkMessage	String	参数校验失败信息

响应示例

JSON

{
    "reqId": "xxxxxxxxxxxx",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "455839218784768",
        "isDeclared": true,
        "message": "上传成功，并发起申报！",
        "checkMessage": ""
    }
}

上传申报表EXCEL数据

上传各税种申报表EXCEL数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/upload/excel

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
file	File	是	Excel文件(multipart/form-data)

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询上传申报表结果

查询上传并申报各税种申报表数据任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/upload/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskId	String	是	任务id

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "454756950473984"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.result	String	任务执行结果
data.resultMessage	String	任务执行明细信息
data.startTime	String	开始时间
data.finishTime	String	完成时间
data.sbState	Integer	申报状态
data.bqybtse	String	本期应补退税额（增值税税额），申报成功或税局保存时返回
data.bqybtsecjs	String	城建税本期应补退税额
data.bqybtsejyfj	String	教育附加本期应补退税额
data.bqybtsedfjyfj	String	地方教育附加本期应补退税额
data.sbScreenUrl	String	申报截图，申报成功时返回
data.taxAmount	String	税额，申报成功时返回
data.detail	Array	明细列表

响应示例

JSON

{
    "reqId": "xxxxxxxxxxxx",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454756950473984",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "申报",
        "result": "SUCCESS",
        "resultMessage": "申报成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "sbState": 1,
        "bqybtse": "0.00",
        "sbScreenUrl": "https:\/\/...",
        "detail": []
    }
}

上传财报数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/upload/financial

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id，创建企业返回的id
year	Integer	是	申报年份，格式yyyy
period	Integer	是	申报月份，自然月（1-12）
accountId	String	否	账号ID，多账号场景
isDirectDeclare	Boolean	否	是否上传数据直接申报，默认false
duration	Integer	否	任务时长（必须大于30），单位分钟
jrwc	String	否	是否兼容一分钱尾差，Y兼容/N不兼容，默认N
gzDeclare	Integer	否	财报覆盖申报，1=覆盖/0=不覆盖，isDirectDeclare=true时生效
allowRepeatDeclare	Boolean	否	是否允许重复申报
overloadKjzdzz	Boolean	否	是否重置会计制度准则，true=重置清册和企业信息的财报备案设置
cbData	Object	否	财报月季度报文，上传月季度报文时不允许为空
cbnbData	Object	否	财报年度申报报文，上传财报年报时不为空
jthbData	Object	否	企业集团合并财务报表报文
optionCodeList	Array	否	多条弹窗设置明细

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2023,
    "period": 3,
    "isDirectDeclare": true,
    "cbData": []
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业Id
data.taskId	String	申报任务id，isDirectDeclare=true时返回
data.message	String	提示信息，如"上传成功，并发起申报！"

响应示例

JSON

{
    "reqId": "xxxxxxxxxxxx",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "455839218784768",
        "message": "上传成功，并发起申报！"
    }
}

查询上传财报结果

查询上传并申报财报数据任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/upload/financial/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskId	String	是	任务id

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "454760922049791"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.result	String	任务执行结果
data.resultMessage	String	任务执行明细信息
data.startTime	String	任务发起时间
data.finishTime	String	任务结束时间
data.sbState	Integer	申报状态
data.sbScreenUrl	String	申报截图，申报成功时返回
data.taxAmount	String	税额，申报成功时返回
data.detail	Array	明细列表

响应示例

JSON

{
    "reqId": "d56bf863692743f29aae10dc27243c0e",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454760922049791",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "财报申报",
        "result": "SUCCESS",
        "resultMessage": "申报成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "sbState": 1,
        "sbScreenUrl": "https:\/\/...",
        "detail": []
    }
}

发起简易申报任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/simple/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询简易申报任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/simple/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起查询合同接口任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/contract/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询合同任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/contract/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起代扣代缴初始化数据

发起代扣代缴初始化数据任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/withhold/init

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

发起获取初始化数据任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/init/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

初始化数据查询

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/init/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

未开票收入算税

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/uninvoiced/calc

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份
wkpsr	Number	是	未开票收入金额

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询未开票收入算税任务

查询未开票收入算税任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/uninvoiced/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起税局申报状态汇总查询

发起税局申报状态汇总查询任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/status/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询申报状态汇总结果

查询税局申报状态汇总任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/status/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功
data.detail	Array	各税种申报状态

发起申报任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/submit/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id
year	Integer	是	年
period	Integer	是	申报月份，自然月
accountId	String	否	账号Id，多账号场景
zsxmList	Array	是	税种明细列表
zsxmList[].yzpzzlDm	String	是	应征凭证种类代码，参考附录
zsxmList[].ssqQ	String	是	所属期起，格式yyyy-MM-dd
zsxmList[].ssqZ	String	是	所属期止，格式yyyy-MM-dd
zsxmList[].zspmDm	String	否	征收品目代码，文化事业建设费时必传
zsxmList[].zlbsxlDm	String	否	资料报送小类代码，财报必传：ZL1001001一般企业/ZL1001003小企业
zsxmList[].templateCode	String	否	资料报送子类代码，一般企业会计准则时必填
zsxmList[].zsxmDm	String	否	征收项目代码，工会经费=39900/水利建设专项收入=30221
jrwc	String	否	是否兼容一分钱尾差，Y兼容/N不兼容，默认N
zdsysfsh	String	否	重点税源是否审核，1=审核
gzDeclare	Integer	否	财报覆盖申报，1=覆盖/0=不覆盖

请求示例

JSON

{
    "aggOrgId": "447111111111200",
    "year": 2023,
    "period": 3,
    "zsxmList": [
        {
            "yzpzzlDm": "BDA0610606",
            "ssqQ": "2023-02-01",
            "ssqZ": "2023-02-28"
        }
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业Id
data.taskIds	Array	任务列表，包含taskId

响应示例

JSON

{
    "reqId": "bc8d1c6a828a49978bdde83dec543c20",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "447111111111200",
        "taskIds": [
            {
                "taskId": "455839218784768"
            }
        ]
    }
}

查询申报任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/submit/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

查询申报任务进度

查询申报任务进度结果接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/submit/progress

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskIds	Array[String]	是	任务id列表，至少1个

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskIds": [
        "454760922049792"
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.serviceCode	String	服务代码，taxBatchSb=批量申报
data.code	String	任务code，2000=申报成功，2002=非本通道申报，4开头=申报失败
data.message	String	任务信息
data.startTime	String	任务发起时间
data.finishTime	String	任务结束时间
data.detail	Array	明细列表，包含各税种申报结果

响应示例

JSON

{
    "reqId": "807aa626b84b4e49ab0405dee305682d",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454760922049792",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "批量申报",
        "serviceCode": "taxBatchSb",
        "code": "2000",
        "message": "申报成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "detail": []
    }
}

发起更正申报任务

发起更正申报任务接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/correct/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询更正申报任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/correct/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起作废申报任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/void/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询作废申报任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/void/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起税款缴纳任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pay/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
year	Integer	是	年
period	Integer	是	月
accountId	String	否	账号ID，多账号场景
tdztswjgmc	String	否	特定主体税务机关名称
duration	Integer	否	任务时长（必须大于30），单位分钟
detail	Array	是	税种明细列表
detail[].yzpzzlDm	String	是	应征凭证种类代码
detail[].fromDate	String	是	有效期起
detail[].toDate	String	是	有效期止
detail[].taxAmount	Number	是	申请缴款金额
detail[].agreementAccount	String	否	三方缴款协议号
detail[].jkfs	String	否	缴款方式：0=三方协议号缴款 1=银行账号缴款 2=二维码缴款，默认0
detail[].yhzh	String	否	银行账号，银行账号缴款时使用
detail[].zspmDm	String	否	征收品目代码，文化事业建设费时必传
detail[].zsxmDm	String	否	征收项目代码，工会经费=39900/水利建设专项收入=30221
detail[].bsswjg	String	否	跨区域缴款省市区，格式：省\|市\|区
detail[].kqyswjgmc	String	否	跨区域税局机关名称
detail[].sebyz	String	否	税额不一致允许缴款（Y/N），默认N

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2023,
    "period": 3,
    "detail": [
        {
            "yzpzzlDm": "BDA0610606",
            "fromDate": "2023-02-01",
            "toDate": "2023-02-28",
            "taxAmount": 10,
            "jkfs": "1",
            "yhzh": "34001445708053000000",
            "agreementAccount": "BD235235123A0610606"
        }
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	Integer	企业id
data.taskId	String	任务id
data.taskIds	Array	任务列表

响应示例

JSON

{
    "reqId": "eedb866f0ddb43e88342adb88283ef98",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": 452681066557440,
        "taskId": "455839218784768",
        "taskIds": [
            {
                "taskId": "455839218784768"
            }
        ]
    }
}

查询税款缴纳任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pay/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

查询缴款任务进度

查询缴款任务进度结果接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pay/progress

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskIds	Array[String]	是	任务id列表，至少1个

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskIds": [
        "454760922049792"
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.serviceCode	String	服务代码
data.code	String	任务code
data.message	String	任务信息
data.startTime	String	任务发起时间
data.finishTime	String	任务结束时间
data.detail	Array	明细列表

响应示例

JSON

{
    "reqId": "807aa626b84b4e49ab0405dee305682d",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454760922049792",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "缴款",
        "serviceCode": "taxBatchPay",
        "code": "2000",
        "message": "缴款成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "detail": []
    }
}

发起申报信息查询任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/info/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
accountId	String	否	账号ID（多账号场景使用）
year	Integer	是	年
period	Integer	是	月
tdztswjgmc	String	否	特定主体税务机关名称
kqyswjgmc	String	否	跨区域税局机关名称
bsswjg	String	否	跨区域上传省市区，格式：省\|市\|区，如"湖南省\|湘潭市\|岳塘区"

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2023,
    "period": 3
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业aggOrgId
data.taskId	String	任务id，用于查询任务执行结果

响应示例

JSON

{
    "reqId": "b73cb23f46004b5abc2e96097936a34b",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "455839218784768"
    }
}

查询申报信息任务

查询申报信息任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/info/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskId	String	是	任务id

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "455810223673344"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业Id
data.taskId	String	任务id
data.businessStatus	String	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceCode	String	任务类型：tax-item获取条目 tax-sb-msg获取条目 tax-check漏报检查
data.serviceName	String	任务类型名称
data.code	String	任务code
data.message	String	任务信息
data.detail	Array	申报详情列表，包含各税种申报状态、缴款状态、税局金额、截图等

响应示例

JSON

{
    "reqId": "c4ddd91520xxxxx",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "455810223673344",
        "businessStatus": "3",
        "businessStatusName": "执行成功",
        "serviceCode": "tax-item",
        "serviceName": "获取条目",
        "code": "SUCCESS",
        "message": "执行成功",
        "detail": []
    }
}

发起漏报检查任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/leak/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询漏报检查任务

查询漏报检查任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/leak/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

税源信息采集

税源信息采集接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/collect

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询税源信息采集结果

查询税源信息采集任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/collect/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

税源信息获取

税源信息获取接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/get

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询税源获取任务结果

查询税源获取任务结果接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/get/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

税源变更

税源变更接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/change

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询税源变更任务结果

查询税源变更任务结果接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/taxsource/change/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

保存申报辅助设置弹窗选项

保存申报辅助设置弹窗选项信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/assist/save

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
data	Object	是	辅助设置数据

响应参数

参数名	类型	说明
code	String	SUCCESS=成功

查询申报辅助设置弹窗信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/assist/query

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
yzpzzlDm	String	否	税种代码

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Object	辅助设置信息

查询全量辅助设置弹窗信息

查询全量申报辅助设置弹窗信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/assist/all

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
yzpzzlDm	String	否	税种代码

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Object	辅助设置信息

发起下载完税证明任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cert/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id
year	Integer	是	年
period	Integer	是	月
accountId	String	否	账号ID，多账号场景
tdztswjgmc	String	否	特定主体税务机关名称
zsxmDtos	Array	否	税种明细列表
zsxmDtos[].yzpzzlDm	String	是	应征凭证种类代码，参考附录
zsxmDtos[].ssqQ	String	是	日期起，格式yyyy-MM-dd
zsxmDtos[].ssqZ	String	是	日期止，格式yyyy-MM-dd
zsxmDtos[].zspmDm	String	否	征收品目代码，文化事业建设费时必传
zsxmDtos[].zsxmDm	String	否	征收项目代码，工会经费=39900/水利建设专项收入=30221
zsxmDtos[].bsswjg	String	否	跨区域上传税务机关，格式：省\|市\|区
zsxmDtos[].kqyswjgmc	String	否	跨区域税局机关名称

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "year": 2023,
    "period": 3,
    "zsxmDtos": [
        {
            "ssqQ": "2023-02-01",
            "ssqZ": "2023-02-28",
            "yzpzzlDm": "BDA0610606"
        }
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业id
data.taskId	String	任务id，可通过查询任务状态接口查询执行情况
data.taskIds	Array	任务明细集合

响应示例

JSON

{
    "reqId": "7f1dbfb3adbd46589b3d9c203458fe75",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557440",
        "taskId": "455839218784768",
        "taskIds": [
            {
                "taskId": "455839218784768"
            }
        ]
    }
}

查询下载完税证明结果

查询下载完税证明任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cert/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskId	String	是	任务id

请求示例

JSON

{
    "aggOrgId": "452681066557441",
    "taskId": "454625331471104"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.result	String	任务执行结果
data.resultMessage	String	任务执行明细信息
data.startTime	String	任务发起时间
data.finishTime	String	任务结束时间
data.code	String	任务code
data.message	String	任务信息
data.detail	Array	明细数据，包含完税证明文件URL等

响应示例

JSON

{
    "reqId": "531c48780e7f4a14a0c399669c16e1ba",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454625331471104",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "下载完税证明",
        "result": "SUCCESS",
        "resultMessage": "下载成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "code": "SUCCESS",
        "message": "执行成功",
        "detail": []
    }
}

发起下载完税证明并解析

发起下载完税证明并解析任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cert/parse/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
year	Integer	是	年份
period	Integer	是	月份

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

查询完税证明解析结果

查询下载完税证明并解析任务的结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/cert/parse/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

发起下载当期PDF任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pdf/current

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
year	Integer	是	年（当前年度）
period	Integer	是	月（当前申报月份）
accountId	String	否	账号ID，多账号场景
tdztswjgmc	String	否	特定主体税务机关名称
analysisPdf	String	否	解析PDF：Y=解析/N=不解析，支持增值税、企业所得税、财报、印花税、房产税等
zsxmList	Array	是	税种明细列表
zsxmList[].yzpzzlDm	String	是	应征凭证种类代码
zsxmList[].ssqQ	String	是	所属期起，格式yyyy-MM-dd
zsxmList[].ssqZ	String	是	所属期止，格式yyyy-MM-dd
zsxmList[].zspmDm	String	否	征收品目代码，文化事业建设费时必传
zsxmList[].zlbsxlDm	String	否	资料报送小类，财报必传：ZL1001001一般企业/ZL1001003小企业
zsxmList[].templateCode	String	否	资料报送子类，一般企业会计准则时必填
zsxmList[].zsxmDm	String	否	征收项目代码，工会经费=39900/水利建设专项收入=30221
zsxmList[].bsswjg	String	否	跨区域上传税务机关，格式：省\|市\|区
zsxmList[].kqyswjgmc	String	否	跨区域税局机关名称

请求示例

JSON

{
    "aggOrgId": "452681066557441",
    "year": 2023,
    "period": 3,
    "analysisPdf": "Y",
    "zsxmList": [
        {
            "yzpzzlDm": "BDA0610606",
            "ssqQ": "2023-02-01",
            "ssqZ": "2023-02-28"
        }
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	String	企业id
data.taskId	String	任务id
data.taskIds	Array	任务列表

响应示例

JSON

{
    "reqId": "f24cf53b202741cb8662184639aa2c7d",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": "452681066557441",
        "taskId": "455839218784768",
        "taskIds": [
            {
                "taskId": "455839218784768"
            }
        ]
    }
}

发起下载往期PDF任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pdf/history

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id
skssqq	String	是	税款所属期起，格式yyyy-MM-dd
skssqz	String	是	税款所属期止，格式yyyy-MM-dd
projectType	Integer	是	查询类型：0=税务 1=财报
yzpzzlDms	Array[String]	是	各税种的yzpzzlDm列表，只支持单个税种
accountId	String	否	账号ID，多账号场景
tdztswjgmc	String	否	特定主体税务机关名称
sbrqq	String	否	申报日期起，格式yyyy-MM-dd
sbrqz	String	否	申报日期止，格式yyyy-MM-dd
analysisPdf	String	否	解析PDF：Y=解析/N=不解析
bsswjg	String	否	跨区域上传税务机关，格式：省\|市\|区
kqyswjgmc	String	否	跨区域税局机关名称

请求示例

JSON

{
    "aggOrgId": "452681066557441",
    "skssqq": "2023-02-01",
    "skssqz": "2023-02-28",
    "sbrqq": "2023-03-01",
    "sbrqz": "2023-03-31",
    "projectType": 0,
    "analysisPdf": "Y",
    "yzpzzlDms": [
        "BDA0610606"
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.aggOrgId	Integer	企业id
data.taskId	String	任务id

响应示例

JSON

{
    "reqId": "ac77bfab0e6f4018be6209a58127ea8d",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "aggOrgId": 452681066557441,
        "taskId": "455839218784768"
    }
}

查询往期PDF数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pdf/history/data

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业Id
projectType	Integer	是	查询类型：0=税务 1=财报
skssqq	String	否	税款所属期起，格式yyyy-MM-dd
skssqz	String	否	税款所属期止，格式yyyy-MM-dd
sbrqq	String	否	申报日期起，格式yyyy-MM-dd
sbrqz	String	否	申报日期止，格式yyyy-MM-dd
yzpzzlDms	Array[String]	否	各税种的yzpzzlDm列表，参考附录

请求示例

JSON

{
    "aggOrgId": "452681066557441",
    "skssqq": "2023-02-01",
    "skssqz": "2023-02-28",
    "projectType": 0,
    "yzpzzlDms": [
        "BDA0610606"
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskState	String	是否有正在执行的任务：0=任务已执行完 1=有正在执行的任务
data.detail	Array	往期PDF明细列表，包含pdfUrl等文件地址

响应示例

JSON

{
    "reqId": "7f4795932506460e8065381ef4dd0be2",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskState": "0",
        "detail": []
    }
}

查询下载PDF任务结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pdf/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskId	String	是	任务id

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "taskId": "454624899269376"
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data.taskId	String	任务id
data.businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data.businessStatusName	String	任务执行状态名称
data.serviceName	String	服务名称
data.result	String	任务执行结果
data.resultMessage	String	任务执行明细信息
data.startTime	String	任务发起时间
data.finishTime	String	任务结束时间
data.pdfFileUrl	String	PDF文件路径
data.code	String	任务code
data.message	String	任务信息
data.detail	Array	明细列表

响应示例

JSON

{
    "reqId": "e2b308161e7d4b4093cf42ba0fa287f0",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": {
        "taskId": "454624899269376",
        "businessStatus": 3,
        "businessStatusName": "执行成功",
        "serviceName": "下载PDF",
        "result": "SUCCESS",
        "resultMessage": "下载成功",
        "startTime": "2023-10-01 10:00:00",
        "finishTime": "2023-10-01 10:00:30",
        "pdfFileUrl": "https:\/\/...",
        "code": "SUCCESS",
        "message": "执行成功",
        "detail": []
    }
}

PDF任务返回结构化数据

查询PDF任务返回结构化数据

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/pdf/structured

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

查询多个任务执行结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/multi/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业id
taskIds	Array[String]	是	任务id列表

请求示例

JSON

{
    "aggOrgId": "447893717379200",
    "taskIds": [
        "447900074182400",
        "447901198051072",
        "447904749215488",
        "448024322614272"
    ]
}

响应参数

参数名	类型	说明
reqId	String	请求id，由服务器端生成的唯一标识
code	String	错误码
success	Boolean	是否成功标记
message	String	错误信息
data[].taskId	String	任务id
data[].businessStatus	Integer	任务执行状态：0未开始 1执行中 2执行失败 3执行成功 4撤销成功
data[].businessStatusName	String	任务执行状态名称
data[].serviceName	String	服务名称
data[].result	String	任务执行结果
data[].resultMessage	String	任务执行明细信息
data[].startTime	String	任务发起时间
data[].finishTime	String	任务结束时间
data[].sbState	Integer	申报状态
data[].bqybtse	String	本期应补退税额（增值税税额），申报成功或税局保存时返回
data[].bqybtsecjs	String	城建税本期应补退税额
data[].bqybtsejyfj	String	教育附加本期应补退税额
data[].bqybtsedfjyfj	String	地方教育附加本期应补退税额
data[].sbScreenUrl	String	申报截图，申报成功时返回
data[].saveScreenUrl	String	税局保存时截图
data[].jkScreenUrl	String	缴款截图，缴款成功时返回
data[].pdfFileUrl	String	PDF文件路径，PDF下载任务成功时返回
data[].taxAmount	String	税额，申报成功时返回
data[].taxFundResult	String	税源采集结果明细
data[].detail	Array	详情列表

响应示例

JSON

{
    "reqId": "xxxxxxxxxxxx",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": [
        {
            "taskId": "447900074182400",
            "businessStatus": 3,
            "businessStatusName": "执行成功",
            "serviceName": "采集企业税务信息",
            "result": "SUCCESS",
            "resultMessage": "执行成功",
            "startTime": "2023-10-01 10:00:00",
            "finishTime": "2023-10-01 10:00:30"
        }
    ]
}

获取助手客户端下载地址

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/helper/download

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.downloadUrl	String	下载地址

查询税收优惠政策代码

查询税收优惠政策代码及名称

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/tax/policy

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
yzpzzlDm	String	否	税种代码

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.list	Array	优惠政策列表

任务终止

任务终止接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/task/stop

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.result	Boolean	终止结果

发起获取我的待办

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/todo/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

发起获取我的提醒

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/remind/start

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.taskId	String	任务ID

获取我的待办结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/todo/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

获取我的提醒结果

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/remind/result

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data.businessStatus	Integer	3=成功

任务回调

智能申报任务回调接口

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/declare/task/callback

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
taskId	String	是	任务ID
businessStatus	Integer	是	3=成功/2=失败

响应参数

参数名	类型	说明
code	String	返回SUCCESS表示已接收