发票开具服务 MCP 文档

文档信息

项目	说明
文档版本	v1.2.0
最后更新	2026-01-12
文档状态	正式版
服务名称	发票开具服务
服务标识	MCP-Server

1. 服务概述

发票开具服务对外提供 已开发票查询、企业信息查询、蓝票开票、红字开票、发票查验 等能力，统一通过 MCP 协议调用。用户只需选择正确的服务路径（mount path）与工具名称（tool），并在请求参数中携带 client_appkey/client_secret 即可完成相关业务。

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

2. 服务路径与工具总览

服务名称	Mount Path	核心工具（对外名称 / 中文说明）
已开发票查询服务	`/mcp/invoice_inquiry`	`query_invoice_details_auto`（已开发票明细查询）, `query_invoice_list_auto`（已开发票列表查询）
企业信息查询服务	`/mcp/enterprise_basic_information`	`query_enterprise_basic_information_auto`（企业基本信息查询）, `query_invoice_issuance_quota_auto`（开票额度查询）
蓝票开票服务	`/mcp/blue_invoice`	`issue_blue_invoice_auto`（蓝票开具）, `issue_agricultural_purchase_invoice_auto`（农产品收购发票开具）, `issue_scrap_purchase_invoice_auto`（报废产品收购发票开具）
红字开票服务	`/mcp/red_invoice`	`apply_red_information_auto`（申请红字信息表）, `issue_red_invoice_auto`（开具红字发票）, `query_red_information_list_auto`（红字信息列表查询）, `query_red_information_details_auto`（红字信息明细查询）
发票查验服务	`/mcp/invoice_verification`	`verify_invoice`（单票查验）, `batch_verify_invoices`（批量查验）, `validate_invoice_info`（发票信息校验）

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

3. 鉴权方式与安全说明

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

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

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

4. 快速开始

4.1 蓝票开具（SSE）

4.2 蓝票开具（HTTP Streamable）

5. 接口说明

5.1 已开发票查询服务（/mcp/invoice_inquiry）

5.1.1 query_invoice_details_auto

功能说明：已开发票明细查询。

必填参数：

nsrsbh: 税号

data

fphm: 发票号码，20位数电发票号码

kprq: 开票日期，包含时间 yyyy-MM-dd HH:mm:ss

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型，本接口传入：fpmx

request_async: 是否为异步方式（默认同步）

data_scope: 获取的数据范围字段，0 或者空默认值只获取发票预览的数据；1 获取勾选状态；2 获取入账状态；3 获取入账、勾选、预览数据

data

ly_ddbh: 来源单编号，同开具接口来源订单编号，通过订单号查询已开明细。如果传此参数，fphm 和 kprq 可不传。注意：只有开具成功才能查询到明细，如开票异步开具中，此接口会返回来源单号不存在！

zz_fpdm: 纸质发票代码，数电纸质发票时必传

zz_fphm: 纸质发票号码，数电纸质发票时必传

client_appkey / client_secret

5.1.2 query_invoice_list_auto

功能说明：已开发票列表查询。

必填参数：

nsrsbh: 税号

data

pageIndex: 当前页码

pageSize: 每页行数（10、20、50、100）

params

kprqq: 开票起始日期，yyyy-MM-dd（起止日期必传且为一年内）

kprqz: 开票结束日期，yyyy-MM-dd（起止日期必传且为一年内）

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型，本接口传入：fpcx

async: 是否为异步方式（默认同步）

data

params

dfnsrmc: 对方纳税人名称

dfnsrsbh: 对方税号

fphm: 指定数电发票号码查询

fplxDm: 发票类型代码，默认查询全部（示例：032、030、004、007、025、026、028、005、015、51、61、87、88、83、70、84、85、8208）

fpztDm: 发票状态代码，默认查询全部（01-正常，02-已作废，03-已红冲-全额，04-已红冲-部分）

gjbq: 归集标签（1-开具发票，2-取得发票，默认开具发票）

zz_fpdm: 增值税发票代码

zz_fphm: 增值税发票号码

client_appkey / client_secret

5.2 企业信息查询服务（/mcp/enterprise_basic_information）

5.2.1 query_enterprise_basic_information_auto

功能说明：查询企业基本信息。

