饿了么开放平台服务商渠道商家建店接入方案
1、文档说明
本文档面向对象为拥有渠道开店资质的服务商，通过api接口实现饿了么平台线上开店的场景。
2、背景介绍
为打造商家、服务商、平台间的商业生态，平台针对有资质的服务商开通商家入驻开店接口，服务商可作为推广者，将自身拥有的商户资源，引导商户在饿了么平台开店，商户入驻成功且开店营业后，服务商可获取推广奖励。
3、入驻开店流程
3.1 商家入驻开店业务流程
3.2 商家入驻开店主流程的接口调用时序
4、api场景能力
4.1、查询商家信息
根据证件类型+证件号码可查询脱敏的商家信息，也可通过短信验证码获取详细的未脱敏商家信息
4.1.1、接口调用流程
4.2、查询商家入驻申请信息
商家签约合同提交入驻申请后，如果需要查询商家入驻申请信息，可使用 eleme.merchant.getById 接口。
4.3、修改认证信息
修改认证信息有2种方式：根据证件类型和证件号码修改认证信息 和 根据申请id修改认证信息；
商家处于入驻中状态，可通过申请id+认证验证码修改认证信息；
商家处于已生效状态，可通过商户id+认证验证码修改认证信息。
4.3.1、接口调用流程
当无法获取到申请id和商户id时，也可通过证件类型+证件号码修改证件信息，接口调用流程如下
4.4、修改商家身份信息
商家入驻申请驳回后，可重新修改商家身份信息并重新提交审核
4.4.1、接口调用流程
入驻申请审核通知需订阅221消息，221消息说明如下：
字段名字段类型字段说明
applyIdString开店申请id
auditStatusString审核状态。PASSED:审核通过、FAILED: 审核不通过
rejectReasonString不通过原因
消息示例：
{ "signature": "13F37703ABAA644C2086CAB09466621F", "requestId": "2285732587666349851", "appId": 12345659, "shopId": 543294619, "type": 221, "message": "{\"applyId\":\"37499\",\"auditStatus\":\"PASS\"}", "userId": "5066666663248870300", "timestamp": 1683561599911 }
4.5、查询开店申请信息
商家提交开店申请后，如果需要查询商家开店申请信息，可使用 eleme.openShop.getDetailByApplyId 接口。
4.6、查询开店申请草稿
商家在提交申请前如果保存了草稿信息，可使用 eleme.openShop.getDraft 接口查询草稿信息。
4.7、维护开店申请信息
维护开店申请信息时，需要填写商家餐饮类目信息，以及商家所处行政区域信息，可通过以下接口获取到需要的类目和行政区域信息。
接口接口描述
eleme.openShop.getAllCateringCategory获取所有餐饮频道的类目信息
eleme.openShop.getAllDivisionInfo获取所有行政区划信息
执照信息必填要求
证件类型证件信息上传要求必填字段
营业执照所有场景必须传入证件号码、企业名称、法人、证件地址、证件有效期、图片
食品经营许可证所有场景必须传入证件号码、企业名称、法人、证件地址、营业项目、主体业态、证件有效期、图片
非法人经营授权书营业执照上法人与商户认证法人不是同一个人时，必须上传非法人经营授权书图片
清真许可证售卖清真食品的商家必须上传清真许可证图片
4.8、修改开店申请信息
开店申请被驳回后，可再次修改开店申请信息重新提交审核
4.8.1、接口调用流程
开店申请审核通知需订阅222消息，222消息说明如下：
字段名字段类型字段说明
applyIdLong开店申请id
auditStatusString审核状态。PASSED:审核通过、FAILED: 审核不通过
auditTimeString审核时间。格式：yyyy-MM-dd HH:mm:ss
消息示例：
{ "signature": "13F37703ABAA644C2086CAB09466621F", "requestId": "2285732587777669851", "appId": 12345659, "shopId": 543294619, "type": 222, "message": "{\"applyId\":123,\"auditStatus\":\"PASS\",\"auditTime\":\"2023-05-09 10:00:00\"}", "userId": "5066666663248870311", "timestamp": 1683605949794 }
5、贴心TIPS
（1）保存草稿[eleme.openShop.saveDraft] 和 开店申请预校验[eleme.openShop.preCheck]，这两个接口在商家入驻前也可调用，可支持商家在入驻前填入商家身份认证信息以及开店信息的场景。
6、接口 & 消息列表
6.1、涉及接口
相关的所有接口可见文档（属于特权接口，需要先申请权限，方能查看文档，申请步骤可见【7、接口权限申请】）：
商户主体服务接口（入驻阶段用到的接口）：https://open.shop.ele.me/openapi/documents/reference/eleme-merchant-root
开店服务接口（开店申请阶段用到的接口）：https://open.shop.ele.me/openapi/documents/reference/eleme-openShop-root
6.2、涉及消息
需订阅221和222消息，221和222消息的消息体和示例可参考如下文档
https://open.shop.ele.me/openapi/documents/callback
7、接口权限申请
（1）资质评估
本业务目前只对饿了么直营城市中的餐饮单店进行开放，请服务商先评估自身业务的拓展能力，包含但不限于城市属地资源、行业场景、分销和业务适用场景拓展的能力。
可通过保障宝或联系邮箱咨询（sktd@service.alibaba.com）
（2）接口权限申请
资质评估通过后，可通过保障宝提交商家入驻开店的特权接口申请流程
保障宝首页，日常保障—特权接口申请
特权接口类型选择**“商家入驻开店”**，填写服务商信息和应用id后提交申请
如果您还未关注保障宝，可参考以下文档：
https://open.shop.ele.me/openapi/documents/saas_instructions
（3）线下业务协议签署
在双方就意愿、能力和技术确认后，我们同步签署《饿了么线上新签服务商（ISV）合作协议》。由运营与服务商沟通，线下形式签署。
