Botó «Refresh» del tauler de Shopify a Odoo: què calcula, pas a pas

On és i quan es veu

Les fitxes del tauler s'obren des del menú Shopify. Aquest tram del menú demana el permís Viewer: si no el tens, no el veus. Dins de la pantalla Dashboard hi ha el botó Refresh, que no depèn de cap condició: es veu sempre i existeix a les versions 17, 18, 19 i 20.

Amb Odoo en català el botó es diu Refresh, perquè el mòdul no el tradueix. Aquest esquema, també fet amb codi i no una pantalla d'Odoo, recull com es rotula segons l'idioma:

Cada tauler pertany a una instància de Shopify: el camp Instance surt a la fitxa i a la llista del tauler, i el botó calcula les dades d'aquesta instància. El camp Open orders és a la fitxa, al grup Sales, i també a la vista kanban, en només lectura.

El període que es calcula

Els camps Date From i Date To són a la fitxa del tauler, però amb els valors per defecte no es veuen: apareixen només quan el període del tauler es posa en personalitzat. Si són buits, el botó pren des de 30 dies abans d'avui fins avui.

Pas a pas: què fa en prémer Refresh

1. Fixa el període: fa servir Date From i Date To si tenen valor; si no, els últims 30 dies fins avui.
2. Suma les vendes del període. Compta les comandes de venda d'aquesta instància i de l'empresa de la instància la data de comanda de les quals cau dins del període (tots dos dies inclosos) i que no estan cancel·lades. Amb elles obté el nombre de comandes, l'import total venut, el valor mitjà per comanda, les unitats venudes (sense les línies amb tipus de visualització), les devolucions de Shopify creades al període i la taxa de devolucions sobre les comandes.
3. Repeteix aquest càlcul sobre el període anterior, de la mateixa durada i acabat el dia abans de l'inici de l'actual.
4. Calcula la variació percentual de l'import total i del nombre de comandes davant del període anterior. Si a l'anterior no hi havia res, la variació és del cent per cent quan ara hi ha alguna cosa i zero quan tampoc n'hi ha.
5. Recompta les incidències: els registres de sincronització de la instància fallits o parcials que van començar en les últimes 24 hores; els mapatges sense assignar (transportistes sense transportista d'Odoo, impostos sense impost d'Odoo i ubicacions de Shopify sense ubicació d'estoc, sumats en un sol comptador); i les comandes de Shopify que no estan cancel·lades i encara no tenen comanda de venda.
6. Recompta l'estoc de la instància: el total de referències analitzades, les marcades per reposar ja o esgotades, les marcades per vigilar i les classificades com a estoc mort.
7. Compta les comandes obertes: les comandes de venda confirmades de la instància i de la seva empresa. Aquest recompte no es limita al període. És el valor de Open orders.
8. Escriu tots els resultats al tauler juntament amb la data i l'hora de l'actualització i el resultat OK.
9. Desa la foto del dia a l'historial: una fila per instància i dia. Si aquell dia ja hi ha fila, la reescriu; si no, la crea. Porta les xifres de vendes del període, les d'estoc i les comandes obertes.

Què comprovar després i casos que confonen

Després de prémer, mira Open orders i la resta de xifres del tauler. Aquests casos surten directament del codi:

• Comandes sense confirmar. Compten a l'import total mentre no estiguin cancel·lades, encara que la comanda de venda segueixi en esborrany. Només les cancel·lades queden fora.
• Altres empreses. Una comanda d'una empresa diferent de la de la instància no entra mai en el càlcul.
• Període sense comandes. El valor mitjà per comanda i la taxa de devolucions valen zero.
• Variació del cent per cent. Si el període anterior no va tenir comandes i l'actual sí, la variació surt com a cent per cent. No és un error: és la regla del pas quatre.
• Prémer dues vegades el mateix dia. No duplica la foto del dia: la reescriu. Si canvies el període i prems de nou aquell mateix dia, la foto de l'historial queda amb les xifres de l'últim període calculat.
• Dues actualitzacions alhora. El codi preveu que una altra actualització creï la fila del dia en el mateix instant: si passa, escriu sobre la fila ja creada.
• Incidències de 24 hores. El comptador de sincronitzacions fallides mira només el que va començar en les últimes 24 hores, no tot l'historial.
• Mapatges sense assignar. És un únic comptador que barreja transportistes, impostos i ubicacions. Per saber quins en falten cal revisar cada mapatge.

Com encaixa amb la subscripció

El mòdul és de pagament únic per versió, està publicat a Odoo Apps per a 17, 18, 19 i 20 i necessita la subscripció a FlexigoTech Cloud. El pla Conector costa 49 €/mes o 490 €/any, sense IVA, per a fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Pots veure el mòdul a la fitxa d'Odoo Apps o a la seva pàgina de flexigotech.com.

Si estàs implantant Odoo i vols que el tauler reflecteixi la teva operativa, 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

• Codi del mòdul: flexigobe_shopify_seller_connector 20.0 (d7e627b4): views/shopify_kpi_dashboard_views.xml
• Codi del mòdul: flexigobe_shopify_seller_connector 20.0 (d7e627b4): models/shopify_kpi_dashboard.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html