Guía de Usuario

Todo lo que necesitas para instalar Odoo–Shopify Order Check e interpretar su veredicto con confianza.

download Instalación

Requisitos previos

  • Navegador: Google Chrome (o cualquier navegador basado en Chromium) con extensiones habilitadas.
  • Odoo: Odoo 14–19+, en Odoo Online (*.odoo.com) u Odoo.sh, con una cuenta de usuario con la que puedas iniciar sesión.
  • Shopify: Una tienda Shopify conectada a Odoo a través de un conector compatible (actualmente Emipro).

Instalar la extensión

  1. Abre la ficha de Chrome Web Store
    Ve a la página de Odoo–Shopify Order Check en Chrome Web Store.
  2. Añádela a Chrome
    Haz clic en "Añadir a Chrome" y confirma el aviso. La extensión se instala en unos segundos.
  3. Fija el icono (opcional)
    Fija la extensión en tu barra de herramientas para que el popup de ajustes esté siempre a un clic.
  4. Inicia sesión en Odoo
    Abre tu instancia de Odoo en el mismo navegador e inicia sesión. Es el único paso necesario antes de empezar a comparar pedidos.
Solo lectura y seguro. La extensión nunca escribe en Odoo ni en Shopify. Solo lee datos de pedidos para construir la comparación, por lo que es seguro usarla en producción.

rocket_launch Primeros pasos

No hay nada que configurar. Una vez instalada la extensión e iniciada sesión en Odoo, abre un pedido y la comparación aparece automáticamente.

  1. Inicia sesión en Odoo
    Abre tu instancia de Odoo e inicia sesión como siempre. La extensión lee tu sesión activa para detectar la instancia y la base de datos — sin clave API, sin URL que escribir.
  2. Abre un pedido
    Abre cualquier pedido de ventas en Odoo (o el pedido equivalente en Shopify). La extensión lo detecta automáticamente e inyecta un panel de comparación.
  3. Interpreta el veredicto
    El panel muestra un veredicto global de coincidencia o discrepancia y te permite desplegar el desglose campo a campo bajo demanda.
Cero configuración. No hay instancias que registrar, ni claves API que pegar, ni página de opciones. La instancia y la base de datos provienen directamente de tu sesión de Odoo en el navegador, usando la cookie.
La red permanece en segundo plano. Todas las solicitudes de red se ejecutan en el service worker de la extensión. El token Admin de Shopify se lee desde Odoo a través del conector, se mantiene solo en memoria y nunca se persiste ni se expone a la página.

verified Interpretar el veredicto

La parte superior del panel te ofrece un veredicto único y de un vistazo para el pedido:

  • Coincidencia: Odoo y Shopify coinciden en el pedido. No se han encontrado discrepancias en los campos comparados.
  • Discrepancia: Al menos un campo difiere entre los dos sistemas. El desglose indica exactamente qué y dónde.
  • No se pudo comparar: La extensión no pudo construir la comparación — por ejemplo, tu sesión de Odoo ha caducado o el pedido aún no está vinculado a Shopify. El panel te indica qué hacer a continuación.

Desplegar los detalles

El veredicto es inmediato; el desglose es bajo demanda. Despliega el panel para ver cada campo comparado, el valor en cada lado y una sección de contexto para todo lo que explica una diferencia sin que sea un error.

dashboard El desglose de discrepancias

Cuando hay una discrepancia, el desglose te muestra campo a campo dónde difieren Odoo y Shopify:

  • Totales: El total del pedido, comparado contra el importe neto facturado de Odoo (consulta la siguiente sección para saber por qué).
  • Impuestos: Importes de impuestos en cada lado. En pedidos comparados contra el total facturado, la base imponible y los impuestos pueden marcarse como no comparables en esta versión.
  • Cantidades: Cantidades por línea. La cantidad facturada de Odoo se toma como autoridad frente a la cantidad actual de Shopify.
  • Líneas de pedido: Productos emparejados por SKU, excluyendo los artefactos del conector (como líneas de descuento o regalo) para que no aparezcan como diferencias fantasmas.
  • Direcciones: Direcciones de envío y facturación, comparadas por sus partes relevantes (calle, ciudad, código postal) en lugar de un nombre para mostrar único.
Severidad. Cada discrepancia tiene un peso, de modo que una diferencia de redondeo no se lee igual que una línea faltante o un total incorrecto. El veredicto refleja la diferencia más significativa encontrada.

swap_horiz Facturado vs. actual

El veredicto económico compara el pedido actual de Shopify contra lo que realmente se ha facturado en Odoo — no contra el pedido de venta original.

¿Por qué el importe neto facturado?

Cuando se factura un pedido, el conector congela el pedido de venta. Comparar ese pedido congelado contra un pedido de Shopify que ha cambiado desde entonces genera falsos positivos. En su lugar, la extensión utiliza el importe neto facturado de Odoo — facturas de cliente registradas menos reembolsos registrados — que es lo que genuinamente coincide con el estado actual de Shopify.

