进行平台授权

更新时间：2026-09-17

1. 操作场景

平台授权用于把电商平台店铺与 GWMS 建立连接。授权成功后，GWMS 才能识别该店铺，并根据平台返回的数据同步订单、商品或库存信息。后续处理平台订单、下发仓库、查看订单同步日志时，系统都会使用这里维护的店铺授权记录。

平台授权只负责建立连接，不等同于订单已经下发仓库。订单同步到 GWMS 后，还需要在 GWMS-平台管理-平台订单 中确认订单、SKU 映射和下发结果。

适用人群：

• 账号管理员
• 店铺运营人员
• 负责平台订单履约的业务人员

适用场景：

1. 首次把店铺接入 GWMS。
2. 店铺授权失效，需要重新授权。
3. 平台更换令牌、更新授权范围或更换店铺管理员账号后，需要重新连接。
4. 店铺已经在平台侧正常经营，需要把已付款待发货订单同步到 GWMS 处理。

不适用场景：

1. 只想修改店铺显示名称，可在列表中使用【编辑】处理，不需要重新走整套授权。
2. 店铺已经停用且暂不继续同步数据，不需要重复新增授权。

2. 操作指引

前提条件

请提前确认以下条件：

1. 权限要求：当前账号可访问 GWMS-平台管理-店铺授权。
2. 账号要求：已准备好目标平台的店铺管理员账号，且该账号有安装应用、授权第三方系统或生成凭证的权限。
3. 验证要求：如果平台账号开启了短信、邮箱或身份验证，请提前准备好验证码接收方式。
4. 浏览器要求：浏览器允许打开新窗口或新标签页，否则点击【前往授权】后可能看不到平台授权页。
5. 命名要求：同一平台下【店铺名称】不能重复。该名称用于 GWMS 内部识别店铺，可按店铺简称、站点或业务组命名。

授权流程

平台授权一般按下面流程处理：

Wayfair 使用填写凭证的方式，直接按 2.8 Wayfair 店铺授权 操作，不经过下面的跳转授权流程。

1. 在 GWMS 新增店铺授权记录，填写店铺名称和平台要求的基础信息。
2. 点击【前往授权】，系统跳转到第三方平台登录页或授权确认页。
3. 使用店铺主账号或有授权权限的账号登录第三方平台。
4. 在第三方平台确认授权范围。
5. 返回 GWMS 平台授权列表，确认店铺记录、授权状态和授权时间。
6. 进入平台订单或订单同步日志，检查后续订单同步结果。

2.1 进入店铺授权页面

菜单路径：GWMS-平台管理-店铺授权

1. 进入页面后，可按【店铺名称】、【平台】、【店铺状态】、【授权状态】筛选已有店铺。
2. 点击【添加授权】。
3. 在弹窗中先选择【平台】，再填写【店铺名称】和页面要求的授权字段。

进入列表后，页面会显示【平台】【店铺名称】【国家/地区】【店铺状态】【授权状态】【授权时间】等信息。

字段填写说明：

1. 【平台】：选择需要接入的电商平台。不同平台显示的字段不同，请按页面实际字段填写。
2. 【店铺名称】：GWMS 内部展示名称，不需要与平台店铺名称完全一致，但建议能区分站点和业务归属。
3. 【国家/地区】：用于区分店铺站点或市场。部分平台会自动带出，部分平台需要在授权页选择。
4. 【前往授权】：点击后会离开 GWMS 当前弹窗，进入第三方平台页面。请不要关闭第三方平台页面，直到平台提示授权完成或返回 GWMS。

2.2 Shopify 店铺授权

操作前状态：店铺尚未接入 GWMS。

1. 在新增授权弹窗中选择平台【Shopify】。
2. 填写【店铺名称】。
3. 在【二级域名】中填写 xxxxx 这一段。当前页面会自动补全为 https://xxxxx.myshopify.com。
4. 点击【前往授权】。

5. 页面跳转到 Shopify 登录页，使用有安装应用权限的账号登录。

6. 在应用授权页点击【Install】完成授权。

7. 返回 GWMS 后，在列表中确认店铺已生成授权记录，并检查【授权状态】是否正常。

授权完成后，Shopify 店铺的订单同步结果可在 GWMS-平台管理-平台订单 或 GWMS-平台管理-订单同步日志 中查看。

2.3 Amazon 店铺授权

操作前状态：已准备好 Amazon 卖家账号。

