Conector Shopify para Odoo 19

1.Cómo usar este manual

Está escrito para la persona que va a operar la tienda todos los días, no para quien programa. No hace falta saber qué es una API para seguirlo.

El manual va en orden: primero se crea la app en Shopify, después se configura la instancia en Odoo y solo al final se sincroniza. Si se salta pasos, lo más probable es que se tope con un error que este documento ya previene.

1.1 Convenciones

• Las rutas de menú se escriben así: Shopify → Configuración → Instancias.
• Los nombres de campo van en negrita; los valores literales, en código.
• Las capturas provienen de una tienda de Shopify y de una base de Odoo reales, no de maquetas.

2.Qué hace el conector

Mantiene sincronizados el catálogo, los clientes, el inventario y los pedidos entre Shopify y Odoo, y deja la contabilidad cuadrada del lado de Odoo.

2.1 Qué viaja en cada dirección

2.2 El recorrido completo de un pedido

2.3 Por qué hay colas

El conector nunca escribe directamente lo que baja de Shopify. Primero lo guarda en una cola y después lo procesa registro por registro. Esto tiene tres ventajas concretas:

• Si un pedido falla, los demás del mismo lote sí entran.
• Queda constancia de qué se descargó y qué se hizo con cada elemento.
• Se puede reintentar solo lo que falló, sin volver a descargar todo.

3.Requisitos previos

Tres cosas antes de empezar: la tienda, el Odoo y una decisión de negocio.

3.1 Del lado de Shopify

• Una tienda de Shopify activa (o una tienda de desarrollo, para pruebas).
• Una cuenta de Shopify Partners para entrar al Dev Dashboard. Es gratuita.
• Ser propietario de la tienda o tener permiso para instalar aplicaciones.

3.2 Del lado de Odoo

• Odoo 19 con los módulos Ventas, Inventario y Contabilidad instalados.
• El módulo mrdc_shopify instalado.
• Un plan de cuentas cargado y un diario de ventas configurado; sin eso no se pueden facturar los pedidos.
• El país de la compañía configurado, si va a dejar que el conector cree los impuestos.

3.3 La decisión de negocio: ¿quién manda en el catálogo?

Es la única decisión que el conector no puede tomar por usted, y conviene tomarla antes de sincronizar nada:

4.Crear la app en Shopify

Aquí se equivoca casi todo el mundo, porque la forma de hacerlo cambió en enero de 2026 y la mayoría de tutoriales que hay en internet describen el método viejo.

4.1 El método actual: el Dev Dashboard

Las apps nuevas se crean en el Dev Dashboard de Shopify y ya no entregan un token fijo: entregan un Client ID y un Client Secret. Con ese par de credenciales el conector pide el token por su cuenta y lo renueva solo, porque esos tokens caducan cada 24 horas.

1. Entre a dev.shopify.com con su cuenta de Shopify Partners.
2. Pulse Create app y elija Start from Dev Dashboard.
3. Póngale un nombre reconocible, por ejemplo Conector Odoo, y pulse Create.

4.2 Configurar la versión y los permisos

Entre a la app y abra la pestaña Versions. Ahí se definen tres cosas:

4.3 Instalar la app en la tienda

1. Vaya a Home, dentro de la app.
2. Baje hasta Install app.
3. Elija la tienda (o cree una de desarrollo) y pulse Install.

4.4 Copiar las credenciales

Con la app ya instalada, abra Settings dentro de la app. Ahí están el Client ID y el Secret.

5.Los permisos que hay que conceder

Shopify llama scopes a los permisos. Si falta uno, la operación que lo necesita falla con un error de acceso denegado; el resto sigue funcionando.

5.1 Permisos obligatorios

Sin estos el conector no puede trabajar:

read_products,write_products,read_orders,write_orders,
read_customers,write_customers,read_inventory,write_inventory,
read_locations,read_fulfillments,write_fulfillments,
write_merchant_managed_fulfillment_orders,
read_publications,write_publications

5.2 Permisos opcionales

5.3 La lista para copiar y pegar

read_all_orders,write_customers,write_fulfillments,write_inventory,
read_locations,write_merchant_managed_fulfillment_orders,write_orders,
write_products,write_publications,write_returns,read_shipping,
read_shopify_payments_accounts,read_shopify_payments_payouts

6.Crear la instancia en Odoo

Una instancia es una tienda de Shopify conectada. Si maneja varias tiendas, crea una instancia por cada una.

6.1 El menú del conector

Tras instalar el módulo aparece el menú Shopify, organizado en cuatro bloques:

6.2 Alta de la instancia