必填参数：

nsrsbh: 税号

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型，本接口传：qyjbxxcx

action: 是否为异步方式（默认同步）

client_appkey / client_secret

5.2.2 query_invoice_issuance_quota_auto

功能说明：查询企业开票额度。

必填参数：

nsrsbh: 税号

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型，本接口传：kpjxxcx

async: 是否为异步方式（默认同步）

client_appkey / client_secret

5.3 蓝票开票服务（/mcp/blue_invoice）

说明：issue_blue_invoice_auto、issue_agricultural_purchase_invoice_auto、issue_scrap_purchase_invoice_auto 使用同一套接口与参数结构，仅 data.tdyslxdm 等特定字段不同。

5.3.1 issue_blue_invoice_auto

功能说明：开具蓝字发票（数电普票/数电专票等）。

必填参数：

nsrsbh: 纳税人识别号

data

fplxdm: 发票类型代码（030-数电普票，032-数电专票，83-数电票(机动车销售统一发票)，87-数电纸质(机动车销售统一发票)）

gmf_lx: 购方类型（0-企业，1-个人）

gmf_nsrmc: 购方名称

ly_ddbh: 来源订单编号（同一订单号仅能开具一次）

xmmx: 开票明细项目（数组，至少一行）

fphxz: 发票行性质（0-正常行，1-折扣行，2-被折扣行）

je: 金额

sl: 税率

spbm: 税收商品编码

spmc: 税收商品名称

xmmc: 项目名称

xsf_nsrsbh: 销方税号

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型

request_async: 是否为异步方式（默认同步）

client_appkey / client_secret

data

bdcjyxsxxs: 不动产经营销售服务信息（特定业务类型为不动产经营销售服务时必填）

bdcdz: 不动产地址

kdsbz: 跨地市标志（Y/N）

mjdw: 面积单位（平方米、亩、m²、平方千米、公顷、hm²、km²）

bdcxxdz: 不动产详细地址

fwcqzshm: 房屋产权证书/不动产权证号码

hdjsjg: 核定计税价格

sjcjhsje: 实际成交含税金额

tdzzsxmbh: 土地增值税项目编号

wqhtbabm: 不动产单元代码/网签合同备案编码

bdczyzlxxs: 不动产经营租赁信息（特定业务类型为不动产经营租赁服务时必填）

bdcdz: 不动产地址（省市区）

fwcqzshm: 房屋产权证书/不动产权证号码（无证书传“无”）

kdsbz: 跨地市标志（Y/N）

mjdw: 面积单位（平方米、亩、m²、平方千米、公顷、hm²、km²）

zlqq: 租赁期起（yyyy-MM-dd 或 yyyy-MM-dd HH:mm）

zlqz: 租赁期止（yyyy-MM-dd 或 yyyy-MM-dd HH:mm）

bdcxxdz: 不动产详细地址

cph: 车牌号（特定商品编码时生效）

bz: 备注

cepzmx_list: 差额明细列表

bckcje: 本次扣除金额

pzhjje: 凭证合计金额

bz: 备注（pzlx 为 08/09 时必传）

fpdm: 发票代码（pzlx 为 02/03/04 时必传）

fphm: 发票号码（pzlx 为 01/02/03/04 且电子发票时必传）

kjrq: 开具日期（YYYY-MM-dd）

pzhm: 凭证号码

pzlx: 凭证类型（01-数电票等）

zzfphm: 纸质发票号码（pzlx 为 02/03/04 且纸质发票时必传）

cezslx_dm: 差额开票代码（01-全额，02-差额）

dfgtgmbq: 多方共同购买标识（Y/N）

dsccsxx: 代收车船税信息（特定业务类型为代收车船税时必填）

bxdh: 保险单号

chhcbdjh: 车船号/船舶登记号

dsccsje: 代收车船税金额

hjje: 合计金额

skssq: 税款所属期（yyyy-MM）

znjje: 滞纳金金额

cjh: 车架号

escxx: 二手车信息（特定业务类型为二手车时必填）

escxsfnsrsbh: 卖方税号

escyqrhyxz: 二手车企业性质（07-市场、08-经销、09-拍卖）

escfw_list: 二手车服务信息

clsbdh: 车辆识别代号/车架号码

