Què fa el botó «Submit to Octopia» de les devolucions FFM

On és el botó i quan es veu

Les fitxes de devolució s'obren des del menú Octopia › Fulfillment › Returns. El tram Octopia demana el permís Octopia User: si no el tens, no veus aquest tram. A la pantalla FFM Returns hi ha el botó, i hi és a les quatre versions publicades del mòdul: Odoo 17, 18, 19 i 20.

El botó té una sola condició de vista: s'amaga quan el camp Return ID té valor. Amb els valors per defecte aquest camp és buit, així que el botó es veu. Dit al revés: una devolució que ja té Return ID deixa d'oferir el botó.

Amb Odoo en català el botó es diu Submit to Octopia. Així es llegeix en cada idioma amb traducció publicada:

Un cas per seguir-lo de principi a fi

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Hogar Norte és una botiga inventada que ven parament a Cdiscount i gestiona les seves devolucions FFM des d'Odoo. Un client retorna un producte d'un enviament ja fet. La Marta, d'atenció al client, obre la fitxa de la devolució a Octopia › Fulfillment › Returns i omple el que aquesta fitxa mostra: l'Account d'Octopia, l'Outbound Shipment del qual ve el producte, el Comment si vol deixar una nota i les Lines de la devolució.

Primer prem Submit to Octopia amb la fitxa sense línies: l'acció s'atura i apareix A return needs at least one line. No s'ha enviat res a Octopia. La Marta afegeix una línia a Lines i torna a prémer. Aquesta vegada el mòdul prepara la petició, l'envia amb el compte triat i, si la resposta porta l'identificador de la devolució, el desa a Return ID. Després passa la devolució a estat creat i anota una línia al registre de sincronització del compte. Com que Return ID ja té valor, el botó desapareix de la fitxa.

El que s'aprèn del cas: la comprovació prèvia que fa el mòdul és que hi hagi línies, i el rastre que la creació ha arribat a Octopia és el valor de Return ID.

Què fa el botó, en ordre

1. Si la devolució ja té Return ID, el mètode la salta sense fer res.
2. Comprova que la devolució tingui línies. Si no en té cap, s'atura amb A return needs at least one line. i no continua.
3. Prepara la petició amb l'identificador extern de l'Outbound Shipment, el motiu de la devolució i, per cada línia, el producte, la quantitat i l'estat del producte.
4. Si Comment té text, l'afegeix a la petició. Si és buit, la petició va sense comentari.
5. Es connecta amb l'Account de la devolució i demana a Octopia que creï la devolució.
6. Si la resposta inclou l'identificador de la devolució, el desa a Return ID.
7. Passa la devolució a estat creat.
8. Anota una línia al registre de sincronització del compte: de tipus fulfillment, amb resultat correcte, amb l'enviament sortint al text i un registre comptat.

Aquest registre no és exclusiu del botó. També hi escriuen dues tasques programades. La tasca Octopia: refresh referentials (categories, brands, carriers, typologies) corre cada set dies i està activa en instal·lar, però només anota al registre quan algun pas de la renovació falla: llavors deixa un error de referencials incomplets. La tasca Octopia: pull discussions (ToTreat queue) corre cada 15 minuts, està activa en instal·lar i també deixa la seva anotació en aquest registre.

El missatge que pot aturar el botó

La comprovació va abans de preparar la petició i de connectar amb Octopia. Quan el missatge surt, aquesta devolució no s'envia i no es desa res del que el botó havia d'escriure: ni Return ID, ni el canvi d'estat, ni la línia de registre.

Dubtes que surten en usar-lo

S'envia el comentari si el deixo buit?

No. El mòdul només afegeix el comentari a la petició quan Comment té text.

Amb quin compte s'envia?

Amb el que figura a Account a la fitxa de la devolució. També el veus a la llista de FFM Returns, juntament amb l'Outbound Shipment.

Què passa si la resposta no porta identificador?

El mòdul passa igualment la devolució a estat creat i anota la línia de registre, però Return ID queda buit. Segons la condició de vista del botó, amb aquest camp buit el botó continua visible.

Es pot enviar dues vegades la mateixa devolució?

Depèn de Return ID. Si la devolució ja el té, no: el botó no es mostra i el mètode la salta. Si va quedar buit perquè la resposta no va portar identificador, el botó continua visible i prémer-lo una altra vegada torna a enviar la petició a Octopia.

Què necessites per usar-lo

El mòdul és de pagament únic per versió i està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20; cada versió d'Odoo es compra allà per separat i el seu preu és a la seva fitxa. A més necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA, per a fins a 3 comptes de la plataforma (el pla Pro és de 98 €/mes o 980 €/any sense IVA, per a fins a 10).

La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla; si la plataforma canvia la seva API, s'adapten el mòdul i el servei. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.

El mòdul té altres botons amb el seu propi article, com Obrir conversa i Declarar a Octopia.

Si necessites ajuda amb Octopia i Odoo

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si vols revisar com encaixen les teves devolucions FFM al teu Odoo, escriu-nos.

Continua llegint

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

Fonts

• Codi del mòdul: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_fulfillment_views.xml
• Codi del mòdul: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_fulfillment.py
• Codi del mòdul: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_referential.py
• apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html