本对接方案的好处是,客户无需为增加发票管理而增加数据库表或者字段、无需研究复杂的税务接口、无需关心税收分类编码、税率等,实现无缝集成。
名称解释:
名称 | 解释 | 备注 |
---|---|---|
用户标识 | 客户系统中的用户唯一编号 | 可以使用手机号,或者加密的字符串 |
商户订单号 | 客户系统的订单号 | 通过该订单号实现2边系统数据联通 |
访问令牌 | 通过EasyAPI获取的访问令牌 |
以类似星巴克的二维码开票演示:
1、调用 “获取用户accessToken” API接口
GET https://fapiap-api.easyapi.com/access-token
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
appKey | string | 必填 | 发票服务appKey |
appSecret | string | 必填 | 发票服务App密钥 |
username | string | 必填 | 用户标识 |
taxNumber | string | 选填 | 企业纳税人识别号(平台型客户传参) |
如何获取appKey和appSecret,登录https://fapiao.easyapi.com
返回结果:
{
"status": "1",
"msg": "获取成功",
"content": {
"accessToken": "5d7780d9da6a5520a79bf28a4f478e4f",
"username": "username001"
}
}
2、获取二维码小票
POST https://fapiao-api.easyapi.com/scan/print
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
accessToken | string | 必填(不使用Key密钥情况下) 前端场景使用,不暴露Key和密钥 | 访问令牌 |
appKey | string | 必填(不使用accessToken情况下) | 发票服务appKey |
appSecret | string | 必填(不使用accessToken情况下) | 发票服务App密钥 |
taxNumber | string | 必填 | 开票企业税号 |
shopNo | string | 必填 | 商户订单号 |
remark | string | 开票备注 | |
items | array | 商品明细 | |
items > name | string | 必填 | 商品名称 |
items > model | string | 规格 | |
items > unit | string | 必填 | 单位 |
items > number | int | 必填 | 数量 |
items > price | double | 必填 | 含税单价 |
调用示例:
{
"appKey": "发票服务appKey",
"appSecret": "发票服务App密钥",
"taxNumber":"91320211MA1WML8X6T",
"shopNo":"123456",
"remark":"发票备注",
"items": [
{
"name": "商品名称",
"model": "型号",
"unit": "单位",
"number": "1",
"price": "1.0"
}
]
}
返回结果:
{
"code": "1",
"message": "提交成功",
"content": "P7bZIVwp"
}
获取开票链接:
URL前缀+小票二维码编号
https://fapiao-scan.easyapi.com/code=小票二维码编号(返回结果的content)
https://fapiao-scan.easyapi.com/?code=P7bZIVwp
如果需要咨询相关电子发票API接口技术问题或者价格,请加微信fanfanle