cphm: 车牌照号

cpxh: 厂牌型号

djzh: 登记证号

zrdclglsmc: 转入地车辆管理所名称

escxsfdz: 卖方地址

escxsflxdh: 卖方电话

escxsfmc: 卖方名称

escxsfzrrbs: 卖方自然人标识

sdfphm: 数电发票号码

zzfpdm: 发票代码

zzfphm: 发票号码

fhr: 复核人

fjxx_list: 附加要素列表

fjxxmc: 附加要素名称

fjxxnr: 附加要素内容

gfxx_confirm: 购方信息确认（0-忽略购方信息错误，空/不传-校验购方税号）

gjql: 干基全硫（%）

gmf_dh: 购买方电话

gmf_dz: 购买方地址

gmf_nsrsbh: 购方税号（数电专票时必填）

gmf_yhmc: 购买方开户银行

gmf_yhzh: 购买方银行账号

gtgmxxes: 多方共同购买方信息

gtgmf: 共同购买方

zjhm: 证件号码

zjlx: 证件类型

gzwhjhff: 干燥无灰基挥发分（%）

hjje: 合计金额

hjse: 合计税额

hsslbs: 含税标识（1-不含税价，2-含税价）

hwysfwdzfpmxb_list: 货物运输明细（特定业务类型为货物运输时必填）

ddd: 到达地

qyd: 起始地

xh: 序号

ysgjhp: 运输工具号牌

ysgjzl: 运输工具种类

yshwmc: 运输货物名称

jazslx_dm: 减按征收类型代码（05-住房租赁）

jbrgjdm: 经办人国籍代码

jbrxm: 经办人姓名

jbrzjhm: 经办人证件号码

jbrzjzldm: 经办人证件种类代码

jbrzrrnsrsbh: 经办人纳税人识别号

jdctyxsxx: 机动车统一销售信息（特定业务类型为机动车统一销售发票时必填）

clsbdh: 车辆识别号/车架号码

cd: 产地

cldw: 吨位

cllx: 车辆类型

fdjhm: 发动机号码

hgzh: 合格证号

jkzmsh: 进口证明书号

sjdh: 商检单号

spmc: 厂牌型号

swjgdm: 主管税务机关代码

wspzhm: 完税证明号码

xcrs: 限乘人数

jshj: 价税合计

jzfwxx: 建筑服务信息（特定业务为建筑服务信息时必填）

jzfwfs: 建筑服务发生地

jzxmmc: 建筑项目名称

kdsbz: 跨地市标志（Y/N）

fsdxxdz: 发生地详细地址

tdzzsxmbh: 土地增值税项目编号

wcjyhdssglzmbh: 跨区域涉税事项报验管理编号（kdsbz 为 Y 时必填）

kdsbz_confirm: 建筑服务发生地与销售方注册地址不在同一县市提示（0-提示，1-忽略）

kjje_confirm: 大金额信息确认（0-忽略大金额提示）

lkysfwxx: 旅客运输服务发票信息

cfd: 出发地

cxr: 出行人

cxrq: 出行日期

cxrzjlx: 出行人证件类型

ddd: 到达地

dj: 等级

jtgjlx: 交通工具类型

sfzjhm: 出行人证件号码

mtfrl: 每千克煤炭发热量（千卡）

mtpzxx: 煤炭品质信息

sfkjsszyfwfppm: 是否开具涉税专业服务发票品目（Y/N）

sfzsgmfdzdh: 是否展示购买方地址电话（1-展示）

sfzsgmfyhzh: 是否展示购买方银行账号（1-展示）

sfzsxsfdzdh: 是否展示销售方地址电话（1-展示）

sfzsxsfyhzh: 是否展示销售方银行账号（1-展示）

skr: 收款人

sszyfwxm: 涉税专业服务项目

sszyfwxybh: 委托协议信息采集编号

tdyslxdm: 特定要素类型代码

tljlhsgjxx: 拖拉机和联合收割机信息（特定业务为拖拉机和联合收割机时必填）

dphgzbh: 底盘合格证编号

fdjbh: 发动机号码

sfyytljdj: 是否用于联合机登记

wjgs: 版式文件格式（OFD,PDF,XML,EWM，多个以逗号分隔）

