Salta al contingut principal
Octopia (Cdiscount)

Què fa el botó «Submit to Octopia» dels gestos comercials

El botó Submit to Octopia envia un gest comercial a Octopia, però abans comprova l'import, el canal de vendes, l'estat de la comanda i el pressupost restant; si tot passa, deixa el gest en InProgress i anota l'enviament.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

Abans de prémer: on és el botó i quan es veu

Els gestos comercials s'obren des de Octopia › Orders › Commercial Gestures. El tram Octopia demana el permís Octopia User: si no el tens, no veus aquest tram. El botó és a la fitxa del gest a les branques 17, 18, 19 i 20 d'Odoo.

Esquema fet amb codi: el menú de gestos comercials, el botó Submit to Octopia amb dos missatges que el poden aturar i l'estat InProgress en què deixa la fitxa
Esquema fet amb codi a partir del codi publicat del mòdul (no és una captura d'Odoo): el menú, el botó, dos dels missatges que el poden aturar i l'estat en què queda el gest.
  • Entra a Octopia › Orders › Commercial Gestures i obre la fitxa del gest.
  • Revisa Order, Amount i Reason: els tres surten a la fitxa i a la llista.
  • Comprova que veus el botó. S'amaga quan el camp State té un altre valor que el d'un gest nou; amb els valors per defecte es veu.
  • Si el teu Odoo és en un altre idioma, busca el rètol traduït del botó. Amb Odoo en castellà és Submit to Octopia; en alemany, An Octopia übermitteln; en francès, Soumettre à Octopia; en italià, Invia a Octopia; en portuguès, Submeter à Octopia.
Esquema fet amb codi amb el text del botó Submit to Octopia en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul (no és una captura d'Odoo): com es diu el botó segons l'idioma d'Odoo.
48 horas hábiles para aceptar cada pedido de Cdiscount: hazlo en Odoo
Vídeo: 48 horas hábiles para aceptar cada pedido de Cdiscount: hazlo en Odoo (vídeo en castellà)

Què fa el botó en prémer-lo, pas a pas

Al prémer, Odoo demana confirmació amb aquest text: A commercial gesture refunds the customer this amount. Continue?. Si acceptes, a Odoo 20.0 el mòdul passa per aquestes comprovacions en aquest ordre i s'atura a la primera que falla.

  • Confirma l'avís només si l'Amount és el que vols tornar al client: l'avís mateix diu que el gest reemborsa aquest import.
  • Estat del gest: si ja no és al seu estat inicial, el mòdul el salta sense missatge i no envia res.
  • Import: ha de ser més gran que zero.
  • Canal de vendes de la comanda: només bloqueja si aquest canal té la seva configuració sincronitzada i aquesta configuració diu que els gestos estan desactivats. Si la configuració del canal no s'ha sincronitzat, no bloqueja: respondrà l'API d'Octopia.
  • Estat de la comanda: ha d'estar enviada o lliurada.
  • Pressupost: el mòdul pregunta a Octopia quant queda per a aquesta comanda i guarda al gest el que Octopia retorna (pressupost disponible i import ja aplicat). Només bloqueja si Octopia dona una xifra (el zero compta) i l'import la supera. Si Octopia no diu res, no bloqueja i decideix l'API en rebre el gest.
  • Enviament: el mòdul envia a Octopia la comanda, el motiu, el detall del motiu (buit si no n'hi ha) i l'import.
  • Escriptura: amb la resposta d'Octopia, el gest passa a InProgress i guarda la referència i la data i hora d'enviament.

Si surt un missatge: què significa i què fer

Cada missatge atura l'acció i el gest no canvia d'estat. Cadascun correspon a una de les comprovacions anteriors:

  • Gesture amount must be greater than zero.: corregeix l'Amount de la fitxa i torna a prémer.
  • Sales channel … has commercial gestures disabled.: al buit hi va el codi del canal. La configuració sincronitzada d'aquest canal diu que no admet gestos, així que el mòdul no envia el d'aquesta comanda.
  • Commercial gestures apply to shipped or delivered orders only (order … is …).: el missatge dona l'identificador de la comanda a Octopia i el seu estat actual. Torna-ho a provar quan la comanda figuri com a enviada o lliurada.
  • Gesture amount %(amount).2f exceeds the remaining budget %(available).2f for this order.: el primer valor és el teu import i el segon, el pressupost que Octopia acaba de retornar. Baixa l'Amount fins que càpiga.

Després d'enviar: què ha d'haver canviat

  • El State del gest és InProgress.
  • El botó ha desaparegut, perquè l'estat ja no és l'inicial.
  • El gest guarda la referència que retorna Octopia (l'identificador de la sol·licitud o, si no ve, el seu id) i la data i hora d'enviament.
  • El registre de sincronització del compte té una entrada de resultat correcte que esmenta la comanda, l'import i el motiu.

Qui deixa el canal a punt per als gestos

El botó fa servir la configuració de gestos que el canal ja té desada. Un dels passos de la tasca programada Octopia: refresh referentials (categories, brands, carriers, typologies) és sincronitzar la configuració dels canals de vendes, que deixa anotat si el canal admet gestos i quan es va sincronitzar. La tasca s'executa cada set dies i ve activa en instal·lar. Treballa amb els comptes connectats i salta els que van per FlexigoTech Cloud sense credencials desades o sense servei. Si algun pas falla, anota al registre de sincronització que el refresc ha quedat incomplet.

Cost i ajuda

El mòdul està publicat a Odoo Apps per a 17, 18, 19 i 20 (consulta la seva fitxa) i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 € al mes o 490 € a l'any, sense IVA, amb fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials i avisa per correu si la sincronització falla.

Si estàs implantant Odoo i vols revisar com encaixen els gestos comercials amb les teves comandes, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida.

Continua llegint

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts