Odoo ↔ Integração Shopify

Visão Geral

Esta habilidade guia você pela integração do Odoo com o Shopify — sincronizando seu catálogo de produtos, níveis de estoque em tempo real, pedidos recebidos e dados de clientes. Ela abrange tanto o uso do conector oficial Odoo Shopify (Enterprise) quanto a construção de uma integração personalizada via APIs Shopify REST + Odoo XMLRPC.

Quando Usar Esta Habilidade

• Vender no Shopify enquanto gerencia o estoque no Odoo.
• Criar automaticamente pedidos de venda no Odoo a partir de compras no Shopify.
• Manter os níveis de estoque do Odoo sincronizados com a disponibilidade de produtos no Shopify.
• Mapear variantes de produtos do Shopify para modelos de produtos do Odoo.

Como Funciona

1. Ativar: Mencione @odoo-shopify-integration e descreva seu cenário de sincronização.
2. Projetar: Receba a arquitetura do fluxo de dados e o mapeamento de campos.
3. Construir: Obtenha trechos de código para o receptor de webhook do Shopify e o chamador de API do Odoo.

Arquitetura do Fluxo de Dados

SHOPIFY                          ODOO
--------                         ----
Product Catalog <──────sync──────  Product Templates + Variants
Inventory Level <──────sync──────  Stock Quants (real-time)
New Order       ───────push──────> Sale Order (auto-confirmed)
Customer        ───────push──────> res.partner (created if new)
Fulfillment     <──────push──────  Delivery Order validated

Exemplos

Exemplo 1: Enviar um Pedido de Venda Odoo para um Pedido Shopify (Python)

import xmlrpc.client, requests

# Odoo connection
odoo_url = "https://myodoo.example.com"
db, uid, pwd = "my_db", 2, "api_key"
models = xmlrpc.client.ServerProxy(f"{odoo_url}/xmlrpc/2/object")

def create_odoo_order_from_shopify(shopify_order):
    # Find or create customer
    partner = models.execute_kw(db, uid, pwd, 'res.partner', 'search_read',
        [[['email', '=', shopify_order['customer']['email']]]],
        {'fields': ['id'], 'limit': 1}
    )
    partner_id = partner[0]['id'] if partner else models.execute_kw(
        db, uid, pwd, 'res.partner', 'create', [{
            'name': shopify_order['customer']['first_name'] + ' ' + shopify_order['customer']['last_name'],
            'email': shopify_order['customer']['email'],
        }]
    )

    # Create Sale Order
    order_id = models.execute_kw(db, uid, pwd, 'sale.order', 'create', [{
        'partner_id': partner_id,
        'client_order_ref': f"Shopify #{shopify_order['order_number']}",
        'order_line': [(0, 0, {
            'product_id': get_odoo_product_id(line['sku']),
            'product_uom_qty': line['quantity'],
            'price_unit': float(line['price']),
        }) for line in shopify_order['line_items']],
    }])
    return order_id

def get_odoo_product_id(sku):
    result = models.execute_kw(db, uid, pwd, 'product.product', 'search_read',
        [[['default_code', '=', sku]]], {'fields': ['id'], 'limit': 1})
    return result[0]['id'] if result else False

Exemplo 2: Webhook do Shopify para Pedidos em Tempo Real

from flask import Flask, request
app = Flask(__name__)

@app.route('/webhook/shopify/orders', methods=['POST'])
def shopify_order_webhook():
    shopify_order = request.json
    order_id = create_odoo_order_from_shopify(shopify_order)
    return {"odoo_order_id": order_id}, 200

Melhores Práticas

• ✅ Faça: Use o sistema de webhooks do Shopify para sincronização de pedidos em tempo real em vez de polling.
• ✅ Faça: Combine produtos usando SKU / Referência Interna como a chave única entre ambos os sistemas.
• ✅ Faça: Valide as assinaturas HMAC dos webhooks do Shopify antes de processar qualquer payload.
• ❌ Não faça: Sincronize o estoque de ambos os sistemas simultaneamente sem um "sistema mestre" — escolha um como a fonte da verdade.
• ❌ Não faça: Use IDs de produtos do Shopify como chave — use SKUs, que são estáveis entre as plataformas.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.