Shopee 连接器配置

Odoo 允许用户在数据库中同步 Shopee 卖家账户，但用户 必须 在完成配置前拥有已注册的 Shopee 卖家账户 和 Shopee Open 账户。

首先访问 Shopee Open 平台，点击页面中部的 Get Access (Now) 按钮，以创建 Open Shopee 账户。

使用 Open Shopee 开发者指南，按照注册流程操作。完成后，按照以下说明在 Odoo 中注册并链接 Open Shopee 账户。

:::: important ::: title 重要 :::

Shopee Open 平台的访问权限和卖家账户要求 因地区而异。这意味着规则、资格和流程在不同国家/地区会有所不同。在进行 Odoo 的 Shopee 连接器设置前，请先确认 您所在 Shopee 区域的要求。

关键考虑因素：

  • Shopee 卖家状态 & 业务类型： 必须拥有有效的 Shopee 卖家账户（个人或已注册企业）。资格取决于所在地区及企业登记情况。
  • 订单量/卖家等级（如适用）： 许多地区要求在特定时间内达到最低订单量或达到某一卖家等级（如 Mall、Preferred、Managed）才能使用 Open 平台。

操作要求：

  1. 确认您的 Shopee 区域。
  2. 查找该区域的官方 Shopee 文档。Open Shopee 开发者指南
  3. 仔细阅读您所在地区对卖家账户及 Open 平台访问的要求。
  4. 确保您的 Shopee 账户满足所有必要条件 后 再进行 Odoo Shopee 连接器的配置。 ::::

在 Apps 中 Install <general/install> Shopee Connector（[sale_shoppe]）。

随后在 Sales 应用 --> Configuration --> Shopee --> Accounts 中连接您的 Shopee Open 账户。

点击 New 创建并链接新的 Shopee 账户。

在 Credentials 选项卡中，从下拉菜单中选择合适的 API Endpoint。

:::: note ::: title 注意 :::

Shopee 提供多个用于生产与测试的 API 端点。选择正确的端点对成功集成至关重要，请根据您的市场所在地选择对应的端点。

  • Shopee Production Endpoint (Singapore)：大多数亚太地区卖家的主要端点。除中国大陆或巴西外，建议使用此选项。
  • Shopee Production Endpoint (China)：仅供在中国大陆运营的卖家使用，符合当地法规与业务惯例。
  • Shopee Production Endpoint (Brazil)：专为巴西卖家设置。如您的店铺位于巴西，请选择此端点。
  • Shopee Testing Endpoint：仅用于开发与测试，模拟与 Shopee API 的交互，不会影响真实数据。生产环境请勿使用。
  • Shopee Testing Endpoint (China)：针对中国生产端点的专用测试环境，同样仅用于测试，勿用于生产。 ::::

在 Credentials 表单中选择正确的 API 端点后，分别在对应字段填写 Open Shopee 的 Partner ID 与 Partner Key，随后点击 Save And Authorize。

:::: important ::: title 重要 :::

完成此步骤需要您的 Open Shopee Partner ID 与 Partner Key。以下是在 Shopee Open 平台获取它们的方法：

  1. 登录 Shopee Open 平台： 使用注册 Open Shopee 账户时的凭证登录 此处。
  2. 进入 App Management： 前往 App Management，再选择 App List。
  3. 选择您的应用： 选中要与 Odoo 同步的应用（测试或生产）。
  4. 获取凭证： 在应用详情页即可看到 Partner ID 与 Partner Key，复制后粘贴到 Odoo 对应字段中。 ::::

:::: note ::: title 注意 :::

  • 仔细复制： 确保 Partner ID 与 Partner Key 完全准确，不能有额外空格或字符，且区分大小写。
  • 妥善保管密钥： Partner Key 属于敏感信息，请勿泄露，视同密码处理。 ::::

在完成 Shoppe Seller account to Odoo <shopee/setup> 的连接后，即进入授权流程。

