易票开放平台接入文档

快速接入指南

本文档适用于第三方平台、ERP服务商、POS厂商等对接易票服务。

第三方平台：如猫酷、美团等为商家提供平台服务的企业；

ERP服务商：如金天鹅、哗啦啦等为商家提供ERP系统的企业；

POS厂商：如联迪、新大陆等为商家提供POS系统的企业。

快速开票开发流程：

申请认证 -> 完成商户注册 -> 调用快速开票服务

电子发票开发流程：

第1步：申请认证；
第2步：完成商户开通；
第3步：关注“易票商户”公众号，增值服务-电子发票完善商户信息，申请开通电子发票服务；
第4步：调用电子发票服务。

如何申请认证

想成为易票服务商线下联系我们，提交企业资质，申请开通服务商后台，获取认证。已成为易票服务商的向我们提供服务商编号即可；

联系电话Tel：010-85753380

测试环境服务商认证标识(accessKey):c57eb03a3fe8d8ec0d8aa285251ef29d

为方便您进行接口对接，特提供示例代码下载： Java版

商户开通

接口描述：

通过此接口可开通易票商户。

测试地址： http://top.yeepiao.com/customer/regist
生产地址： http://op.yeepiao.com/customer/regist
请求类型：POST
接口参数：

名称	类型	必填	说明
accessKey	string	是	服务商认证标识
billingCode	string	是	开票码，快速开票服务对商户的唯一识别码，由接入方提供，要求字段长度为10-32位
enterpriseName	string	是	企业名称
taxNo	string	是	企业税号（需要和开票软件上一致）
linkMan	string	是	联系人姓名
phoneNo	string	是	手机号码
sign	string	是	签名

返回结果：

名称	类型	说明
resultCode	string	返回响应结果，0表示查询成功，返回其它结果表示查询失败；
resultMsg	string	返回信息，当resultCode不为0时，说明异常原因。
serialNumber（data的子元素）	string	序列号（请妥善保存该字段），当开通成功时，返回序列号用于登录插件
billUrl（data的子元素）	string	该商户开票链接，可将此链接转成二维码形式展示给消费者开票
customerNo（data的子元素）	string	商户编号

返回示例（JSON）：

        // 返回结果，开通成功
        {"data":{"serialNumber":"3001027832","billUrl":"http://localhost:8400/s/0eec84b9e","customerNo":"20020104"},"resultCode":"0"}
        // 调用接口报错返回结果
        {"data":null,"resultCode":"88080299999","resultMsg":"系统未知异常"}
        {"resultCode":"98","resultMsg":"开票码已注册"}

商户开通状态查询

接口描述：

通过此接口可查询商户当前的开通状态。

测试地址： http://top.yeepiao.com/customer/query
生产地址： http://op.yeepiao.com/customer/query
请求类型：POST
接口参数：

名称	类型	必填	说明
accessKey	string	是	服务商认证标识
billingCode	string	是	开票码，易票开票服务对商户的唯一识别码。
sign	string	是	签名

返回结果：

名称	类型	说明
resultCode	string	返回响应结果，0表示查询成功，返回其它结果表示查询失败；
resultMsg	string	商户当前状态，true表示已开通商户，并返回绑定商户信息，false表示未开通商户。

返回示例（JSON）：

        // 返回结果，状态为开票码已开通商户,并返回绑定商户信息
        {"data":{"enterpriseName":"注册测试1","taxNo":"123456789012345","phoneNo":"18301310621","linkMan":"注册测试1","qrcode":"3001027832","billUrl":"http://localhost:8400/s/0eec84b9e","bindStatus":"BINDED","electronicStatus":"FALSE"},"resultCode":"0"}
        bindStatus: BINDED表示已绑定开票码    FALSE 未绑定开票码 
        electronicStatus=TRUE 已开通电子发票服务   FALSE 未开通电子发票服务  PROCESSING 电子发票服务开通中
        // 调用接口报错返回结果
        {"resultCode":"98","resultMsg":"accessKey或开票码错误"}

快速开票服务 - 应用场景

应用场景可参考以下方式：

快速开票服务 - 调用链接

调用描述：

调用商户开通接口时，会返回该商户开票链接。
注意：可将此链接转成二维码形式展示给消费者开票

易票平台接入文档