申报与企业管理服务 MCP 文档

文档信息

项目	说明
文档版本	v1.1.0
最后更新	2026-01-12
文档状态	正式版
服务名称	申报与企业管理服务
服务标识	MCP-Server

1. 服务概述

申报与企业管理服务对外提供 企业税务信息采集与查询、申报初始化数据任务、财务报表上传、任务查询与任务执行 等能力，统一通过 MCP 协议调用。用户只需选择正确的服务路径（mount path）与工具名称（tool），并在请求参数中携带 client_appkey/client_secret 即可完成相关业务。

基础 URL（生产）：https://mcp.qixiangyun.com

2. 服务路径与工具总览

服务名称	Mount Path	核心工具（对外名称 / 中文说明）
企业管理服务	`/mcp/enterprise_management`	`load_org_tax_info`（发起采集企业税务信息）, `query_org_info`（查询企业信息）
初始化数据模块	`/mcp/initialize_data`	`load_init_data_task`（发起初始化数据任务）, `get_init_data`（查询初始化数据）
财务报表模块	`/mcp/financial_report`	`upload_financial_report_data`（上传财务报表数据）
任务查询模块	`/mcp/task_query`	`query_task_info`（查询任务结果）
任务执行模块	`/mcp/task_execution`	`load_pdf_task`（下载PDF任务）, `load_payment_task`（税款缴纳任务）, `load_wszm_task`（完税证明任务）, `load_declare_info_task`（申报信息查询任务）

说明：统一网关同时提供 SSE 与 HTTP Streamable 两种传输模式，请参考《MCP服务文档》的调用方式章节。

3. 鉴权方式与安全说明

所有工具调用必须包含 client_appkey 与 client_secret。

推荐使用注入脚本从本地 .env 读取后自动注入，避免每次手工传参。

请勿在日志中输出企业税号、账号信息等敏感字段。

4. 快速开始

4.1 企业信息查询（SSE）

4.2 企业信息查询（HTTP Streamable）

5. 接口说明

5.1 企业管理服务（/mcp/enterprise_management）

5.1.1 load_org_tax_info

功能说明：发起采集企业税务信息任务，成功后返回 taskId。

必填参数：

aggOrgId: 企业Id

可选参数：

accountId: 账号ID（多账号场景）

client_appkey / client_secret

5.1.2 query_org_info

功能说明：查询企业税务登记信息、纳税人状态等信息。

必填参数：

aggOrgId: 企业唯一标识 ID

可选参数：

client_appkey / client_secret

5.2 初始化数据模块（/mcp/initialize_data）

5.2.1 load_init_data_task

功能说明：发起申报初始化数据任务。

必填参数：

aggOrgId: 企业Id

year: 税款所属期年（integer）

period: 税款所属期月（integer）

zsxmList: 征收项目列表（array）

ssqQ: 所属期起（yyyy-MM-dd）

ssqZ: 所属期止（yyyy-MM-dd）

yzpzzlDm: 应征凭证种类代码

template_code: 资料报送子类代码（一般企业会计准则/企业会计准则金融企业时必填，其余准则传0）

zlbsxl_dm: 资料报送小类代码（财报必须传）

zspm_dm: 征收品目代码（文化事业建设费必传）

可选参数：

accountId: 账号id（多账号场景）

zsxmList: 征收项目列表（array）

templateCode: 资料报送子类代码（一般企业会计准则/企业会计准则金融企业时必填，其余准则传0）

zlbsxlDm: 资料报送小类代码（财报必须传）

zspmDm: 征收品目代码（文化事业建设费必传）

client_appkey / client_secret

5.2.2 get_init_data

功能说明：查询当期申报初始化数据。

必填参数：

aggOrgId: 企业 ID

year: 税款所属期年（integer）

period: 税款所属期月（integer）

yzpzzlDm: 应征凭证种类代码

可选参数：

client_appkey / client_secret

5.3 财务报表模块（/mcp/financial_report）

5.3.1 upload_financial_report_data

功能说明：上传财务报表数据。

必填参数：

aggOrgId: 企业Id

year: 申报年份（yyyy）

period: 申报月份（1-12）

option_code_list: 多条弹窗设置明细

fileCode: 文件编码（base64），option_code 为强制申报使用

fileName: 文件名称
可选参数：

accountId: 账号ID（多账号场景）

allowRepeatDeclare: 是否允许重复申报（V1版本客户使用）

attachEncode: 财报附注excel base64（即将下线）

attachName: 财报附注excel文件名称（即将下线）

cbData: 财报月季报文

cbnbData: 财报年报报文

duration: 任务时长（分钟，必须大于30）

exAction: 发起税局暂存任务（新版税局即将下线）

gzDeclare: 财报覆盖申报（1覆盖，0不覆盖）

isDirectDeclare: 是否上传数据直接申报

jrwc: 是否兼容一分钱尾差（Y/N）

jthbData: 企业集团合并财务报表

option_code_list: 多条弹窗设置明细

memoJson: 备注信息

optionCode: 选项 code

client_appkey / client_secret

5.4 任务查询模块（/mcp/task_query）

5.4.1 query_task_info

功能说明：查询任务结果（PDF、缴款、完税证明等）。

必填参数：

taskId: 任务 ID

可选参数：

client_appkey / client_secret

5.5 任务执行模块（/mcp/task_execution）

5.5.1 load_pdf_task

功能说明：发起下载当期 PDF 任务。

必填参数：

aggOrgId: 企业id

year: 年

period: 月

zsxmList: 税种明细列表（array）

