Pujar factures d'IVA a Amazon des d'Odoo: què fa la tasca en cada passada

Què fa la tasca i cada quant corre

La tasca treballa sobre les comandes d'Amazon que guarda el mòdul i agafa com a molt 100 comandes per passada. Corre cada 30 minuts i ve activa en instal·lar. Està a les branques 17.0, 18.0, 19.0 i 20.0; a Odoo 17.0 està configurada per repetir-se sense fi. El que segueix explica el que fa el codi d'Odoo 20.0.

Detalls de cada passada

Només mira els comptes que han activat la pujada

La primera cosa que fa la passada és buscar els comptes d'Amazon amb la pujada de factures activada. Si no n'hi ha cap, acaba aquí sense revisar cap comanda. La pujada és opcional: ve desactivada per defecte i s'activa a la configuració del compte d'Amazon. Els camps del compte els tens explicats en aquest article sobre el compte SP-API.

Només recull factures publicades i encara sense pujar

D'aquests comptes, la passada tria les comandes la factura de client de les quals està publicada i que encara no tenen data de pujada. Si el compte limita la pujada a comandes d'empresa, les de consumidor es queden fora. El codi aplica aquests filtres d'entrada a propòsit: una factura en esborrany, o una comanda de consumidor en un compte només d'empresa, ocuparien el lot per davant de la resta de comandes de tots els comptes. I una comanda ja pujada no es torna a enviar: la tasca no avisa dues vegades a Amazon de la mateixa factura.

Cada passada té límit, i els fallits van darrere

El límit és de 100 comandes. Primer entren les que no tenen cap error guardat, per ordre de creació. Només si no s'arriba al límit, s'afegeixen les que ja van fallar en una altra passada, començant per la que fa més temps que no s'intenta. Cada fallada torna a escriure la comanda, així que els fallits es van alternant en lloc de repetir-se sempre els mateixos.

Una fallada no atura la passada

Si la pujada d'una comanda dona error, el mòdul guarda el text de l'error en aquesta comanda, deixa un avís al registre del servidor i continua amb la següent. La comanda no queda marcada com a pujada, així que torna a la cua de fallits per a una passada posterior.

Guarda el fet després de cada comanda

Després de cada comanda, la tasca guarda a la base de dades les marques del que du fet. El motiu que dona el codi: Odoo talla una tasca que se'n va del seu límit de temps (120 s per defecte) i s'endú la seva transacció; sense aquest desat, la passada següent enviaria a Amazon les mateixes factures una altra vegada. Dins les proves automàtiques no es desa així, perquè Odoo ho prohibeix allà.

Què envia a Amazon i què deixa anotat

Per a cada comanda, el mòdul genera el PDF de la factura publicada, el puja a Amazon i crea un feed de factures d'IVA amb aquestes dades: el número de comanda d'Amazon, el número de factura, el tipus de document (factura), l'import total i l'import d'IVA. Fa servir el marketplace de la comanda o, si la comanda no el té, el del compte. Només quan tot l'enviament acaba sense error, anota la data de pujada a la comanda, esborra l'error anterior i, si la comanda d'Amazon té una comanda de venda vinculada, deixa una nota al seu chatter: Factura … subida a Amazon (feed de facturas de IVA) para el pedido … (Invoice … uploaded to Amazon (VAT invoice feed) for order …).

Com trobar la tasca segons el teu idioma

El nom de la tasca depèn de l'idioma del teu Odoo: amb Odoo en català és Amazon SP-API - Upload VAT invoices to Amazon, que el mòdul no tradueix. El mòdul porta també traduccions a l'alemany, el francès, l'italià i el portuguès.

Si no puja res: què revisar

Repassa el que el codi exigeix a cada comanda:

• Que la pujada de factures estigui activada al compte de la comanda. Per saber quin és, obre la comanda des del menú Amazon › Orders i mira els camps Account i Amazon Order de la fitxa de Amazon Orders. L'Amazon Order és de només lectura.
• Que la comanda tingui una factura de client i que estigui publicada: si la factura és en esborrany, la tasca no la puja.
• Que el compte no limiti la pujada a comandes d'empresa si la comanda és de consumidor.
• Que la comanda no s'hagi pujat ja: amb data de pujada, no es torna a enviar.
• Que no hi hagi més comandes pendents que el límit de 100: les passades següents, cada 30 minuts, continuen amb la resta.
• Que la tasca segueixi activa: ve activa en instal·lar.

Per veure el menú Amazon › Orders calen permisos: el tram Amazon demana Viewer i el tram Orders també.

Què costa i com t'ajudem

El mòdul és de pagament únic per versió (publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0) i necessita la subscripció a FlexigoTech Cloud, pla Conector: 49 € al mes o 490 € a l'any, sense IVA. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla. Més detall a la pàgina del mòdul i a la fitxa d'Odoo Apps.

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, per si el teu circuit de factures amb Amazon necessita alguna cosa més.

Continua llegint

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

Fonts

• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8c5900d9): data/ir_cron_data.xml
• Codi del mòdul: flexigobe_amazon_seller_connector 17.0 (51d6a72c): data/ir_cron_data.xml
• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/amazon_order.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html