- 1、本文档共18页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 5、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 6、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 7、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 8、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多
erp接口服务说明
总体说明
接口提供方式:接口以HTTP的方式提供。
数据格式:ERP中间件响应的数据统一为JSON格式。
编码:UTF-8
HTTP method:全部接口都以POST方式提供。
接口地址: /rest/****
每日访问次数限制:50000
准备步骤
申请成为华阳的开发者。
申请通过审核之后,会收到邮件,如下图:
请记录其中的appKey和appSecret。
登录,进入开发者中心,添加一个应用场景,注意要勾选其中的“ERP对接选项”,“登录地址”应填写为:
创建完成之后,从页面中可以看到应用ID,请将其复制并记录:
进入首页中,可以在“我的定制”中看到ERP,进入之后可以做ERP相关的设置。
目前可以实现线下门店跟线上门店的关联:
具体操作方式请参考《ERP系统门店关联操作手册》。
准备工作完成。下面可以进行后台接口调用。
接口调用
所有的接口都以http post方式提供。ERP中间件响应的内容为json格式,UTF-8编码,参数应以http parameter的方式传送给ERP中间件。
一个正常的响应示例:
{"result":{"accessToken":"glZbo+zFsQ1678SeCleO9PdBCww=","expiresIn":7200},"success":true}
一个异常的响应示例:
{"exceptionInfo":{"exceptionMessage":"未找到对应的订单","exceptionType":"未找到对象","exception":"ObjectNotFoundException"},"success":false}
其中,success字段表示接口是否调用成功,成功时值为true,失败时值为false。当成功时,响应中会包含result字段,这个字段是业务接口的返回值。当失败时,响应中会包含exceptionInfo字段,可以根据exceptionInfo来判断错误的类型,有助于调整您的程序代码。
其中的accessToken就是获取到的accessToken,请在你的服务器中缓存这个值,并在调用每个业务接口时都加上这个参数。expiresIn是指accessToken的有效时间(秒),有效时间内不需要重复获取accessToken。过期之后,需要重新获取。
exceptionInfo中的exception字段表示了异常的类型(可以理解为错误代码),目前常见的有以下几种:
AccessExceedException:接口访问次数超出限额
AccessTokenInvalidException:无效的AccessToken
AccessTokenNotFountException:未获取AccessToken
MethodNotAllowedException:HTTP METHOD错误
ObjectNotFoundException:未找到对象
ParameterBindingException:参数绑定错误
ParameterExceedException:参数超出范围
ParameterEmptyException:参数空错误
ParameterTypeMismatchException:参数类型错误
PermissionRefusedException:越权操作
UncategorizedException:未分类的异常
如果出现的异常不在上述分类当中,则可能是ERP中间件内部发生了异常,请联系华阳信通公司。
备注:
每个接口、每个商家、每天的访问次数一般为50000次(个别除外,详见接口文档),超限额的请求不会被接受,系统会给出AccessExceedException。
请注意并非所有情况下都会保证按上述内容响应(比如断网、ERP中间件正在维护、或者域名解析错误等)。请在编写代码时妥善处理。推荐使用HTTP状态码做额外判断。
接口在后续有扩展的可能。有可能新增字段等。请妥善处理您的程序,应当仅处理您需要的字段。
基本的参数及返回值的类型:
String:字符串。
int\Integer:整型数字。如果没有特别说明,一般应当大于或等于0。
Double:浮点型数字。如果没有特别说明,一般应当大于或等于0。
Boolean:布尔型。true或false
Date:日期型。实际接口中以String型代替,格式为yyyy-MM-dd HH:mm:ss
智慧商圈分页获取账单信息
接口请求说明
调用地址
接口地址/rest/boxCircle/findBills
方法描述
分页获取账单信息,每日访问次数限制为50000次
请求参数描述
参数
名称
类型
允许为空
备注
accessToken
唯一凭证
String
N
pageNumber
第几页
int
您可能关注的文档
- CRM标准对接方案.ppt
- ERP方提供给华阳的接口规则.docx
- 华阳提供给线下ERP接口文档.docx
- 华阳信通智慧门店包装功能阐述.pdf
- 领客智慧门店+咖啡解决方案.pdf
- 线下CRM方提供给华阳的接口规则.docx
- 华阳向线下CRM的接口文档_V0.2.doc
- 钰珑银招商手册(1112).ppt
- FAB简约说明使用.ppt
- 配置应用程序块Enterprise Library Step By Step系列.pdf
- 2024年山东省聊城东阿县事业单位选聘32人历年高频考题难、易错点模拟试题(共500题)附带答案详解.docx
- 2024年山东省聊城莘县事业单位招聘单位高频考题难、易错点模拟试题(共500题)附带答案详解.docx
- 汽机专业题库及解析.docx
- 基本常规医疗流程答案.doc
- 大金空调故障代码汇总.docx
- 理综-山西省阳泉市2023-2024学年高三年级上学期期末考试试题和答案.docx
- 数学-海南省天一大联考2023-2024学年高三学业水平诊断(二)带答案.docx
- 地理-湖南省长沙市雅礼中学2023-2024学年高三上学期月考试卷带答案.docx
- 生物-湖南省长沙市雅礼中学2023-2024学年高三上学期月考试卷带答案.docx
- 数学-湖南省长沙市雅礼中学2023-2024学年高三上学期月考试卷带答案.docx
文档评论(0)