Vaya a Shopify → Configuración → Instancias → Nuevo y llene los datos de conexión:

6.3 Probar la conexión

Pulse Probar conexión. El conector hace dos cosas: pide un token con sus credenciales y consulta qué permisos le concedió la tienda.

7.Ubicaciones y almacenes

Es el primer paso después de conectar y el que más problemas evita más adelante.

Shopify guarda el inventario en ubicaciones; Odoo, en almacenes. El conector necesita saber qué ubicación corresponde a qué almacén para dos cosas: saber de dónde descontar el inventario que exporta y desde qué almacén entregar cada pedido.

1. En la ficha de la instancia, pulse Importar ubicaciones.
2. Abra la pestaña Ubicaciones.
3. Para cada ubicación, elija el Almacén de Odoo que le corresponde.
4. En Almacenes que suman existencias indique de qué almacenes se debe sumar el stock que se publica en esa ubicación.

8.Configuración de ventas

La pestaña Ventas controla cómo entran los pedidos y con qué valores por defecto se crean.

9.Configuración de productos

Cómo decide el conector que un producto de Shopify y uno de Odoo son el mismo.

9.1 El emparejamiento

9.2 Creación automática

10.Productos especiales

Un pedido de Shopify no trae solo artículos: trae envío, descuentos, propinas y a veces aranceles. Cada uno de esos conceptos necesita un producto en Odoo donde aterrizar.

11.Flujos de trabajo automáticos

Esta es la pieza que decide cuánto trabajo manual queda después de importar un pedido. Bien configurada, un pedido pagado llega a Odoo ya confirmado y facturado.

11.1 Qué es un flujo de trabajo

Un flujo es una receta de pasos que se ejecutan sobre el pedido recién importado:

11.2 Asignar el flujo según el estado de pago

No todos los pedidos merecen el mismo tratamiento: uno pagado se puede facturar, pero uno pendiente de pago no. Por eso el flujo se asigna combinando la pasarela de pago con el estado financiero del pedido.

11.3 Las pasarelas de pago

El conector crea la pasarela sola la primera vez que ve un pedido pagado con ella. No hay que darlas de alta a mano: haga una importación de prueba y luego configure los flujos sobre las pasarelas que aparezcan.

12.Clientes, reembolsos y payouts

Tres pestañas cortas de la instancia que definen comportamientos importantes.

12.1 Clientes

Importar el cliente como empresa hace que, cuando la dirección de Shopify trae un nombre de compañía, el contacto se cree en Odoo como empresa en lugar de como persona. Actívelo si vende mayoreo; déjelo desactivado si vende al consumidor final.

12.2 Reembolsos y devoluciones

12.3 Payouts

Un payout es cada transferencia que Shopify Payments hace a su cuenta bancaria. El conector los descarga con su detalle de comisiones y los convierte en extractos bancarios. Se explica en el capítulo 23.

13.Notificaciones y sincronización

Cómo enterarse de que algo falló sin tener que estar revisando.

Con Crear actividad programada activo, cuando una cola falla tres veces el conector abre una actividad a los usuarios responsables, con el plazo que indique. Es la forma de que un problema de sincronización no pase inadvertido durante días.

14.El asistente de operaciones

Es el mando único: desde una sola pantalla se lanza cualquier importación o exportación.

Está en Shopify → Operaciones → Importar / Exportar. Elija la instancia, elija la operación y pulse Ejecutar. El formulario cambia según lo que elija: si la operación admite rango de fechas, aparecen las fechas; si trabaja sobre productos concretos, aparece el selector de productos.

15.Importar productos

Trae de Shopify los productos, sus variantes, sus atributos y sus imágenes.

15.1 Cómo ejecutarlo

1. Abra el asistente y elija Importar productos.
2. Deje las fechas vacías para traer todo el catálogo la primera vez.
3. Pulse Ejecutar. Se abre la cola creada.
4. Pulse Procesar la cola, o espere a que la acción planificada la procese sola.

15.2 Qué crea exactamente

Por cada producto de Shopify el conector mantiene tres registros en Odoo:

15.3 Atributos y variantes

Si el producto tiene opciones en Shopify (talla, color), el conector crea en Odoo los atributos y sus valores, y deja que Odoo genere las variantes. Después empareja cada variante de Shopify con la de Odoo comparando la combinación de valores.

15.4 Catálogos grandes

Para catálogos de miles de productos, marque Usar operación masiva. En lugar de pedir los productos página por página, el conector le encarga a Shopify que prepare el catálogo completo en un archivo y lo descarga de una sola vez. Es notablemente más rápido y no consume el límite de llamadas de la tienda.