xgm_xsyhzc: 放弃享受减按征收率原因（04/05）

xsf_dh: 销方电话

xsf_dz: 销方地址

xsf_nsrmc: 销方名称

xsf_yhmc: 销方开户银行

xsf_yhzh: 销方银行账号

zfxxes: 支付信息

jydh: 交易单号

zfqd_dm: 支付渠道

5.3.2 issue_agricultural_purchase_invoice_auto

功能说明：开具农产品收购发票。

必填参数：

nsrsbh

data.tdyslxdm: 固定为 "16"

其余参数同 issue_blue_invoice_auto

5.3.3 issue_scrap_purchase_invoice_auto

功能说明：开具报废产品收购发票。

必填参数：

nsrsbh

data.tdyslxdm: 固定为 "24"

其余参数同 issue_blue_invoice_auto

5.4 红字开票服务（/mcp/red_invoice）

5.4.1 apply_red_information_auto

功能说明：申请红字信息表。

必填参数：

aggOrgId: 企业id

nsrsbh: 税号

data

hcyydm: 红冲原因代码（01-开票有误，02-销货退回，03-服务中止，04-销售折让）

lz_kprq: 蓝字开票日期，yyyy-MM-dd HH:mm:ss

可选参数：

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型（本接口传入：hzqrxx_save）

request_async: 是否为异步方式（默认同步）

client_appkey / client_secret

data

bfhc: 部分红冲

bfhcbz: 部分红冲标志（0-全额红冲，1-部分红冲）

hcmx: 部分红冲明细

hcje: 本次红冲金额

lzmxxh: 蓝字发票明细项序号（从1开始）

hcse: 本次红冲税额

hcsl: 本次红冲数量

hsslbs: 计税方式（1-不含税价，2-含税价）

fplxdm: 发票类型代码（030-数电普票，032-数电专票，税控发票无需传值）

gmf_nsrsbh: 购买方识别号

hcjshj: 红冲价税合计

lrfsf: 录入方身份（0-销方发起，1-购方发起）

ly_ddbh: 来源订单编号

lz_fphm: 蓝字数电发票号码（数电发票必传）

wjgs: 红字发票版式文件格式（OFD,PDF,XML,EWM）

xsf_nsrsbh: 销售方识别号

zz_fpdm: 发票代码（增值税发票必传）

zz_fphm: 发票号码（增值税发票必传）

5.4.2 issue_red_invoice_auto

功能说明：开具红字发票。

必填参数：

nsrsbh: 税号

data

hzuuid: 红字信息UUID

xsfNsrsbh: 销方纳税人识别号

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型（本接口传入：hz_fpkj）

request_async: 是否为异步方式（默认同步）

client_appkey / client_secret

data

ly_ddbh: 来源订单编号

wjgs: 获取红字发票版式文件格式（OFD,PDF,XML,EWM，多个以逗号分隔）

5.4.3 query_red_information_list_auto

功能说明：查询红字信息列表。

必填参数：

nsrsbh: 税号

data

pageIndex: 当前页码

pageSize: 每页行数（10、20、50）

params

gxflx: 购销方类型（0-我是销方，1-我是购方）

kprqq: 开票起始日期（yyyy-MM-dd；起止日期必传且为三个月内）

kprqz: 开票结束日期（yyyy-MM-dd；起止日期必传且为三个月内）

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型，本接口传入：hzqrxx_list

request_async: 是否为异步方式（默认同步）

client_appkey / client_secret

data

cxmx: 是否查询明细（默认 false，true 时异步执行）

params

dfnsrmc: 对方纳税人名称

hzqrdbh: 红字确认单编号

hzqrzt_dm: 红字确认状态代码（00-全部，01-无需确认，02-销方录入待购方确认，03-购方录入待销方确认，04-购销双方已确认，05-作废(销方否认)，06-作废(购方否认)，07-作废(超72小时未确认)，08-发起方撤销，09-确认后撤销）

hzuuid: 红字uuid（红字uuid查询时，销方纳税人识别号为必传）

kpzt: 开票状态（Y-已开具，N-未开具，不传表示全部）

lrfsf: 录入方身份（0-销方申请，1-购方申请）

lz_fphm: 蓝字发票号码

