- 基本介绍
- 快速开始
- 接口调用鉴权
- 公共参数
- 登录
- 发票查验
- 发票同步
- 发票开具
- 人脸认证
- 基础信息
- 字典数据
- 开票信息维护
- 红字发票开具
- 蓝字发票开具
全国增值税查验平台查验
POST
openapi.nmy.cn/api/v1/open/national-invoice-check
接口描述#
参数组合#
1.
bhsje 字段2.
jym 字段3.
bhsje 字段4.
jshj 字段5.
jshj 字段⚠️ 注意：该接口仅支持单张查验。不同发票类型所需校验项目不同，请按对应票种选择参数组合。
请求参数
Header 参数
Body 参数application/json必填
示例
{
"fpdm": "0***********",
"fphm": "12345678",
"jym": "校验码，非空时应为6位数字",
"jshj": 1130,
"bhsje": 1000,
"kprq": "2024-01-01",
"bswjlx": [
"A"
]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'openapi.nmy.cn/api/v1/open/national-invoice-check' \
--header 'Authorization: {{authorization}}' \
--header 'Content-Type: application/json' \
--data '{
"fpdm": "0***********",
"fphm": "12345678",
"jym": "校验码，非空时应为6位数字",
"jshj": 1130,
"bhsje": 1000,
"kprq": "2024-01-01",
"bswjlx": [
"A"
]
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"code": 0,
"message": "success",
"traceId": "xxxx-xxxx-xxxx-xxxx",
"data": {
"cycs": "查验次数",
"cyjgMsg": "查验结果消息",
"cysj1": "2024-12-31",
"fplxDm": "A",
"fplyDm": "10001",
"fppzDm": "10001",
"fpztDm": 1,
"fppmxx": {
"bz": "备注信息",
"ewm": "二维码信息",
"fhr": "复核人",
"fphm": "12345678",
"fpkjfsdm": "10001",
"fppzdm": "10001",
"gmfdzdh": "13800138000",
"gmfkhhjzh": "购买方开户银行及账号",
"gmfmc": "示例名称",
"gmfnsrsbh": "91440300MA5EXAMPLE",
"hjje": 1000,
"hjse": 130,
"jshj": 1130,
"jshjdx": "价税合计大写",
"kjlx": "A",
"kpfnsrsbh": "91440300MA5EXAMPLE",
"kpr": "开票人",
"kprq": "2024-01-01",
"lrrq": "2024-12-31",
"sflzfpbz": "Y",
"sfwzzfp": "是否为纸质发票",
"tdyslxdm": "A",
"xsfdsjswjgdm": "10001",
"xsfdzdh": "13800138000",
"xsfkhhjzh": "销售方开户银行及账号",
"xsfmc": "示例名称",
"xsfnsrsbh": "91440300MA5EXAMPLE",
"xsfssjswjgdm": "10001",
"xsfzgswjdm": "10001",
"xsfzgswskfjdm": "10001",
"hkysdzkpxcdInfo": {
"bxf": "保险费",
"fphm": "12345678",
"gngjbz": "Y",
"hj": "合计",
"kpzt": 1,
"lkxm": "旅客姓名",
"mhfzjj": "民航发展基金",
"pj": "票价",
"ryfjf": "燃油附加费",
"sfzjhm": "身份证件号码",
"xcdqz": "行程单签注",
"xcdtkdw": "行程单填开单位",
"xcdtkrq": "2024-12-31",
"xswddh": "销售网点代号",
"yzm": "验证码",
"zzsse": 130,
"zzssl": "0.13",
"hkysdzkpxcdMxList": [
{
"hdxh": 1,
"cyr": "承运人",
"cyrq": "2024-12-31",
"hbh": "航班号",
"mdz": "目的站",
"mfxle": "免费行李额",
"qfsj": "2024-12-31",
"sfz": "始发站",
"yxjzrq": "2024-12-31",
"zwdj": "座位等级"
}
]
},
"jzfwTdysInfo": {
"kdsbz": "Y",
"xsfDsjswjgDm": "10001",
"xsfSsjswjgDm": "10001",
"xsfZgswjDm": "10001",
"tdzzsxmbh": "土地增值税项目编号"
},
"tldzkpInfo": {
"yppj": 1,
"cccc": "出乘车次",
"cfsj1": "2024-12-31",
"cfz": "出发站",
"cfzpy": "出发站拼音",
"cx": "车厢",
"ddz": "到达站",
"ddzpy": "到达站拼音",
"dzkph": "24442000000012345678",
"fphm": "12345678",
"kprq": "2024-01-01",
"rq": "2024-12-31",
"tsxxq": "特殊信息区",
"xb1": "席别",
"xm": "姓名",
"xw": "席位",
"ytje": 1000,
"ywlxmcsht": "A",
"zjhm": "证件号码"
},
"bdcTdysfpList": [
{
"xh": "序号",
"bdcdz": "广东省深圳市南山区科技园",
"bdczldz": "广东省深圳市南山区科技园",
"cqzsbh": "产权证书编号",
"cqzsh": "产权证书号",
"fppzDm": "10001",
"kdsbz": "Y",
"kprq": "2024-01-01",
"sflzfp": "是否蓝字发票",
"tdyslxDm": "A",
"zlqq": "租赁起期",
"zlqqz": "2024-12-31",
"zlqz": "租赁止期"
}
],
"escxsTdysList": [
{
"cjhjxx": 1,
"cjhjdx": "车价合计（大写）",
"cllxDm": "A",
"clsbdh": "车辆识别代号",
"cphm": "车牌号码",
"cpxh": "厂牌型号",
"djzh": "登记证号",
"escscdh": "13800138000",
"escscdz": "广东省深圳市南山区科技园",
"escsckhyh": "二手车市场开户银行",
"escscnsrmc": "示例名称",
"escscnsrsbh": "91440300MA5EXAMPLE",
"escscyhzh": "二手车市场银行账号",
"hwhyslwfwmc": "示例名称",
"spfwjc": "商品服务简称",
"sphfwssflhbbm": "10001",
"xmmc": "示例名称",
"zrdclglsmc": "示例名称",
"escsckhyhzh": "二手车市场开户银行账号",
"jydwnsrmc": "示例名称",
"jydwdz": "广东省深圳市南山区科技园",
"jydwnsrsbh": "91440300MA5EXAMPLE",
"jydwkhyhzh": "经营单位开户银行和账号",
"jydwdh": "13800138000"
}
],
"hwysfwdzfpmxbList": [
{
"xh": 1,
"ddd": "到达地",
"qyd": "起运地",
"ysgjph": "运输工具牌号",
"ysgjzl": "运输工具种类",
"yshwmc": "示例名称"
}
],
"jdcxsTdysList": [
{
"bhsj": 1,
"cjfy": 1,
"jdcxstyfpjg": 1,
"jshj": 1130,
"se": 130,
"slv": "0.13",
"zzsse": 130,
"cd": "产地",
"cllxDm": "A",
"clsbdh": "车辆识别代号",
"cpxh": "产品型号",
"dh": "13800138000",
"dz": "广东省深圳市南山区科技园",
"fdjhm": "发动机号码",
"gmfzjhm": "购买方证件号码",
"hgzh": "合格证号",
"hwhyslwfwmc": "示例名称",
"khyh": "开户银行",
"nsrsbh": "91******************",
"scqymc": "示例名称",
"spfwjc": "商品服务简称",
"sphfwssflhbbm": "10001",
"xcrs": "限乘人数",
"xhdwmc": "示例名称",
"xmmc": "示例名称",
"xsyhzcbz": "Y",
"zgswjgDm": "10001",
"zgswjgmc": "示例名称",
"zh": "账号"
}
],
"jzfwfpmxList": [
{
"xh": 1,
"je": 1000,
"se": 130,
"sl1": "0.13",
"jzfwfsd": "建筑服务发生地",
"jzxmmc": "示例名称",
"xmmc": "示例名称",
"xzqhszDm": "10001"
}
],
"lkysfwTdysList": [
{
"xh": "序号",
"cfd": "出发地",
"chuxrq": "2024-12-31",
"cxr": "出行人",
"cxrzjlxDm": "A",
"ddd": "到达地",
"dengj": "等级",
"jtgjlx": "A",
"sfzjhm": "身份证件号码"
}
],
"mxzbList": [
{
"xh": 1,
"je": 1000,
"jzjtcsfl": 1,
"kce": 1,
"se": 130,
"dj": "单价",
"dw": "单位",
"fphm": "12345678",
"fphxzDm": "10001",
"ggxh": "规格型号",
"hwhyslwfwmc": "示例名称",
"slv": "0.13",
"spfwjc": "商品服务简称",
"sphfwssflhbbm": "10001",
"spsl": "99",
"ssyhzclxDm": "A",
"tdyslxDm": "A",
"tdzsfsDm": "0.13",
"xmmc": "示例名称",
"xsyhzcbz": "Y"
}
],
"txfList": [
{
"mxxh": "明细序号",
"cllxDm": "A",
"cphm": "车牌号码",
"dataCategory": "数据类别",
"dj": "单价",
"fpbbDm": "10001",
"gfSjswjgDm": "10001",
"ggxh": "规格型号",
"je": 1000,
"jldw": "计量单位",
"jssj": "2024-12-31",
"kprq": "2024-01-01",
"kpyf": 202412,
"mc": "示例名称",
"rksj": "2024-12-31",
"se": 130,
"sl": "99",
"slv": "0.13",
"spbm": "101****************",
"tslsh": "通行流水号",
"txrqq": "2024-12-31",
"txrqz": "2024-12-31",
"xfSjswjgDm": "10001",
"xmmc": "示例名称",
"ydfpbz": "Y",
"yhzcbs": "优惠政策标识"
}
],
"skr": "收款人",
"kce": 1,
"sfzsgmfdzdh": "13800138000",
"sfzsgmfyhzh": "是否展示购买方银行账号",
"sfzsxsfdzdh": "13800138000",
"sfzsxsfyhzh": "是否展示销售方银行账号",
"fjysList": [
{
"fjysmc": "示例名称",
"fjysz": "附加要素值"
}
],
"kjhzfpdydlzfpbz": "备注信息"
},
"ossUrl": {
"ofdUrl": "https://example.com",
"pdfUrl": "https://example.com",
"xmlUrl": "https://example.com"
}
}
}🟠400
🟠401
🔴500
修改于 2026-09-29 07:58:32