Shopee虾皮连接器¶
Odoo 允许用户与数据库中的 Shopee 卖家账户同步,但在完成配置之前,用户 必须 拥有已注册的 Shopee 卖家账户 和 Shopee 开放平台账户。
首先前往 Shopee 开放平台,点击页面中间的 立即获取访问权限 按钮,创建 Shopee 开放平台账户。
使用 Shopee 开放平台开发者指南,按流程完成注册。完成后,按以下说明在 Odoo 中注册并关联 Shopee 开放平台账户。
重要
Shopee 开放平台的访问权限以及卖家账户要求 因地区而异。也就是说,规则、资质和流程在不同国家各不相同。在继续配置 Odoo 的 Shopee 连接器之前,请先确认 您 所在 Shopee 地区的具体要求。
关键注意事项:
Shopee 卖家状态与业务类型: 您必须拥有有效的 Shopee 卖家账户(个人或已注册企业)。是否符合资格取决于您所在的地区以及企业注册情况。
订单量/卖家等级(如适用): 许多地区要求在指定时间范围内达到最低订单量,或达到某个卖家等级(例如 Mall、Preferred、Managed),才能使用开放平台。
需要执行的操作:
确认您的 Shopee 所在地区。
查找所在地区的 Shopee 官方文档。打开 Shopee 开发者指南
仔细查阅您所在地区关于卖家账户和开放平台访问权限的要求。
在继续配置 Odoo Shopee 连接器 之前,请确保您的 Shopee 账户满足所有必要条件。
将 Shopee 卖家账户连接至 Odoo¶
转到 ,以便 安装 Shopee Connector (sale_shoppe)模块。
随后导航至 来连接您的 Shopee Open 账户。
在此处点击 新建,创建并关联新的 Shopee 账户。
然后在 凭据 标签页中,从下拉菜单里选择合适的 API 端点 。
注解
Shopee 为生产环境和测试环境提供了多个 API 端点。选择正确的端点对成功集成至关重要。请选择与您所在市场地区对应的端点。
Shopee 生产端点(新加坡) :这是大多数亚太地区国家使用的主要端点。除非您专门在中国大陆或巴西开展业务,否则请选择此选项。
Shopee 生产端点(中国) :此端点仅供在中国大陆境内经营的卖家使用,旨在符合当地的法规和商业惯例。
Shopee 生产端点(巴西) :此端点专供在巴西境内经营的卖家使用。如果您的 Shopee 店铺位于巴西,请选择此选项。
Shopee 测试端点 :此端点仅用于开发和测试目的。您可以使用它模拟与 Shopee API 的交互,而不会影响线上数据。请勿将此端点用于生产环境。
Shopee 测试端点(中国) :与通用测试端点类似,此端点专门用于测试与中国专用生产端点相关的集成。请勿将此端点用于生产环境。
在 凭据 表单中选择正确的 API 端点后,在相应字段中输入您的 Open Shopee 合作伙伴 ID 和 合作伙伴密钥 。然后点击 保存并授权 。
重要
完成此步骤需要您的 Open Shopee 合作伙伴 ID 和 合作伙伴密钥 。以下是在 Shopee Open Platform 中找到它们的方法:
登录 Shopee Open Platform: 使用您注册 Open Shopee 账户时所用的凭据 登录 。
导航至 App Management: 转到 App Management 部分,然后选择 App List 。
选择您的应用: 选择您要与 Odoo 同步的具体应用(您的测试应用或生产应用均可)。
查找您的凭据: 在应用详情中,您可以找到合作伙伴 ID 和合作伙伴密钥。这些就是您需要复制并粘贴到 Odoo 相应字段的值。
注解
仔细复制: 准确复制合作伙伴 ID 和合作伙伴密钥,不得带有多余的空格或字符。这些值区分大小写。
妥善保管密钥: 您的合作伙伴密钥属于敏感信息,请勿与任何人共享,并像对待密码一样保管它。
Shopee 卖家账户的选择/登录¶
点击 保存并授权 后,Odoo 会跳转到 Shopee 卖家账户选择页面。
已登录: 如果您已经登录了某个 Shopee 账户,页面会显示您的电子邮箱地址或用户名。点击您的账户即可继续。
未登录: 如果您尚未登录,系统会提示您输入要连接至 Odoo 的 Shopee 卖家账户的凭据(电子邮箱/用户名和密码)。
授予 Odoo 访问权限¶
在选择或登录您的 Shopee 卖家账户后,您将被引导至授权(或同意)页面。请在此确认允许 Shopee 授予 Odoo 访问您的账户及相关数据的权限。此步骤对于集成的正常运行至关重要。
账户注册与 Shopee 店铺创建¶
确认访问权限后,Shopee 会将您重定向回 Odoo。此时会出现一个指示标志,确认您的 Shopee 账户已成功注册。
同步后的配置¶
重定向完成后,您应在 Odoo 中执行以下步骤:
重命名 Shopee 账户(可选): Odoo 中新建的 Shopee 账户通常会带有默认名称。您可以将其重命名为更具描述性的名称(例如您的 Shopee 店铺名称),以便于管理。
设置最后订单同步日期: 此设置决定了从 Shopee 获取订单的起始时间点。请选择一个日期,作为 Odoo 拉取历史订单的起点。
配置库存同步: 决定是否在 Odoo 与 Shopee 之间同步您的产品库存。启用 同步库存 选项可自动将库存更新从 Odoo 推送到 Shopee。禁用此选项则不会自动更新库存。
分配默认销售团队: 在 Odoo 中为您的 Shopee 账户分配一个默认销售团队。这有助于报告与订单管理。
Shopee 账户注册成功后,该账户可用的其他市场也可以按完全相同的方式同步,并会列在 店铺 按钮下。
Odoo 中的 Shopee 订单¶
同步 Shopee 订单时,Odoo 的销售订单中只会为商品创建明细行,每行代表一件在 Shopee 上售出的产品。
与运费或收入对费用相关的任何必要价格调节,可以稍后使用 Shopee 的每周/每月财务报表来处理,这些报表随后可导入 Odoo 的 会计 应用。
为销售订单明细选择数据库产品时,是通过将其 编码 (Odoo 中可自定义的产品引用标识,如 FURN001)与 Shopee 的 SKU 进行匹配来完成的。
如果某个 Shopee SKU 找不到内部参考匹配的数据库产品,则使用默认数据库产品 Shopee 商品。
注解
若要修改默认产品,请激活 开发者模式 ,并导航至 。在 连接器 部分中,于 Shopee 同步 下找到 默认产品 。
产品税配置¶
为了让 Shopee 销售能在 Odoo 中正常报税,销售订单行上的税额取产品上设置的税,或由 税务规则 决定。
请确保在 Odoo 中为产品设置正确的税额,或交由税务规则决定,以避免 Shopee 卖家中心 与 Odoo 的小计出现差异。
注解
由于 Shopee 不一定会应用与 Odoo 相同的税额,Odoo 与 Shopee 卖家中心 的订单总额偶尔会相差几分钱。在 Odoo 中对账付款时,可以通过核销来处理这些差额。
加入新市集¶
若要添加新的市场,请按照以下步骤操作:
导航至 Shopee 账户: 转到 。
创建新的 Shopee 账户: 点击 新建 以创建新的 Shopee 市场账户。
选择 API 端点: 为您的本地市场选择合适的 API 端点。(通常应选用 Shopee 生产端点(新加坡) ,除非您在中国大陆或巴西开展业务。端点选择的详细信息请参阅相关文档)。
输入凭据: 您的 合作伙伴 ID 和 合作伙伴密钥 与关联到您唯一的 Open Shopee 账户的值相同。请在相应字段中输入这些值。
为店铺命名: 为新店铺设置一个具有描述性的名称(例如
Shopee Philippines),以便日后识别。分配销售团队: 分配一个相关的销售团队(例如
Shopee Sales Philippines),以启用高级报告功能。同步您的账户: 如果列表中没有显示您现有的任何市场,请点击 使用其他账户登录 来同步新的市场。这将启动 Shopee 授权流程。
自动同步¶
新添加的市场会自动加入已同步市场的列表。如果某个新市场在同步后 未 出现在列表中,说明该市场与 Shopee Open Platform 不兼容,或对您的特定卖家账户不可用。请查阅 Shopee Open Platform 文档或联系其支持团队以获取更多帮助。
重要
虽然 Odoo 允许多次创建同一个 Shopee 店铺,但由于令牌限制,只有一个实例能够正常运作。为避免订单管理问题,每个店铺只同步一次。若需更新连接,请先手动获取订单,再重新建立连接。
本站校对说明
本篇《Odoo 20.0 documentation》翻译自 Odoo 20.0 企业版官方文档。销售链路的术语按国内业务习惯统一:lead 译为「线索」、opportunity 译为「商机」、quotation 译为「报价单」,订单状态流转的描述保持与系统界面按钮一致,便于照着点。文中的字段名与必填项已核对 20.0 版本的默认配置,若你的数据库改过销售流程或加了审批节点,实际界面会与本页略有差异。涉及报价转订单、折扣审批与回款核销的常见配置,可在本站销售专题中查阅。以官方英文版为准。
内容源自 Odoo S.A. 官方文档,依 CC BY-SA 4.0 许可翻译与校对,版权归 Odoo S.A.。本站为第三方中文文档站点,非 Odoo 官方网站。遇到与官方表述冲突之处,请以 odoo.com 官方文档 为准;版本选型可参考 社区版与企业版对比。