国内ERP对接各大零售平台开放文档

前言

写这篇文章目的在于笔记，三年开发经验，对接过美团和抖音b2c模式、还有o2o配送平台相关业务，刚开始我也挺懵的，完全搞不懂我们ERP属于哪个主体，平台主体如何对应我们系统主体，授权方式，扣费方式...

现在在下面都做下整理

接入主体

不管你们公司ERP(后续简称为ERP)准备对接哪个平台的什么业务都好，对于平台来讲，ERP或其他公司都被视作接入主体

接入主体大致可以分为三类(具体根据平台情况而定)：

1. 商家 & 没有自研能力：这类人群或公司，没有属于自己的开发团队，需要纯依赖平台方提供的技术服务来拓展公司的业务发展
2. 商家 & 有自研能力：这类有属于自己的开发团队，可使用平台提供的API来统计分析更多维度的数据，拓展自己的业务
3. 商家 & 没有自研能力 & 服务商提供技术桥接：这类商家一般为了省成本，可以简单理解为外包，请开发人员桥接ERP和三方平台

PS：第二类和第三类与实际并不一定对得上，比如说有的平台对第二类有更加便利的待遇，公司为享受到即使是第三类也会谎称第二类，所以大家懂我意思

确认ERP主体

你得问领导或者自己判断，公司ERP准备以哪个主体进行对接？

商户账号、店铺账号、开发者账号

商户账号(商家账号)：以第三方平台商户的身份入职三方平台；站在接入主体角度，这个账号可以是商户无自研能力、自研公司的人、请外包的商家来注册

商户账号都会有个标识，比如商户ID、商家ID、企业ID等等

店铺账号：店铺账号一般是和商家账号是有关联的，一个商家允许有多个店铺，也会有个店铺ID标识

开发者账号：三方平台多数考虑到平台商户具有开发对接的能力，因此搞了个开发者账号，用于对接三方平台的接口和回调；注册人群：自研公司的人，外包服务商

开发者账号也有个标识，比如appkey、appId、dev_id等等

平台主体和ERP主体对应关系

1. 如果需要你系统的商家跟平台注册商户账号，然后你注册开发者账号，提供技术桥接。这种情况商户账号可能会有多个，开发者账号一个，多用于第三类接入主体，这样的好处是服务商只提供技术，至于平台和商家的一些结算是不干预的

对应关系：在ERP也得有个主体得和三方平台商户有个映射关系

PS：要留意下一个开发者账号是否允许关联多个商户账号，因为ERP入驻商家不止一个的；相反，如果商户除了对接ERP外，还需要对接其他公司的ERP，那么一个商户账号是否也可以绑定开发者账号

2.如果你单独作为商家，为入驻你系统的商家提供统一的三方平台服务，那么商户账号只要注册一个就够了，然后开发者账号一个，多用于第二类接入主体，好处是商家不用跟平台结算，服务商和平台结算，服务商和商家自己内部结算

对应关系：可不需要在ERP维护映射关系，因为商户和开发者是一对一

店铺是否需要维护

有些平台上，是要求商户账号必须维护门店的，因此需要考虑在ERP这边如何跟三方平台的门店进行映射

授权

你商户打算让哪个开发者来服务于你对接ERP，需要有个绑定关系，即授权，绑定即授权。

目前主流的绑定方式有两种：
1. 在平台上直接绑定。比如登录开发者账号，发起商户绑定请求，然后商户账号来审核；但这种有个缺点，没有授权回调，授权有没成功，ERP是不清楚的，全靠人工口述通知

2. 在ERP嵌套授权链接。商户点击授权链接，登录商户账号完成授权；这种方式在于有授权回调，ERP能清楚是否授权成功，知道授权成功了就可以调用接口了

PS：授权链接的参数中一般都有开发者账号的ID标识的，比如appkey、appId、dev_id，检查下有没有这个，不然你商户登录后要绑定哪个开发者账号？

结算

这个很重要，不要以为结算不花你的钱跟你没关系，公司是很看重这个的，你对接人家三方平台的业务，人家给你提供服务，肯定要收费的，因此我们要了解收费的方式，怎么结算的

1. 确定是【三方平台和外包结算、外包和商户结算】还是【三方平台直接和商户结算】？

2. 平台如何获利？从一单里扣，还是给固定费

3. 结算方式是什么？是记账月结、预充值月结、预充值下一扣一....

4. 有没啥优惠返利政策？比如充值1000送100，下单量多少返多少钱等等

开发

请求规范

市面上http，post，json的形式相对主流点，但是我要提醒的不是这个，而是要清楚公共参数和业务参数的定义格式是咋样的

目前相对主流的参数定义有三种：

1. 公共参数在请求体，如app_key、signatrue、body等等，body则是业务参数
   

2. 公共参数在每个接口都有，但是接口参数各自独立，如dev_id、timestamp
   
   

3. 公共参数跟在URL后面，业务参数放在请求体，如下：

http://localhost:8080/xx/xx?appKey='xx'&method='post'

上面三种你发现只是参数定义结构不一样，然后都要有公共参数，对应公共参数你要提前了解下面问题：

1. 公共参数是否有开发者ID，商户ID？这很重要，能看出来开发者和商户是一对一还是一对多关系

2. 如何计算签名？有无生成签名示例代码？

3. 有无SDK？

测试

一般三方平台都会提供测试环境给开发者使用，如果你第一次对接，一定要清楚下面的问题？

1. 有无提供测试域名？没有是否可用线上的

2. 平台有没提供现成的测试开发者账号、测试商户账号？如果商户下还有店铺，问下有没测试店铺账号？如果有就用，没有就去注册（有的测试账号啥的是得你去注册完登录才有说明的）

3. 确定你们本次要对接的接口，以及回调接口有哪些？回调地址在哪里设置？控制回调工具在哪里？

上线

1. 确定线上域名，并切换
2. 注册线上开发者和商户账号，提供资料
3. 充值，授权，回调配置
4. 正式发单