如何授权 MakroZa（Makro 南非站）店铺

开始前确认

• 当前 ERP 账号具备店铺授权权限。
• 能登录 Makro 卖家后台（seller.makro.co.za）的主账号邮箱和密码。
• 一个能接收 Makro 登录验证码（OTP）的邮箱，以及该邮箱的客户端授权码（供 IMAP/POP3 读取邮件使用，不是邮箱登录密码）。
• 可选：Makro 卖家后台 Developer Access 生成的 API Key 和 Secret；不使用官方 API 时两项都可以留空。

进入店铺授权并选择 MakroZa

1. 在 ERP 顶部菜单进入 系统 → 店铺授权，页面地址为 /system/authorize。
2. 停留在 店铺帐号 页签，在平台卡片区找到 MakroZa（卡片 Logo 为 MACROZA），点击卡片；也可以先点左下角 添加/更新授权，再选择 MakroZa。
3. 页面弹出标题为 授权店铺 的对话框，顶部显示 MACROZA 标识，即可开始填写。

获取 API Key 和 Secret（可选）

只有需要调用 Makro 官方 API 时才填写 API Key 和 Secret。两项必须同时填写或同时留空，只填其中一项会提示「API Key 和 Secret 请同时填写或同时留空」。

1. 用主账号登录 Makro 卖家后台，打开 https://seller.makro.co.za/index.html#dashboard/developer-access。
2. 点击 Create New Access，Access Name 和 Description 均填写 wxwerp，Domain 填写 www.wxwerp.com，然后提交。
3. 等状态变为 APPROVED 后，复制 API Key；再点 Secret 列的 Copy Secret 复制 Secret。

准备接收 OTP 的邮箱

授权时系统会用「门户登录邮箱」和「门户登录密码」登录 Makro 卖家后台，Makro 会把登录验证码发送到该邮箱；系统再通过 IMAP 或 POP3 读取邮件中的验证码，因此必须提供邮箱的客户端授权码。

4.1 使用 163 邮箱接收验证码

1. 登录 163 邮箱，进入 设置 → POP3/SMTP/IMAP。
2. 开启 IMAP/SMTP 服务 和 POP3/SMTP 服务。
3. 在「授权密码管理」中点击 新增授权密码，按提示验证后复制生成的授权密码。

4.2 使用 Outlook 等其他邮箱

如果 Makro 店铺绑定的是 Outlook、Gmail 等邮箱，建议先把验证码邮件转发到 163 邮箱，再用 163 邮箱读取：

1. 在原邮箱设置中新增规则，条件为主题包含 Makro，操作为转发到你的 163 邮箱。
2. 保存规则后，在 Makro 卖家后台触发一次登录，确认 163 邮箱能收到验证码邮件。
3. 回到 ERP 授权弹窗，把「邮箱登录账号」填写为这个 163 邮箱，「邮箱客户端授权码」填写 163 邮箱的授权密码。

填写授权信息并提交

确认无误后点击 确定。系统会读取邮箱中的 OTP 完成一次完整登录，并调用 Makro 私有接口校验店铺，整个过程约 30 秒，请耐心等待，不要重复点击。

确认授权结果

授权成功后弹窗自动关闭，店铺列表新增一条 MakroZa 店铺记录，可以核对以下信息：

• 授权状态显示「授权有效」。
• 列表显示店铺 ID、账号别名和授权时间。
• 后续可在商品、订单等模块按该店铺同步数据。

常见问题