16.Exportar productos a Shopify

El camino inverso: el catálogo se arma en Odoo y se publica en la tienda.

16.1 Preparar el producto en Odoo

Antes de exportar, revise que el producto tenga:

• Referencia interna en cada variante. Es lo que viaja como SKU.
• Precio de venta.
• Peso, si va a cobrar envío calculado.
• Atributos, si es un producto con variantes.

16.2 Exportar

1. Abra el asistente y elija Exportar productos.
2. Deje el selector de productos vacío para exportar todos los pendientes, o elija los que quiera.
3. Pulse Ejecutar.

Al terminar, la ficha de Shopify guarda el identificador del producto creado, su handle y los identificadores de cada variante. A partir de ahí, Actualizar productos modifica el producto existente en lugar de crear uno nuevo.

17.Publicar y despublicar

Un producto puede existir en Shopify sin estar a la venta. Publicarlo es lo que lo hace visible en la tienda en línea y en el punto de venta.

Desde la ficha del producto de Shopify, los botones Publicar y Despublicar actúan sobre todos los canales de venta de la tienda. También se puede hacer en lote desde el asistente, seleccionando varios productos.

18.Inventario

Odoo manda. La existencia que ve el comprador en la tienda sale del almacén.

18.1 Exportar existencias

Elija Exportar existencias en el asistente. El conector calcula, para cada variante y cada ubicación, la cantidad que corresponde según el campo de existencias configurado y los almacenes asociados a esa ubicación, y arma una cola.

18.2 Cantidades fijas y porcentajes

En cada variante de Shopify puede fijar un tipo de existencia fija:

18.3 Importar existencias

Importar existencias trae a Odoo lo que hay en Shopify y hace un ajuste de inventario. Es para el arranque, cuando la tienda ya operaba y Odoo empieza en cero. No la programe: si la ejecuta periódicamente, pisará los movimientos de bodega.

19.Clientes

Los clientes llegan de dos formas: importados en lote o creados al vuelo cuando entra su primer pedido.

19.1 Cómo evita duplicados

Antes de crear un contacto, el conector busca en este orden:

1. Un contacto ya enlazado con ese cliente de Shopify.
2. Un contacto con el mismo correo electrónico.
3. Un contacto con el mismo teléfono.

Solo si no encuentra nada crea uno nuevo. Las direcciones adicionales se agregan como contactos hijos de tipo dirección de entrega, comparando calle, ciudad, código postal y país para no repetir la misma dirección dos veces.

20.Pedidos

El corazón del conector. Un pedido de Shopify se convierte en un pedido de venta de Odoo con todas sus líneas, impuestos, descuentos y envío.

20.1 Qué se trae de cada pedido

20.2 La factura

Si el flujo lo indica, la factura se crea y se valida sola, en la moneda del pedido.

20.3 Reimportar es seguro

21.Entregas y fulfillment

Cuando se despacha en Odoo, Shopify se entera: el pedido pasa a preparado y el cliente recibe su número de guía.

21.1 El flujo

1. Prepare la entrega en Odoo como cualquier otra.
2. Escriba el número de guía y elija el transportista.
3. Valide la entrega.
4. Ejecute Actualizar el estado de envío, o deje que lo haga la acción planificada.

21.2 El transportista

Para que el número de guía sea útil, el transportista de Odoo debe llevar su código de transportista en Shopify. Ese código es el que Shopify usa para armar el enlace de rastreo que ve el cliente.

21.3 Entregas parciales

Si despacha en varias entregas, cada una genera su propio fulfillment con sus artículos y su guía. Shopify irá mostrando el pedido como parcialmente preparado hasta que se complete.

22.Reembolsos y cancelaciones

Se hacen en Shopify, que es donde está el dinero, y Odoo los refleja en la contabilidad y en el inventario.

22.1 Reembolso parcial

Al reembolsar en Shopify y traerlo a Odoo, el conector:

1. Crea una nota de crédito a partir de la factura original.
2. Deja en ella solo las líneas y cantidades reembolsadas, no la factura completa.
3. Agrega, si la hay, una línea de ajuste por las diferencias que Shopify sumó al reembolso.
4. La valida y, si está configurado, la marca como pagada.
5. Si el reembolso reingresa mercancía, crea la devolución de stock por esas unidades.

22.2 Cancelación

Al cancelar un pedido en Shopify e importar la cancelación, el conector distingue dos casos:

23.Payouts y conciliación

Shopify no le deposita lo que vendió: le deposita lo que vendió menos sus comisiones. Aquí es donde eso cuadra.

