十九、Takealot 店铺授权指南
Takealot 使用 API Key 连接店铺。在卖家后台取得密钥后,进入 店铺管理 → 店铺账号 → Takealot 店铺,填写店铺名称与 API Key,校验通过后再设置默认仓库。
操作顺序:主账号获取 API Key → 绑定新店铺 → 核对卖家身份与授权状态 → 设置默认仓库 → 创建跟卖报价并同步订单。
下图为当前版本真实前端组件的本地截图,使用演示店铺数据,不包含真实店铺凭证。请按自己的店铺信息操作。
1. 打开官方接入与授权文档
Takealot Marketplace API 官方文档:Overview 与授权说明
从 Overview 的 Authorisation(授权) 小节查看 API Key 的获取方式和使用要求。官方 API 使用 X-API-Key 请求头认证,海云星会在绑定时校验对应的卖家身份。
2. 在 Takealot 后台获取 API Key
- 使用店铺的 主账号(account owner) 登录 Takealot 卖家后台,确认当前是要连接的店铺。
- 进入 API Access,按平台提示生成 API Key。
- 复制这家店铺的 API Key,准备在海云星中绑定。
一个 Takealot 卖家账号同时只有一把有效 API Key。生成新密钥会让旧密钥失效;已有其他集成使用旧密钥时,也需要同步更新。 若找不到 API Access,请先核对是否使用主账号,仍不可见时联系 Takealot 支持。
3. 在海云星绑定店铺
- 登录 海云星 ERP,确认当前公司正确。
- 进入 店铺管理 → 店铺账号,切换到 Takealot 店铺 页签。
- 点击 绑定新店铺,填写以下两项并提交。
| 字段 | 填写说明 |
|---|---|
| 店铺名称 | 在海云星内区分店铺的名称,最多 100 个字符。 |
| API Key | 从目标 Takealot 店铺 API Access 复制的完整密钥。 |
卖家编号(Seller ID)由系统校验时自动读取,无需手填。API Key 校验通过后加密保存,不会回显;每次提交后输入框都会清空,失败重试时需重新粘贴。
4. 核对授权结果与默认仓库
返回 Takealot 店铺列表,确认 卖家编号、Takealot 店名、授权状态和最近校验时间 正确。授权状态应为 已授权;列表仅显示 API Key 的末 4 位。
随后点击该店铺的 设置,选择直邮库存实际使用的 默认仓库 并保存:
- 平台只有一个卖家仓库时,绑定后系统会自动设为默认仓库。
- 有多个仓库时,需选择正确的默认仓库;跟卖报价填写的直邮库存会写入这个仓库。
- 显示「没有仓库」时,先到 Takealot 卖家后台维护仓库,再回 ERP 点击 校验 刷新仓库列表与直邮天数范围。
需要同事处理报价或订单时,再配置对应角色和店铺权限,并用成员账号核对可见范围。
5. 已绑定店铺怎样更新密钥?
平台侧更换 API Key,或 ERP 授权状态显示 需更新密钥 时:
- 在 Takealot 店铺列表找到原店铺,点击 更新密钥。
- 粘贴这家店铺当前有效的 API Key 并提交。新密钥必须属于原来同一个卖家。
- 核对授权状态和最近校验时间,必要时点击 校验 重新获取店铺与仓库资料。
6. 授权后创建跟卖报价
进入 平台商品 → Takealot 跟卖,使用 新建报价 或 Excel 导入 创建报价。条码应对应 Takealot 商品库中已有的商品;尚未建档的新品先在 Takealot 卖家后台提交并完成审核。
| 内容 | 填写说明 |
|---|---|
| SKU、条码、售价 | 新建与导入的必填内容。同一店铺的 SKU 应唯一;售价使用含税整数南非兰特(ZAR),至少为 1。 |
| RRP | 选填的划线价,填写时应为整数,且不低于售价。 |
| 直邮天数、直邮库存 | 填写库存时需同时填写直邮天数,并先设置默认仓库;天数应符合店铺允许范围。 |
Excel 导入先选择店铺并下载模板,每次最多 2000 行。任意一行校验失败时,整份文件不会导入;按返回的行号与原因修正后重新上传。
提交后查看 操作状态 与 Takealot 状态。可单条或批量改价、改库存,维护 RRP 和直邮天数,并使用 停售、恢复销售、刷新选中。出现 结果未确认 时,先刷新核对,再按需重新提交,避免重复新建同一 SKU。已建成的报价使用 停售;「删除」仅适用于尚未建成、没有待确认提交的本地记录。
7. 同步订单与记录发货
进入 订单管理 → 平台订单,点击 同步订单。手动同步会覆盖具备权限的已授权店铺,包括 Takealot;完成后按平台和店铺筛选订单并核对同步结果。系统也会默认每 2 小时 自动同步 Takealot 订单;需要卖家处理的直邮 / 揽收订单进入工作台,已备货在 Takealot 仓的销售记录不进入待处理队列。
先在 Takealot 卖家后台完成发货单、约仓、标签和实际交运,再回到 ERP 标记 发货;筛选 Takealot 后也可使用 批量标记发货。该操作只更新 ERP 的处理记录,Takealot 的平台状态以卖家后台为准。
8. 授权常见问题
官方文档可以打开,就表示店铺已经授权了吗?
官方文档是公开的接入说明。店铺是否连接成功,需要以海云星对目标店铺的实际校验结果为准。
更新 API 凭证后,原连接还能使用吗?
Takealot 生成新 API Key 后,旧 Key 会失效。请在原店铺记录中 更新密钥,同步更新其他仍需使用的集成,并重新核对授权结果。
多家 Takealot 店铺可以共用一份凭证吗?
每家店铺应使用与其对应的访问凭证,分别连接并核对店铺身份,避免把不同店铺的配置混用。
绑定提示 API Key 无效怎么办?
确认密钥来自目标店铺,复制完整、没有多余空格,并且没有在平台上重新生成过新的 Key。仍无法连接时,到 Takealot 核对当前有效密钥与账号状态,再回 ERP 重试。
店铺已经绑定,为什么还看不到跟卖或订单入口?
核对成员角色、Takealot 店铺授权及套餐权限;联系管理员为负责操作的成员分配对应店铺和业务权限。店铺列表已存在原记录时,使用原记录更新密钥,无需重复绑定。
删除 ERP 店铺会删除 Takealot 上的报价或停用 API Key 吗?
删除仅移除海云星内的店铺绑定与保存的密钥,不会删除 Takealot 上的报价,也不会停用平台 API Key。有报价正在提交或结果待确认时,先核对操作结果后再处理店铺。