Convierta GSE-Web en el WMS de su
ERP Odoo
Odoo conserva sus artículos, sus terceros, sus pedidos y su contabilidad. GSE-Web prepara, expide, recibe y cuenta la mercancía, y manda sobre el stock físico.
Esta documentación describe el funcionamiento del conector Odoo. Todavía no está abierto a las organizaciones: la entrada «Odoo» de la página «Integraciones» solo estará disponible cuando termine su puesta en servicio. Escríbanos si desea que le avisemos de su apertura.
En resumen
El conector Odoo une un Odoo (versiones 17, 18 y 19) a un almacén de GSE-Web. Odoo sigue siendo el maestro de sus artículos, de sus terceros y de sus pedidos; GSE-Web manda sobre el stock físico. Lo configura un administrador de la organización, en el menú ADMIN › «Integraciones». Cada intercambio es una opción, desactivada por defecto: usted compone el conector que le conviene.
- Lo que llega a GSE-Web: los pedidos de venta confirmados del almacén vinculado, que se convierten en vales de salida confirmados, con stock reservado; los pedidos de compra confirmados, que se convierten en pedidos a proveedor; como opción, los artículos y los terceros de Odoo.
- Lo que va a Odoo: cada entrada, salida, ajuste, inventario o transferencia del almacén vinculado, en forma de movimiento de stock (nunca una cantidad sobrescrita), unos segundos después; las entregas y las recepciones validadas en GSE-Web; como opción, las fichas de producto de GSE-Web.
- Cuándo: si marca «Recibir las notificaciones de Odoo», un pedido llega en cuanto Odoo avisa a GSE-Web. Un pase periódico (5 minutos por defecto, de 1 a 15) sirve de red de seguridad y recupera lo que hubiera faltado.
- Lo que nunca se hace: no se convierte ninguna cantidad, no se crea ningún vale parcial, no se elimina nada en Odoo y una diferencia de stock nunca se corrige en silencio. La facturación y la contabilidad siguen en Odoo.
- Desconexión: pausa, desconexión o cierre del módulo en cualquier momento, sin perder nada; al reanudar, se recuperan los pedidos realizados entretanto.
Requisitos
Compruebe estos puntos antes de abrir la pantalla del conector: la prueba de conexión los verifica y rechaza con claridad lo que no encaja.
Odoo 17, 18 o 19
Se admiten las tres versiones. GSE-Web lee la versión de Odoo y elige el protocolo de intercambio: JSON-RPC hasta Odoo 18, JSON-2 a partir de Odoo 19. Cualquier otra versión se rechaza con claridad.
Un usuario de integración y su clave de API
Cree en Odoo un usuario reservado a GSE-Web y genérele una clave de API (Preferencias › Seguridad de la cuenta › Nueva clave de API). Derechos necesarios: «Inventario / Usuario» para escribir movimientos, «Ventas / Usuario» y «Compras / Usuario» para leer los pedidos, «Ajustes técnicos» solo para activar el tiempo real.
Un Odoo accesible desde Internet, en HTTPS
La dirección del servidor debe ser pública y en HTTPS, sin credenciales ni parámetros. Una dirección de red privada se rechaza. En Odoo Online, el acceso externo solo existe en los planes «Custom».
Los módulos abiertos para su organización
«Integraciones» y luego «Odoo». Su apertura se solicita a KLS-Concept. Sin «Integraciones», la entrada del menú no aparece; sin «Odoo», su tarjeta indica «No disponible para su organización».
Una cuenta ADMIN con autenticación en dos pasos
La introducción de la clave de API se rechaza mientras la autenticación en dos pasos no esté activada en su cuenta, en «Mi información».
Un almacén real y un almacén de Odoo
El conector une un almacén de Odoo con un almacén real de GSE-Web. Un almacén de ejercicio se rechaza. Solo un almacén por conexión.
La misma divisa
La divisa de la sociedad de Odoo debe ser la de su organización. Si Odoo tiene varias sociedades, usted elige la que se va a vincular.
Para el tiempo real: «Acciones automatizadas»
Para que los pedidos lleguen en cuanto Odoo avisa a GSE-Web, el módulo «Acciones automatizadas» debe estar instalado en Odoo. Si no, solo funciona el pase periódico, y un punto por tratar se lo indica.
Configuración paso a paso
Seis pasos, en el orden de la pantalla.
Abrir la pantalla del conector
Menú ADMIN › «Integraciones». La tarjeta Odoo está en la categoría «ERP». Haga clic en «Configurar» (el botón pasa a «Gestionar» una vez guardada la conexión).
Tarjeta «Servidor Odoo»
Rellene la «Dirección del servidor» (por ejemplo https://miempresa.odoo.com), la «Base de datos», el «Usuario de integración» (normalmente su dirección de correo en Odoo), la «Clave de API» y el «Almacén de GSE-Web» que se va a vincular. El «Protocolo de intercambio» se queda en «Automático» salvo necesidad concreta.
La clave de API es de solo escritura: una vez guardada, no vuelve a mostrarse; la pantalla solo muestra algunos caracteres. Para conservarla, deje el campo vacío; para sustituirla, introduzca una nueva. Si cambia la dirección del servidor o la base, la clave debe volver a introducirse: nunca acompaña a otro destino.
Probar la conexión y luego elegir la sociedad y el almacén de Odoo
Guarde y luego «Probar la conexión»: GSE-Web consulta Odoo, comprueba la clave, los derechos, la versión y la divisa, y la pantalla muestra, por ejemplo, «Odoo 18.0 · protocolo JSON-RPC». Odoo declara entonces sus sociedades y sus almacenes: elija la «Sociedad de Odoo» (obligatoria en cuanto hay varias) y el «Almacén de Odoo» vinculado al almacén de GSE-Web, y luego «Guardar». Incluso si se rechaza, la prueba conserva lo que Odoo ha declarado, para que pueda corregirlo.
Componer las opciones
La tarjeta «Lo que circula entre GSE-Web y Odoo» agrupa las opciones por tema. Todo está desmarcado por defecto: marque solo lo que necesite.
- Ventas › «Importar los pedidos de venta de Odoo»: con los «Estados de pedido de venta importados» («Confirmado» por defecto, y «Bloqueado» además si lo desea).
- Ventas › «Validar las entregas en Odoo»: un vale entregado valida la entrega del pedido en Odoo.
- Stock › «Enviar los movimientos de stock a Odoo en tiempo real»: cada movimiento del almacén vinculado va a Odoo.
- Stock › «Medir las diferencias de stock cada noche»: GSE-Web compara su stock con el de Odoo.
- Compras › «Importar los pedidos de compra de Odoo»: con los «Estados de pedido de compra importados» («Confirmado» por defecto, y «Bloqueado» además si lo desea).
- Compras › «Validar las recepciones en Odoo»: una recepción hecha en GSE-Web se valida en Odoo.
- Artículos y terceros › «Tomar los artículos de Odoo» o «Enviar las fichas de producto de GSE-Web a Odoo»: son excluyentes entre sí, un solo maestro de artículos; marcar una desmarca la otra. La «Correspondencia de unidades de medida» asocia el identificador de una unidad de Odoo con el código de la unidad de GSE-Web.
- Artículos y terceros › «Tomar los terceros de Odoo»: dirección, IVA y condiciones de pago de los clientes.
- Tiempo real › «Recibir las notificaciones de Odoo»: los pedidos llegan en cuanto Odoo avisa a GSE-Web.
- Tiempo real › «Cadencia del sondeo de respaldo (minutos)»: 5 por defecto, de 1 a 15. «Antigüedad máxima de un pedido recuperado (días)»: 30 por defecto, de 1 a 90; un pedido más antiguo se convierte en un punto por tratar en lugar de importarse de oficio.
Guardar y probar
Haga clic en «Guardar». «Probar la conexión» y «Activar» actúan sobre la configuración guardada: mientras un cambio no esté guardado, la pantalla lo recuerda. Si está marcada una opción que escribe en Odoo y el usuario de integración no tiene derecho de escritura, la prueba lo señala.
Activar
«Activar» repite la prueba (en ese momento se exige un almacén de Odoo). Si «Recibir las notificaciones de Odoo» está marcada, GSE-Web crea en Odoo acciones automatizadas «GSE-Web» que le avisan en cada cambio. El estado pasa a «Activa — sondeo de respaldo cada N minutos». Lo anterior a la activación nunca se repite: ni pedidos, ni movimientos de stock previos.
Qué se sincroniza, y quién manda
Cada dato tiene un único maestro. GSE-Web no impone a Odoo sus artículos ni sus pedidos; Odoo nunca impone a GSE-Web una cantidad física.
📦 Manda GSE-Web
- ✓Stock físico: cantidades y movimientos
- ✓Entregas: lo que realmente ha salido
- ✓Recepciones: lo que realmente ha llegado
- ✓Artículos, si elige «Enviar las fichas de producto de GSE-Web a Odoo»
🏢 Manda Odoo
- ✓Pedidos de venta
- ✓Pedidos de compra
- ✓Terceros (clientes)
- ✓Artículos, por defecto o si elige «Tomar los artículos de Odoo»
- ✓Facturación
- ✓Contabilidad
Las reglas
- Un solo maestro de artículos. «Tomar los artículos de Odoo» y «Enviar las fichas de producto de GSE-Web a Odoo» se excluyen. Los artículos se emparejan por referencia (código interno de Odoo = referencia de GSE-Web); nunca se eliminan en Odoo, un producto retirado se archiva allí.
- Un pedido de venta = un vale de salida confirmado del almacén vinculado, sobre la cantidad pendiente de entregar, con la casilla «Reservar los productos para este albarán» marcada: se reserva toda la cantidad, incluso por encima del stock (lo que falta se lee «Pendiente de recepción» en el vale).
- Nunca un vale parcial. Si una línea da problemas — artículo desconocido, unidad distinta de la unidad de stock, artículo seguido por lote o número de serie, divisa distinta, cliente archivado — no se crea ningún vale y un punto por tratar lo explica. «Repetir» retoma la importación una vez corregida la causa. Nunca se convierte ninguna cantidad.
- Un cliente = un tercero con el código de Odoo. El código del tercero es la referencia (
ref) del cliente en Odoo, oODOO-seguido de su identificador si no tiene ninguna. Nunca se empareja por e-mail. - Pedido anulado en Odoo: el vale se anula y se liberan sus reservas, salvo que alguien ya lo esté tramitando; en ese caso, un punto por tratar deja la decisión al equipo. Pedido modificado tras la importación: la modificación no se traslada al vale, un punto por tratar le invita a revisarlo. Pedido ya entregado fuera de GSE-Web: ningún vale, un punto por tratar lo indica.
- Entrega validada en Odoo: un vale entregado o cerrado valida la entrega con las cantidades realmente preparadas. Si ha salido menos de lo solicitado, el resto queda abierto en Odoo. GSE-Web nunca anula un pedido en Odoo.
- Stock en movimientos, nunca en valor sobrescrito. Cada entrada, ajuste, inventario o transferencia del almacén vinculado se convierte en un movimiento de stock en Odoo, unos segundos después del cambio. Un mismo movimiento nunca se envía dos veces. No se repite nada anterior a la activación. La valoración (coste) sigue en Odoo.
- Sin doble recuento. Una salida procedente de un pedido importado de Odoo se descuenta en Odoo mediante su entrega, y una recepción de un pedido de compra importado mediante su recepción: esos movimientos no se envían además como movimientos de stock.
- Diferencias medidas, nunca corregidas en silencio. Cada noche, GSE-Web compara su stock con el de Odoo, artículo por artículo. Una diferencia se convierte en un punto por tratar con las dos cantidades; no se escribe nada, en ningún sentido. «Alinear Odoo con GSE-Web» es un gesto del ADMIN: envía a Odoo un ajuste fechado, el stock de GSE-Web no se modifica.
- Un pedido de compra = un pedido a proveedor confirmado del módulo Compras, del tercero proveedor con el mismo código, al precio neto de la línea, con su fecha prevista. Los mismos rechazos que en las ventas: nunca un pedido parcial. Un pedido modificado o anulado en Odoo tras la importación no se traslada: un punto por tratar lo indica.
- Recepción validada en Odoo: una recepción hecha en GSE-Web sobre un pedido importado valida la recepción del pedido en Odoo con la cantidad recibida; lo que queda por recibir sigue abierto.
- Tiempo real y red de seguridad. Con «Recibir las notificaciones de Odoo», Odoo avisa a GSE-Web en cada cambio; GSE-Web agrupa las notificaciones (2 segundos de calma, 10 como máximo) y luego vuelve a leer los registros en Odoo. Sin esta opción, o si Odoo no puede llamar, basta el pase periódico. Las variantes de Odoo se toman como productos simples independientes.
En el día a día
La pantalla del conector se lee de arriba abajo: el estado, el servidor, las opciones, los botones, y después los puntos por tratar y el registro.
La tarjeta «Estado»
Indica en qué punto está la conexión, la versión de Odoo y el protocolo elegido, la fecha de la última sincronización, el último error y el número de puntos por tratar. En la tarjeta de la página «Integraciones», el estado cabe en una etiqueta.
- Por activar «Configurada, aún sin activar».
- Conectado «Activa — sondeo de respaldo cada N minutos».
- En pausa «En pausa — no se envía ni se importa nada».
- Detenido — revisar «Detenida por el servidor — compruebe la clave y pruebe».
«Sincronizar ahora»
Los pedidos llegan en cuanto Odoo avisa a GSE-Web, o como muy tarde en el próximo sondeo, y el stock va a Odoo unos segundos después de cada movimiento: la pantalla lo recuerda bajo el botón. Este botón solo sirve para lanzar de inmediato un pase completo. El mensaje indica si el pase ha terminado, si ha detectado puntos por tratar o por qué no se ha lanzado.
La tarjeta «Lo que circula entre GSE-Web y Odoo»
Enumera las opciones por tema — Ventas, Stock, Compras, Artículos y terceros, Tiempo real — con lo que hace cada una. Las opciones que escriben en Odoo llevan la mención «Escribe en Odoo: el usuario de integración debe tener derecho de escritura». Si Odoo no puede avisar a GSE-Web, la pantalla lo indica y solo funciona el sondeo de respaldo.
El «Registro»
Cada pase figura con su tipo y su resultado. Tipos: «Envío de fichas de producto», «Toma de artículos de Odoo», «Toma de terceros de Odoo», «Envío de stock (recuperación)», «Stock en directo», «Recuperación de pedidos de venta», «Pedido recibido de Odoo», «Entregas validadas en Odoo», «Recuperación de pedidos de compra», «Recepciones validadas en Odoo», «Medición de diferencias de stock», «Control de las acciones automatizadas», «Prueba de conexión». Resultados: «Correcto», «Parcial», «Fallido», «En curso», «Interrumpido». Un clic en un pase abre su detalle, elemento por elemento: pedido importado, entrega validada, movimiento enviado o ya presente en Odoo, artículo creado, actualizado o vinculado… (200 elementos como máximo por pase). Los pases que no han cambiado nada pueden ocultarse.
Los «Puntos por tratar»
Una línea que no pasa nunca bloquea la sincronización: se convierte en un punto por tratar y el resto continúa. Corrija la causa en Odoo o en GSE-Web y luego «Repetir»; si no, «Ignorar».
- «Repetir» se ofrece para los pedidos de venta y de compra, las entregas y las recepciones: vuelve a leer el registro en Odoo y lo reintenta. Los demás puntos desaparecen solos una vez corregida su causa.
- «Ignorar» archiva el punto: un punto ignorado no vuelve mientras su causa no haya desaparecido y vuelto a aparecer. «Ignorar todo», en la cabecera de la lista, archiva de una vez todos los puntos abiertos tras una confirmación; con ello no se importa ningún pedido.
Notificaciones de Odoo
- Causa
- «Recibir las notificaciones de Odoo» está marcada, pero el módulo «Acciones automatizadas» no está instalado en Odoo, o el usuario de integración no tiene los derechos técnicos para crear las acciones.
- Qué hacer
- Instale el módulo en Odoo y dé al usuario de integración el derecho «Ajustes técnicos», y luego pruebe de nuevo. Mientras tanto, el pase periódico importa los pedidos.
- Causa
- Alguien ha desactivado o eliminado en Odoo una acción «GSE-Web»; el control, cada 6 horas, lo ha detectado.
- Qué hacer
- GSE-Web la reactiva o la recrea cuando puede, y el registro lo indica. Si no, compruebe en Odoo que las acciones «GSE-Web» estén activas.
Artículos y terceros
- Causa
- Los movimientos de stock se envían, pero ningún artículo almacenable de Odoo tiene la referencia de este producto.
- Qué hacer
- Cree el artículo en Odoo con la misma referencia (almacenable), o marque «Enviar las fichas de producto de GSE-Web a Odoo». El punto desaparece cuando el movimiento se envía.
- Causa
- Odoo ha rechazado la ficha enviada por GSE-Web; se muestra su código de rechazo.
- Qué hacer
- Revise los derechos del usuario de integración y la ficha del artículo en Odoo a partir de ese código.
- Causa
- El artículo vinculado ya no existe en Odoo.
- Qué hacer
- Vuelva a crearlo en Odoo con la misma referencia. Si ya no debe figurar allí, escríbanos.
- Causa
- El conector no gestiona los artículos seguidos por lote o por número de serie de Odoo.
- Qué hacer
- Nada que hacer en GSE-Web: este artículo no se toma. Gestiónelo directamente en Odoo.
- Causa
- La unidad de medida del artículo en Odoo no está en la «Correspondencia de unidades de medida».
- Qué hacer
- Añada el identificador de la unidad de Odoo y el código de la unidad de GSE-Web correspondiente, guarde y luego vuelva a lanzar la sincronización.
- Causa
- La referencia de este producto la llevan varios artículos en Odoo, o un artículo ya vinculado a otro producto de GSE-Web.
- Qué hacer
- Asegúrese de que una referencia designe un solo artículo, en ambos lados.
- Causa
- La ficha del tercero no se pudo crear o actualizar en GSE-Web.
- Qué hacer
- Revise la ficha del tercero en Odoo (nombre, dirección) y luego vuelva a lanzar la sincronización; si el punto reaparece, escríbanos.
Pedidos de venta
- Causa
- Una línea del pedido lleva una referencia que no existe en GSE-Web.
- Qué hacer
- Cree el producto con la misma referencia (o marque «Tomar los artículos de Odoo») y luego «Repetir».
- Causa
- La línea está expresada en una unidad distinta de la unidad de stock del artículo (por ejemplo, docenas). Nunca se convierte ninguna cantidad.
- Qué hacer
- Corrija la línea en Odoo para que esté en la unidad de stock y luego «Repetir».
- Causa
- Una línea lleva un artículo seguido por lote o por número de serie en Odoo.
- Qué hacer
- Tramite este pedido directamente en Odoo; el conector no admite esos artículos.
- Causa
- La divisa del pedido no es la de su organización.
- Qué hacer
- Utilice la divisa de la organización para este pedido en Odoo y luego «Repetir».
- Causa
- El pedido tiene más días que la «Antigüedad máxima de un pedido recuperado» (30 por defecto), por ejemplo tras una pausa larga.
- Qué hacer
- Si aun así desea tramitarlo, «Repetir» lo importa; si no, «Ignorar».
- Causa
- El tercero correspondiente al cliente está archivado en GSE-Web.
- Qué hacer
- Reactive el tercero en GSE-Web y luego «Repetir».
- Causa
- El vale ya lo está tramitando alguien: GSE-Web no lo anula por encima del equipo.
- Qué hacer
- Decida con el equipo si se anula el vale o se sirve, y luego «Repetir» o «Ignorar».
- Causa
- GSE-Web no escribe en un vale ya creado los cambios hechos después en el pedido.
- Qué hacer
- Revise el vale y corríjalo a mano si es necesario, y luego «Ignorar».
- Causa
- Odoo ya ha entregado este pedido cuando llega: un vale haría salir la mercancía por segunda vez.
- Qué hacer
- Registre la salida de stock correspondiente en GSE-Web si no figura, y luego «Ignorar».
- Causa
- El vale no se pudo crear; se muestra el motivo.
- Qué hacer
- Corrija la causa indicada y luego «Repetir»; si el punto reaparece, escríbanos.
- Causa
- GSE-Web nunca anula un pedido en Odoo.
- Qué hacer
- Anule el pedido en Odoo si es necesario y luego «Ignorar».
Entregas y stock
- Causa
- Odoo no ha aceptado la validación: pedido eliminado en Odoo, línea del vale ausente del pedido, o ninguna cantidad preparada.
- Qué hacer
- Corrija la causa indicada en Odoo o en GSE-Web y luego «Repetir».
- Causa
- Odoo ha rechazado el movimiento; se muestra el motivo.
- Qué hacer
- Revise los derechos «Inventario / Usuario» del usuario de integración y el artículo en Odoo. El punto desaparece cuando el movimiento se envía.
- Causa
- El stock de GSE-Web y el de Odoo difieren para este artículo. No se ha escrito nada.
- Qué hacer
- Busque el origen de la diferencia. Si GSE-Web tiene razón, «Alinear Odoo con GSE-Web» envía a Odoo un ajuste fechado, tras confirmar las dos cantidades.
Compras y recepciones
- Causa
- Una línea del pedido de compra lleva una referencia ausente de GSE-Web.
- Qué hacer
- Cree el producto con la misma referencia y luego «Repetir».
- Causa
- La línea está expresada en una unidad distinta de la unidad de stock. No se convierte ninguna cantidad.
- Qué hacer
- Corrija la línea en Odoo y luego «Repetir».
- Causa
- Ningún tercero proveedor de GSE-Web tiene el código del proveedor del pedido.
- Qué hacer
- Cree el proveedor con el mismo código (o marque «Tomar los terceros de Odoo») y luego «Repetir».
- Causa
- La divisa del pedido no es la de su organización.
- Qué hacer
- Utilice la divisa de la organización en Odoo y luego «Repetir».
- Causa
- Una línea lleva un artículo seguido por lote o por número de serie en Odoo.
- Qué hacer
- Tramite este pedido directamente en Odoo.
- Causa
- El pedido tiene más días que la «Antigüedad máxima de un pedido recuperado».
- Qué hacer
- «Repetir» lo importa a pesar de su antigüedad; si no, «Ignorar».
- Causa
- GSE-Web no traslada a un pedido a proveedor ya creado los cambios hechos después en Odoo.
- Qué hacer
- Revise el pedido a proveedor y corríjalo a mano si es necesario, y luego «Ignorar».
- Causa
- El pedido a proveedor no se pudo crear; se muestra el motivo.
- Qué hacer
- Corrija la causa indicada y luego «Repetir»; si el punto reaparece, escríbanos.
- Causa
- Odoo no ha aceptado la validación de la recepción; se muestra el motivo.
- Qué hacer
- Corrija la causa indicada en Odoo o en GSE-Web y luego «Repetir».
Pausa, reanudación y cambios
El conector se desactiva y se vuelve a activar en cualquier momento. Algunos cambios siguen una regla, que la pantalla recuerda y que el servidor hace cumplir.
«Poner en pausa»
Ya no se envía ni se importa nada, y no se pierde nada.
«Reanudar»
Se lanza la recuperación: los pedidos realizados durante la pausa se importan si tienen menos de N días («Antigüedad máxima de un pedido recuperado», 30 por defecto). Los más antiguos pasan a ser puntos por tratar.
Cambiar de servidor, de base, de clave, de almacén de Odoo o de almacén de GSE-Web
Con una conexión activa, estos ajustes están bloqueados. Siga este orden: «Poner en pausa», modificar, «Guardar», «Probar la conexión», «Reanudar». Para cambiar de servidor, primero «Desconectar»: se retiran las acciones automatizadas del antiguo Odoo. La clave de API debe volver a introducirse en cuanto cambia el servidor o la base.
«Desconectar»
Tras una confirmación, las acciones automatizadas «GSE-Web» se retiran de Odoo y la clave de API se borra. No se elimina nada, ni en Odoo ni en GSE-Web: los vales, terceros y pedidos ya creados se mantienen. Si Odoo no responde, la pantalla le pide que elimine usted mismo las acciones «GSE-Web» desde Odoo.
Volver a conectar el mismo servidor
Los pedidos, artículos y terceros ya vinculados se recuperan: no se crea un segundo vale para un pedido ya importado.
Lo anterior a la activación
Los pedidos y los movimientos de stock anteriores a la activación nunca se repiten. El pase periódico vuelve a leer el diario de stock un poco hacia atrás para no perder nada, sin remontarse nunca antes de la activación.
Elegir quién es el maestro de los artículos
«Tomar los artículos de Odoo» y «Enviar las fichas de producto de GSE-Web a Odoo» no se marcan a la vez: marcar una desmarca la otra. Piénselo antes de activar, para evitar que un lado reescriba el otro.
Cierre del módulo
Si KLS-Concept cierra el módulo para su organización, todo se detiene sin eliminar nada. Al reabrirlo, el pase siguiente recupera los pedidos; los vales, terceros y pedidos ya creados siguen siendo ordinarios.
Seguridad y datos
Lo que guarda el conector, y cómo.
Clave de API cifrada
La clave de API se cifra en el servidor (AES-256-GCM). Es de solo escritura: nunca vuelve a mostrarse ni se escribe en los registros, y debe volver a introducirse en cuanto cambia el servidor o la base.
Autenticación en dos pasos
Es obligatoria para introducir o sustituir la clave de API de un Odoo.
Solo HTTPS público
El conector solo llama a la dirección HTTPS introducida, en un host público; no se sigue ninguna redirección y una dirección de red privada se rechaza.
Notificaciones con dirección secreta
Odoo no firma sus notificaciones. Cada notificación llega a una dirección secreta, y su contenido nunca se da por bueno: GSE-Web vuelve a leer el registro en Odoo antes de actuar.
Movimientos sin duplicados
Cada movimiento de stock lleva una referencia que permite a GSE-Web comprobar, antes de escribir, que no está ya en Odoo. Nunca se sobrescribe ninguna cantidad, no se elimina nada en Odoo.
Trazabilidad
Quién ha conectado Odoo, cambiado la clave, suspendido la sincronización, y cada escritura de GSE-Web en Odoo (entrega, recepción, movimiento, alineación) figuran en el registro de auditoría de la organización, sin incluir nunca el valor de la clave.
Resolución de problemas
El mensaje que muestra la pantalla y lo que hay que hacer. El código entre corchetes ayuda al soporte a localizar el caso.
«Detenida por el servidor — compruebe la clave y pruebe»
Tras cinco rechazos de autenticación seguidos (clave revocada, usuario eliminado, contraseña cambiada), el servidor detiene la conexión para no insistir. Compruebe la clave en Odoo, introduzca una nueva si es necesario, «Guardar», «Probar la conexión» y luego «Activar».
- Qué hacer
- Introduzca la dirección completa, que empieza por https://, sin usuario ni parámetros.
[ODOO_SERVER_URL_INVALID]
- Qué hacer
- El conector solo llama a servidores públicos. Utilice la dirección pública de su Odoo.
[ODOO_SERVER_URL_PRIVATE_HOST]
- Qué hacer
- Indique el nombre de la base a la que se conecta el usuario de integración, guarde y luego pruebe.
[ODOO_DATABASE_REQUIRED]
- Qué hacer
- Revise la base, el usuario y la clave de API, y que el usuario de integración esté activo. Genere una nueva clave si es necesario.
[ODOO_SERVER_AUTH_FAILED]
- Qué hacer
- El conector no se conecta a ninguna otra versión de Odoo.
[ODOO_SERVER_VERSION_UNSUPPORTED]
- Qué hacer
- Dele los derechos «Inventario / Usuario», o desmarque la opción que escribe en Odoo.
[ODOO_SERVER_READ_ONLY]
- Qué hacer
- «Probar la conexión», elija la «Sociedad de Odoo» y luego «Guardar».
[ODOO_COMPANY_REQUIRED]
- Qué hacer
- Pruebe de nuevo la conexión y elija una sociedad de la lista propuesta.
[ODOO_COMPANY_UNKNOWN]
- Qué hacer
- El conector solo une una sociedad en la divisa de su organización.
[ODOO_SERVER_CURRENCY_MISMATCH]
- Qué hacer
- Elija el «Almacén de GSE-Web» que se va a vincular y luego «Guardar».
[ODOO_WAREHOUSE_REQUIRED]
- Qué hacer
- Elija un almacén real.
[ODOO_WAREHOUSE_EXERCISE_REFUSED]
- Qué hacer
- «Probar la conexión», elija el «Almacén de Odoo», «Guardar» y luego «Activar».
[ODOO_REMOTE_WAREHOUSE_REQUIRED]
- Qué hacer
- Pruebe de nuevo la conexión y elija un almacén de la sociedad seleccionada.
[ODOO_REMOTE_WAREHOUSE_UNKNOWN]
- Qué hacer
- Compruebe que su Odoo responde desde Internet y vuelva a intentarlo.
[ODOO_SERVER_UNREACHABLE]
- Qué hacer
- Vuelva a intentarlo un poco más tarde.
[ODOO_SERVER_TIMEOUT]
- Qué hacer
- Espere: el pase siguiente se reanuda solo.
[ODOO_SERVER_RATE_LIMITED]
- Qué hacer
- Vuelva a intentarlo; si el mensaje se repite, escríbanos con el código que figura más abajo.
[ODOO_SERVER_RESPONSE_INVALID]
- Qué hacer
- Lea el mensaje de Odoo: suele indicar lo que falta (derecho, registro, campo). Corríjalo en Odoo y vuelva a intentarlo.
[ODOO_REMOTE_ERROR]
- Qué hacer
- «Poner en pausa», modificar, «Guardar», «Probar la conexión», «Reanudar».
[ODOO_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Qué hacer
- «Desconectar» y luego introduzca el nuevo servidor.
[ODOO_SERVER_CHANGE_REQUIRES_DISCONNECT]
- Qué hacer
- Introduzca la clave de API. Debe volver a introducirse en cuanto cambia la dirección del servidor o la base.
[ODOO_CREDENTIALS_REQUIRED]
- Qué hacer
- Actívela en «Mi información» (la pantalla propone «Abrir «Mis datos»») y vuelva a guardar.
[ODOO_CONNECTION_TWO_FACTOR_REQUIRED]
- Qué hacer
- Lo más habitual: «Tomar los artículos de Odoo» y «Enviar las fichas de producto de GSE-Web a Odoo» están marcadas a la vez. Conserve solo una.
[ODOO_SETTINGS_INVALID]
- Qué hacer
- Nada que hacer: la diferencia ya se ha resuelto.
[ODOO_STOCK_ALIGN_NOTHING_TO_DO]
- Qué hacer
- Vuelva a introducir la clave de API, pruebe y luego active.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Qué hacer
- Espere a que termine el pase en curso.
[INTEGRATIONS_CONNECTION_BUSY]
Preguntas frecuentes
¿Está disponible el conector Odoo?
Está en proceso de puesta en servicio: esta página describe su funcionamiento, pero todavía no está abierto a las organizaciones. Escríbanos desde la página de contacto si desea que le avisemos de su apertura.
¿Qué versiones de Odoo se admiten?
Odoo 17, 18 y 19. GSE-Web lee la versión y elige el protocolo: JSON-RPC hasta Odoo 18, JSON-2 a partir de Odoo 19. Cualquier otra versión se rechaza con claridad, sin cambio silencioso.
¿Quién manda: GSE-Web u Odoo?
GSE-Web manda sobre el stock físico, las entregas y las recepciones. Odoo conserva los artículos (o GSE-Web, si así lo elige), los terceros, los pedidos de venta y de compra, la facturación y la contabilidad. Odoo nunca escribe una cantidad física en GSE-Web: su stock solo se lee, para medir las diferencias.
¿El stock de GSE-Web sobrescribe el de Odoo?
No. Cada entrada, ajuste, inventario o transferencia va a Odoo en forma de movimiento de stock, nunca como una cantidad sobrescrita. Un movimiento ya presente en Odoo no se vuelve a enviar. Una diferencia se mide cada noche y nunca se corrige en silencio: «Alinear Odoo con GSE-Web» es un gesto del ADMIN.
¿Hay que activarlo todo?
No. Cada intercambio es una opción, desactivada por defecto: ventas, entregas, stock, diferencias, compras, recepciones, artículos, terceros, notificaciones. Usted marca solo lo que necesita, por ejemplo los pedidos de venta, el stock y las entregas sin las compras, o al revés.
¿Qué ocurre si una línea de pedido da problemas?
No se crea ningún vale, nunca un vale parcial, y un punto por tratar explica el motivo: artículo desconocido, unidad distinta de la unidad de stock, artículo seguido por lote o número de serie, divisa distinta. Corrija la causa y luego «Repetir». Nunca se convierte ninguna cantidad.
¿Se gestionan los artículos con lote o número de serie?
No. Los artículos seguidos por lote o por número de serie en Odoo se rechazan, con un punto por tratar. La facturación y la contabilidad tampoco entran en el alcance del conector.
¿Se toman las variantes de Odoo?
Sí, como productos simples independientes. La jerarquía de padre e hijos de las variantes de GSE-Web no se toma por el momento.
¿Cuánto tarda un pedido en llegar a GSE-Web?
Al instante si «Recibir las notificaciones de Odoo» está marcada y si Odoo puede llamar a GSE-Web (módulo «Acciones automatizadas» instalado). Si no, como muy tarde en el siguiente pase periódico (5 minutos por defecto, ajustable de 1 a 15).
¿Y el stock hacia Odoo?
Unos segundos después de cada cambio en el almacén vinculado, si «Enviar los movimientos de stock a Odoo en tiempo real» está marcada. El pase periódico recupera un envío que se hubiera perdido.
Mi Odoo no es accesible desde Internet. ¿Es posible?
No. El conector solo llama a servidores públicos en HTTPS. En Odoo Online, el acceso externo solo existe en los planes «Custom».
¿Qué ocurre si pongo en pausa o si desconecto?
En pausa, no se envía ni se importa nada y no se pierde nada; al reanudar, se recuperan los pedidos realizados entretanto. Al desconectar, las acciones automatizadas «GSE-Web» se retiran de Odoo y la clave se borra; los vales, terceros y pedidos ya creados se mantienen, y volver a conectar el mismo servidor no crea ningún segundo vale.
Conectar su Odoo con GSE-Web
Solicite que le avisemos de la apertura del conector para su organización, o envíenos sus preguntas sobre su caso.