认证服务 MCP 文档

文档信息

项目	说明
文档版本	v1.0.0
最后更新	2026-01-12
文档状态	正式版
服务名称	认证服务
服务标识	MCP-Server

1. 服务概述

认证服务对外提供 税款所属期获取/更新、进项发票采集、进项发票勾选、发票统计确认 等能力，统一通过 MCP 协议调用。用户只需选择正确的服务路径（mount path）与工具名称（tool），并在请求参数中携带 client_appkey/client_secret 即可完成相关业务。

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

2. 服务路径与工具总览

服务名称	Mount Path	核心工具（对外名称 / 中文说明）
获取税款所属期服务	`/mcp/get_tax_payment_period`	`get_tax_payment_period_auto`（获取税款所属期）, `update_tax_payment_period_auto`（更新税款所属期）, `update_tax_payment_period_task_result_auto`（更新税款所属期任务结果查询）
进项发票采集	`/mcp/collect_input_invoice`	`request_input_invoice_collection_auto`（申请进项发票采集）, `get_input_invoice_data_auto`（获取进项发票数据）, `query_input_invoice_collection_result_auto`（进项发票采集结果查询）
进项发票勾选服务	`/mcp/select_invoice_for_deduction`	`select_invoice_for_deduction_auto`（进项发票勾选/撤销）, `query_invoice_selection_result_auto`（发票勾选结果查询）
发票统计确认服务	`/mcp/invoice_authentication_statistics`	`apply_invoice_authentication_statistics_auto`（发票统计确认申请）, `confirm_invoice_authentication_statistics_auto`（发票统计确认签名申请）, `revoke_invoice_authentication_statistics_confirmation_auto`（撤销统计确认）, `query_invoice_authentication_statistics_confirmation_result_auto`（统计确认/撤销统计结果查询）

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

3. 鉴权方式与安全说明

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

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

请勿在日志中输出税号、发票号码等敏感信息。

4. 快速开始

4.1 获取税款所属期（SSE）

4.2 获取税款所属期（HTTP Streamable）

5. 接口说明

5.1 获取税款所属期服务（/mcp/get_tax_payment_period）

5.1.1 get_tax_payment_period_auto

功能说明：获取税款所属期。

必填参数：

nsrsbh: 纳税人识别号

可选参数：

client_appkey / client_secret

5.1.2 update_tax_payment_period_auto

功能说明：更新税款所属期（可同步/异步）。

必填参数：

nsrsbh: 纳税人识别号

可选参数：

accountId: 登录账户唯一标识（多账号时必传）

sync: 是否同步获取结果（true-同步，false-异步，默认 false）

client_appkey / client_secret

5.1.3 update_tax_payment_period_task_result_auto

功能说明：查询更新税款所属期任务结果。

必填参数：

nsrsbh: 纳税人识别号

taskId: 任务ID

可选参数：

client_appkey / client_secret

5.2 进项发票采集（/mcp/collect_input_invoice）

5.2.1 request_input_invoice_collection_auto

功能说明：申请进项发票采集任务。

必填参数：

nsrsbh: 纳税人识别号

可选参数：

accountId: 登录账户唯一标识（多账号时必传）

cjlx: 采集类型（单次仅允许单个类型；与 gxzt 需匹配）

customReqId: 用户标识ID（AppKey+UUID，需唯一）

fpdm: 发票代码

fphm: 发票号码

qdfphm: 全电发票号码

fplx: 发票类型（01/03/04/08/10/14/61/81/82/83/85/86/87/88/8208，可多值用逗号分隔）

fpzt: 发票状态（0-正常，2-作废，7-部分红冲，8-全额红冲，可多值用逗号分隔）

glzt: 管理状态（0-正常，1-疑点，2-异常）

gxzt: 勾选状态（0-未勾选，1-已勾选，仅可填一个）

kprqq: 开票日期起（时间区间限制）

kprqz: 开票日期止（时间区间限制）

pageNumber: 页码（同步请求时必传）

pageSize: 分页大小（10/20/50/100，同步请求时必传）

sync: 是否同步获取结果（true-同步，false-异步，默认 false）

xfmc: 销方名称

xfsbh: 销方识别号

client_appkey / client_secret

5.2.2 get_input_invoice_data_auto

功能说明：进项发票取数。

必填参数：

nsrsbh: 纳税人识别号

可选参数：

customReqId: 用户标识ID（AppKey+UUID，需唯一）

fpdm: 发票代码（单张取数）

fphm: 发票号码（单张取数）

qdfphm: 全电发票号码（单张取数）

zmbh: 转内销证明编号（单张取数）

fplx: 发票类型（01/03/04/08/10/14/61/81/82/83/85/86/87/88/8208，可多值用逗号分隔）

fpzt: 发票状态（0-正常，2-作废，7-部分红冲，8-全额红冲，可多值用逗号分隔）

glzt: 管理状态（0-正常，1-非正常，2-疑似非正常）

gxzt: 勾选状态（0-未勾选，1-已勾选）

kprqq: 开票日期起（与 rksjq/rksjz 二选一）

kprqz: 开票日期止（与 kprqq 配对）

rksjq: 入库时间起（与 kprqq/kprqz 二选一）

rksjz: 入库时间止（与 rksjq 配对）

skssqq: 税款所属期起（gxzt=1 时必传）

skssqz: 税款所属期止（gxzt=1 且 skssqq 不为空时必传）

xfmc: 销方名称

xfsbh: 销方识别号

page

currentPage: 当前页

pageSize: 分页大小

client_appkey / client_secret

5.2.3 query_input_invoice_collection_result_auto