23.1 Qué es un payout

Cada transferencia de Shopify Payments a su banco es un payout, y viene con su desglose: cargos brutos, comisiones, reembolsos y ajustes. El conector descarga cada payout con todas sus transacciones y las enlaza con los pedidos de Odoo cuando puede identificarlos.

23.2 De payout a extracto bancario

1. Ejecute Importar reportes de payout.
2. Abra el payout y revise sus transacciones.
3. Pulse Generar extracto bancario.
4. Concilie el extracto en Odoo como cualquier otro.

El extracto se crea en el diario de payouts configurado, con una línea por transacción y el importe neto de cada una. Al conciliar, los cobros cierran las facturas de los pedidos y las comisiones van a la cuenta de gastos que usted indique.

24.Webhooks: sincronización en tiempo real

Con webhooks, un pedido aparece en Odoo segundos después de que el cliente pagó, sin esperar a la siguiente acción planificada.

24.1 Qué hace falta

Un webhook es un aviso que Shopify envía a su Odoo cuando algo pasa. Para que llegue, su Odoo tiene que ser alcanzable desde internet. Antes de activarlos, configure el parámetro del sistema web.base.url con la dirección pública de su Odoo.

24.2 Activarlos

En la pestaña Webhooks de la instancia hay tres interruptores. Al activar cualquiera, el conector registra en Shopify los avisos de ese grupo:

24.3 Cómo se protege

La dirección del webhook es pública, así que el conector verifica cada aviso antes de hacerle caso:

• Comprueba la firma HMAC con el secreto de la app. Si no coincide, responde 401 y descarta el aviso.
• Comprueba que el dominio de la tienda del encabezado coincida con el de la instancia. Si no, responde 404.

24.4 Qué pasa cuando llega un aviso

Si por un mismo registro llegan dos avisos seguidos (Shopify manda «creado» y «actualizado» casi a la vez), el conector reutiliza la cola pendiente en lugar de crear otra. Así no se llena de colas repetidas.

25.Las colas de importación

Todo lo que baja de Shopify pasa por aquí. Saber leer una cola es saber resolver el 90 % de los problemas.

25.1 Los estados

25.2 Qué hacer con una cola fallida

1. Ábrala y pulse Registros para ver el motivo exacto de cada fallo.
2. Corrija la causa en Odoo: cree el producto que faltaba, arregle el SKU, abra el período contable.
3. Pulse Reintentar las líneas fallidas.
4. Pulse Procesar la cola.

Si algunas líneas no se van a poder procesar nunca, Cancelar las líneas pendientes las marca como canceladas para que la cola deje de aparecer como pendiente.

26.Registros y libros de registro

Aquí está siempre la respuesta a «¿por qué no se importó esto?».

27.Acciones planificadas

Para que la sincronización ocurra sola.

28.Impuestos y monedas

Dos temas donde un descuido se convierte en contabilidad mal registrada.

28.1 Impuestos

28.2 Monedas

Un pedido se registra en la moneda en que se vendió. Si esa moneda no es la de la lista de precios de la instancia, el conector busca una lista de precios en esa moneda y, si no existe, la crea. También activa la moneda en Odoo si estaba desactivada.

29.Usuarios y permisos

Dos perfiles: quien opera y quien configura.

Si maneja varias compañías, cada instancia pertenece a una y las reglas de registro impiden que los usuarios de una compañía vean los datos de otra.

30.Problemas frecuentes

Ordenados por lo que se ve en pantalla.

30.1 Al conectar

30.2 Al importar productos o pedidos

30.3 Al exportar

30.4 Webhooks

31.Anexos

31.1 Modelos que crea el conector

31.2 Límites de Shopify que conviene conocer

31.3 Glosario

31.4 Lista de verificación de puesta en marcha

1. App creada en el Dev Dashboard con todos los permisos.
2. App instalada en la tienda; Client ID y Secret copiados.
3. Instancia creada en Odoo y Probar conexión en verde, sin permisos faltantes.
4. Ubicaciones importadas y mapeadas a almacenes.
5. Productos especiales revisados, sobre todo el de envío.
6. Emparejamiento por SKU verificado: todas las variantes de Shopify tienen SKU.
7. Flujos de trabajo configurados por pasarela y estado financiero.
8. Importación de prueba de productos y clientes, con las colas en verde.
9. Un pedido de prueba importado, facturado y entregado de punta a punta.
10. Existencias exportadas y verificadas en Shopify.
11. Acciones planificadas activadas, o webhooks registrados.
12. Responsables de notificaciones asignados.