十五、Trendyol 店铺授权教程
将 Trendyol 店铺连接到海云星 ERP，需要从卖家后台取得 Seller ID、API Key、API Secret，再到 ERP 填写并校验。本流程适用于 GULF 海湾地区的沙特（SA）、阿联酋（AE）和科威特（KW）站点。
操作顺序：登录 Trendyol 卖家后台 → 打开账户集成信息 → 复制三项授权信息 → 在 ERP 绑定店铺 → 核对各站点校验结果。
本教程的截图已脱敏，不展示完整账号或明文密钥。实际绑定请填写自己的店铺信息；测试环境与正式环境的账号、密钥不同，不能混用。正式店铺请登录 Trendyol 卖家后台。
1. 授权前准备
- 准备好已开通目标海湾站点的 Trendyol 店铺，并使用卖家后台的 主账号 登录。Trendyol 官方说明，集成凭证仅主账号可见。
- 登录 海云星 ERP，确认当前公司正确，账号有查看和绑定 Trendyol 店铺的权限。
- 确认实际使用的站点及物流协议。一个 Seller ID 在 ERP 中绑定为一家店铺，SA、AE、KW 在这家店铺下分别管理。
2. 在 Trendyol 后台获取授权信息
- 登录 Trendyol 卖家后台，核对右上角当前店铺。
- 点击右上角 店铺名称 / 头像，在菜单中选择 Account details（账户信息）。
- 在账户信息页打开 Integration details（集成信息）。
- 开启 Do you work with a marketplace integrator?（是否使用集成服务商） 后，会弹出 Edit integrator information（编辑集成商信息）。已经显示集成凭证卡片时，可直接继续下一步。
在弹窗中按下表填写：
| 字段 | 操作说明 |
|---|---|
| Name of the integrator you work with | 填写 Haiyunxing，即海云星 ERP 的英文服务商名称。 |
| Integration management service | 展开下拉框，将服务类型 全部勾选。 |
确认名称填写正确、服务类型已全部勾选后，点击 Save（保存）。保存成功后，再查看下面的集成凭证卡片并复制授权信息。
- 找到下图中的集成凭证卡片，通过各字段右侧的复制按钮，分别复制 Seller ID (Entity ID)、API key、API secret，填写到下一步 ERP 中名称对应的输入框。部分页面也将 Seller ID 标为 Supplier ID，或在左侧店铺卡片展示。
按下表对应填写：
| Trendyol 后台字段 | 海云星 ERP 对应字段 |
|---|---|
| Seller ID (Entity ID) | Seller ID，复制卖家编号，填写纯数字。 |
| API key | API Key。 |
| API secret | API Secret。 |
| Integration reference code | 绑定店铺时无需填写。 |
| Token | 绑定店铺时无需填写。 |
ERP 绑定使用前三项；API Secret 应复制 API secret 的值，请勿用 Token 或登录密码代替。
三项信息必须来自 同一家店铺、同一个环境。请勿把 API Key、API Secret 发到公开群聊或公开文档；提交问题截图时也应遮挡密钥。
3. 在海云星 ERP 绑定店铺
进入 店铺管理 → 店铺账号，切换到 Trendyol 店铺 页签，点击 绑定新店铺。
按下表填写：
| 字段 | 填写说明 |
|---|---|
| 店铺名称 | 自己容易辨认的名称，仅用于 ERP 内区分店铺。 |
| Seller ID | 从 Trendyol 后台复制的卖家编号，填写纯数字。 |
| API Key | 同一家店铺的 API Key。 |
| API Secret | 与 API Key 配套的 API Secret。 |
| 站点 | 勾选该店铺实际开通、需要在 ERP 使用的 SA 沙特、AE 阿联酋或 KW 科威特，可多选。 |
| 各站点物流 | 按店铺在该国家实际签订的物流协议选择 Trendyol Pays 或 Seller Pays；KW 仅支持 Trendyol Pays。 |
填写完成后点击弹窗右下角 确认，等待校验结果。
- 系统会逐一校验所选站点，至少一个站点通过 才能完成绑定。
- 部分站点未通过时，通过的站点仍可完成绑定，未通过的站点也会保留，按提示处理后再点击 校验。
- 如果密钥被拒绝，或所有站点都未通过，本次不会完成新店铺绑定；按实际错误提示检查后再试。
- API Key 和 API Secret 校验通过后加密保存，不会回显。提交后输入框被清空时，需要重新从 Trendyol 后台复制。
4. 怎样确认授权成功？
回到 Trendyol 店铺列表，核对以下内容：
| 检查项 | 应核对的结果 |
|---|---|
| 店铺名称、Seller ID | 与本次要绑定的店铺一致。 |
| 授权状态 | 显示 已授权。 |
| 店铺状态 | 需要使用时应为 启用。 |
| 站点校验结果 | 逐站点核对 已通过 / 被拒绝 / 未能校验，不能只看店铺整体授权状态。 |
查看站点的详细原因时，可打开该店铺 更多 → 详情。处理未开通、权限或临时请求失败等问题后，在列表点击 校验，再检查结果。
店铺已授权不代表三个站点全部通过，也不代表商品已经上架。 商品发布后，还需继续核对刊登结果、平台审核和在售状态。
5. 绑定后完成站点设置
在店铺所在行点击 站点设置，逐个站点检查：
- 币种、默认 VAT（%）：系统预填 SA 为 SAR / 15、AE 为 AED / 5、KW 为 KWD / 0。请按店铺实际业务核对后保存。
- 物流模式：与 Trendyol 后台的物流协议一致。Trendyol Pays 使用平台物流；Seller Pays 由卖家安排承运商并回填运单号。
- 允许上架：需要发布的站点应开启；关闭后该站点不参与发布。
- 默认发货地址、默认退货地址：选择平台已有且类型正确的地址。
绑定完成时系统会尝试同步地址。若提示地址同步失败或没有地址，先到 Trendyol 卖家后台维护发货 / 退货地址，再在 ERP 点击 更多 → 同步地址，然后回到 站点设置 选择默认地址。
每次只保存当前选中的一个站点。 需要调整多个站点时，分别打开、核对并保存。
开始整理商品前，还可以在 更多 → 默认品牌 中搜索并选择店铺品牌。默认品牌会带入之后认领的商品，商品编辑页仍可修改；仅完成店铺授权不会自动确定商品品牌。
后续开通其他海湾站点时，在原店铺使用 更多 → 添加站点，无需为同一个 Seller ID 重复绑定一家新店铺。
6. 已绑定店铺怎样更新密钥？
授权状态显示 需更新密钥，或更换了 Trendyol API 凭证后：
- 在原店铺所在行点击 更新密钥。
- 从 Trendyol 后台复制这家店铺当前的 API Key、API Secret，填写到 ERP。
- 核对弹窗中的店铺和 Seller ID。Seller ID 不能在更新密钥时更改；要连接另一卖家，应使用绑定新店铺。
- 点击 确认。系统重新校验这家店铺已有的全部站点，通过后替换原密钥。
- 返回列表，检查授权状态与逐站点校验结果，再重试原来的业务操作。
更新密钥沿用原来的站点设置。需要增加站点时，使用 更多 → 添加站点。
7. 授权常见问题
找不到 Integration details 或看不到密钥怎么办？
先确认登录的是目标店铺的主账号，再从右上角店铺菜单进入 Account details。普通成员看不到时，请店铺主账号操作；仍没有集成信息时，联系 Trendyol 核实店铺的 API 接入权限。
填写服务商名称后，保存没有完成怎么办？
先按平台提示检查必填项，确认保存成功后再查看凭证。仍停留在填写弹窗，或保存后仍未显示凭证时，联系 Trendyol 核实账号的集成开通情况；取得这家店铺的 API Key 和 API Secret 后再到 ERP 绑定。
提示拒绝 Seller ID / API Key / API Secret 怎么办？
重新核对三项信息是否来自同一家店铺，是否把 API Key 与 API Secret 填反，以及有没有复制不完整。测试账号的凭证不能用于正式店铺连接；确认无误仍被拒绝时，请联系 Trendyol 核查凭证和权限。
店铺已授权，为什么某个站点仍显示“被拒绝”？
店铺授权和站点权限需要分别核对。某个站点被拒绝时，查看该站点的具体原因，确认已在 Trendyol 开通该国家并有对应权限；平台侧处理完成后，回到 ERP 点击 校验。不要仅因一个站点被拒绝就反复更新整家店铺的密钥。
显示“未能校验”或接口触发限流怎么办？
这可能是临时请求失败、超时或限流。按提示稍后再点击 校验；首次绑定尚未完成时，重新填写并提交。持续失败时，将操作时间、目标站点及错误提示提供给管理员，不要附上明文密钥。
提示 Seller ID 已绑定怎么办？
先在当前公司的 Trendyol 店铺列表查找原店铺。已有店铺需要恢复授权时，对原记录 更新密钥；提示绑定在其他公司时，先核对当前登录的公司，并联系原绑定公司的管理员处理。
绑定成功，但认领或发布时选不到店铺怎么办？
检查 更多 → 店铺设置 中店铺是否启用，目标站点是否已通过校验，以及 站点设置 → 允许上架 是否开启。子账号还需核对角色和店铺权限，参阅 角色与权限设置。
删除 ERP 店铺会让 Trendyol 密钥失效吗？
不会。ERP 的 删除 移除本系统内的店铺绑定及凭证，不会删除 Trendyol 平台商品，也不会让平台的 API Key / API Secret 失效。不再使用集成时，平台侧凭证仍需由店铺主账号到 Trendyol 后台处理。
8. 官方参考
- Trendyol 接入与授权说明：凭证获取位置、主账号可见范围、测试与正式环境的区别。
- Trendyol 站点代码说明：SA、AE、KW 的站点代码与税率信息。