接入帮助中心

围绕你的申请、账号、门店和系统连接,找到下一步操作。

准备申请材料查看企业、首店、品牌与各类经营资质的要求。跟进审核与开通查询状态、补充资料,为新获批账号设置密码。管理门店与连接查看授权范围,维护门店编码及 Webhook 配置。

申请与材料

连锁总部如何开始申请?

在申请页选择连锁总部及实际经营类型,填写总部企业、品牌、申报门店规模、经营方式与技术联系人。自研团队选择自主研发;委托接入需补充服务商名称和信用代码。仅总部申请无需首店。若同时提交首店,则总部与首店的企业身份应一致;其他主体门店独立入驻并授权。

材料上传失败时怎么处理?

先完成申请联系人手机验证,再选择 JPEG、PNG 或 WebP 图片。单张不超过 6 MB;按页面提示使用对应材料栏重新上传。证照通过私密接口保存,只有返回上传成功才可以继续提交,不能用图片网址代替。

法人和联系人是同一个手机号,需要重复验证吗?

同号可复用本次验证结果。号码改变后需要重新验证;验证成功仍需在有效期内提交。不要把短信验证码或申请凭证发给无关人员。

如何补件,或恢复之前的申请?

进入申请进度输入申请编号及查询凭证,或导入此前下载的凭证文件。在允许补件的状态点击“修改并重新提交”。缺失凭证时需要通过平台已有服务渠道核验身份,手机号本身不能读取申请。

自研与委托服务商的权限如何开通?

自研接入需提供技术联系人,获得相应接口权限后完成联调。委托服务商还需核对委托身份及服务商企业资料;申报服务商不等于为其创建账号或授予门店权限。本站当前没有服务市场发布流程。

账号开通与登录

  1. 先在申请进度页确认审核状态。
  2. 获批的新账号如显示“设置新账号登录密码”,请再次验证原申请联系人的手机号,再设置密码。提交申请时已经使用的手机验证凭证不能重复使用。
  3. 完成设置后,用联系人手机号和密码进入控制台。既有商家账号沿用原来的登录方式。
首次登录要求修改密码怎么办?

控制台会进入专用改密流程,输入原密码和新密码。成功后重新登录;在完成改密前无法访问主体、门店或系统连接。

为什么页面刷新后需要重新登录?

控制台的登录令牌只保存在当前页面内存,刷新或关闭后清除。申请查询凭证另行保存在当前标签页,并可由你主动下载、导入或清除。

提示没有主体或无访问权限怎么办?

请由总部管理员或平台审核人员核对账号成员关系、经营主体状态与授权范围。填写品牌名称或门店 ID 不会新增权限;页面显示的门店数仅是此账号有权访问的数量。

分店邀请、经营关系与人员

总管在控制台创建邀请,选择直营、加盟或合伙。门店负责人核对邀请后,已有门店由所有者在自己的登录会话中确认,新店从受邀分店登记验证手机号并继续补齐资质。

总管、店长、店员和直营、加盟、合伙有什么区别?

前三项是人员职责:总管管理总部范围,店长管理本店,店员处理授权事务。后三项是门店与总部的经营关系;关系名称本身不增加人员权限,也不自动改变收款账户。

总部可以统一商品与装修吗?

加入时可以明确同意总部统一内容管理。系统 API 还需门店所有者单独授权;实际下发使用总部已保存的模板版本及门店允许的内容范围。当前内容写入接口仅支持外卖。

邀请码丢失或发错了怎么办?

完整邀请码仅创建时显示,不保存到浏览器。可在邀请记录撤销原邀请后重新创建。请由门店本人登录操作,不向总部提供门店登录密码。

填写总部收款和分成比例就能分账吗?

不能。邀请只登记合作意向,不直接启用收款、分账或改变原结算主体,资金能力另行审核开通。

原来的 CSV 门店编码入口在哪里?

经营主体控制台的门店管理仍可维护已有权限门店的 ERP 和线上编码,每批最多 100 条。该入口不替代邀请或新店审核,也不能迁移其他主体门店。

OpenAPI 联调与排查

总部应用先创建密钥,再由门店所有者选择权限和有效期。总部系统用独立密钥调用授权门店接口;查看总部 API。以下为 Webhook 事件接收流程。

  1. 准备公网 HTTPS 接收地址,按验签说明处理原始请求体、时间戳和随机串,并按事件 ID 幂等。
  2. 在控制台读取当前主体配置,填写地址及密钥,选择订阅事件并保存启用。
  3. 发送测试事件后进入投递日志,核对最终状态和接收服务的实际结果。
返回 queued 就代表送达了吗?

queued 仅表示任务入队。接收方在规定时间内返回 2xx 才是投递成功;请查看最近 100 条日志中的状态、响应码与重试次数。

保存成功,为什么显示待验证?

配置启用与连接已验证分别记录。需要使用当前配置成功投递一次,才能确认接收地址与验签处理正确。更新配置后应重新联调。

如何处理接口报错?

401 表示登录或申请凭证失效,请核对凭证或重新登录。403 表示权限不足,须先核对主体和门店授权,不要重复重试。429 表示请求过于频繁,请按 Retry-After 或页面倒计时等待。5xx 或网络中断后的写入结果可能未确认,先查询申请进度、门店记录或投递日志,再决定是否重试。字段与材料错误按返回提示修正。

开发文档仅列出当前使用的接口与字段。接入前请核对当前版本,已停用的历史入口不作为业务调用入口。

查看接口说明 · 下载事件推送接入文档 · 下载申请接口文档

零售与电商

即时零售与邮寄电商分别选择经营类型。电商申请需说明商品来源、品牌关系、仓库及退货地址、售后联系手机与结算账户;自有商标和品牌授权分别上传相应证明。资料完整后进入审核,后续系统连接遵循主体与账号权限。

查看业务接入 · 查看材料清单

酒店与民宿

酒店需提交经营场所权利证明、属地经营许可及相关材料有效期。民宿分为基础资料受理、资质准备及显式激活;处于准备状态的账号可按要求补件,不代表可以上架、营业或收款。

官网目前提供住宿入驻与账号开通流程,开放接口未提供按日期的房态房价同步。请以已列出的实际接口及账号能力为准。

申请酒店入驻 · 申请民宿入驻 · 查看资质清单