用途
本技能用于指导将 Odoo 与 Shopify 打通，同步商品目录、实时库存水平、入站订单与客户数据。资料给出的适用场景包括：在 Shopify 上销售同时在 Odoo 中管理库存；由 Shopify 购买自动生成 Odoo 销售订单；保持 Odoo 库存水平与 Shopify 商品可售量同步；将 Shopify 商品变体映射到 Odoo 产品模板。
主要能力
资料描述其覆盖两条实现路径：使用官方 Odoo Shopify 连接器（Enterprise），或通过 Shopify REST 与 Odoo XMLRPC API 构建自定义集成。工作流程分为三步：激活（提及 @odoo-shopify-integration 并描述同步场景）、设计（给出数据流架构与字段映射）、构建（提供 Shopify Webhook 接收端与 Odoo API 调用方的代码片段）。
数据流架构
资料给出的同步方向如下：
- 商品目录：Odoo 产品模板 + 变体 ——同步到——> Shopify
- 库存水平：Odoo Stock Quants（实时）——同步到——> Shopify
- 新订单：Shopify ——推送——> Odoo 销售订单（自动确认）
- 客户：Shopify ——推送——> Odoo res.partner（若为新客户则创建）
- 履约：Odoo 已校验的交付单 ——推送——> Shopify
使用方式
资料提供两个示例。示例一为用 Python 将 Shopify 订单推送为 Odoo 销售订单：通过 xmlrpc.client 连接 Odoo，先在 res.partner 中按邮箱查找或创建客户，再创建 sale.order，将 Shopify 订单号写入 client_order_ref，并把订单行映射为 product_id、product_uom_qty、price_unit；其中 get_odoo_product_id 按 SKU（default_code）查找 Odoo 产品 ID。示例二为使用 Flask 接收 Shopify 订单 Webhook，在 /webhook/shopify/orders 路由中解析请求并调用上述下单函数，返回 Odoo 订单 ID。
适用场景与限制
最佳实践方面，资料建议：使用 Shopify Webhook 系统实现实时订单同步而非轮询；以 SKU / 内部参考作为两系统之间的唯一匹配键；在处理任何载荷前校验 Shopify Webhook 的 HMAC 签名。同时建议不要在两个系统同时同步库存而不设定“主系统”，应选定一方作为真实来源；不要使用 Shopify 产品 ID 作为键，而应使用跨平台稳定的 SKU。
限制方面，资料说明：仅当任务明确符合上述范围时才使用此技能；输出不应替代针对具体环境的验证、测试或专家评审；若缺少必需输入、权限、安全边界或成功标准，应停止并请求澄清。此外，资料未提供官方连接器的具体安装步骤、版本要求、价格与收费信息。