接入帮助中心
围绕你的申请、账号、门店和系统连接,找到下一步操作。
申请与材料
连锁总部如何开始申请?
在申请页选择连锁总部及实际经营类型,填写总部企业、品牌、申报门店规模、经营方式与技术联系人。自研团队选择自主研发;委托接入需补充服务商名称和信用代码。仅总部申请无需首店。若同时提交首店,则总部与首店的企业身份应一致;其他主体门店独立入驻并授权。
材料上传失败时怎么处理?
先完成申请联系人手机验证,再选择 JPEG、PNG 或 WebP 图片。单张不超过 6 MB;按页面提示使用对应材料栏重新上传。证照通过私密接口保存,只有返回上传成功才可以继续提交,不能用图片网址代替。
法人和联系人是同一个手机号,需要重复验证吗?
同号可复用本次验证结果。号码改变后需要重新验证;验证成功仍需在有效期内提交。不要把短信验证码或申请凭证发给无关人员。
如何补件,或恢复之前的申请?
进入申请进度输入申请编号及查询凭证,或导入此前下载的凭证文件。在允许补件的状态点击“修改并重新提交”。缺失凭证时需要通过平台已有服务渠道核验身份,手机号本身不能读取申请。
自研与委托服务商的权限如何开通?
自研接入需提供技术联系人,获得相应接口权限后完成联调。委托服务商还需核对委托身份及服务商企业资料;申报服务商不等于为其创建账号或授予门店权限。本站当前没有服务市场发布流程。
账号开通与登录
- 先在申请进度页确认审核状态。
- 获批的新账号如显示“设置新账号登录密码”,请再次验证原申请联系人的手机号,再设置密码。提交申请时已经使用的手机验证凭证不能重复使用。
- 完成设置后,用联系人手机号和密码进入控制台。既有商家账号沿用原来的登录方式。
首次登录要求修改密码怎么办?
控制台会进入专用改密流程,输入原密码和新密码。成功后重新登录;在完成改密前无法访问主体、门店或系统连接。
为什么页面刷新后需要重新登录?
控制台的登录令牌只保存在当前页面内存,刷新或关闭后清除。申请查询凭证另行保存在当前标签页,并可由你主动下载、导入或清除。
提示没有主体或无访问权限怎么办?
请由总部管理员或平台审核人员核对账号成员关系、经营主体状态与授权范围。填写品牌名称或门店 ID 不会新增权限;页面显示的门店数仅是此账号有权访问的数量。
分店邀请、经营关系与人员
总管在控制台创建邀请,选择直营、加盟或合伙。门店负责人核对邀请后,已有门店由所有者在自己的登录会话中确认,新店从受邀分店登记验证手机号并继续补齐资质。
总管、店长、店员和直营、加盟、合伙有什么区别?
前三项是人员职责:总管管理总部范围,店长管理本店,店员处理授权事务。后三项是门店与总部的经营关系;关系名称本身不增加人员权限,也不自动改变收款账户。
总部可以统一商品与装修吗?
加入时可以明确同意总部统一内容管理。系统 API 还需门店所有者单独授权;实际下发使用总部已保存的模板版本及门店允许的内容范围。当前内容写入接口仅支持外卖。
邀请码丢失或发错了怎么办?
完整邀请码仅创建时显示,不保存到浏览器。可在邀请记录撤销原邀请后重新创建。请由门店本人登录操作,不向总部提供门店登录密码。
填写总部收款和分成比例就能分账吗?
不能。邀请只登记合作意向,不直接启用收款、分账或改变原结算主体,资金能力另行审核开通。
原来的 CSV 门店编码入口在哪里?
经营主体控制台的门店管理仍可维护已有权限门店的 ERP 和线上编码,每批最多 100 条。该入口不替代邀请或新店审核,也不能迁移其他主体门店。
OpenAPI 联调与排查
总部应用先创建密钥,再由门店所有者选择权限和有效期。总部系统用独立密钥调用授权门店接口;查看总部 API。以下为 Webhook 事件接收流程。
- 准备公网 HTTPS 接收地址,按验签说明处理原始请求体、时间戳和随机串,并按事件 ID 幂等。
- 在控制台读取当前主体配置,填写地址及密钥,选择订阅事件并保存启用。
- 发送测试事件后进入投递日志,核对最终状态和接收服务的实际结果。
返回 queued 就代表送达了吗?
queued 仅表示任务入队。接收方在规定时间内返回 2xx 才是投递成功;请查看最近 100 条日志中的状态、响应码与重试次数。
保存成功,为什么显示待验证?
配置启用与连接已验证分别记录。需要使用当前配置成功投递一次,才能确认接收地址与验签处理正确。更新配置后应重新联调。
如何处理接口报错?
401 表示登录或申请凭证失效,请核对凭证或重新登录。403 表示权限不足,须先核对主体和门店授权,不要重复重试。429 表示请求过于频繁,请按 Retry-After 或页面倒计时等待。5xx 或网络中断后的写入结果可能未确认,先查询申请进度、门店记录或投递日志,再决定是否重试。字段与材料错误按返回提示修正。
开发文档仅列出当前使用的接口与字段。接入前请核对当前版本,已停用的历史入口不作为业务调用入口。
查看接口说明 · 下载事件推送接入文档 · 下载申请接口文档
零售与电商
即时零售与邮寄电商分别选择经营类型。电商申请需说明商品来源、品牌关系、仓库及退货地址、售后联系手机与结算账户;自有商标和品牌授权分别上传相应证明。资料完整后进入审核,后续系统连接遵循主体与账号权限。
酒店与民宿
酒店需提交经营场所权利证明、属地经营许可及相关材料有效期。民宿分为基础资料受理、资质准备及显式激活;处于准备状态的账号可按要求补件,不代表可以上架、营业或收款。
官网目前提供住宿入驻与账号开通流程,开放接口未提供按日期的房态房价同步。请以已列出的实际接口及账号能力为准。