Bootstrap

EasyAPI基于电子发票API接口二维码小票对接方案

本对接方案的好处是,客户无需为增加发票管理而增加数据库表或者字段、无需研究复杂的税务接口、无需关心税收分类编码、税率等,实现无缝集成。

名称解释:

名称解释备注
用户标识客户系统中的用户唯一编号可以使用手机号,或者加密的字符串
商户订单号客户系统的订单号通过该订单号实现2边系统数据联通
访问令牌通过EasyAPI获取的访问令牌

以类似星巴克的二维码开票演示:

1、调用 “获取用户accessToken” API接口

 GET https://fapiap-api.easyapi.com/access-token

参数名称参数类型是否必填描述
appKeystring必填发票服务appKey
appSecretstring
 
必填
 
发票服务App密钥
usernamestring必填用户标识
taxNumberstring选填企业纳税人识别号(平台型客户传参)
 

 如何获取appKey和appSecret,登录https://fapiao.easyapi.com

返回结果: 

{
    "status": "1",
    "msg": "获取成功",
    "content": {
        "accessToken": "5d7780d9da6a5520a79bf28a4f478e4f",
        "username": "username001"
    }
}

2、获取二维码小票 

POST https://fapiao-api.easyapi.com/scan/print

参数名称参数类型是否必填描述
accessTokenstring必填(不使用Key密钥情况下)
前端场景使用,不暴露Key和密钥
访问令牌
appKeystring必填(不使用accessToken情况下)发票服务appKey
appSecretstring
 
必填(不使用accessToken情况下)
 
发票服务App密钥
taxNumberstring必填开票企业税号
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

;