Gelato¶

Gelato es una plataforma global de impresión bajo demanda que se integra con Odoo para sincronizar catálogos de productos y automatizar el cumplimiento de pedidos.

Conectar los servicios de Gelato con las aplicaciones Ventas y Comercio electrónico activa lo siguiente:

Sincronización de los pedidos de venta de Odoo con Gelato para el cumplimiento automatizado de los pedidos.
Crear y gestionar productos de Gelato dentro de Odoo; admite la sincronización de variantes e imágenes de productos
Configurar opciones de entrega en Odoo y recibir actualizaciones de pedidos mediante webhooks.

Configuración¶

Importante

La información de la compañía (Nombre de la compañía y Dirección de facturación) en la cuenta de Gelato debe coincidir con la información de la compañía en la base de datos de Odoo para que los pedidos de venta se puedan confirmar y enviar a Gelato para su cumplimiento.

screenshot: sales-gelato-company-in-gelato

menu: (Gelato dashboard) ‣ Settings ‣ Company
shows: The company information page on the Gelato platform, with the company name, address and VAT number.
highlight: The company name and address (red frame).
data: A throw-away Gelato account.
module: sale_gelato
notes: English UI, light theme, crop to the company block.

screenshot: sales-gelato-company-in-odoo

menu: Settings ‣ Users & Companies ‣ Companies ‣ (the company)
shows: The company form in Odoo, with the same name, address and VAT number as the Gelato account.
highlight: The name, address and VAT fields (red frame).
data: Demo company "YourCompany".
module: base
notes: English UI, light theme, 1440px width, crop to the company details.

Configurar claves de API y webhooks en Gelato¶

Antes de configurar el conector de Gelato en Odoo, primero obtenga las credenciales de API y los webhooks de la cuenta de Gelato.

Los conectores de API permiten que Odoo Ventas envíe y reciba datos de Gelato para el procesamiento de pedidos, mientras que los webhooks proporcionan actualizaciones en tiempo real sobre el estado del pedido y el seguimiento del envío.

Clave API¶

Una clave de API es un token de autenticación único que permite a Odoo comunicarse de forma segura con la API de Gelato, lo que permite la transmisión de pedidos, las actualizaciones de estado y la sincronización de datos.

Tras iniciar sesión en Gelato, haga clic en Developer en la barra de menú izquierda. Desde allí, haga clic en API keys. En la nueva página, haga clic en el botón Add API Key para abrir un nuevo formulario de clave de API. Escriba un nombre y luego haga clic en Create Key.

Copie la clave de API generada mediante Copy to Clipboard.

screenshot: sales-gelato-api-key

menu: (Gelato dashboard) ‣ Developer ‣ API Keys
shows: The Gelato API-keys page with a newly generated key and its copy button.
highlight: The generated key (red frame).
data: A throw-away key; mask the value.
module: sale_gelato
notes: English UI, light theme, crop to the key row. Use a throw-away secret and mask it.

Importante

Copie la clave de API y guárdela en un lugar seguro antes de salir de esta página. Una vez que la página se actualice o se cierre, la clave ya no estará disponible para copiar.

Si la clave no se puede copiar o se pierde, regrese a la página Clave API y vuelva a empezar para crear una clave API nueva.

Webhook¶

Un webhook es un sistema de notificación automatizado que actualiza Odoo al instante cuando Gelato procesa, envía o entrega un pedido, lo que garantiza un seguimiento en tiempo real y una intervención manual mínima.

Para crear un webhook vaya a Desarrollador ‣ Webhooks en el menú desplegable Desarrollador en la barra de menú izquierda. En la nueva página, haga clic en Añadir webhook para abrir el formulario Crear webhook.

El formulario de webhook requiere varias configuraciones específicas:

URL: indica a Gelato dónde enviar las actualizaciones de pedidos en Odoo. Copie y pegue la URL de la base de datos de Odoo con el sufijo adicional /gelato/webhook.

Example
https://stealthywood.odoo.com/gelato/webhook
Events: haga clic en el campo y seleccione order_status_updated. Al seleccionar order_status_updated, Odoo recibe automáticamente los cambios de los pedidos.
Method: haga clic en el campo y seleccione la opción HTTP Post, ya que este es el método de solicitud utilizado para enviar datos de Gelato a Odoo.
Marque la casilla junto a I want to take Authorization to this webhook.
Nombre del encabezado: En este campo escriba firma para que coincida con el campo en Odoo.
Haga clic en Generate Key para generar un Header Value.
Haga clic en Create para completar esta configuración del webhook.