1. 在新增授权弹窗中选择平台【Amazon】。
2. 填写【店铺名称】。
3. 当前页面会按页面规则带出【国家/地区】信息，无需额外手工补充未显示字段。
4. 点击【前往授权】。

5. 页面跳转到 Amazon 登录页后，输入账号并继续登录。请确认当前登录的是本次授权的店铺账号；如果不是，请先切换到正确账号。

6. 登录成功后，按页面提示确认授权。

7. 返回 GWMS 后，在列表中确认授权状态正常。

如果 Amazon 登录页提示账号地区或店铺权限不匹配，请先在 Amazon 页面切换到正确卖家账号，再重新点击 GWMS 的【前往授权】。

2.4 Amazon VC 店铺授权

操作前状态：已准备好 Amazon Vendor Central 账号。

1. 在新增授权弹窗中选择平台【Amazon VC】。
2. 填写【店铺名称】。
3. 按页面要求选择【订单模式】。当前页面支持 PO 和 DF 两种模式，可按业务需要勾选。
4. 点击【前往授权】。

5. 页面跳转到 Amazon 登录页后，输入账号并继续登录。请确认当前登录的是本次授权的店铺账号；如果不是，请先切换到正确账号。

6. 登录成功后，按页面提示确认授权。

7. 返回 GWMS 后确认店铺已出现在授权列表中，并检查所选【订单模式】是否符合当前业务。

2.5 TikTok 店铺授权

操作前状态：已准备好 TikTok Shop 管理员账号。

1. 在新增授权弹窗中选择平台【TikTok】。
2. 填写【店铺名称】。
3. 按页面显示确认授权站点等信息后，点击【前往授权】。

4. 页面跳转到 TikTok 授权页后，先按店铺账号类型展开对应分组，再选择店铺所在国家或地区，然后点击【Next】继续。

5. 进入 TikTok 卖家入口页后，如果当前店铺已经有卖家账号，请点击页面里的【Log in】进入登录页。

6. 在 TikTok 登录页输入手机号或邮箱账号和密码，使用店铺主账号登录。如果当前浏览器已登录店铺账号，页面会直接进入下一步授权确认页。

7. 登录后，按页面提示继续授权。

8. 返回 GWMS 后确认列表中已生成店铺授权记录。

TikTok 会先选择店铺所在国家或地区，再进入登录和授权确认。若登录后没有进入授权确认页，请检查当前账号是否属于所选国家或地区的 TikTok Shop 店铺。

2.6 Temu 店铺授权

操作前状态：已准备好 Temu 店铺管理员账号。

1. 在新增授权弹窗中选择平台【Temu】并点击【前往授权】。
2. 系统会进入 Temu 授权确认页。
3. 在确认页填写【店铺名称】和【店铺代码】。
4. 勾选授权协议后，点击【同意并完成授权】。
5. 授权完成后返回 GWMS，确认列表中已生成店铺授权记录。

Temu 当前不是手工粘贴 access_token 的旧方式，需按页面跳转后的授权确认流程完成。

当前缺少 Temu 授权确认页的真实截图，待人工补充。

2.7 eBay 店铺授权

操作前状态：已准备好 eBay 店铺账号。

1. 在新增授权弹窗中选择平台【eBay】。
2. 填写【店铺名称】。
3. 点击【前往授权】。

4. 页面跳转到 eBay 登录页后，使用对应店铺账号登录。

5. 进入授权确认页后，按页面提示完成授权。若当前浏览器先进入安全验证页，请先完成验证，再继续后续授权。

6. 返回 GWMS 后确认授权成功。

eBay 授权过程中可能出现账号安全验证或二次确认页面。完成验证后继续授权即可，不需要回到 GWMS 重新新增店铺。

2.8 Wayfair 店铺授权

Wayfair 的订单、发货等功能需要先完成沙箱测试，才能开通对应的生产权限。GWMS 提供两种【接入方式】：

• 【Sandbox 测试】：帮助您完成开通权限所需的测试。填写沙箱凭证后，GWMS 自动测试订单查询、订单确认和发货通知等功能，无需逐项手动测试。此操作不会保存正式店铺授权。
• 【Production 授权】：对应生产权限开通后，使用生产凭证连接真实店铺，用于正式订单同步和发货处理。已有生产权限的店铺可直接选择此项。

请确认 GWMS 账号可【添加授权】，Wayfair 账号可管理应用。测试前，在 Wayfair 创建 Sandbox 和 Production 两种应用，分别保存 Client ID 和 Client Secret，并准备供应商编号 SUID；两套凭证不能混用。已有生产凭证可从 2.8.4 开始。

