Què fa el botó «Create Vendor Bill» d'Octopia Connector

On és el botó i quan es veu

Les fitxes s'obren des del menú Octopia › Finance › Commission Invoices. El tram Octopia demana el permís Octopia User; si no el tens, no veus aquest tram del menú. A la fitxa tens Account, Invoice ID, Lines i Vendor Bill.

El botó és a la pantalla Commission Invoices de les branques publicades del mòdul (Odoo 17, 18, 19 i 20). S'amaga quan Vendor Bill té valor; amb els valors per defecte aquest camp és buit i el botó es veu. Vendor Bill és de només lectura: no l'escrius tu, l'omple el mateix botó (o la tasca diària i el botó Pull Finance).

Amb Odoo en català el botó es diu Create Vendor Bill; el segon esquema recull com es rotula en altres idiomes.

Un cas de principi a fi

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

Imagina una botiga inventada, Hogar Norte, amb un compte d'Octopia connectat i una factura de comissió que ja apareix a Commission Invoices. Això és el que passa quan prem el botó (segons el codi d'Odoo 20):

1. Obre la fitxa. Veu l'Account, l'Invoice ID, i Vendor Bill buit, de manera que el botó Create Vendor Bill és a la vista.
2. El prem. Si la fitxa ja tingués factura de proveïdor, el mètode la deixaria com està i passaria a la següent.
3. Si Lines és buit, el mètode primer descarrega les línies d'Octopia: esborra les que hi hagués, les demana pàgina a pàgina mentre Octopia indiqui que hi ha una altra pàgina, i anota quan les ha descarregat. Si Lines ja tenia línies, les usa tal qual, sense tornar a demanar-les.
4. Busca el proveïdor de comissions del compte. Si el compte encara no en té, crea un contacte de tipus empresa anomenat Octopia Marketplace (nombre de la cuenta), marcat com a proveïdor i sense companyia assignada, i el desa al compte. A les factures posteriors del mateix compte s'usa aquest mateix contacte.
5. Suma els imports nets de totes les línies. Si la suma és zero o positiva, crearà una factura de proveïdor; si és negativa, un abonament de proveïdor.
6. Crea la factura amb una línia per cada línia d'Octopia (detall a la taula següent).
7. Enllaça la factura creada a Vendor Bill. Amb aquest camp ja ple, el botó desapareix de la fitxa.

Què porta la factura que es crea

Els signes es conserven. Les línies de restitució o de crèdit arriben en negatiu i resten de la factura. Quan el total és negatiu i es crea un abonament, el mòdul inverteix el signe del preu unitari de cada línia.

El camí normal: la tasca diària

El botó no és el camí principal. La tasca programada Octopia: pull finance (operations, payouts, invoices, DAC7) s'executa un cop al dia i està activa en instal·lar el mòdul. Recorre els comptes connectats i, per a cadascun, llegeix operacions i pagaments. Després crea una fitxa de factura de comissió per cada ID de factura nou que veu a les operacions i, per a cada fitxa nova, descarrega les línies i el PDF. Si el compte està configurat per crear la factura de proveïdor automàticament, crida la mateixa acció del botó. Finalment, llegeix els informes DAC7.

D'aquí surt quan et fa falta el botó: la tasca només recorre les fitxes que ella mateixa ha creat en aquella passada. Una fitxa que ja existia i no té factura de proveïdor, per exemple perquè la creació automàtica no estava configurada quan es va descarregar, no entra en aquest recorregut. Aquesta és la fitxa per a la qual serveix el botó.

On es pot aturar

Alguns punts en què el procés es pot aturar:

• Amb la tasca diària i FlexigoTech Cloud. Si el compte es connecta a través de FlexigoTech Cloud i allà no hi ha desades les credencials, o no hi ha servei, la tasca se salta aquest compte. Si el relé de FlexigoTech Cloud l'atura a mig camí, només s'informa del codi a FlexigoTech Cloud, no es marca res i la propera execució continua.
• Amb qualsevol altre error a la tasca. L'error s'anota al registre del servidor i es passa al compte següent. Per al compte afectat, els passos que quedaven en aquella passada (les altres factures i els informes DAC7) no s'executen.
• Amb el botó. La creació de la factura va després de la descàrrega de les línies, de manera que una fitxa sense línies depèn primer d'aquesta descàrrega. Amb les línies ja carregades, el botó treballa amb el que hi ha a Lines.

Per comprovar el resultat, obre la fitxa i mira Vendor Bill: si té valor, la factura està enllaçada.

Què aprendre del cas

• Abans de prémer, mira si Vendor Bill ja té valor: si en té, no hi ha botó.
• El botó i la tasca diària comparteixen la mateixa acció, així que donen la mateixa factura.
• El signe del total net decideix si el resultat és factura o abonament de proveïdor.
• Revisa Lines abans de prémer: si ja hi ha línies, no es tornen a descarregar.

Com t'ajuda FlexigoTech

Si estàs implantant Odoo i vols decidir com encaixar aquestes factures de comissió a la teva comptabilitat, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. El mòdul està publicat per a aquestes quatre versions i necessita la subscripció a FlexigoTech Cloud (pla Connector, 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 i avisa per correu si falla la sincronització.

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_finance_views.xml
• Codi del mòdul: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_finance.py
• apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html