Aplin Connector for Odoo - Sincronización de productos
Este es el paso que sostiene todo lo demás.
Aplin identifica cada producto por su SKU. Si un producto de Odoo no tiene correspondencia en Aplin, cualquier entrada u orden que lo mencione va a fallar entera. Por eso conviene dejar el catálogo en orden antes de mover una sola pieza.
🔀 Los dos modos
En Ajustes → Aplin - Noden → Productos eliges cómo quieres que trabajen los dos catálogos.
Aplin → Odoo (vincular por SKU)
Es el modo por defecto.
El conector lee el catálogo de Aplin y, por cada producto, busca en Odoo el que tenga esa misma referencia interna. Cuando lo encuentra, guarda el identificador de Aplin en el producto de Odoo.
- No escribe nada en Aplin.
- No crea productos en Odoo.
- Vincula también los productos que ahora mismo están a cero, porque la correspondencia no depende de las existencias.
- Los productos con existencias cuyo SKU Aplin no conoce se listan en el resumen de la bitácora: ésa es tu lista de tareas.
Funciona con cualquier clave de API.
Odoo → Aplin (crear en Aplin)
El conector da de alta en Aplin los productos con existencias que falten, y actualiza los que hayan cambiado de nombre o de código de barras.
Requiere una clave de API con acceso extendido. Con una clave estándar, Aplin responde:
403 {"error":"This endpoint requires extended access"}Si te pasa eso, no es un fallo del conector: pide a Aplin una clave con permisos de alta, o usa el modo de vinculación y crea los productos desde su panel.
▶️ Ejecutarlo
Dos formas:
- Sincronizar productos ahora, el botón de los ajustes, para una corrida inmediata.
- El proceso automático Sincronizar productos, cada 10 minutos por defecto.
El botón devuelve un resumen en pantalla:
- En modo vinculación:
N vinculados, M sin correspondencia en Aplin, K sin SKU. - En modo creación:
N creados, M actualizados, K omitidos.
El color del aviso te dice si hay que hacer algo. Verde es que todo cuadra. Ámbar es que hay productos sin correspondencia. Rojo es que Aplin rechazó las altas.
💡 Tip: El detalle completo, con la lista de los SKU que faltan, queda guardado en Inventario → Aplin → Registros, en la operación Resumen de sincronización de productos.
🎯 Qué productos entran
Los que cumplen las tres condiciones:
- Son almacenables.
- Tienen existencias en el almacén configurado.
- Tienen referencia interna (SKU).
Los que no tienen SKU se cuentan como omitidos y se reportan. No es un capricho: sin referencia interna Aplin no puede identificar el producto, y una entrada a medias es peor que un error visible.
En el caso de productos con variantes, cada variante viaja como un producto independiente de Aplin, con su propio SKU. El nombre que se envía incluye los valores de la variante, que es como lo va a reconocer quien esté en el almacén.
👀 Cómo ver el estado
En la ficha del producto:
- Una cinta En Aplin o Parcial en Aplin en la esquina.
- El campo Estado en Aplin en la pestaña Inventario.
- En la variante, su ID en Aplin.
En la lista de productos, la columna Aplin y los filtros En Aplin y Sin sincronizar con Aplin.
Parcial significa que unas variantes están vinculadas y otras no. Es el estado peligroso: las que faltan harán fallar cualquier documento que las incluya, y sin este distintivo no habría forma de detectarlo a tiempo.
Los servicios no muestran estado, porque nunca van a Aplin.
🧩 Qué hacer con los que no casan
Si el resumen te reporta SKU sin correspondencia, tienes tres caminos:
- Darlos de alta en el panel de Aplin con exactamente ese SKU. En la siguiente sincronización quedan vinculados solos.
- Cambiar el modo a Odoo → Aplin, si tienes una clave con acceso extendido.
- Corregir la referencia interna en Odoo, si el producto ya existe en Aplin con otro código.
⚠️ Ojo: el SKU es lo único que une los dos sistemas. Cambiar la referencia interna de un producto ya vinculado no rompe nada —el conector guarda el identificador de Aplin y lo usa con preferencia—, pero sí complica cualquier revisión manual. Trátalos como códigos estables.