Shopee虾皮连接器

Odoo 允许用户与数据库中的 Shopee 卖家账户同步,但在完成配置之前,用户 必须 拥有已注册的 Shopee 卖家账户 和 Shopee 开放平台账户。

首先前往 Shopee 开放平台,点击页面中间的 立即获取访问权限 按钮,创建 Shopee 开放平台账户。

使用 Shopee 开放平台开发者指南,按流程完成注册。完成后,按以下说明在 Odoo 中注册并关联 Shopee 开放平台账户。

重要

Shopee 开放平台的访问权限以及卖家账户要求 因地区而异。也就是说,规则、资质和流程在不同国家各不相同。在继续配置 Odoo 的 Shopee 连接器之前,请先确认 您 所在 Shopee 地区的具体要求。

关键注意事项:

  • Shopee 卖家状态与业务类型: 您必须拥有有效的 Shopee 卖家账户(个人或已注册企业)。是否符合资格取决于您所在的地区以及企业注册情况。

  • 订单量/卖家等级(如适用): 许多地区要求在指定时间范围内达到最低订单量,或达到某个卖家等级(例如 Mall、Preferred、Managed),才能使用开放平台。

需要执行的操作:

  1. 确认您的 Shopee 所在地区。

  2. 查找所在地区的 Shopee 官方文档。打开 Shopee 开发者指南

  3. 仔细查阅您所在地区关于卖家账户和开放平台访问权限的要求。

  4. 在继续配置 Odoo Shopee 连接器 之前,请确保您的 Shopee 账户满足所有必要条件。

将 Shopee 卖家账户连接至 Odoo

转到 应用 ,以便 安装 Shopee Connector (sale_shoppe)模块。

随后导航至 销售应用 ‣ 配置 ‣ Shopee ‣ 账户 来连接您的 Shopee Open 账户。

在此处点击 新建,创建并关联新的 Shopee 账户。

然后在 凭据 标签页中,从下拉菜单里选择合适的 API 端点 。

注解

Shopee 为生产环境和测试环境提供了多个 API 端点。选择正确的端点对成功集成至关重要。请选择与您所在市场地区对应的端点。

  • Shopee 生产端点(新加坡) :这是大多数亚太地区国家使用的主要端点。除非您专门在中国大陆或巴西开展业务,否则请选择此选项。

  • Shopee 生产端点(中国) :此端点仅供在中国大陆境内经营的卖家使用,旨在符合当地的法规和商业惯例。

  • Shopee 生产端点(巴西) :此端点专供在巴西境内经营的卖家使用。如果您的 Shopee 店铺位于巴西,请选择此选项。

  • Shopee 测试端点 :此端点仅用于开发和测试目的。您可以使用它模拟与 Shopee API 的交互,而不会影响线上数据。请勿将此端点用于生产环境。

  • Shopee 测试端点(中国) :与通用测试端点类似,此端点专门用于测试与中国专用生产端点相关的集成。请勿将此端点用于生产环境。

在 凭据 表单中选择正确的 API 端点后,在相应字段中输入您的 Open Shopee 合作伙伴 ID 和 合作伙伴密钥 。然后点击 保存并授权 。

重要

完成此步骤需要您的 Open Shopee 合作伙伴 ID 和 合作伙伴密钥 。以下是在 Shopee Open Platform 中找到它们的方法:

  1. 登录 Shopee Open Platform: 使用您注册 Open Shopee 账户时所用的凭据 登录 。

  2. 导航至 App Management: 转到 App Management 部分,然后选择 App List 。

  3. 选择您的应用: 选择您要与 Odoo 同步的具体应用(您的测试应用或生产应用均可)。

  4. 查找您的凭据: 在应用详情中,您可以找到合作伙伴 ID 和合作伙伴密钥。这些就是您需要复制并粘贴到 Odoo 相应字段的值。

注解

  • 仔细复制: 准确复制合作伙伴 ID 和合作伙伴密钥,不得带有多余的空格或字符。这些值区分大小写。

  • 妥善保管密钥: 您的合作伙伴密钥属于敏感信息,请勿与任何人共享,并像对待密码一样保管它。

授权与账户注册

将 Shopee 卖家账户连接到 Odoo 后,授权流程随即开始。

Shopee 卖家账户的选择/登录

点击 保存并授权 后,Odoo 会跳转到 Shopee 卖家账户选择页面。

  • 已登录: 如果您已经登录了某个 Shopee 账户,页面会显示您的电子邮箱地址或用户名。点击您的账户即可继续。

  • 未登录: 如果您尚未登录,系统会提示您输入要连接至 Odoo 的 Shopee 卖家账户的凭据(电子邮箱/用户名和密码)。

