Què fa el botó «Post Credit Note Now» del connector d'Amazon

On és i quan es veu

S'hi arriba des del menú Amazon › Analytics / BI › Returns. Cada tram d'aquesta ruta demana el permís Viewer. El botó és a la pantalla Returns (BI) i actua sobre una sola línia de devolució cada vegada. Existeix a les branques publicades del mòdul: Odoo 17, 18, 19 i 20.

Amb els valors per defecte el botó es veu. S'amaga quan el camp Credit Note State indica que la rectificativa ja està comptabilitzada.

Tenir el permís Viewer et deixa arribar a la pantalla. Que el botó et funcioni depèn dels accessos que es comproven més avall.

Abans del botó: el camí automàtic

El botó és la via manual. Odoo també pot crear aquestes factures rectificatives sol. La casella Auto-create credit notes (opt-in) és a la fitxa d'Accounts, pestanya Returns & Reviews, i ve desactivada per defecte. La seva ajuda diu: Automatically creates a draft customer credit note when the return refund amount is reported and the sale is accounted in Odoo.

Amb la casella activa, l'execució automàtica del compte es llança des de dues tasques programades, actives en instal·lar: Amazon SP-API - Auto receive returns to stock, cada 15 minuts, i Amazon SP-API - Sync returns, cada 3 hores.

Aquesta execució recorre les línies de devolució del compte amb import de reemborsament més gran que zero i sense factura rectificativa, i per a cadascuna crida el mateix pas intern que fa servir el botó. Algunes diferències:

• Comptabilitza només si ho permet l'ajust de comptabilització automàtica del compte; si no, deixa la rectificativa en esborrany. El botó sempre demana comptabilitzar.
• Recorre un nombre limitat de línies a cada execució.
• Si una línia falla, la marca com a saltada o amb error segons el tipus de fallada i desa el text de l'error.
• La comprovació d'accés de Comptabilitat només s'aplica quan ho fa una persona, no en aquesta execució.

Per això el botó queda per comptabilitzar a mà una línia concreta.

Què fa el botó, per ordre

1. Com que el prems tu, comprova que tens accés de Comptabilitat (facturació); si no el tens, s'atura.
2. Si la línia ja té una factura rectificativa i està en esborrany, la comptabilitza, marca l'estat de la rectificativa com a comptabilitzat, anota la data de procés i esborra l'error. No en crea cap altra. Si la rectificativa existent no està en esborrany, el botó l'obre sense comptabilitzar res.
3. Si no hi ha rectificativa, busca la comanda de venda. Si no la troba, s'atura amb No se encontró el pedido de venta para el pedido de Amazon ….
4. Busca la factura de client d'origen. Si no en troba cap de comptabilitzada, s'atura amb No se encontró ninguna factura de cliente contabilizada para el pedido de venta ….
5. Crea la rectificativa de client amb l'empresa, el client, la divisa i el diari de la factura d'origen. L'origen és el nom de la comanda de venda i la referència és Amazon return …, amb l'identificador de la devolució o, si no n'hi ha, el de la comanda. Posa la data d'avui, buida el termini de pagament i l'enllaça amb la factura d'origen, en la mesura que Odoo tingui aquests camps.
6. La comptabilitza i anota a la línia la factura d'origen, la rectificativa, l'estat comptabilitzat i la data de procés, i esborra l'error.
7. Obre la rectificativa en una finestra anomenada Posted Credit Note, a la mateixa pantalla.

Si falla qualsevol dels passos anteriors, el codi escriu a la línia l'estat d'error, la data i el text de l'error, i torna a llançar l'error perquè el vegis.

Un cas il·lustratiu

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

Hogar Mediterráneo és una botiga inventada que ven a Amazon i té desactivada la casella de creació automàtica. La Lucía, d'administració, té accés de Comptabilitat. El Pere pot obrir la pantalla de devolucions, però no té accés de Comptabilitat. Tots dos obren Amazon › Analytics / BI › Returns.

• Primera línia, amb comanda de venda i factura comptabilitzada. La Lucía prem el botó. El mòdul crea la rectificativa a partir de la factura d'origen, la comptabilitza i obre Posted Credit Note. En tornar a la línia, el botó ha desaparegut perquè l'estat ja marca la rectificativa com a comptabilitzada.
• Segona línia, amb un esborrany ja creat. La Lucía prem el botó i el mòdul comptabilitza aquest esborrany. No es crea una segona rectificativa.
• Tercera línia, premuda pel Pere. El botó es veu, però en prémer-lo el codi s'atura perquè el Pere no té accés de Comptabilitat. La Lucía la comptabilitza després.
• Quarta línia, sense factura de client comptabilitzada. Abans de crear res, el mòdul busca aquesta factura i, si no la troba, s'atura amb l'avís que no hi ha cap factura de client comptabilitzada per a la comanda de venda. Cal resoldre primer la factura d'aquesta comanda.

El que s'aprèn: el botó es veu encara que falti l'accés o alguna dada, i t'assabentes del que falta en prémer-lo. Passar-hi no duplica rectificatives, perquè si la línia ja en té una, treballa amb aquella.

Què comprovar després de prémer-lo

Obre la rectificativa que et mostra el mòdul i mira la referència Amazon return …, l'origen i l'enllaç amb la factura d'origen. Torna a la línia i comprova que Credit Note State ja no la deixa amb el botó visible. Si l'acció s'ha aturat, llegeix l'error en pantalla i resol la causa que descriu (accés de Comptabilitat, comanda de venda, factura de client comptabilitzada) abans de tornar a prémer.

Cost i ajuda de FlexigoTech

El mòdul és de pagament únic per versió d'Odoo i està publicat a Odoo Apps per a 17, 18, 19 i 20 (pots veure'l a la fitxa o a la pàgina del mòdul). La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Necessites el pla Connector: 49 € al mes o 490 € a l'any, sense IVA, per a fins a 3 comptes de la plataforma.

Si estàs implantant Odoo i vols decidir qui comptabilitza les devolucions d'Amazon, o necessites una integració a mida, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors.

Continua llegint

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

Fonts

• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_return_line_views.xml
• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_return_line.py
• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html