Quan es pot fer
El gest va sobre una comanda ja en camí: Odoo només l'envia si la comanda d'Octopia és a Shipped o Delivered. A més, el canal de venda ha d'admetre gestos. Ho veus a Octopia › Configuration › Sales Channels, al grup «Commercial Gestures» de cada canal: «Commercial Gestures Enabled», «Gesture Max Amount», «Gesture Max Rate (%)» i «Gesture Currency». Són dades de només lectura que arriben d'Octopia en sincronitzar la configuració. Mentre un canal no s'ha sincronitzat, Odoo no atura el gest per aquest motiu i l'última paraula és d'Octopia.
Els botons del gest només els veu qui té permisos de gestor al connector.

Pas a pas
- Ves a Octopia › Orders › Commercial Gestures i crea'n un de nou.
- Tria la comanda i el motiu, i escriu-hi el detall si cal.
- Prem «Check Remaining Budget». Odoo llegeix d'Octopia quant queda per concedir en aquella comanda i ho deixa al camp de pressupost disponible.
- Escriu l'import del gest, sense passar-te d'aquest pressupost.
- Prem «Submit to Octopia» i confirma: l'avís recorda que el gest retorna aquest import al client.
- El gest passa a In Progress amb la referència d'Octopia i la data d'enviament.

Els motius
Octopia demana un motiu de la seva llista, i Odoo t'ofereix els mateixos: Late Delivery, Missing Product, Product Return Fees, Quantity Compensation, Reference Mistake, Shipping Fees, Fees Unduly Charged, Warranty Period Exceeded i Other. Tria el que descriu el que va passar; el detall, si l'omples, viatja amb el gest.
El que comprova en enviar-lo
| Comprovació | Avís si falla |
|---|---|
| El canal no té els gestos desactivats | Sales channel %s has commercial gestures disabled. |
| La comanda és a Shipped o Delivered | Commercial gestures apply to shipped or delivered orders only (order %s is %s). |
| L'import no supera el pressupost restant, quan és més gran que 0 | Gesture amount %(amount).2f exceeds the remaining budget %(available).2f for this order. |
Odoo torna a llegir el pressupost just abans d'enviar, així que el tercer control fa servir la xifra del moment, no la que vas veure en prémer el botó. Aquest control només atura el gest quan hi ha una xifra de pressupost més gran que 0: amb el pressupost a 0, esgotat o sense dada, Odoo envia el gest igualment i decideix Octopia.

Després d'enviar-lo
La tasca «Octopia: poll async jobs (packages, cancellations, gestures)» pregunta a Octopia cada 5 minuts pels gestos en In Progress. Si no vols esperar, «Poll Status» fa la mateixa consulta a l'instant. El gest acaba a Done si Octopia l'accepta o a Rejected si no; la llista els pinta en verd i en vermell.
Amb Done, Odoo et pot deixar preparada la factura rectificativa. Ha d'estar marcada «Auto-create Credit Notes» al compte d'Octopia i la comanda ha de tenir client. La rectificativa es crea en esborrany, amb una sola línia per l'import del gest i sense impostos, i la referència comença per «Octopia commercial gesture». Va sense impostos perquè aquest import és el brut que va retornar el canal, amb l'IVA ja a dins. Revisa-la abans de publicar-la: si a la teva comptabilitat has de desglossar aquest IVA, fes-ho sense canviar el total.
El gest anul·la la comanda?
No. La comanda continua igual i el client rep només l'import del gest. Per anul·lar la comanda sencera o algunes línies hi ha l'anul·lació de comandes de Cdiscount.
És a totes les versions?
Sí, els gestos comercials són al connector publicat per a Odoo 17, 18, 19 i 20.
Continua llegint
Comprovat al codi del connector (versió 17.0, 18.0, 19.0 i 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: views/octopia_order_actions_views.xml, models/octopia_order_actions.py
- Codi del mòdul: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_api_client.py (GESTURE_REASON_SELECTION, GESTURE_STATUS_SELECTION), models/octopia_order_actions.py
- Codi del mòdul: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_order_actions.py (action_submit, action_check_available)
- Codi del mòdul: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_sales_channel.py, views/octopia_sales_channel_views.xml, views/menu.xml
- Codi del mòdul: flexigobe_octopia_connector · 17.0 501e336 · 18.0 e234fab · 19.0 d258001 · 20.0 5cbe12a: models/octopia_order_actions.py (action_poll, _on_done), models/octopia_account.py, data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