功能说明：查询进项发票采集任务结果。

必填参数：

nsrsbh: 纳税人识别号

taskId: 任务ID

page: 分页信息

currentPage: 当前页

pageSize: 每页条数

可选参数：

client_appkey / client_secret

5.3 进项发票勾选服务（/mcp/select_invoice_for_deduction）

5.3.1 select_invoice_for_deduction_auto

功能说明：进项发票勾选/撤销。

必填参数：

nsrsbh: 纳税人识别号

skssq: 税款所属期

gxlx: 勾选类型

list: 勾选明细列表

可选参数：

customReqId: 用户标识ID（AppKey+UUID，需唯一）

list

fpdm: 发票代码（增值税发票/数电纸质发票必填）

fphm: 发票号码（增值税发票/数电纸质发票必填）

qdfphm: 全电发票号码（数电发票20位必填）

yxse: 有效税额（不填默认为税额）

zmbh: 出口转内销证明编号（出口转内销勾选时必填）

client_appkey / client_secret

5.3.2 query_invoice_selection_result_auto

功能说明：查询勾选结果。

必填参数：

nsrsbh: 纳税人识别号

reqId: 请求ID

customReqId: 自定义请求ID

可选参数：

client_appkey / client_secret

5.4 发票统计确认服务（/mcp/invoice_authentication_statistics）

5.4.1 apply_invoice_authentication_statistics_auto

功能说明：发票统计确认申请。

必填参数：

nsrsbh: 纳税人识别号

ywlx: 业务类型

可选参数：

customReqId: 用户标识ID（AppKey+UUID，需唯一）

mxbz: 明细标识（1-需要，2-不需要）

client_appkey / client_secret

5.4.2 confirm_invoice_authentication_statistics_auto

功能说明：发票统计确认签名申请。

必填参数：

nsrsbh: 纳税人识别号

ywlx: 业务类型

可选参数：

customReqId: 用户标识ID（AppKey+UUID，需唯一）

mxbz: 明细标识（1-需要，2-不需要）

client_appkey / client_secret

5.4.3 revoke_invoice_authentication_statistics_confirmation_auto

功能说明：撤销统计确认申请。

必填参数：

nsrsbh: 纳税人识别号

ywlx: 业务类型

可选参数：

customReqId: 用户标识ID（AppKey+UUID，需唯一）

mxbz: 明细标识（1-需要，2-不需要）

client_appkey / client_secret

5.4.4 query_invoice_authentication_statistics_confirmation_result_auto

功能说明：统计确认/撤销统计结果查询。

必填参数：

nsrsbh: 纳税人识别号

id: 申请ID

可选参数：

customReqId:用户标识ID

client_appkey / client_secret

6. 常见问题

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

Q2：采集与取数有什么区别？
A：采集（request_input_invoice_collection_auto）发起任务，取数（get_input_invoice_data_auto）用于查询已采集数据。

Q3：统计确认如何查询结果？
A：先申请统计/确认，若返回异步任务信息，再用 query_invoice_authentication_statistics_confirmation_result_auto 查询结果。

认证服务

认证服务 MCP 文档#

文档信息#

目录#

1. 服务概述#

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

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

4. 快速开始#

4.1 获取税款所属期（SSE）#

4.2 获取税款所属期（HTTP Streamable）#

5. 接口说明#

5.1 获取税款所属期服务（/mcp/get_tax_payment_period）#

5.1.1 get_tax_payment_period_auto#

5.1.2 update_tax_payment_period_auto#

5.1.3 update_tax_payment_period_task_result_auto#

5.2 进项发票采集（/mcp/collect_input_invoice）#

5.2.1 request_input_invoice_collection_auto#

5.2.2 get_input_invoice_data_auto#

5.2.3 query_input_invoice_collection_result_auto#

5.3 进项发票勾选服务（/mcp/select_invoice_for_deduction）#

5.3.1 select_invoice_for_deduction_auto#

5.3.2 query_invoice_selection_result_auto#

5.4 发票统计确认服务（/mcp/invoice_authentication_statistics）#

5.4.1 apply_invoice_authentication_statistics_auto#

5.4.2 confirm_invoice_authentication_statistics_auto#

5.4.3 revoke_invoice_authentication_statistics_confirmation_auto#

5.4.4 query_invoice_authentication_statistics_confirmation_result_auto#

6. 常见问题#

认证服务 MCP 文档

文档信息

目录

1. 服务概述

2. 服务路径与工具总览

3. 鉴权方式与安全说明

4. 快速开始

4.1 获取税款所属期（SSE）

4.2 获取税款所属期（HTTP Streamable）

5. 接口说明

5.1 获取税款所属期服务（/mcp/get_tax_payment_period）

5.1.1 get_tax_payment_period_auto

5.1.2 update_tax_payment_period_auto

5.1.3 update_tax_payment_period_task_result_auto

5.2 进项发票采集（/mcp/collect_input_invoice）

5.2.1 request_input_invoice_collection_auto

5.2.2 get_input_invoice_data_auto

5.2.3 query_input_invoice_collection_result_auto

5.3 进项发票勾选服务（/mcp/select_invoice_for_deduction）

5.3.1 select_invoice_for_deduction_auto

5.3.2 query_invoice_selection_result_auto

5.4 发票统计确认服务（/mcp/invoice_authentication_statistics）

5.4.1 apply_invoice_authentication_statistics_auto

5.4.2 confirm_invoice_authentication_statistics_auto

5.4.3 revoke_invoice_authentication_statistics_confirmation_auto

5.4.4 query_invoice_authentication_statistics_confirmation_result_auto

6. 常见问题