Si usas Odoo, en esta documentación aprenderás a asignar cada dato de tus ventas al campo correspondiente de Odoo, para que tus pedidos se importen con toda la información que necesitas, organizada y registrada correctamente.
¿Cómo funciona?
Yuju toma los valores que recibe del marketplace y los asocia con los valores que existen en los campos de tipo catálogo de tu Odoo. Para encontrar la coincidencia, aplica validaciones de acentos y de mayúsculas/minúsculas.
Si Yuju encuentra el valor, lo envía a Odoo. Si no lo encuentra, usa el valor que tú hayas definido para esos casos (lo configuras en el paso 5).
Esta sección es dinámica: solo verás los campos de catálogo que existen en tu Odoo.
¿Cómo configurar el mapeo de estos campos?
1. Entra a la configuración de Odoo
Ve a Configuración, elige Ventas en el menú desplegable y abre Mapeo de campos > Mapeo Ventas.
2. Abre el acordeón que necesitas
Los campos están agrupados en secciones: General, Clientes, Dirección de facturación y Dirección de envío. Haz clic en una sección para desplegarla.
3. Revisa la tabla de mapeo
Cada fila conecta un campo de Yuju con un campo de Odoo:
Columna | ¿Qué hace? |
Campos de Yuju | Los campos de Yuju donde se guardan los valores que llegan desde los marketplaces (por ejemplo, Id Pedido o Referencia). |
Campos de Odoo | El campo de Odoo donde se guardará ese dato. |
Tipo de valor / Valor | Se usan cuando quieres asignar un valor fijo (ver paso 4). |
Valor para no coincidencias | Lo que se enviará si Yuju no encuentra una equivalencia en Odoo (ver paso 5). |
Las filas marcadas como Requerido son necesarias para que tus pedidos se sincronicen correctamente y estas ya están mapeadas por defecto.
4. (Opcional) Define un valor fijo
¿Necesitas que un campo de Odoo reciba siempre el mismo valor? En la columna Campos de Yuju, selecciona Definir valor por defecto. Luego, en la columna 3, elige el tipo de valor que deseas enviar (numérico o texto) y, en la columna 4 (Valor), ingresa el contenido que se enviará a Odoo.
Importante: Yuju enviará siempre ese valor a Odoo, sin importar lo que llegue desde el marketplace.
5. (Opcional) Elige qué hacer cuando no hay coincidencia
Estos mapeos están pensados especialmente para los campos de Odoo que tienen una lista de valores predeterminados. A veces, el valor que llega desde el marketplace no existe en esa lista.
En la columna Valor para no coincidencias, escribe el valor que quieres usar en esos casos. Así evitas que el pedido se quede sin dato en ese campo.
Haz clic en Guardar. Los cambios aplican a las ventas nuevas.
Nota: Esta columna solo se activa en los campos que son de tipo catálogo en Odoo. Si en otras filas no ves el campo de texto, es normal.
Casos de uso
1. Las ciudades o regiones se escriben distinto en Odoo
Situación: El marketplace envía la ciudad como Bogota, pero en tu Odoo el valor está creado como Bogotá DC.
Qué hacer: En el campo "Valor para no coincidencias", escribe Bogotá DC.
Resultado: Si Yuju no encuentra una coincidencia exacta entre lo que envía el marketplace y los valores de Odoo, enviará Bogotá DC.
2. El marketplace no siempre comparte el correo del comprador
Situación: Algunos marketplaces no entregan un correo electrónico asociado al comprador, y tu Odoo lo necesita en el campo Correo DTE.
Qué hacer: En la columna Campos de Yuju elige Definir valor por defecto y escribe el correo que quieres usar (por ejemplo, el correo de tu área de facturación). Luego asócialo al campo Correo DTE de Odoo.
Resultado: Yuju enviará siempre ese correo al campo Correo DTE.
Preguntas frecuentes
¿Qué pasa si no completo “Valor para no coincidencias”?
Ese campo es opcional. Si lo dejas vacío y no hay coincidencia, no se enviará un valor de respaldo para ese dato.
¿Puedo cambiar un mapeo después de guardarlo?
Sí. Vuelve a entrar, modifica la fila y haz clic en Guardar.
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.