xsf_nsrsbh: 销方纳税人识别号

zz_fpdm: 纸质发票代码

zz_fphm: 纸质发票号码

5.4.4 query_red_information_details_auto

功能说明：查询红字信息明细。

必填参数：

nsrsbh: 税号

data

hzuuid: 红字信息UUID

xsfNsrsbh: 销方纳税人识别号

可选参数：

aggOrgId: 企业id

accountId: 账号唯一标识，多账号下的账号唯一标识

action: 操作类型（本接口传入：hzqrxx_detail）

request_async: 是否为异步方式（默认同步）

client_appkey / client_secret

data

pdfDownload: 是否下载pdf文件（true:是，false:否）

wjgs: 获取红字发票版式文件格式（OFD,PDF,XML,EWM，多个以逗号分隔）

5.5 发票查验服务（/mcp/invoice_verification）

5.5.1 verify_invoice

功能说明：单票查验。

必填参数：

fpdm

fphm

je

kprq

5.5.2 batch_verify_invoices

功能说明：批量查验。

必填参数：

invoices: 发票列表（每条包含 fpdm、fphm、je、kprq）

5.5.3 validate_invoice_info

功能说明：发票参数校验。

必填参数：

fpdm

fphm

je

kprq

6. 常见问题

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

Q2：蓝票开具需要哪些最小字段？
A：nsrsbh、aggOragId、data.ly_ddbh、data.fplxdm、data.xsf_nsrsbh、data.gmf_lx、data.gmf_nsrmc、data.xmmx。

Q3：发票查验与已开发票查询的区别？
A：查验用于验证发票真伪与状态，已开发票查询用于查询企业已开具的发票数据。

发票开具服务

发票开具服务 MCP 文档#

文档信息#

目录#

1. 服务概述#

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

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

4. 快速开始#

4.1 蓝票开具（SSE）#

4.2 蓝票开具（HTTP Streamable）#

5. 接口说明#

5.1 已开发票查询服务（/mcp/invoice_inquiry）#

5.1.1 query_invoice_details_auto#

5.1.2 query_invoice_list_auto#

5.2 企业信息查询服务（/mcp/enterprise_basic_information）#

5.2.1 query_enterprise_basic_information_auto#

5.2.2 query_invoice_issuance_quota_auto#

5.3 蓝票开票服务（/mcp/blue_invoice）#

5.3.1 issue_blue_invoice_auto#

5.3.2 issue_agricultural_purchase_invoice_auto#

5.3.3 issue_scrap_purchase_invoice_auto#

5.4 红字开票服务（/mcp/red_invoice）#

5.4.1 apply_red_information_auto#

5.4.2 issue_red_invoice_auto#

5.4.3 query_red_information_list_auto#

5.4.4 query_red_information_details_auto#

5.5 发票查验服务（/mcp/invoice_verification）#

5.5.1 verify_invoice#

5.5.2 batch_verify_invoices#

5.5.3 validate_invoice_info#

6. 常见问题#

发票开具服务 MCP 文档

文档信息

目录

1. 服务概述

2. 服务路径与工具总览

3. 鉴权方式与安全说明

4. 快速开始

4.1 蓝票开具（SSE）

4.2 蓝票开具（HTTP Streamable）

5. 接口说明

5.1 已开发票查询服务（/mcp/invoice_inquiry）

5.1.1 query_invoice_details_auto

5.1.2 query_invoice_list_auto

5.2 企业信息查询服务（/mcp/enterprise_basic_information）

5.2.1 query_enterprise_basic_information_auto

5.2.2 query_invoice_issuance_quota_auto

5.3 蓝票开票服务（/mcp/blue_invoice）

5.3.1 issue_blue_invoice_auto

5.3.2 issue_agricultural_purchase_invoice_auto

5.3.3 issue_scrap_purchase_invoice_auto

5.4 红字开票服务（/mcp/red_invoice）

5.4.1 apply_red_information_auto

5.4.2 issue_red_invoice_auto

5.4.3 query_red_information_list_auto

5.4.4 query_red_information_details_auto

5.5 发票查验服务（/mcp/invoice_verification）

5.5.1 verify_invoice

5.5.2 batch_verify_invoices

5.5.3 validate_invoice_info

6. 常见问题