Cómo se lee cada lado

  • Odoo: Total neto facturado (suma de facturas de cliente registradas menos reembolsos registrados) y la cantidad facturada por línea como autoridad.
  • Shopify: El total actual del pedido y la cantidad actual por línea — la fuente de verdad en tiempo real de lo que el cliente tiene.
¿Aún no facturado? Si el pedido no tiene facturas registradas, la extensión recurre a comparar los importes pedidos y etiqueta el veredicto como provisional para que sepas que una factura lo confirmará más adelante.

history Reembolsos, devoluciones y cancelaciones

Los reembolsos, devoluciones y ediciones de pedido raramente significan que algo esté mal — forman parte del ciclo de vida normal de un pedido. La extensión los muestra como contexto, separados de la lista de discrepancias para que no provoquen falsas alarmas:

  • Reembolsos: El importe original, los reembolsos aplicados y el importe neto facturado resultante se muestran juntos para que el cálculo sea transparente.
  • Devoluciones: Una devolución en curso se muestra como contexto en el lado de la entrega en lugar de contarse como discrepancia de cantidad.
  • Ediciones de pedido: Cuando se edita un pedido de Shopify, se muestra el historial (original, reembolsos, ediciones) para que un cambio legítimo no parezca un error.

Pedidos cancelados

Cuando un pedido está cancelado, el panel muestra un banner claro para que entiendas de inmediato por qué los números tienen ese aspecto, en lugar de interpretar la cancelación como una discrepancia.

Contexto, no discrepancias. Todo lo que aparece en esta sección es informativo. Explica las diferencias; por sí solo nunca cuenta para el veredicto de coincidencia o discrepancia.

business Empezar desde Shopify

También puedes abrir la comparación desde un pedido de Shopify, no solo desde Odoo. Para ello, la extensión necesita saber a qué instancia de Odoo pertenece la tienda, y aprende ese mapeo la primera vez que comparas el pedido desde Odoo.

Cómo funciona el mapeo aprendido

  1. Inicia sesión en Odoo y abre el pedido una vez desde ahí. La extensión resuelve la tienda y recuerda a qué instancia y base de datos de Odoo corresponde.
  2. A partir de ese momento, abrir el pedido equivalente en Shopify funciona directamente — la extensión ya sabe dónde buscar.
  3. El mapeo se almacena localmente en tu navegador; no se envía a ningún sitio.
¿La tienda aún no está aprendida? Si abres un pedido de Shopify de una tienda que la extensión no ha visto desde Odoo, te pedirá que abras primero el pedido en Odoo en lugar de adivinar. Una vez que haya aprendido el mapeo, las comparaciones iniciadas desde Shopify funcionarán directamente.

settings Ajustes

Un pequeño hogar de ajustes te permite consultar tu estado de acceso, gestionar tu licencia y ver algunos datos de diagnóstico — sin salir de la página en la que estás.

Dónde encontrarlo

  • Popup del icono de la extensión: Haz clic en el icono de la extensión en tu barra de herramientas para abrir los ajustes desde cualquier pestaña.
  • Engranaje en el panel: Abre el engranaje ⚙ en el panel de comparación para ver los mismos ajustes en el mismo lugar, justo al lado del pedido que estás mirando.

Qué puedes hacer

  • Ver tu estado de acceso: Comprueba si estás en la prueba gratuita o con una licencia activa, y cuántos días de prueba te quedan.
  • Activar una clave de licencia: Pega una clave de licencia de Polar para desbloquear la extensión en cualquier momento — durante la prueba o después de que acabe.
  • Comprar un plan: Ve directo al pago para comprar un plan Starter, Growth o Agency.
  • Gestionar tu suscripción: Abre el portal de clientes alojado de Polar para cambiar o cancelar tu suscripción.

Diagnóstico de solo lectura

El panel de diagnóstico es puramente informativo y muestra:

  • Días de prueba restantes.
  • Tu plan y nivel.
  • La instancia de Odoo detectada.
  • La versión instalada de la extensión.

credit_card Suscripción

Tu prueba gratuita de 14 días

Cada instalación comienza con una prueba gratuita de 14 días que desbloquea la extensión completa. La prueba se registra localmente en tu dispositivo mediante un sistema de honor — sin registro y sin llamada de red para iniciarla.

Planes

  • Starter: Cubre 1 instancia de Odoo y 1 tienda Shopify.
  • Growth: Cubre 1 instancia de Odoo y tiendas Shopify ilimitadas.
  • Agency: Cubre instancias de Odoo y tiendas Shopify ilimitadas.

Cómo comprar

  1. Abre los ajustes desde el popup del icono de la extensión o el engranaje ⚙ del panel.
  2. Elige Comprar y selecciona el plan Starter, Growth o Agency.
  3. Completa el proceso de pago. Recibirás una clave de licencia para activar la extensión.

