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 | |
| 校验码后6位 | check_code | false | String | 871589 | 专票、机动车票、二手车票可为空，普票不为空 |
| 金额 | pretax_amount | false | String | 2648.54 | 专票(税前金额)、机动车票(税前金额)、二手车票(总价)不为空，普票可为空 |
| 开票日期 | date | true | String | 2017年03月28日 | 格式为: 年/月/日 |
| 发票类型 | type | true | String | 10100 | 发票类型 |
| 电子票标识 | electronic_mark | false | int | 0或者1 | 是否增值税电子专用发票: 0: 否(默认值) 1: 是 |
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有限公司', -- 销售方名称
'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红冲
'oil_mark': '0', -- 成品油标志
'receiptor': 'XXX', -- 收款人
'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', -- 限乘人数
},
'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'
}