Sincronización de Puntos de Venta con un Servidor Central en Odoo

1.Cómo usar este manual

Una guía completa para el personal de operaciones, encargados de tienda y equipo de TI que administra la red de puntos de venta.

Este manual documenta el sistema de sincronización que conecta un servidor central Odoo 19 con las instancias de punto de venta Odoo 18 instaladas en cada tienda. Está escrito para tres lectores distintos:

• El encargado de operaciones, que necesita entender qué viaja entre las tiendas y el central, cuándo, y cómo verificar que todo llegó (capítulos 11 a 18).
• El equipo de TI, que instala y configura ambos módulos, administra las llaves API y resuelve incidencias (capítulos 5 a 10 y 19 a 22).
• El personal de tienda, que solo necesita saber qué botones existen en su instancia y qué significa cada estado (capítulos 13 a 16).

Todas las capturas de pantalla provienen de un ambiente real con los dos módulos instalados y sincronizando datos entre sí. Los nombres técnicos de campos y botones aparecen tal como se ven en pantalla, en este formato cuando son valores o rutas técnicas.

2.Qué es el sincronizador y cómo funciona

Un servidor concentra; muchas tiendas operan. Cada dato viaja en una sola dirección y con una clave que lo identifica sin ambigüedad.

Cada tienda opera de forma autónoma: su punto de venta funciona aunque no haya internet hacia el central, porque la base de datos es local. La sincronización ocurre después de los hechos: cuando se cierra una sesión de caja, cuando se valida una recepción de compra, cuando se cuenta un inventario. El central, por su parte, es el dueño del catálogo: los productos, los precios, las categorías y la configuración de cada caja se definen una sola vez en el central y se empujan hacia todas las tiendas.

El mecanismo: colas, endpoints y registros

La comunicación funciona igual en ambas direcciones, con tres piezas:

1. Una cola de envíos en el lado que emite. Cada evento (cerrar una sesión, sincronizar un producto) crea un registro en la cola con el destino, el contenido en formato JSON y un estado: Pending → In Progress → Completed o Failed. Si el envío falla, el registro queda con el error y puede reintentarse.
2. Un receptor (endpoint) en el lado que recibe: una ruta HTTP protegida con llave API que valida el contenido, crea o actualiza los documentos y responde éxito o error.
3. Un log en el lado que recibe, donde queda escrito cada mensaje recibido: cuándo llegó, qué contenía y qué se respondió. Es la bitácora que se consulta cuando algo no cuadra.