ssqQ: 所属期起（yyyy-MM-dd）

ssqZ: 所属期止（yyyy-MM-dd）

yzpzzlDm: 应征凭证种类代码

可选参数：

accountId: 账号ID（多账号场景）

analysisPdf: 解析PDF（Y-解析，N-不解析）

tdztswjgmc: 特定主体税务机关名称

zsxmList: 税种明细列表（array）

bsswjg: 跨区域上传税务机关名称（省|市|区）

kqyswjgmc: 跨区域税局机关名称

templateCode: 资料报送子类（一般企业会计准则类型时必填）

zlbsxlDm: 资料报送小类（财报必须传）

zspmDm: 征收品目代码（文化事业建设费必传）

zsxmDm: 征收项目代码（工会经费=39900/水利建设专项收入=30221，可为空）

client_appkey / client_secret

5.5.2 load_payment_task

功能说明：发起税款缴纳任务。

必填参数：

aggOrgId: 企业id

year: 年

period: 月

detail: 税种明细列表（array）

fromDate: 有效期起

toDate: 有效期止

taxAmount: 申请缴款金额

yzpzzlDm: 应征凭证种类代码

可选参数：

accountId: 账号ID（多账号场景）

duration: 任务时长（必须大于30，分钟）

tdztswjgmc: 特定主体税务机关名称

detail: 税种明细列表（array）

agreementAccount: 三方缴款协议号

bsswjg: 跨区域缴款税务机关名称（省|市|区）

jkfs: 缴款方式（0-三方协议号缴款，1-银行账号缴款，2-二维码缴款）

kqyswjgmc: 跨区域税局机关名称

sebyz: 税额不一致允许缴款（Y/N）

yhzh: 银行账号

zspmDm: 征收品目代码（文化事业建设费）

zsxmDm: 征收项目代码（工会经费/水利建设专项收入等）

client_appkey / client_secret

5.5.3 load_wszm_task

功能说明：发起完税证明任务。

必填参数：

aggOrgId: 企业id

year: 年

period: 月

zsxm_dtos: 税种明细列表（array）

ssqQ: 日期起（yyyy-MM-dd）

ssqZ: 日期止（yyyy-MM-dd）

yzpzzlDm: 应征凭证种类代码
可选参数：

accountId: 账号ID（多账号场景）

tdztswjgmc: 特定主体税务机关名称

zsxm_dtos: 税种明细列表（array）

bsswjg: 跨区域上传税务机关名称（省|市|区）

kqyswjgmc: 跨区域税局机关名称

zspmDm: 征收品目代码（文化事业建设费必传）

zsxmDm: 征收项目代码（工会经费/水利建设专项收入等）

client_appkey / client_secret

5.5.4 load_declare_info_task

功能说明：发起申报信息查询任务。

必填参数：

aggOrgId: 企业id

year: 年

period: 月

可选参数：

accountId: 账号ID（多账号场景）

kqyswjgmc: 跨区域税局机关名称

tdztswjgmc: 特定主体税务机关名称

client_appkey / client_secret

6. 常见问题

Q1：为什么提示缺少 client_appkey/client_secret？
A：请确认已通过注入脚本或手工参数传入。建议使用统一注入脚本自动补齐。

Q2：初始化数据任务与任务查询如何配合？
A：先调用 load_init_data_task 获取任务，若为异步则通过 query_task_info 查询任务结果。

Q3：财报上传字段为字符串还是对象？
A：cbData 与 cbnbData 在工具层为对象结构，若使用 HTTP 调用传字符串，系统会尝试解析 JSON 字符串。

申报与企业管理服务

申报与企业管理服务 MCP 文档#

文档信息#

目录#

1. 服务概述#

2. 服务路径与工具总览#

3. 鉴权方式与安全说明#

4. 快速开始#

4.1 企业信息查询（SSE）#

4.2 企业信息查询（HTTP Streamable）#

5. 接口说明#

5.1 企业管理服务（/mcp/enterprise_management）#

5.1.1 load_org_tax_info#

5.1.2 query_org_info#

5.2 初始化数据模块（/mcp/initialize_data）#

5.2.1 load_init_data_task#

5.2.2 get_init_data#

5.3 财务报表模块（/mcp/financial_report）#

5.3.1 upload_financial_report_data#

5.4 任务查询模块（/mcp/task_query）#

5.4.1 query_task_info#

5.5 任务执行模块（/mcp/task_execution）#

5.5.1 load_pdf_task#

5.5.2 load_payment_task#

5.5.3 load_wszm_task#

5.5.4 load_declare_info_task#

6. 常见问题#

申报与企业管理服务 MCP 文档

文档信息

目录

1. 服务概述

2. 服务路径与工具总览

3. 鉴权方式与安全说明

4. 快速开始

4.1 企业信息查询（SSE）

4.2 企业信息查询（HTTP Streamable）

5. 接口说明

5.1 企业管理服务（/mcp/enterprise_management）

5.1.1 load_org_tax_info

5.1.2 query_org_info

5.2 初始化数据模块（/mcp/initialize_data）

5.2.1 load_init_data_task

5.2.2 get_init_data

5.3 财务报表模块（/mcp/financial_report）

5.3.1 upload_financial_report_data

5.4 任务查询模块（/mcp/task_query）

5.4.1 query_task_info

5.5 任务执行模块（/mcp/task_execution）

5.5.1 load_pdf_task

5.5.2 load_payment_task

5.5.3 load_wszm_task

5.5.4 load_declare_info_task

6. 常见问题