On és i quan es veu
Obre Mirakl › Configuration › Marketplaces i entra a la fitxa d'una instància, a la pantalla Mirakl Instances. Allà hi ha el botó Import Invoices. No té cap condició de visibilitat: es veu a Odoo 17, 18, 19 i 20.

El rètol canvia amb l'idioma del teu Odoo. Amb Odoo en castellà és Importar facturas; l'esquema recull també el d'altres idiomes.

Importar facturas, alemany Rechnungen importieren, francès Importer les factures, italià Importa fatture i portuguès Importar Faturas.Si encara no has comprovat la connexió de la instància, mira abans què fa el botó Provar connexió.

Sis idees equivocades sobre el botó
«Prémer el botó és la forma normal de portar les factures»
Realitat: el mòdul porta una tasca programada, Mirakl - Sync Invoices, que s'executa un cop al dia i ve desactivada en instal·lar. Quan l'actives, recorre les instàncies actives que tinguin activada la sincronització de factures i demana les factures a cadascuna. Només un administrador pot executar aquesta acció planificada.
En aquest camí hi ha dos filtres. Les instàncies que van per FlexigoTech Cloud i no tenen la clau desada no es truquen. I si el permís desat no inclou el servei, no es truca a cap de les que van per FlexigoTech Cloud. Si una instància falla, el mòdul deixa una línia d'error al registre i continua amb la següent.
El botó és la via manual: el prems quan vols importar ara, sense esperar la tasca.
«Porta totes les factures de l'operador»
Realitat: el botó fa servir com a finestra els dies del camp Initial Invoice Sync Days. El veus a la fitxa de la instància, pestanya Invoices and Messages, grup Invoices (Settlements). La seva ajuda diu: «Historical window (days) for manual invoice sync.» El valor per defecte al codi és 90.
La petició es fa per pàgines. El mòdul s'atura quan una pàgina porta menys factures que la mida de pàgina, quan arriba al total que indica la resposta o quan no n'arriba cap. A més, hi ha un límit de pàgines per passada.
«Si l'operador no ofereix factures, el botó dona error»
Realitat: si la plataforma respon amb HTTP 404 en demanar les factures, el mòdul no llança cap error. Marca la casella Invoices Endpoint Unavailable, deixa un avís al registre, anota la data de l'última sincronització de factures i acaba amb el recompte que dugués. Si el 404 arriba a la primera pàgina, aquest recompte és zero.
La casella és de només lectura i és a la mateixa pestanya i grup que la finestra de dies. La seva ajuda diu: «Set automatically when /invoices returns 404 so scheduled sync skips the endpoint until retried manually.»
Això marca la diferència entre els dos camins. La tasca diària se salta la instància mentre la casella estigui marcada. El botó no aplica aquesta comprovació i torna a provar. Si la petició funciona, el mòdul buida la casella.
«Si una factura falla, no s'importa res»
Realitat: cada factura rebuda es processa per separat. Si una falla, el mòdul deixa una línia d'error al registre i continua amb les altres; la que ha fallat no suma al recompte.
Una altra cosa és que falli la petició a la plataforma amb un error diferent del 404, per exemple de xarxa. Llavors el mòdul anota l'error al registre i deixa de demanar pàgines. Les factures de les pàgines anteriors ja s'han processat.
«Zero registres vol dir que no hi ha factures»
Realitat: en acabar, el botó publica el resultat com a missatge a la fitxa de la instància i mostra un avís amb el títol Mirakl que no queda fix a la pantalla. Si el recompte és més gran que zero, l'avís és d'èxit:
Import Invoices completed: … invoices processed., amb el número en lloc dels punts.
Si el recompte és zero, l'avís és d'advertència:
Import Invoices completed: 0 records. Check logs or increase sync window.
El zero pot venir d'una finestra sense factures, d'un 404 o de factures que han fallat en processar-se. Els dos últims casos deixen una línia al registre, que és el que l'avís t'envia a revisar. Si no hi ha res a veure, amplia els dies del camp Initial Invoice Sync Days i torna a prémer.
«El botó sempre acaba amb l'avís de completat»
Realitat: si FlexigoTech Cloud no deixa passar la trucada (sense subscripció o pausa del relay), la importació s'interromp sense marcar res i no arriba l'avís de completat. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.
Què comprovar després de prémer-lo
- El missatge amb el resultat a la fitxa de la instància.
- La casella
Invoices Endpoint Unavailable, a la pestanyaInvoices and Messages, grupInvoices (Settlements). - Les línies d'error del registre del mòdul, si l'avís va ser de zero registres.
Com encaixa amb FlexigoTech
Mirakl Connector és un mòdul de pagament únic per versió, publicat per a Odoo 17, 18, 19 i 20, i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA. El preu de cada versió és a la seva fitxa d'Odoo Apps i, per a la resta, a la pàgina del mòdul. Si necessites implantar Odoo o ajustar la integració al teu operador, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa 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_mirakl_connector 20.0 (aa05e537): views/mirakl_instance_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
