Odoo ↔ Shopify (cliente Hoseg) — Integración Stock + Productos
Registrado: 2026-08-28 · Cliente: Hoseg (14 Diez SAC) · Estado: 🆕 EN DEFINICIÓN (fase 1)
Objetivo: Que el stock del almacén de la sucursal Casa Hoseg (Odoo) se refleje en Shopify, creando los artículos faltantes desde Odoo.
🎯 Alcance Fase 1 (definido por Daniel 2026-08-28)
- Conexión Odoo ↔ Shopify establecida
- Stock de Casa Hoseg (almacén en Odoo) reflejado en Shopify
- Crear en Shopify los artículos que faltan usando la información de Odoo (la tienda Shopify actual NO tiene el catálogo completo)
- Al terminar la fase 1 → continuar con las siguientes cosas (pendiente definir)
🗺️ Contexto del mapa de integraciones (cliente Hoseg)
- Hoseg Cash ↔ Shopify — wallet de recompensas (proyecto aparte, ya en producción)
- Odoo ↔ Shopify — ESTE proyecto (ERP v19.2 SaaS + tienda online)
- QuickBooks ↔ Shopify — por explorar, posible conexión futura
- ⚠️ NO mezclar proyectos
🔑 Credenciales necesarias (PENDIENTE — pedir a Daniel)
- [ ] Odoo: URL instancia (¿hoseg.odoo.com?), nombre BD, usuario, API key (Preferences → Account Security → New API Key)
- [ ] Odoo: confirmar plan SaaS con API habilitada (Custom) — o usar duplicado para pruebas
- [ ] Odoo: ID/ubicación del almacén Casa Hoseg (warehouse + stock.location)
- [ ] Shopify: confirmar cuál tienda es la de producción real (¿hosegstore.myshopify.com?) vs dev store m0cwcm-if
- [ ] Shopify: credenciales de producción (la dev store ya tiene creds en
credentials/shopify-dev-store.json, token expira 24h, refresh vía client_credentials)
🏗️ Arquitectura propuesta
Odoo (PostgreSQL) --JSON-2 API--> Nexus (integrador) --Admin API--> Shopify
product.template / product.product product create/update
stock.quant (Casa Hoseg location) inventoryLevels.set
Flujo sugerido
- Lectura Odoo:
product.product(SKU, nombre, precio, categoría, estado) +stock.quantfiltrado por ubicación Casa Hoseg - Mapeo: SKU de Odoo = handle/SKU en Shopify (dedupe por SKU para no duplicar)
- Creación Shopify:
POST /admin/api/2025-01/products.jsonpara artículos faltantes (con precio, inventario inicial) - Sincronización de stock:
POST /admin/api/2025-01/inventory_levels/set.json(location_id Shopify + quantity desde Odoo) - Frecuencia: job periódico (ej. cada X min/hora) o manual — pendiente definir con Daniel
Preguntas abiertas
- ¿Sync continuo (cron cada N minutos) o bajo demanda?
- ¿Shopify tiene un solo location de inventario o varios?
- ¿Los precios se toman de Odoo tal cual (con IGV) o se transforman?
- ¿Imágenes? ¿Se copian de Odoo o se dejan sin imagen?
- ¿Variantes (tallas/colores) o productos simples?
📚 Referencias (del wiki odoo-hoseg.md)
- API recomendada: JSON-2 API (
POST /json/2/<model>/<method>con API key como bearer) - Modelos Odoo:
product.product→product_product,stock.quant→ stock por ubicación - Odoo Online: NO acceso directo a PostgreSQL (solo API)
- Shopify: Admin API REST, token por client_credentials (expira 24h) o token de app instalada
⏳ Próximos pasos
- Obtener credenciales Odoo (URL + BD + API key) → probar
res.partner/search_readlimit 5 - Explorar catálogo:
product.product/search_read(contar, ver SKUs) +stock.quanten Casa Hoseg - Confirmar tienda Shopify de producción y su location_id
- Crear script de sync (lectura Odoo → creación/update Shopify → stock)
- Probar con pocos productos → validar con Daniel → correr completo
✅ FASE 1 — EJECUTADA (2026-08-28, tarde) ⭐
Resultado (dev store m0cwcm-if)
- 86 productos creados en Shopify (producto base + variantes), 484 variantes en total
- 2 almacenes creados en Shopify: Larcomar (id 87421419683) + Casa Hoseg (id 87421452451) — vía GraphQL
locationAdd(REST no permite crear locations) - Inventario sincronizado desde Odoo: Casa Hoseg 389 items/3,665 uds · Larcomar 294 items/752 uds
- Precios: Odoo sin IGV × 1.18 (IGV Perú)
- Estructura: nombre fuera de paréntesis = producto base (template Odoo); género/talla/modelo = variantes; SKU = key de sincronización (default_code de Odoo)
- Estado: draft (sin publicar, para revisión de Daniel)
Datos técnicos clave
- Odoo sandbox: hoseg-odoo-shopify.odoo.com (JSON-2 API, creds en credentials/odoo-hoseg-sandbox.json)
- Odoo locations: CH/Existencias = 269 · Larcomar = 212 · stock.quant con quantity>0
- Shopify API version: usar 2026-01 (2025-01 da 406 en POST)
- Odoo atributos: product.template.attribute.value (name + attribute_id) — ignorar Marca/manufacturer/Basic/TALA/GEN
- Script: tmp/odoo_shopify_sync_v2.py (agrupa por product_tmpl_id, crea producto con options, setea inventory_levels por SKU)
- ⚠️ Token Shopify expira en 24h → refresh vía client_credentials (grant_type=client_credentials) o authorization_code
Pendientes / siguientes
- [ ] Revisar productos en admin Shopify (draft → publicar cuando Daniel valide)
- [ ] Verificar precios con IGV y variantes (muestreo)
- [ ] Definir sincronización periódica (cron) con refresh de token
- [ ] Fase 2: procesos de tienda (15% cumpleaños, envío gratis, etc.) — pendiente definición
⏸️ PAUSA (2026-08-28 23:21)
Daniel pausó el proyecto Odoo↔Shopify. Estado para retomar:
- ✅ Fase 1 completa: 86 productos/484 variantes en dev store, 2 almacenes, stock cargado, precios con IGV, sync por SKU
- ✅ Script listo: tmp/odoo_shopify_sync_v2.py
- ⏳ Pendiente al retomar: revisar productos en draft → publicar, definir cron periódico (o evaluar conector nativo Odoo), fase 2 tiendas
- 🔑 Credenciales: Odoo sandbox (credentials/odoo-hoseg-sandbox.json) · Shopify dev store (credentials/shopify-dev-store.json) · token Shopify expira 24h (refresh client_credentials)