Gelato

Gelato is a global print-on-demand platform that integrates with Odoo to sync product catalogs and automate order fulfillment.

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.

• Create and manage Gelato products within Odoo; supports product variant and image sync

• Configure delivery options in Odoo and receive order updates via 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.

Configure API keys and webhooks in Gelato

Before configuring the Gelato connector in Odoo, first obtain API credentials and webhooks from the Gelato account.

API connectors enable Odoo Sales to send and receive data from Gelato for order processing, while webhooks provide real-time updates on order status and shipment tracking.

Clave API

An API Key is a unique authentication token that allows Odoo to securely communicate with Gelato’s API, enabling order transmission, status updates, and data synchronization.

After logging into Gelato, click Developer in the left menu bar. From here, click on API keys. In the new page, click the Add API Key button to open a new API key form. Type in a name, then click Create Key.

Copy the generated API key using Copy to Clipboard.

Importante

Copy the API key and store it somewhere safe and secure before leaving this page. Once the page is refreshed or exited, the key will not be available to copy.

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

A webhook is an automated notification system that instantly updates Odoo when Gelato processes, ships, or delivers an order, ensuring real-time tracking and minimal manual intervention.

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: This tells Gelato where to send the order updates in Odoo. Copy and paste the Odoo database URL with the additional suffix /gelato/webhook.

  Example

  https://stealthywood.odoo.com/gelato/webhook

• Events: Click into the field and select order_status_updated. Selecting order_status_updated ensures Odoo receives order changes automatically.

• Method: Click into the field and select the HTTP Post option, as this is the request method used to send data from Gelato to Odoo.

• Tick the checkbox next to I want to take Authorization to this webhook.

• Nombre del encabezado: En este campo escriba firma para que coincida con el campo en Odoo.

• Click Generate Key to generate a Header Value.

• Click Create to complete this webhook configuration.

Truco

Copy and paste the API key and webhook on a notepad before tabbing out of the Gelato webpage as backup.

Configure Gelato connector in 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

Start selling products with Gelato: Quick & easy setup

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.

Successful synchronization pulls the Gelato product variant options into the newly configured Odoo product.

In the new Print Images field, click the default marker to set a default product image. Click the (edit) icon and select the product image file to upload, then Save & Close.

Importante

The Print Images field must be configured on all Gelato products and their respective product variations before they can be ordered.

Variantes de producto

To view and edit the newly synchronized product variants, navigate to the Attributes & Variants tab, which will have the variants pulled from the Gelato product configuration. Click the Configure button to edit and configure the variant images, delivery methods, additional pricing, etc.

Order a Gelato product from 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.

To add Gelato delivery, click Add shipping on the sales order. Select Standard Delivery or Express Delivery in the Shipping Method field, then click Get rate.

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

When creating a sales order for Gelato products in the database, only Gelato products can be added to the same sales order. Multivendor orders are not available with the Gelato connector at this time.