授予 Odoo 访问权限

在选择或登录您的 Shopee 卖家账户后,您将被引导至授权(或同意)页面。请在此确认允许 Shopee 授予 Odoo 访问您的账户及相关数据的权限。此步骤对于集成的正常运行至关重要。

账户注册与 Shopee 店铺创建

确认访问权限后,Shopee 会将您重定向回 Odoo。此时会出现一个指示标志,确认您的 Shopee 账户已成功注册。

同步后的配置

重定向完成后,您应在 Odoo 中执行以下步骤:

  1. 重命名 Shopee 账户(可选): Odoo 中新建的 Shopee 账户通常会带有默认名称。您可以将其重命名为更具描述性的名称(例如您的 Shopee 店铺名称),以便于管理。

  2. 设置最后订单同步日期: 此设置决定了从 Shopee 获取订单的起始时间点。请选择一个日期,作为 Odoo 拉取历史订单的起点。

  3. 配置库存同步: 决定是否在 Odoo 与 Shopee 之间同步您的产品库存。启用 同步库存 选项可自动将库存更新从 Odoo 推送到 Shopee。禁用此选项则不会自动更新库存。

  4. 分配默认销售团队: 在 Odoo 中为您的 Shopee 账户分配一个默认销售团队。这有助于报告与订单管理。

Shopee 账户注册成功后,该账户可用的其他市场也可以按完全相同的方式同步,并会列在 店铺 按钮下。

Odoo 中的 Shopee 订单

同步 Shopee 订单时,Odoo 的销售订单中只会为商品创建明细行,每行代表一件在 Shopee 上售出的产品。

Odoo 中已同步的 Shopee 销售订单。

与运费或收入对费用相关的任何必要价格调节,可以稍后使用 Shopee 的每周/每月财务报表来处理,这些报表随后可导入 Odoo 的 会计 应用。

为销售订单明细选择数据库产品时,是通过将其 编码 (Odoo 中可自定义的产品引用标识,如 FURN001)与 Shopee 的 SKU 进行匹配来完成的。

如果某个 Shopee SKU 找不到内部参考匹配的数据库产品,则使用默认数据库产品 Shopee 商品。

注解

若要修改默认产品,请激活 开发者模式 ,并导航至 销售应用 ‣ 配置 ‣ 设置 。在 连接器 部分中,于 Shopee 同步 下找到 默认产品 。

产品税配置

为了让 Shopee 销售能在 Odoo 中正常报税,销售订单行上的税额取产品上设置的税,或由 税务规则 决定。

请确保在 Odoo 中为产品设置正确的税额,或交由税务规则决定,以避免 Shopee 卖家中心 与 Odoo 的小计出现差异。

注解

由于 Shopee 不一定会应用与 Odoo 相同的税额,Odoo 与 Shopee 卖家中心 的订单总额偶尔会相差几分钱。在 Odoo 中对账付款时,可以通过核销来处理这些差额。

加入新市集

若要添加新的市场,请按照以下步骤操作:

  1. 导航至 Shopee 账户: 转到 销售 ‣ 配置 ‣ 账户 。

  2. 创建新的 Shopee 账户: 点击 新建 以创建新的 Shopee 市场账户。

  3. 选择 API 端点: 为您的本地市场选择合适的 API 端点。(通常应选用 Shopee 生产端点(新加坡) ,除非您在中国大陆或巴西开展业务。端点选择的详细信息请参阅相关文档)。

  4. 输入凭据: 您的 合作伙伴 ID 和 合作伙伴密钥 与关联到您唯一的 Open Shopee 账户的值相同。请在相应字段中输入这些值。

  5. 为店铺命名: 为新店铺设置一个具有描述性的名称(例如 Shopee Philippines ),以便日后识别。

  6. 分配销售团队: 分配一个相关的销售团队(例如 Shopee Sales Philippines ),以启用高级报告功能。

  7. 同步您的账户: 如果列表中没有显示您现有的任何市场,请点击 使用其他账户登录 来同步新的市场。这将启动 Shopee 授权流程。

自动同步

新添加的市场会自动加入已同步市场的列表。如果某个新市场在同步后 未 出现在列表中,说明该市场与 Shopee Open Platform 不兼容,或对您的特定卖家账户不可用。请查阅 Shopee Open Platform 文档或联系其支持团队以获取更多帮助。

重要

虽然 Odoo 允许多次创建同一个 Shopee 店铺,但由于令牌限制,只有一个实例能够正常运作。为避免订单管理问题,每个店铺只同步一次。若需更新连接,请先手动获取订单,再重新建立连接。