screenshot: sales-gelato-webhook

menu: (Gelato dashboard) ‣ Developer ‣ Webhooks
shows: The Gelato webhooks page with the configured order-status webhook pointing at the Odoo database URL.
highlight: The webhook URL (red frame).
data: A throw-away Gelato account; the URL points to the demo database.
module: sale_gelato
notes: English UI, light theme, crop to the webhook row.

Truco

Copie y pegue la clave de API y el webhook en un bloc de notas antes de salir de la página web de Gelato, como copia de seguridad.

Configurar el conector de Gelato en Odoo¶

En Odoo, vaya a Ventas ‣ Configuración ‣ Ajustes, después baje a la sección Conectores. Para activar el conector Gelato, marque la casilla de verificación. Después, pegue las claves API que se acaban de generar y la clave secreta del webhook en sus respectivos campos. Una vez que se guarden los cambios, Gelato estará disponible en los productos de Ventas y Comercio electrónico de Odoo.

Sincronizar los productos Gelato con Ventas de Odoo¶

Se recomienda tener productos ya configurados en Gelato antes de configurarlos en Odoo. Para obtener el ID del producto en Gelato, vaya a la página Plantillas desde el menú de la barra lateral. Seleccione qué producto quiere sincronizar con Odoo, después pase el cursor por encima de la tarjeta del producto para mostrar el icono de menú (tres puntos verticales). Haga clic en el icono del menú y después en Copiar ID de la plantilla para copiar el ID de la plantilla del producto al portapapeles.

Ver también

Comience a vender productos con Gelato: configuración rápida y sencilla

Producto de Ventas de Odoo¶

Para crear un producto en Odoo que coincida con el producto en Gelato, vaya a Ventas ‣ Productos ‣ Productos y haga clic en Nuevo para crear un nuevo formulario de producto. Escriba el Nombre del producto y después vaya a la pestaña Ventas. Busque la sección Gelato, haga clic en el campo Referencia de la plantilla y pegue el ID de la plantilla que copió del producto de Gelato. Por último, haga clic en Sincronizar.

Una sincronización correcta extrae las opciones de variantes de producto de Gelato al producto recién configurado en Odoo.

En el nuevo campo Print Images, haga clic en el marcador default para establecer una imagen de producto predeterminada. Haga clic en el icono (edit) y seleccione el archivo de imagen del producto que desea cargar, y luego en Save & Close.

Importante

El campo Print Images debe configurarse en todos los productos de Gelato y sus respectivas variantes antes de que se puedan pedir.

Variantes de producto¶

Para ver y editar las nuevas variantes de producto sincronizadas, vaya a la pestaña Atributos y variantes, que contendrá las variantes extraídas de la configuración del producto de Gelato. Haga clic en el botón Configurar para editar y configurar las imágenes de las variantes, los métodos de entrega, los precios adicionales, etc.

Pedir un producto de Gelato desde Odoo¶

Una vez sincronizados, los productos de Gelato están disponibles para pedirlos desde Odoo mediante presupuestos de ventas o desde la tienda de Comercio electrónico. Las opciones de envío de Gelato se sincronizan automáticamente con la configuración del webhook de la API.

Para añadir el envío de Gelato, haga clic en Añadir envío en el pedido de venta. Seleccione Entrega estándar o Entrega exprés en el campo Método de envío y, a continuación, haga clic en Obtener tarifa.

Una vez que se confirme el presupuesto, se convertirá en un pedido de venta activa y el pedido se envía a Gelato para su cumplimiento. Una vez que el pedido de venta se envíe de Odoo a Gelato, Gelato procesa el pedido, produce el producto en el centro de logística y lo envía de inmediato al cliente final.

Ver también

Crear presupuestos

Importante

Al crear un pedido de venta para productos de Gelato en la base de datos, solo se pueden añadir productos de Gelato a ese mismo pedido de venta. Los pedidos multiproveedor no están disponibles con el conector de Gelato por el momento.