点击 Save and Authorize 后，Odoo 会跳转至 Shopee 卖家账户选择页面。

  • 已登录： 若已登录 Shopee 账户，会显示您的邮箱或用户名，直接点击即可继续。
  • 未登录： 若未登录，系统会提示输入欲连接的 Shopee 卖家账户的邮箱/用户名及密码。

选择或登录卖家账户后，将进入授权（同意）页面。确认您同意 Shopee 将账户及相关数据授权给 Odoo，这一步是集成正常运行的前提。

授权完成后，Shopee 会将您重定向回 Odoo，并出现指示标识，表明 Shopee 账户已成功注册。

返回 Odoo 后，请执行以下操作：

  1. 重命名 Shopee 账户（可选）： 默认名称可改为更具描述性的名称（如您的 Shopee 店铺名），便于管理。
  2. 设置最近订单同步日期： 该设置决定从何时开始从 Shopee 拉取订单，可自行选择起始日期。
  3. 配置库存同步： 是否在 Odoo 与 Shopee 之间同步产品库存。启用 Synchronize Inventory 可自动将 Odoo 库存更新推送至 Shopee；关闭则不自动更新。
  4. 指定默认销售团队： 为该 Shopee 账户分配默认销售团队，便于报表与订单管理。

成功注册 Shopee 账户后，可在同一账户下的其他市场同样方式同步，并在 Shops 按钮下列出。

Shopee 订单同步后，仅在 Odoo 销售订单中生成商品行，每一行对应 Shopee 上售出的商品。

后续可使用 Shopee 的每周/每月财务报表进行运费、收入与费用的价格对账，并将报表导入 Odoo 会计 应用。

订单项的数据库产品通过匹配其 Internal Reference（Odoo 中可自定义的产品参考标识，如 [FURN001]）与 Shopee SKU 来确定。

若未找到匹配的内部参考，则使用默认数据库产品 Shopee Item。

:::: note ::: title 注意 :::

要修改默认产品，请激活 developer mode <developer-mode>，进入 Sales app --> Configuration --> Settings，在 Connectors 区块的 Shopee Sync 中找到 Default Products。 ::::

为实现 Shopee 销售的税务报表，订单项的税务遵循产品本身设定的税或由 fiscal position <../../../finance/fiscal_localizations> 决定。

请确保 Odoo 中的产品已设置正确的税率，或通过财务位置进行配置，以避免 Odoo 与 Shopee Seller Central 之间的小额税额差异。

:::: note ::: title 注意 :::

由于 Shopee 的税务规则可能与 Odoo 不完全一致，Odoo 与 Shopee Seller Central 的订单总额可能会出现几分钱的差异。可在 Odoo 对账时通过冲销处理这些差异。 ::::

添加新市场的步骤如下：

  1. 进入 Shopee 账户页面： Sales --> Configuration --> Accounts。
  2. 创建新 Shopee 账户： 点击 New 新建市场账户。
  3. 选择 API 端点： 为本地市场选择合适的 API 端点（通常使用 Shopee Production Endpoint (Singapore)，除非在中国大陆或巴西）。
  4. 填写凭证： Partner ID 与 Partner Key 与您唯一的 Open Shopee 账户绑定，填入对应字段。
  5. 命名店铺： 为新店铺起一个易辨识的名称（如 [Shopee Philippines]）。
  6. 分配销售团队： 指定相应的销售团队（如 [Shopee Sales Philippines]），以获得高级报表功能。
  7. 同步账户： 若现有市场列表中未出现新市场，点击 Log in with another account 进行同步，此操作将启动 Shopee 授权流程。

新添加的市场会自动加入已同步市场列表。如同步后列表中仍未出现，说明该市场可能不兼容 Shopee Open 平台或不适用于您的卖家账户，请参考 Shopee Open 平台文档或联系客服获取帮助。

:::: important ::: title 重要 :::

虽然 Odoo 允许多次创建相同的 Shopee 店铺，但因 token 限制只能有一个实例正常工作。为避免订单管理混乱，请每个店铺仅同步一次。若需更新连接，先手动抓取订单后再重新建立连接。 ::::

::: seealso

  • Shopee supported features and marketplaces <../shopee_connector> - manage :::