| 项目 | 说明 |
|---|---|
| 文档版本 | v1.1.0 |
| 最后更新 | 2025-12-05 |
| 文档状态 | 正式版 |
| 服务名称 | 发票开具服务 |
| 服务标识 | MCP-Server |
| 功能模块 | 挂载路径 (Mount Path) | 说明 | 新增特性 |
|---|---|---|---|
| 发票开具 | /mcp/blue_invoice | 支持蓝字发票开具(专票、普票),支持20+种特定业务类型 | 自动认证,令牌缓存 |
| 发票红冲 | /mcp/red_invoice | 红字信息表申请、红字发票开具、红字信息查询 | 自动认证,一键红冲流程 |
| 发票查询 | /mcp/invoice_inquiry | 已开发票明细查询,支持多种查询条件 | 自动认证,多条件组合查询 |
| 认证服务 | /mcp/face | 人脸识别认证(个税APP、税务APP) | 自动认证,双APP支持 |
| 发票查验 | /mcp/verification | 数电票、数电纸质票、税控票查验 | 批量查验,多票种支持 |
/mcp/blue_invoice)| 工具名称 | 功能说明 |
|---|---|
issue_blue_invoice_auto | 蓝字发票开具(专票/普票) |
issue_agricultural_purchase_invoice_auto | 农产品收购发票开具 |
issue_scrap_purchase_invoice_auto | 废旧物资收购发票开具 |
/mcp/invoice_inquiry)| 工具名称 | 功能说明 |
|---|---|
query_invoice_details_auto | 已开发票明细查询 |
/mcp/red_invoice)| 工具名称 | 功能说明 |
|---|---|
apply_red_information_auto | 申请红字信息表 |
issue_red_invoice_auto | 开具红字发票 |
query_red_information_list_auto | 查询红字信息列表 |
query_red_information_details_auto | 查询红字信息明细 |
/mcp/face)| 工具名称 | 功能说明 |
|---|---|
get_face_qr_code_auto | 获取税务APP人脸二维码 |
get_face_auth_result_auto | 查询税务APP认证结果 |
get_gs_face_qr_code_auto | 获取个税APP人脸二维码 |
get_gs_face_auth_result_auto | 查询个税APP认证结果 |
issue_blue_invoice_autonsrsbh: 纳税人识别号aggOrgId:企业IDdata.ly_ddbh: 来源订单编号data.fplxdm: 发票类型代码(030-数电普票,032-数电专票,87-数电纸质(机动车销售统一发票),83-数电票(机动车销售统一发票)data.xsf_nsrsbh: 销方税号data.gmf_lx: 购方类型(0-企业,1-个人)data.gmf_nsrmc: 购方名称data.xmmx.fphxz: 开票行性质0:正常行,1:折扣行,2:被折扣行data.xmmx.spbm:税收商品编码data.xmmx.spmc:税收商品名称data.xmmx.xmmc:项目名称data.xmmx.sl:税率data.xmmx.je:金额accountId: 多账号下的账号唯一标识 (string)async: 是否为异步方式(默认 false)(boolean)data.xsf_nsrmc: 销方名称 (string)data.xsf_dz: 销方地址 (string)data.xsf_dh: 销方电话 (string)data.xsf_yhmc: 销方开户银行 (string)data.xsf_yhzh: 销方银行账号 (string)data.gmf_lx: 购方类型(0-企业,1-个人)(string)data.gmf_dz: 购买方地址 (string)data.gmf_dh: 购买方电话 (string)data.gmf_yhmc: 购买方开户银行 (string)data.gmf_yhzh: 购买方银行账号 (string)data.hjje: 合计金额(不含税,建议传入以保证金额准确)(string)data.hjse: 合计税额 (string)data.jshj: 价税合计(含税,建议传入以保证金额准确)(string)data.bz: 备注 (string)data.fhr: 复核人 (string)data.skr: 收款人 (string)data.hsslbs: 含税标识(1:不含税, 2:含税,默认为含税价)(string)data.tdyslxdm: 特定要素类型代码,报废产品收购时为 "24" (string)data.wjgs: 生成的版式文件格式,多个用,隔开(如: OFD,PDF,XML)(string)data.fjxxList: 附加要素列表 (array)data.xmmx: 发票项目明细 (array)data.xmmx[].ggxh: 商品规格型号 (string)data.xmmx[].dw: 单位 (string)data.xmmx[].spsl: 商品数量 (string)data.xmmx[].dj: 单价 (string)data.xmmx[].se: 税额 (string)data.xmmx[].tdzsfsdm: 特定征税方式代码(01:不征税, 02:零税率, 03:差额征税, 04:免税, 05:简易征税, 06:减按征税)(string)data.xmmx[].ssyhzclx: 税收优惠政策类型 (string)jbrxm: 经办人姓名 (string)jbrzjhm: 经办人证件号码 (string)jbrgjdm: 经办人国籍代码 (string)jbrzrrnsrsbh: 经办人纳税人识别号 (string)jbrzjzldm: 经办人证件种类代码 (string)https://app.apifox.com/link/project/2393904/apis/api-100012782{
"code": "2000",
"success": true,
"data": {
"fphm": "2431***************",
"kprq": "2024-03-01 04:49:19",
"jshj": 1175.52,
"pdf_url": "https://example.com/invoice.pdf",
"ofd_url": "https://example.com/invoice.ofd"
}
}issue_agricultural_purchase_invoice_autonsrsbh: 纳税人识别号aggOrgId:企业IDdata.ly_ddbh: 来源订单编号data.fplxdm: 发票类型代码(030-数电普票,032-数电专票,87-数电纸质(机动车销售统一发票),83-数电票(机动车销售统一发票)data.xsf_nsrsbh: 销方税号data.gmf_lx: 购方类型(0-企业,1-个人)data.gmf_nsrmc: 购方名称data.xmmx.fphxz: 开票行性质0:正常行,1:折扣行,2:被折扣行data.xmmx.spbm:税收商品编码(设置农产品专属编码)data.xmmx.spmc:税收商品名称data.xmmx.xmmc:项目名称data.xmmx.sl:税率data.xmmx.je:金额data.tdyslxdm:"16":"农产品收购发票"{
"code": "2000",
"success": true,
"data": {
"fphm": "2431***************",
"kprq": "2024-03-01 04:49:19",
"jshj": 1175.52,
"pdf_url": "https://example.com/invoice.pdf",
"ofd_url": "https://example.com/invoice.ofd"
}
}issue_scrap_purchase_invoice_autonsrsbh: 纳税人识别号aggOrgId:企业IDdata.ly_ddbh: 来源订单编号data.fplxdm: 发票类型代码(030-数电普票,032-数电专票,87-数电纸质(机动车销售统一发票),83-数电票(机动车销售统一发票)data.xsf_nsrsbh: 销方税号data.gmf_lx: 购方类型(0-企业,1-个人)data.gmf_nsrmc: 购方名称data.xmmx.fphxz: 开票行性质0:正常行,1:折扣行,2:被折扣行data.xmmx.spbm:税收商品编码(设置农产品专属编码)data.xmmx.spmc:税收商品名称data.xmmx.xmmc:项目名称data.xmmx.sl:税率data.xmmx.je:金额data.tdyslxdm:"24":"报废产品收购"{
"code": "2000",
"success": true,
"data": {
"fphm": "2431***************",
"kprq": "2024-03-01 04:49:19",
"jshj": 1175.52,
"pdf_url": "https://example.com/invoice.pdf",
"ofd_url": "https://example.com/invoice.ofd"
}
}apply_red_information_autonsrsbh: 纳税人识别号aggOrgId: 企业iddata.lzKprq: 蓝字开票日期data.hcyydm: 红冲原因代码data.bfhc.hcmx.lzmxxh: 本次红冲数量-行号序号从1开始,除折扣行,依次为1,2,3...行data.bfhc.hcmx.hcje: 本次红冲金额accountId: 账号唯一标识async:是否为异步方式(默认同步)action: 操作类型-值:hzqrxx_savedata.lrfsf: 录入方身份data.gmfNsrsbh: 购买方识别号data.xsfNsrsbh: 销售方识别号data.lzFphm: 蓝字数电发票号码-数电发票必传data.zz_fpdm: 发票代码-增值税发票必传data.fplxdm: 发票类型代码data.wjgs: 红字发票版式文件,如果已经开具成功的可以返回版式文件-(OFD,PDF,XML,EWM)多个以,隔开data.hcjshj: 红冲价税合计data.bfhc.bfhcbz: 部分红冲标志data.bfhc.hsslbs: 计税方式data.bfhc.hcmx.hcsl: 本次红冲数量data.bfhc.hcmx.hcse: 本次红冲税额{
"code": "710021",
"data": {
"total": 1,
"pageNumber": 1,
"pageSize": 10,
"list": [
{
"hcsj": "2024-07-31 14:52:20", //红冲时间对应红字发票开具时间
"sylzfpje": "-9.90",
"ljhcje": "-9.90",
"hcje": "-9.90",
"jxzcje": "-9.90",
"hcyy": "01",
"jxsezcjeye": "0",
"hzfphm": "243***************75",//红字发票号码
"lzfphm": "243***************93"//蓝字发票号码
}
]
},
"success": true,
"message": "业务提示:蓝票没有可红冲的金额,不可再次红冲!",
"reqId": "88224fe36592447e98122609a4a8b1e2"
}issue_red_invoice_autonsrsbh: 纳税人识别号aggOrgId: 企业iddata.hzuuid: 红字信息UUIDdata.xsfNsrsbh: 销方纳税人识别号accountId: 账号唯一标识async:是否为异步方式(默认同步)action: 操作类型-值:hz_fpkjdata.wjgs: 获取红字发票的版式文件格式-(OFD,PDF,XML,EWM)多个以,隔开hzuuid(红字信息UUID),用于后续开具红字发票。query_red_information_list_autoaggOrgId: 企业idnsrsbh: 税号data.pageIndex: 当前页码data.pageSize: 每页行数(10、20、50)data.params.gxflx: 购销方类型(0:我是销方,1:我是购方)data.params.kprqq: 开票起始日期(yyyy-MM-dd;红字申请表申请日期;起止日期必传且为三个月内)data.params.kprqz: 开票结束日期(yyyy-MM-dd;红字申请表申请日期;起止日期必传且为三个月内)accountId: 账号唯一标识(多账号下的账号唯一标识)async: 是否为异步方式(默认同步)(默认值: false)action: 操作类型(本接口传入:hzqrxx_list)data.params.xsfNsrsbh: 销方纳税人识别号data.params.dfnsrmc: 对方纳税人名称data.params.lrfsf: 录入方身份(0: 销方申请,1:购方申请)data.params.hzuuid: 红字uuid(红字uuid查询时,销方纳税人识别号为必传)data.params.hzqrdbh: 红字确认单编号data.params.hzqrztDm: 红字确认状态代码(00或不传:全部,01:无需确认(全电大多数情况是自动01) 02:销方录入待购方确认 03:购方录入待销方确认 04:购销双方已确认 05:作废(销方录入购方否认) 06:作废(购方录入销方否认) 07:作废(超 72 小时未确认) 08:发起方撤销 09:确认后撤销)data.params.lzFphm: 蓝字发票号码data.params.zzFpdm: 纸质发票代码data.params.zzFphm: 纸质发票号码{
"reqId": "34894b49f4ff47af95507cba2b66ef26",
"code": "2000",
"success": true,
"message": null,
"data": {
"pageIndex": 1,
"records": 28,
"pageSize": 10,
"list": [
{
"bz": "",
"gmfNsrmc": "**********术有限公司",
"gmfNsrsbh": "************BDRR90",
"gxflx": "销售方",
"hcyydm": "01",
"hzFpdm": null,
"hzFphm": "************33969191",
"hzHjje": -1.13,
"hzHjse": -0.07,
"hzKprq": "2024-01-31 15:09:52",
"hzkjBz": "Y",
"hzqrdbh": "31022924011005502771",
"hzqrztDm": "01",
"hzuuid": "1f4f398d3adf45d88e11c0223d26e97e",
"kpr": "**飞",
"lrfsf": "0",
"lzFpdm": null,
"lzFphm": "************23057583",
"lzFplxdm": "030",
"lzHjje": 1.13,
"lzHjse": 0.07,
"lzKprq": "2024-01-22 19:56:27",
"lzTdyslxDm": null,
"qrjkp": "Y",
"qrrq": null,
"rzzt": "00",
"xfsYtZt": "00",
"xsfNsrmc": "********信息有限公司",
"xsfNsrsbh": "************PDDL2G",
"ydkse": null,
"yjjdkncpse": null,
"zzsYtzt": "03"
},
{
"bz": "",
"gmfNsrmc": "**********术有限公司",
"gmfNsrsbh": "************BDRR90",
"gxflx": "销售方",
"hcyydm": "01",
"hzFpdm": null,
"hzFphm": "************33966549",
"hzHjje": -0.94,
"hzHjse": -0.06,
"hzKprq": "2024-01-31 15:08:47",
"hzkjBz": "Y",
"hzqrdbh": "31022924011005002990",
"hzqrztDm": "01",
"hzuuid": "b727bbd0861f4ad6b150486066120239",
"kpr": "**飞",
"lrfsf": "0",
"lzFpdm": null,
"lzFphm": "************14298110",
"lzFplxdm": "030",
"lzHjje": 0.94,
"lzHjse": 0.06,
"lzKprq": "2024-01-15 11:45:37",
"lzTdyslxDm": null,
"qrjkp": "Y",
"qrrq": null,
"rzzt": "00",
"xfsYtZt": "00",
"xsfNsrmc": "********信息有限公司",
"xsfNsrsbh": "************PDDL2G",
"ydkse": null,
"yjjdkncpse": null,
"zzsYtzt": "03"
}
]
}
}query_red_information_details_autoaggOrgId: 企业idnsrsbh: 税号data.hzuuid: 红字信息UUIDdata.xsfNsrsbh: 销方纳税人识别号accountId: 账号唯一标识(多账号下的账号唯一标识)async: 是否为异步方式(默认同步)(默认值: false)action: 操作类型(本接口传入:hzqrxx_detail)data.pdfDownload: 是否下载pdf文件(true:是,false:否)data.wjgs: 获取红字发票版式文件格式(OFD,PDF,XML,EWM,多个以,隔开){
"reqId": "4dc1834846cf45ae9658eb01bfd60ae5",
"code": "2000",
"success": true,
"message": null,
"data": {
"lzTdyslxDm": "04",
"gxflx": "销售方",
"hzKprq": "2024-09-23 15:05:11",
"hcyydm": "01",
"hzkjBz": "Y",
"lzFplxdm": "030",
"ydkse": 0,
"sfzzfpbz": "N",
"zzsYtzt": "03",
"lzHjje": 0.1,
"hzFphm": "2451*****************000",
"xsfNsrmc": "成都****************中心",
"hzqrztDm": "01",
"lrfsf": "0",
"hzHjse": 0,
"bz": "",
"xmmx": [
{
"xh": 1,
"se": 0,
"spsl": "",
"xmmc": "其他货物运输服务",
"spmc": "运输服务",
"sl": "0.0",
"xmmc2": "*运输服务*其他货物运输服务",
"je": -0.1,
"spbm": "3019902000000000000",
"uuid": "3e4af607abe24cbfb613d8b1f4add026",
"lzMxxh": 1
}
],
"lzFphm": "24**************38",
"xfsYtZt": "00",
"qrjkp": "Y",
"gmfNsrsbh": "91***************38",
"lzHjse": 0,
"yjjdkncpse": 0,
"hzuuid": "0cc*******************529",
"gmfNsrmc": "***************有限公司",
"kpr": "罗灿",
"xsfNsrsbh": "9***************9R",
"lzfppzDm": "02",
"hzqrdbh": "51***************96",
"lzKprq": "2024-09-23 14:16:10",
"lrrq": "2024-09-23 15:05:11",
"rzzt": "00",
"hzHjje": -0.1
}
}query_invoice_details_autoaggOrgId: 企业idnsrsbh: 税号data.kprq: 开票日期data.fphm: 发票号码accountId: 账号唯一标识async: 是否为异步方式(默认同步)action: 操作类型:本接口传入:fpmxdata.ly_ddbh: 来源单编号data.zz_fphm: 纸质发票号码data.zz_fpdm: 纸质发票代码dataScope: 获取的数据范围字段(0 或者空默认值 只获取发票预览的数据 1 获取勾选状态 2.获取入账状态 3 获取入账,勾选,预览数据){
"reqId": "5459b5980b004b4ba08091be6e9de2b2",
"code": "2000",
"success": true,
"message": null,
"data": {
"kplx": "1",
"xsf_dz": "******************弄1-72号B座12层",
"gmf_dz": "**************906号001",
"xsf_yhzh": "**********10301",
"kce": 0,
"hjje": -0.94,
"gmf_dh": "********7376",
"xsf_nsrsbh": "************PDDL2G",
"jshj_chn": "(负数)壹圆整",
"kprq": "2024-02-29 00:00:00",
"bz": "******************************************号:************02704133",
"xmmx": [
{
"ggxh": null,
"spsl": null,
"yhzcbs": "N",
"dj": null,
"spmc": "研发和技术服务",
"yhzclxDm": null,
"xmmc2": "*研发和技术服务*技术服务费",
"kce": 0,
"xsyhzcbz": null,
"lzMxxh": 1,
"xh": 1,
"fphxz": "0",
"se": -0.06,
"dw": null,
"xmmc": "技术服务费",
"sl": "0.06",
"je": -0.94,
"spbm": "3040105000000000000"
}
],
"gmf_nsrmc": "**********术有限公司",
"zz_fpdm": null,
"xsf_yhmc": "**********上海青浦支行",
"kpf_nsrsbh": "************PDDL2G",
"hjse": -0.06,
"gmf_yhmc": "**************首体科技金融支行",
"kpr": "**飞",
"xsf_dh": "******98617",
"fplxdm": "030",
"xsf_nsrmc": "********信息有限公司",
"ewm": "01,32, ,************54513944,-1,20240229, ,F3F7",
"jshj": -1,
"zz_fphm": null,
"gmf_nsrsbh": "************BDRR90",
"gmf_yhzh": "**********10702",
"fphm": "************54513944",
"lzFphm": "************54513666",
"lzKprq": "2024-02-29 00:00:00"
}
}get_face_qr_code_autonsrsbh: 纳税人识别号aggOrgId: 企业idaccountId: 账号唯一标识async: 是否为异步方式(默认同步)action: 操作类型-本接口传:gsrzewm{
"code": "2000",
"success": true,
"data": {
"nsrssbh": "913*************",
"ewm": "二维码内容或图片base64",
"rzid": "79e63da3*******************",
"kpr": "开票人"
}
}get_face_auth_result_autonsrsbh: 纳税人识别号data.rzid: 认证ID(由二维码接口返回)aggOrgId: 企业idaccountId:账号唯一标识async: 是否为异步方式(默认同步)action: 操作类型-本接口传:rzztcx{
"code": "2000",
"success": true,
"data": {
"nsrsbh": "913*************",
"slzt": "2",
"source": "TAX_APP"
}
}slzt 为受理状态,取值含义为 1=未扫脸、2=扫脸成功、3=二维码已过期。get_gs_face_qr_code_autonsrsbh: 纳税人识别号aggOrgId: 企业idaccountId: 账号唯一标识async: 是否为异步方式(默认同步)action: 操作类型-本接口传:gsrzewm{
"code": "2000",
"success": true,
"data": {
"nsrssbh": "9131*********************",
"ewm": "二维码图片base64",
"rzid": "79e63da30**************************",
"kpr": "开票人"
}
}get_gs_face_auth_result_autonsrsbh: 纳税人识别号data.rzid: 认证ID(由二维码接口返回)aggOrgId: 企业idaccountId:账号唯一标识async: 是否为异步方式(默认同步)action: 操作类型-本接口传:rzztcx{
"code": "2000",
"success": true,
"data": {
"nsrsbh": "9131*********************",
"slzt": "1",
"source": "GS_APP"
}
}slzt 为受理状态,取值含义为 1=未扫脸、2=扫脸成功、3=二维码已过期。