在【添加授权】中选择【Wayfair】-【Sandbox 测试】，填写供应商 ID 和 Sandbox 凭证，点击【开始沙箱测试】。测试通过后，到 Wayfair 确认对应生产权限已开通，再使用 Production 凭证完成 2.8.6 的正式授权。

2.8.1 进入开发者门户

登录 Wayfair Partner Home。

1. 展开【集成（Integration）】。
2. 点击【开发者门户（Developer Portal）】。

2.8.2 创建生产应用

1. 点击【Application Management】。
2. 点击【Create New Application】。

在新建应用弹窗中填写：

1. 填写【App Name】，例如 GWMS-Production；【App Description】可填写用途。
2. 选择【Production Application】。
3. 点击【Save & Create】，生成应用凭证。

2.8.3 保存凭证

1. 点击【Copy Client ID】并保存。
2. 点击【Copy Client Secret】，安全保存完整密钥。
3. 点击【Next】进入权限页。

离开页面后，Client Secret 不能再次直接查看或复制，请及时保存。

2.8.4 检查权限

1. 进入【Permissions】。
2. 核对【Purchase Order Read】等订单、发货、库存权限是否勾选。
3. 点击【Save】。

生产权限需通过对应的 Sandbox 测试后开放。灰色锁定或未勾选的项目表示未授权。

2.8.5 获取 SUID

SUID 即 Supplier ID，请使用与生产应用对应的供应商编号。

旧版后台进入【Supplier Integration Status】，选中供应商；点击对应业务的【View/Update】可打开右侧面板。

1. 【Supplier】：名称前的编号即 SUID。
2. 【Available Suppliers】：右侧编号也是对应供应商的 SUID。

新版后台若没有该页面，请从 Wayfair 开店邮件中查找 SUID；无法确认时联系 Wayfair 支持。

2.8.6 在 GWMS 保存授权

1. 展开【平台管理】。
2. 点击【店铺授权】。
3. 点击【添加授权】。

1. 【平台】选择【Wayfair】。
2. 【接入方式】选择【Production 授权】。
3. 填写【店铺名称】，同一平台下不能重复。

向下滚动弹窗：

1. 【供应商ID】：填写 SUID。
2. 【客户端ID】：粘贴生产应用的 Client ID。
3. 【客户端密钥】：粘贴同一应用的 Client Secret。
4. 点击【保存生产授权】。校验通过后，弹窗关闭，列表显示店铺授权记录。

图中为示例数据，请填入自己的店铺信息和凭证。

2.9 Walmart 店铺授权

授权前，请确认 Walmart 账号可查看店铺密钥，GWMS 账号可【添加授权】。本流程使用生产凭证 ClientId 和 ClientSecret 连接店铺，不使用 Sandbox Keys。

2.9.1 进入密钥管理

登录 Walmart Seller Center，点击右上角齿轮图标，进入【Account】。

向下滚动左侧菜单，在【API】下点击【Consumer ID and Private Keys】。

在【API Integration】页面点击【API Key Management】，进入 Walmart Developer Portal。

2.9.2 复制生产凭证

在【API Keys】中选择【Production Keys】，找到【My API Key】，分别复制同一组【ClientId】和【ClientSecret】。若密钥被隐藏，点击眼睛图标查看后复制。

请妥善保管密钥，不要为了复制凭证点击【Reset】或【Delete】。若密钥已重置，需在 GWMS 中【更新授权】并填入新凭证。

2.9.3 在 GWMS 添加授权

1. 进入【平台管理】-【店铺授权】。
2. 点击【添加授权】。

1. 【平台】选择【Walmart】，填写用于区分店铺的【店铺名称】。
2. 【站点】当前固定为【美国 (US)】，无需选择。
3. 【Client ID】【Client Secret】分别粘贴上一步复制的同一组生产凭证。
4. 【自动接单】默认【关闭】，可手动接单；选择【开启】后，系统会在订单保存成功后自动确认平台未接单订单。平台已确认的订单仍正常同步，不会重复确认。
5. 点击【立即授权】。校验通过后，弹窗关闭，列表显示店铺授权记录。

图中为示例数据，请填写自己的凭证。若授权失败，请检查两项凭证是否完整、来自同一组 Production Keys；授权后可在【平台订单】和【订单同步日志】查看同步结果。

2.10 查看授权结果并继续维护店铺

完成第三方平台授权后，请回到 GWMS-平台管理-店铺授权 检查结果。

建议按下面顺序确认：

