Salta al contingut principal
Mirakl

Què fa el botó Importar factures de Mirakl Connector

El botó Import Invoices demana a Mirakl les factures de la finestra de dies que marca la fitxa de la instància, en processa cadascuna i et diu quantes ha comptat. És el camí manual: la importació diària la fa una tasca programada que ve desactivada en instal·lar.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Mirakl
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

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.

Esquema del recorregut: menú Mirakl, Configuration, Marketplaces, i el botó Import Invoices
Esquema fet amb codi, no és una pantalla d'Odoo: la ruta del menú i el botó, amb els rètols en anglès del codi del mòdul, per 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.

Esquema del rètol del botó Import Invoices segons l'idioma d'Odoo
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una pantalla d'Odoo: castellà 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ó.

Same stock on every Mirakl marketplace, sent from Odoo
Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo en anglès)

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 pestanya Invoices and Messages, grup Invoices (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

Mirakl Connector: «Set the Mirakl API key before testing the connection»Quan surt l'error de clau d'API buida a Mirakl Connector per a Odoo, quina condició el provoca i com resoldre'l en prémer Test Connection.Mirakl Connector: «This binding has no Mirakl instance configured.»Quan surt a Mirakl Connector l'avís de vincle sense instància de Mirakl configurada, quina condició el provoca i què fer quan apareix.Què fa el botó Test Connection de Mirakl Connector, pas a pasQuè fa el botó Test Connection de Mirakl Connector a Odoo: quan apareix, què comprova, què desa a la fitxa i quins errors pot donar.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts