Sincronización de ventas

Sincronización de ventas de Tienda Nube a Odoo

La sincronización de ventas trae automáticamente a Odoo las órdenes generadas en Tienda Nube: Odumbo crea la orden, la confirma y deja que el flujo siga de forma nativa en Odoo. Con eso centralizas en un solo lugar la facturación, los despachos y la asignación comercial de tus canales digitales.

Odumbo no avanza más allá de la creación y la confirmación de la venta. Lo que viene después —facturar, preparar el pedido, despachar— queda en manos del usuario, dentro de Odoo.

Modos Sandbox y Producción

Cada integración trabaja en una de dos modalidades, y el modo determina si lo que hace es real o simulado.

• Modo Sandbox (Pruebas): es el modo por defecto al crear la integración. Permite hacer testeos de forma segura sin afectar datos reales.
• Modo Producción: es el modo activo, que sincroniza datos reales de forma automática y periódica.

El paso de uno a otro no es solo un interruptor de seguridad: mientras la integración está en Producción, los campos de configuración quedan bloqueados, así que el orden natural del trabajo es configurar y probar en Sandbox, y activar al final.

Parámetros de la sincronización de ventas

Los parámetros se completan en la columna derecha del panel de integraciones de Odumbo, en la sección Sincronización de Ventas.

Parámetro	Qué define
Solo ventas pagadas	Activado (Tildado): solo se sincronizan las ventas cuyo pago fue confirmado y recibido en Tienda Nube (estado verde Recibido). Desactivado (Destildado): se sincronizan todas las ventas de la tienda de manera inmediata, sin importar si su estado de pago es Pendiente o Recibido.
Compañía	La empresa de tu base de Odoo donde se registran las ventas. Se completa con el número de ID que devuelve la lupa (por ejemplo, 6 para Mueblería ARG).
Comercial	El vendedor por defecto de las ventas sincronizadas. Se completa con el ID del usuario que devuelve la lupa (por ejemplo, 18 para Juan Gómez).
Almacén	El ID del almacén desde el que se procesa el stock y el despacho de los productos de Tienda Nube.
Campos extra para Ventas	Valores fijos que Odoo aplica por defecto a toda venta que llega de Tienda Nube, como el Diario de facturación o el Proyecto analítico al que se imputa el canal de distribución.

Configurar la sincronización de ventas

Deja la integración lista para importar órdenes, todavía sin impacto en datos reales.

Prerequisitos

• Acceso al panel de Odumbo, con la cuenta de Tienda Nube ya conectada. Ver Conectar Odumbo a Tienda Nube.
• Los ID de compañía, comercial y almacén de tu base de Odoo.

Para configurar la sincronización:

1. En el panel de integraciones de Odumbo, activa la opción Sincronización de Ventas.
2. En la columna de la derecha, completa los parámetros obligatorios de la tabla anterior.
3. Si tu operativa necesita valores contables o de gestión fijos, completa la sección Campos extra para Ventas.
4. Guarda los cambios.

La integración queda parametrizada y lista para la prueba manual. Todavía no importa ventas de forma automática: eso lo habilita la activación en Producción.

Probar la sincronización con el botón Test

Valida que la comunicación entre las dos plataformas funcione antes de dejar la integración en modo automático.

Prerequisitos

• La sincronización de ventas configurada y guardada.
• Al menos una venta existente en la cuenta de Tienda Nube.

Para probar la sincronización:

1. En el panel de Odumbo, haz clic en el botón "Test".
2. El sistema procesa exclusivamente las últimas 5 ventas de tu cuenta de Tienda Nube.
3. Espera unos segundos hasta que emerja la ventana de resultados (logs).

La ventana de resultados detalla las operaciones realizadas y los números de orden generados en Odoo.

aviso

Si estás realizando este test conectado a una base de datos real y activa de Odoo, presionar el botón "Test" creará documentos y transacciones de venta reales. Si repites el test, se vuelven a evaluar las mismas 5 ventas con fines de diagnóstico.

Verificar las órdenes en Odoo

Comprueba que el flujo terminó bien y entiende con qué particularidades llega cada orden.

Prerequisitos

• Una prueba con el botón "Test" ya ejecutada, o la sincronización activa en Producción.
• Acceso a la base de Odoo donde se registran las ventas.

Para verificar las órdenes:

1. En Odoo, entra al módulo "Ventas > Órdenes > Órdenes de venta".
2. Abre una de las órdenes nuevas y revisa los cuatro puntos de abajo.

En las órdenes creadas por Odumbo vas a encontrar:

• Estado del flujo: el pedido omite la etapa de presupuesto y pasa directamente al estado "Orden de venta" de forma automática.
• Historial y enlaces (Chatter): en la zona de comunicación lateral o inferior del documento hay un registro que indica que la venta fue importada por Odumbo y especifica el número de orden original de Tienda Nube (ej. #146). Ese número es un enlace directo que abre el detalle de la venta en la plataforma de e-commerce, en una pestaña nueva.
• Asignación comercial y segmentación: en la pestaña "Otra información" consta el vendedor asignado. Además, Odoo crea automáticamente un Equipo de Ventas exclusivo (llamado "TiendaNube [Nombre de tu Tienda]") para segmentar los reportes de tus canales digitales.
• Líneas de pedido y totales: se listan los artículos, las cantidades, los precios y los costos de envío contratados. El monto total de la orden en Odoo debe coincidir con el total cobrado en Tienda Nube.

Activar la sincronización en Producción

Pasa la integración a Producción para que empiece a importar las ventas reales de Tienda Nube de forma automática y periódica.

Prerequisitos

• Las pruebas de funcionamiento de la sincronización de ventas terminadas en el entorno de pruebas.
• Las credenciales de la base de datos productiva de Odoo.

consejo

Antes de pasar a Producción puedes optar por continuar con la configuración de la sincronización de stock y de precios desde los respectivos enlaces de la parte inferior de la pantalla, o bien activar directamente la sincronización de ventas.

Para activar la sincronización en Producción:

1. Verifica y actualiza la cuenta de Odoo. Revisa el campo Cuenta de Odoo: si ya muestra la base de datos de producción, no hay cambios por hacer. Si muestra una cuenta de pruebas (Test), haz clic en el botón "Editar" al lado de la cuenta y reemplaza el Dominio de la base y el Nombre de la base por las credenciales productivas. El usuario y la API Key se mantienen iguales, salvo que en producción necesites una clave API distinta; en ese caso, genérala en tu base de producción. Guarda los cambios y vuelve a la pantalla principal de la integración.
2. Cambia de Sandbox a Producción. En la barra superior de la integración, haz clic en el botón Sandbox (Click to switch). El estado de la integración pasa a Producción, con una etiqueta verde en la esquina superior derecha.
3. Configura la fecha de inicio y activa. En la sección Sincronización de Ventas, ubica el campo de fecha y hora, y establece la fecha del día actual y el horario a partir del cual quieres que empiecen a importarse las ventas a Odoo. Haz clic en el botón superior "Activar sincronización".
4. Monitorea el estado de la sincronización. El resultado de cada proceso queda en el Chatter del panel derecho de la pantalla (o en la parte inferior, según la resolución del monitor): el sistema genera un registro con el título Synchronization #000001 y detalla en el cuerpo del mensaje las ventas o el stock modificados. Si no hubo transacciones nuevas en ese lapso, indica que no se hicieron cambios (No changes were made on the synchronized accounts).

Desde ese momento la integración importa las ventas reales de Tienda Nube de forma automática, a partir de la fecha y hora que definiste.

Pausar la sincronización para modificar la configuración

Habilita la edición de los campos de configuración de una integración que ya está activa.

Prerequisitos

• Acceso al panel de la integración en Odumbo, en modo Producción.

aviso

Mientras la integración se encuentre activa en modo producción, los campos de configuración no son editables, para evitar errores en la transferencia de datos.

Para modificar los almacenes, diarios o campos de ventas:

1. En la barra superior, haz clic en el botón "Pausar". Esto detiene temporalmente las sincronizaciones automáticas.
2. Haz los cambios que necesites en los campos de configuración.
3. Haz clic de nuevo en "Activar sincronización" para reanudar el proceso automático.

La integración vuelve a sincronizar de forma automática con la configuración nueva.

Consultar el historial de ventas sincronizadas

Audita las operaciones comerciales que la integración fue procesando.

Prerequisitos

• La integración con al menos una sincronización ejecutada en modo Producción.

Para consultar el historial:

1. En el menú superior de la integración, haz clic en el botón "Mis ventas".
2. Revisa el listado, que muestra el historial completo de las ventas sincronizadas correctamente en el Modo Producción.

Las ventas que se sincronizaron previamente durante el modo Sandbox no aparecen en este listado: corresponden únicamente al entorno de pruebas y no dejan registro en el historial productivo.

Solución de problemas

En la orden de Odoo aparece "Producto TiendaNube genérico" en lugar del producto real

Producto TiendaNube genérico

Ocurre cuando el sistema no puede enlazar el artículo de la tienda online con tu inventario interno, porque el código SKU no coincide exactamente entre Odoo y Tienda Nube. Es la regla de oro de la integración: para que los productos se vinculen correctamente de forma automática, el SKU debe ser exactamente el mismo en las dos plataformas.

Para resolverlo, corrige la orden ya recibida y después la causa:

1. En la orden de Odoo, ve al chatter y haz clic en el enlace que abre la orden en Tienda Nube.
2. Identifica cuál fue el producto real que compró el cliente.
3. Vuelve a la orden en Odoo, edita el documento, elimina la línea del producto genérico y agrega manualmente el producto correcto, respetando el precio cobrado.
4. Para evitar que vuelva a pasar, edita los productos en Odoo o en Tienda Nube para que sus códigos SKU coincidan antes de la próxima venta. Ver Vinculación de productos.

Antes de abrir un ticket

Adjunta:

• El número de orden en Tienda Nube y el de la orden de venta en Odoo.
• La ventana de resultados (logs) del botón "Test", completa.
• El registro del Chatter de la orden en Odoo.
• El modo en el que estaba la integración (Sandbox o Producción) y la fecha y hora de inicio configuradas.