La conexión con Odoo viene con los planes Pro Nacional y Enterprise, como los orígenes de importación (página de planes). Trae tus productos, tus clientes con sus direcciones de entrega y una tarifa, y entrega a Odoo como presupuestos los pedidos que se entregan al confirmarse. La configura en «Conectores» quien administra la cuenta, con su segundo factor confirmado. Si en tu cuenta todavía no puedes conectarla, escríbenos desde «Soporte».
Qué Odoo hace falta
MercaMap usa la API JSON-2 de Odoo, que llega con la versión 19. Sirve Odoo Online con el plan Custom (el plan Standard y la app gratis no dan acceso a la API externa), Odoo.sh y un Odoo en tu propio servidor, por https en el puerto 443, con un nombre público y el certificado en regla. Un Odoo sin dirección pública, dentro de tu red, no se puede conectar.
Conecta
Escribe la dirección con la que entras en Odoo (https://ribera.odoo.com), el nombre de la base de datos (en Odoo Online suele ser lo que va delante de .odoo.com, aquí ribera), la empresa tal como la muestra Odoo y la clave de API. La conexión se guarda desactivada: no trae nada ni recibe pedidos hasta que la pruebes y la actives. Cualquier cambio en «Conecta» o en «Elige los datos», o una prueba que no pasa, la pausa de nuevo; si cambias la dirección o la base de datos, vuelve a pegar la clave. La clave se guarda cifrada y no se vuelve a mostrar.
Da acceso
Prepara esto en tu Odoo; «Comprobar», al lado de cada punto, prueba la conexión hasta ese paso sin cambiar nada en Odoo:
- Un usuario para MercaMap. En «Ajustes › Usuarios y compañías › Usuarios», crea un usuario interno solo para MercaMap y, en sus permisos de acceso, dale en Ventas «Usuario: Mostrar todos los documentos»: así lee productos, clientes y tarifas, crea presupuestos y lee sus entregas. No le des el rol de administrador. Como cualquier usuario interno, cuenta en tu suscripción de Odoo.
- Su clave de API. Entra con ese usuario, abre «Mis preferencias», pestaña «Seguridad», y pulsa «Add API Key» (Odoo todavía no traduce ese botón). Ponle de descripción «MercaMap» y la duración más larga que te ofrezca: a un usuario que no es administrador, Odoo le deja 90 días. Copia la clave, que Odoo enseña una sola vez, y pégala en «Conecta».
- La empresa. El usuario tiene que pertenecer a la empresa que escribiste: leemos y escribimos solo en ella.
La página dice cuándo caduca la clave y te avisa 14 días antes: pega otra en «Cambiar la conexión», prueba la conexión y actívala.
Elige los datos
Cada parte que marcas es un origen de importación propio, con «Traer ahora», una programación si la quieres y su historial. Lo que trae se importa como un archivo que subes, y en Odoo no cambia nada.
- Productos, en tus referencias: la referencia interna como código (sin ella,
odoo-y su número en Odoo), el nombre y el código de barras. El tamaño de caja es el del primer embalaje que tenga de los que nombras como caja, en orden («Caja de 12, Caja de 6»), en unidades enteras; sin ninguno, la referencia conserva el suyo, y una referencia nueva sin él se rechaza. Los servicios y los productos que no se venden se quedan fuera; puedes traer solo una categoría con sus subcategorías. - Clientes y sus direcciones de entrega, en tus códigos de tienda. Escribe cada cliente que es de una cadena, uno por línea, con su referencia en Odoo (
C0001 = Masymas; sin referencia,odoo-y su número): cada dirección de entrega es una tienda de esa cadena, con el código cliente/dirección (C0001/T01), que buscamos en nuestro directorio por su dirección y código postal; un cliente sin direcciones de entrega es él mismo una tienda. Si Odoo tiene el campo GLN, viene con cada una. Se quedan fuera los clientes que no escribes y una referencia que llevan dos. - Una tarifa, en una de tus listas de precios: el precio fijo vigente de cada producto para una unidad, de una tarifa en euros (otra moneda no trae nada). Si en Odoo manda una regla de una categoría o de todos los productos, un descuento o una fórmula, ese producto se queda sin precio: no lo calculamos.
Si nombras una categoría, una tarifa o un embalaje que tu Odoo no tiene, el origen falla y lo dice, sin traer un archivo a medias.
Los pedidos
Marca «Entregar a Odoo, como presupuestos, los pedidos que se entregan al confirmarse»; la entrega tiene que ser «Al confirmarse cada pedido» (Archivos del ERP y entrega de pedidos), y solo una conexión de la cuenta recibe los pedidos. Cada uno llega a Odoo como presupuesto, para el cliente y la dirección de entrega del código de la tienda (C0001/T01), con una línea por referencia (el producto por su referencia interna, las unidades en su unidad) y con el identificador de nuestro pedido, sin guiones, en «Referencia del cliente». Antes de crearlo buscamos ese identificador, así que un pedido cuya respuesta se perdió nunca se crea dos veces.
Odoo pone los precios como a cualquier presupuesto, y tu oficina lo confirma. Su número (S00042) vuelve como la respuesta: el pedido se muestra como «Aceptado por el ERP». Cuando Odoo termina todas sus entregas, el pedido muestra la última y su fecha; la buscamos durante 30 días.
En «Prueba y activa», la página cuenta los pedidos que esperan y los que no se han podido entregar, con el motivo:
- Odoo no tiene alguno de los productos: entrega ese pedido por archivo.
- La tienda no tiene código de cliente, u Odoo no tiene ese cliente o esa dirección: corrígelo y pulsa «Volver a intentarlo», o entrégalo por archivo.
- Odoo no acepta la clave, a su usuario le falta un permiso, o la empresa o la base de datos ya no están: corrígelo, prueba la conexión, actívala y pulsa «Volver a intentarlo».
- Tu Odoo tarda demasiado o responde con un error: lo intentamos más tarde y paramos tras varios fallos seguidos; «Volver a intentarlo» entrega de nuevo los detenidos.
Cuando Odoo pide esperar, los pedidos esperan el tiempo que indica, sin contar como fallo. Con la conexión en pausa, los pedidos se entregan por archivo, también los que esperaban.
Qué guardamos
La dirección (el nombre del servidor), la base de datos, la empresa, lo que lee cada parte y las cadenas de los clientes, hasta que borras la conexión o se cierra la cuenta; la clave, cifrada, con cuándo la pegaste y cuándo caduca, solo para hablar con tu Odoo y nunca en un registro, hasta que la cambias o borras la conexión. Cada pedido que Odoo recibe guarda su número y su última entrega con su fecha, como el resto del pedido. «Borrar la conexión», tras confirmarlo, borra sus orígenes (las importaciones que abrieron se quedan) y deja de entregar pedidos. Para retirar el acceso en Odoo, borra la clave en «Mis preferencias › Seguridad» de su usuario o archiva el usuario.