1. 刷新列表，确认已生成对应店铺记录。
2. 查看【授权状态】是否正常。
3. 查看【授权时间】是否更新为本次操作时间。
4. 如页面支持【刷新令牌】或【更新授权】，按当前状态决定是否继续处理。

正常情况下，店铺记录生成后，系统会开始后续同步。后续如需同步订单，可继续进入 GWMS-平台管理-平台订单 或 GWMS-平台管理-订单同步日志 查看结果。

如果列表中已经生成店铺记录，但订单长时间没有同步到平台订单列表，请进入 GWMS-平台管理-订单同步日志，按店铺、平台和同步时间查看是否存在失败记录。

3. 补充说明

3.1 列表字段和状态

• 【店铺状态】：用于控制该店铺是否继续参与同步。列表中可对店铺执行【启用】或【停用】。
• 【授权状态】：用于表示当前授权是否正常。若状态异常，请优先检查是否需要【刷新令牌】或【更新授权】。
• 【授权时间】：显示该店铺最近一次授权完成时间。
• 【国家/地区】：用于区分店铺所属站点或市场。部分平台会自动带出，部分平台需要手工选择。

3.2 列表操作说明

• 【更新授权】：适用于平台要求重新确认授权、授权范围变化、店铺管理员账号变更等场景。
• 【刷新令牌】：适用于令牌接近过期或授权状态异常时的快速刷新。若刷新后系统提示“请更新授权”，需要重新走授权流程。
• 【编辑】：当前主要用于修改店铺名称，不会重新发起平台授权。
• 【删除】：删除后，该店铺的授权记录会从当前列表移除。

3.3 命名和同步规则

1. 同一平台下不能存在重复的【店铺名称】。
2. 平台授权成功后，系统会开始后续的异步同步处理。
3. 如果店铺已经授权，但长时间没有同步结果，可结合 GWMS-平台管理-订单同步日志 检查后续同步情况。
4. 如果只是更换店铺显示名称，优先使用【编辑】；不要重复新增同一店铺授权。

4. 常见问题

Q1：授权成功后，多久能在 GWMS 看到订单或店铺数据？

A1：授权成功后，系统会启动后续同步处理。不同平台的返回速度不同，实际看到订单或商品数据的时间，以平台返回和 GWMS-平台管理-订单同步日志 为准。

Q2：授权状态异常时，应该先点【刷新令牌】还是【更新授权】？

A2：建议先尝试【刷新令牌】。如果刷新后系统仍提示需要重新授权，或平台侧已经变更授权信息，再使用【更新授权】重新完成整套授权流程。

Q3：同一平台可以授权多个店铺吗？

A3：可以。但同一平台下【店铺名称】不能重复。新增前请先确认当前列表中没有同名店铺。

Q4：停用店铺和删除店铺有什么区别？

A4：停用是保留授权记录，但不继续使用该店铺参与后续同步；删除是移除当前授权记录。需要保留历史识别信息时，优先使用停用。

Q5：点击【前往授权】后没有弹出第三方平台页面，怎么处理？

A5：先检查浏览器是否拦截了新窗口或新标签页，再确认当前浏览器是否允许弹窗。如果浏览器已拦截，放开拦截后重新点击【前往授权】。如果页面仍然没有打开，再检查当前账号是否有对应平台的授权权限。

Q6：第三方平台已经提示授权成功，但 GWMS 列表状态还是异常，怎么处理？

A6：先回到 GWMS-平台管理-店铺授权 刷新列表，确认【授权时间】是否已更新。若授权时间已更新但【授权状态】仍异常，建议先点击【刷新令牌】；如果系统仍提示需要重新授权，再点击【更新授权】重新完成整套流程。

Q7：Wayfair 只显示【开始沙箱测试】，找不到保存授权按钮，怎么办？

A7：将【接入方式】切换到【Production 授权】，即可显示【店铺名称】和【保存生产授权】。

Q8：SUID 和 Client ID 是同一个值吗？

A8：不是。SUID 填入【供应商ID】，Client ID 填入【客户端ID】，两者不能混用。

Q9：没有保存 Wayfair Client Secret，还能再次复制吗？

A9：需要由应用管理员轮换密钥，再在 GWMS【更新授权】中填写新凭证；其他使用该密钥的系统也需同步更新。

Q10：Wayfair 生产授权失败，或者保存后仍不能同步，先检查什么？

A10：核对生产凭证是否完整、来自同一应用，SUID 是否匹配，所需生产权限是否开放。授权成功但未同步时，查看【平台管理-订单同步日志】中的失败原因。