Activar tu clave de licencia

  1. Abre los ajustes y localiza el campo de clave de licencia.
  2. Pega la clave que recibiste tras la compra.
  3. Actívala. La extensión completa se desbloquea de inmediato para todo tu equipo.
Suscripción para toda la empresa. Una suscripción cubre a toda tu empresa: la misma clave de licencia funciona en todo tu equipo, sin límite por usuario. Los planes solo se diferencian por el alcance: cuántas instancias de Odoo y tiendas Shopify cubren.

Gestionar o cancelar tu suscripción

La facturación, los cambios de plan y la cancelación se gestionan en el portal de clientes alojado de Polar — la extensión solo te lleva hasta allí.

  1. Abre los ajustes desde el popup o el engranaje del panel.
  2. Elige Gestionar suscripción para abrir el portal de clientes de Polar.
  3. Actualiza tu plan, los datos de pago o cancela desde ahí.

La extensión nunca almacena tus datos de pago. Toda la facturación reside en el portal de Polar.

help Solución de problemas

No se ha detectado sesión de Odoo

Si no has iniciado sesión en Odoo, la extensión no puede detectar tu instancia y muestra un mensaje accionable de "inicia sesión en Odoo" en lugar de adivinar.

  1. Abre tu instancia de Odoo en el mismo navegador.
  2. Inicia sesión como siempre.
  3. Vuelve al pedido — el panel detecta tu sesión automáticamente.

Pedido no vinculado a Shopify

  • No es un pedido de Shopify: Si el pedido no tiene contrapartida en Shopify, no hay nada que comparar y el panel se retira discretamente.
  • Ábrelo primero desde Odoo: Al empezar desde una tienda Shopify que la extensión aún no conoce, abre el pedido en Odoo una vez para que pueda aprender el mapeo tienda-instancia.

Instancia no detectada

  • Sesión caducada: Si tu sesión de Odoo ha caducado, vuelve a iniciar sesión y reabre el pedido.
  • Alojamiento no compatible: La autodetección apunta a Odoo Online (*.odoo.com) y Odoo.sh en esta versión. Odoo en un dominio completamente personalizado aún no está cubierto.

El panel no aparece

  1. Recarga la página: Actualiza la pestaña del pedido para que el content script se vuelva a ejecutar y detecte el pedido.
  2. Comprueba que la extensión está habilitada: Abre chrome://extensions y confirma que Odoo–Shopify Order Check está activado.
¿Sigues atascado? El diagnóstico de los ajustes muestra la instancia de Odoo detectada y la versión de tu extensión — datos útiles para incluir cuando contactes con el soporte.

quiz Preguntas frecuentes

General

¿Qué hace Odoo–Shopify Order Check?

Cuando abres un pedido en Odoo o Shopify, la extensión compara ambos sistemas campo a campo — totales, impuestos, cantidades, líneas de pedido y direcciones — y muestra un veredicto global de coincidencia o discrepancia con un desglose de las diferencias.

¿Modifica algo en Odoo o Shopify?

No. La extensión es estrictamente de solo lectura. Nunca crea, edita ni elimina datos en ninguno de los sistemas — solo lee, por lo que es seguro usarla en producción.

¿Necesito configurar algo?

No. La extensión detecta automáticamente tu instancia y base de datos de Odoo desde tu sesión activa. No hay instancias que registrar, ni claves API, ni página de opciones.

Suscripción

¿Hay una prueba gratuita?

Sí. Cada instalación incluye una prueba gratuita de 14 días con toda la funcionalidad. Tras la prueba están disponibles los planes Starter, Growth y Agency, cada uno cubre a todo tu equipo y se delimita por cuántas instancias de Odoo y tiendas Shopify incluye.

¿Cómo cancelo?

Abre los ajustes, elige Gestionar suscripción y cancela desde el portal de clientes alojado de Polar. La extensión solo te lleva hasta allí; nunca almacena datos de pago.

Privacidad y seguridad

¿De dónde viene el token de Shopify?

Se lee desde Odoo a través del conector y se mantiene solo en memoria dentro del service worker de la extensión. Nunca se persiste en disco ni se expone a la página que estás viendo.

¿Los datos de mis pedidos salen de mi navegador?

No hay backend. La extensión lee Odoo y Shopify directamente desde tu navegador para construir la comparación, y el mapeo aprendido de tienda a instancia se almacena localmente en tu dispositivo.

support Obtener ayuda

Contactar con soporte

Si algo no funciona o tienes una pregunta, escríbenos y te ayudamos:

  • Email: odoointegrations.team@gmail.com
  • Incluye la versión de tu extensión (visible en el diagnóstico de los ajustes).
  • Las capturas del panel y del pedido ayudan a resolver el problema mucho más rápido.