1. 接口信息
1.1. 调用地址
https://fapiao.glority.cn/v1/item/fapiao_validation
1.2. 请求方式
GET/POST
1.3. 返回类型
JSON
2. 请求参数
公共请求参数
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
Key |
app_key |
true |
String(32) |
c5ed72329fece2fe0010a437505b01cb |
分配的key |
令牌 |
token |
true |
String(32) |
7007bd1257dce8d47489166a7c77a926 |
授权令牌 |
时间戳 |
timestamp |
true |
String(32) |
1522374165 |
timestamp 为January 1 1970 00:00:00 GMT 到现在的秒数 |
增值税专用发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
电子票标识 |
electronic_mark |
false |
int |
0或者1 |
是否增值税电子专用发票: 0: 否(默认值) 1: 是 |
金额 |
pretax_amount |
true |
String |
2648.54 |
税前金额 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10100 |
发票类型 必填 |
增值税普通发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
校验码后6位 |
check_code |
true |
String |
871589 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10101 |
发票类型 必填 |
增值税普通发票(卷票)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
校验码后6位 |
check_code |
true |
String |
871589 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10103 |
发票类型 必填 |
增值税电子普通发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
校验码后6位 |
check_code |
true |
String |
871589 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10102 |
发票类型 必填 |
增值税电子普通发票(区块链)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10102 |
发票类型 必填 |
区块链标识 |
block_chain |
true |
int |
1 |
1: 是 |
纳税人识别号 |
seller_tax_id |
false |
String |
91440300MA5DMG1WXL |
销售方纳税人识别号 |
地区 |
area |
true |
String |
GUANG_DONG |
地区 SHEN_ZHEN, BEI_JING, YUN_NAN |
校验码后6位 |
check_code |
false |
String |
871589 |
必填 |
机动车销售统一发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
金额 |
pretax_amount |
true |
String |
2648.54 |
税前金额 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10104 |
发票类型 必填 |
二手车销售统一发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
金额 |
pretax_amount |
true |
String |
2648.54 |
总价金额 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10105 |
发票类型 必填 |
数电票(增值税专用发票)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
金额 |
total |
true |
String |
2648.54 |
金额 价税合计 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10107 |
发票类型 必填 |
数电票(普通发票)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
金额 |
total |
true |
String |
2648.54 |
金额 价税合计 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10108 |
发票类型 必填 |
数电票(火车票)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
金额 |
total |
true |
String |
2648.54 |
金额 价税合计 必填 |
开票日期 |
date_of_issue |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10503 |
发票类型 必填 |
数电票(航空运输电子客票行程单)
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
receipt_number |
true |
String |
15064112 |
必填 |
金额 |
total |
true |
String |
2648.54 |
金额 价税合计 必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10506 |
发票类型 必填 |
机打发票
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
10400 |
发票类型 必填 |
价税合计 |
total |
true |
String |
656 |
必填 |
纳税人识别号 |
seller_tax_id |
true |
String |
91440300MA5DMG1WXL |
必填 |
地区 |
area |
true |
String |
GUANG_DONG |
地区 GUANG_DONG, ZHE_JIANG 必填 |
非税收入类票据
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
发票号码 |
number |
true |
String |
15064112 |
必填 |
发票代码 |
code |
true |
String |
6300161320 |
必填 |
开票日期 |
date |
true |
String |
2017年03月28日 |
格式为: 年/月/日 必填 |
发票类型 |
type |
true |
String |
102015 |
发票类型 必填 |
金额 |
pretax_amount |
true |
String |
2648.54 |
总价金额 必填 |
校验码 |
check_code |
true |
String |
871589 |
必填 |
2.1. 请求说明
- 支持的图片类型: jpg, jpeg, png及pdf. 图片最大支持8M.
- token 的值计算方式为:
md5($appkey+$timestamp+$appSecret)
token=md5("c5ed72329fece2fe0010a437505b01cb+1522374165+5c9597f3c8245907ea71a89d9d39d08e")=7007bd1257dce8d47489166a7c77a926
- API请求示例:
https://fapiao.glority.cn/v1/item/fapiao_validation?app_key=c5ed72329fece2fe0010a437505b01cb×tamp=1522374165&token=7007bd1257dce8d47489166a7c77a926&code=6300161320&number=15064112&check_code=871589&date=2017年03月28日
- 生成token时,字符串连接中的“+”是必需的,缺少这个符号会无法验证通过验证
3. 返回值
3.1. 正确返回参数
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
返回状态码 |
result |
true |
int |
0或1 |
请求状态. 1:成功, 0:失败 |
回复 |
response |
true |
json |
|
|
3.2. 正确返回样例
{
'result': 1,
'response': {
'data': {
'version': '4.8_20180226',
'result': 1,
'timestamp': 1092098766,
'message': 'success',
'id': 'a744aa6929b97355430ab6b5ee831854',//结果标识id
'time_cost': '1000',//验真花费的时长,单位毫秒
'identify_results': [
{
'validation': { -- 发票查验结果
'code': 10000, -- 发票验真结果代码
'message': 'success' -- 发票查验结果详细信息
},
'details': { // 发票具体信息,验真结果为真票是返回,否则不返回
//增值税
'code': '3300174320', -- 发票代码
'number': '10400215', -- 发票号码
'date': '2017年03月28日', -- 开票日期
'pretax_amount': '6406.80', -- 税前金额
'tax': '192.20' -- 税额
'total': '6599.00', -- 总金额
'check_code': '52657910788452871589' -- 校验码
'seller': 'XXXXXX有限公司', -- 销售方名称
'proxy_seller':'' -- 销售方名称(代开)
'seller_tax_id': '15260000000000000G', -- 销售方纳税人识别号
'proxy_seller_tax_id':'' -- 销售方纳税人识别号(代开)
'seller_addr_tel': '杭州市XXXXXX0571-xxxxxxxx', -- 销售方地址电话
'seller_bank_account': '工商银行城站支行1202027709900075360', -- 销售方开户行及帐号
'buyer': 'XXXXXX有限公司', -- 购买方方名称
'buyer_tax_id': '11684616000000000D', -- 购买方纳税人识别号
'buyer_addr_tel': '杭州市XXXXXX0571-xxxxxxxx', -- 购买方地址电话
'buyer_bank_account': '工商银行城站支行1202028888900075360', -- 购买方开户行及帐号
'remark': '备注', -- 备注
'machine_code': '499924850051', -- 机器编号
'invalid_mark': '0', -- 作废标志: 0-正常,1-已作废,3红冲
'oil_mark': '0', -- 成品油标志
'receiptor': 'XXX', -- 收款人
'transit_mark':'0' -- 通行费标志 0-非通行费 1-是通行费
'items':[{ -- 明细信息
'name':'*旅游服务*旅游费', -- 货物或应税劳务、服务名称
'specification':'', -- 规格型号
'unit':'', -- 单位
'quantity':'1', -- 数量
'price':'', -- 单价
'total':'6406.80', -- 金额
'tax_rate':'3' -- 税率
'tax':'192.20' -- 税额
'license_plate':'浙A668' -- 车牌号
'vehicle_type':'客车' -- 车辆类型
'start_date':'20210521' ---通行日期起
'end_date':'20200702' --通行日期止
},
{....}
],
//全电票
'code': '', -- 发票代码
'number': '10400215', -- 发票号码
'date': '2017年03月28日', -- 开票日期
'pretax_amount': '6406.80', -- 税前金额
'tax': '192.20' -- 税额
'total': '6599.00', -- 总金额
'check_code': '' -- 校验码
'seller': 'XXXXXX有限公司', -- 销售方名称
'seller_tax_id': '15260000000000000G', -- 销售方纳税人识别号
'seller_addr_tel': '杭州市XXXXXX0571-xxxxxxxx', -- 销售方地址电话
'seller_bank_account': '工商银行城站支行1202027709900075360', -- 销售方开户行及帐号
'buyer': 'XXXXXX有限公司', -- 购买方方名称
'buyer_tax_id': '11684616000000000D', -- 购买方纳税人识别号
'buyer_addr_tel': '杭州市XXXXXX0571-xxxxxxxx', -- 购买方地址电话
'buyer_bank_account': '工商银行城站支行1202028888900075360', -- 购买方开户行及帐号
'remark': '备注', -- 备注
'machine_code': '499924850051', -- 机器编号
'invalid_mark': '0', -- 作废标志: 0-正常,1-已作废,3红冲, 7-部分红冲,8-全额红冲,80-红字发票待确认
'items':[{ -- 明细信息
'name':'*旅游服务*旅游费', -- 货物或应税劳务、服务名称
'specification':'', -- 规格型号
'unit':'', -- 单位
'quantity':'1', -- 数量
'price':'', -- 单价
'total':'6406.80', -- 金额
'tax_rate':'3' -- 税率
'tax':'192.20' -- 税额
},
{....}
],
//二手车销售统一发票
'code': '6300161320', -- 发票代码
'number': '15064112', -- 发票号码
'date': '2017年03月28日', -- 开票日期
'total': '100000.00', -- 总金额
'seller': 'XXXXXX有限公司', -- 卖方单位/个人
'seller_id': '330517489552522146', -- 卖方单位代码/个人身份证号
'seller_address': '', -- 卖方单位/个人住址
'seller_tel': '', -- 卖方电话
'buyer': 'XXXXXX有限公司', -- 买方单位/个人
'buyer_id': '350822221211525564', -- 买方单位代码/个人身份证号
'buyer_address': '', -- 买方单位/个人住址
'buyer_tel': '', -- 买方电话
'company_name': 'xxx二手车交易管理有限公司', -- 二手车市场
'company_tax_id': '15260000000000000G', -- 二手车市场纳税人识别号
'company_address': '', -- 二手车市场地址
'company_bank_account': '', -- 二手车市场开户银行账号
'company_tel': '', -- 二手车市场电话
'license_plate': '浙A88888', -- 车牌号
'registration_number': '320027731473', -- 登记证号
'car_code': 'LVSHKAML8FG461612', -- 车架号/车辆识别代码
'car_model': '丰田牌CAF7150N4', -- 厂牌型号
'machine_code': '499924850051', -- 机器编号
'invalid_mark': '0', -- 作废标志
'remark': '备注', -- 备注
'transfer_vehicle_office': '杭州市', -- 转入地车辆管理所名称
'auction_name': '', -- 经营、拍卖单位
'auction_address': '', -- 经营、拍卖单位地址
'auction_tax_id': '', -- 经营、拍卖单位纳税人识别号
'auction_bank_account': '', -- 经营、拍卖单位开户银行账号
'auction_tel': '', -- 经营、拍卖单位电话
//机动车销售统一发票
'code': '6300161320', -- 发票代码
'number': '15064112', -- 发票号码
'machine_code': '123001221606', -- 机打代码
'date': '2017年03月28日', -- 开票日期
'pretax_amount': '930000.00', -- 税前金额
'tax': '70000', -- 税额
'tax_rate': '7%', -- 税率
'total': '1000000.00', -- 总金额
'seller': 'XXXXXX有限公司', -- 销售单位
'seller_tax_id': '330517489552522146', -- 销售单位纳税人识别号
'buyer': 'XXXXXX有限公司', -- 买方单位/个人
'buyer_id': '350822221211525564', -- 买方单位代码/个人身份证号
'buyer_tax_id': '350822221211525564', -- 买方单位代码/个人纳税人识别号
'tax_authorities': 'xxx市国家税务局xx分局', -- 主管税务机关
'tax_authorities_code': '144030613', -- 主管税务机关代码
'tax_certificate_number': '', -- 完税凭证号码
'car_code': 'LVSHKAML8FG461612', -- 车架号/车辆识别代码
'car_engine_code': 'Q035277', -- 发动机号码
'car_model': '丰田牌CAF7150N4', -- 厂牌型号
'certificate_number': 'YE80X1001351257', -- 合格证号
'invalid_mark': '0', -- 作废标志
'car_type': '多用途货车', -- 车辆类型
'original_place': '河南省中牟县', -- 产地
'bill_number': '', -- 商检单号
'import_certificate_number': '', -- 进口证明书号
'tel': '025-52350620', -- 电话
'address': '苏省南京市安德门大街32号', -- 地址
'bank': '南京银行城西支行', -- 开户银行
'account': '01310120210012269', -- 账号
'tonnage': '0.636', -- 吨位
'limit_passengers_count': '2+3', -- 限乘人数
//区块链
"code": "1440****9110", -- 发票代码
"number": "222***850", -- 发票号码
"date": "2020-11-25 00:00:00", -- 开票日期
"total": "565.0", -- 价税合计
"check_code": "67029", -- 校验码
"seller": "深圳市*******店", -- 销售方名称
"seller_tax_id": "9144***MG1WXL", -- 销售方纳税人识别号
"buyer": "深圳市*******限公司", -- 购买方名称
"abnormal_status": "0", -- 异常状态 1-异常发票 0-正常发票
"status": "0", -- 发票状态,1-已开票 2-已打印 3-已收票 4-已报销 5-已冲红 6-已登记异常 7-已标记销毁 8-已回退
//广东通用电子
"total": "Right", --价税合计信息,Right-一致
"seller": "广州市越*******宜世饮品店", --纳税人名称
"seller_tax_id": "Right", --纳税人税号信息, Right-一致
"check_mark": "found" -- 查验标志,found-成功
//浙江通用电子
"code": "2330****111", -- 发票代码
"number": "393***58", -- 发票号码
"date": "2021-05-11", -- 开票日期
"total": "504", -- 价税合计
"seller": "杭州市*******餐饮店", -- 销售方名称
"seller_tax_id": "9233******5PE5J", -- 销售方纳税人识别号
"buyer": "安吉银凯置业有限公司", -- 购买方名称
"buyer_tax_id": "91330*****ND53", -- 购买方纳税人识别号
//非税收入票据
"code": "00010XXX", -- 发票代码
"number": "003822XXX", -- 发票号码
"date": "2022-08-24", -- 开票日期
"total": "560.00", -- 金额
"check_code": "793aaa", -- 校验码
"seller": "国家知识产权局", -- 销售方名称
"buyer": "XXX有限公司", -- 购买方名称
"dept_seal": "", -- 主管税务机关章
"red_flushed": false, -- 是否红冲
"buyer_credit_code": "914101006688XXX", -- 购买方纳税人识别号
"seller_full_name": "XXX", -- 销售方纳税人全称
"electronic_ticket_title": "中央非税收入统一票据(电子)", -- 发票种类
"dept_seal_number": "", -- 主管税务机关代码
"reviewer": "XXX", -- 复核人
"items1": [
{
"name": "XXX", -- 项目名称
"unit": "元", -- 单位
"quantity": "0.15", -- 数量
"total": "135.00", -- 金额
"standard": "900", -- 规格型号
"remarks": "", -- 备注
"item_code": "056990XXX" -- 项目编码
}
]
//火车票
"number": "24119121XXX", -- 发票号码
"date": "2024年06月07日", -- 乘车日期
"pretax_amount": "533.03", --税前金额
"tax": "47.97", --税额
"total": "581.00", -- 总金额
"buyer": "浙江XXX有限公司", --购买方名称
"buyer_tax_id": "913310XXX", --社会统一信用代码
"invalid_mark": "0", -- 作废标志: 0-正常,1-已作废,3红冲
"tax_rate": "9%", --税率
"user_id": "320924******03XXX", -- 身份证号
"station_geton": "北京南", -- 上车车站
"station_getoff": "杭州东", -- 下车车站
"date_of_issue": "2024年06月09日", --开票日期
"time": "06:30", -- 乘车时间
"name": "XXX", -- 乘车人姓名
"train_number": "G171", -- 车次
"seat": "二等座", -- 座位类型
"seat_number": "09车 04D号" -- 座位号
// 航空运输电子客票行程单
"receipt_number": "2411899921100XXX", --发票号码
"number": "9996015XXX", --电子客票号码
"date": "2024年08月12日", --开票日期
"tax": "90.00", --税额
"total": "1140.00", -- 总额
"buyer": "海南XXXX有限公司", --购买方名称
"buyer_tax_id": "91460000MXXXX", --购买方纳税人识别号
"invalid_mark": "0", --作废标志: 0-正常,1-已作废,3红冲
"user_id": "230302******17XXXX", -- 身份证号
"user_name": "高XX", --旅客姓名
"international_flag": "国内", -- 国内国际标签
"number_of_gp_order": "", --GP订单号
"flights": [
{
"flight_number": "CA8XX", -- 航班号
"flight_segment": "1", ---航段序号
"from": "长春-龙嘉 T2", -- 出发站
"to": "呼和浩特-白塔 ", -- 到达站
"carrier": "国航", - 承运人
"fare_basis": "U/CA1FXXX", --客票级别
"date": "2024年08月07日", --乘机日期
"time": "12:15", -- 乘机时间
"seat": "U" - 座位等级
}
],
},
'extra': {
}
}
]
}
}
}
3.3. 错误返回参数
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
返回状态码 |
result |
true |
int |
0或1 |
请求状态. 1:成功, 0:失败 |
错误码 |
error |
true |
int |
10002 |
|
信息说明 |
message |
true |
String |
"Autdenticate failed" |
|
3.4. 错误返回样例
{
'result': 0,
'error': 10002,
'message': 'Authenticate failed'
}