Español
English
Deutsch
Français
Português
Italiano
Nederlands
PolskiQuè canvia a la factura en instal·lar el mòdul
Mirakl Connector amplia la factura de l'app estàndard «Facturació» d'Odoo amb un botó i diversos camps: el botó Send to Mirakl, i els camps de només lectura Sent to Mirakl on i Mirakl order. El mòdul està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20, i la condició que decideix quan es veu el botó és la mateixa en les quatre versions.
Tot gira al voltant d'una idea: la factura de client les línies de la qual vénen d'una comanda de venda lligada a una comanda de Mirakl. El mòdul busca, entre les comandes de venda de les línies de la factura, la primera que estigui lligada a Mirakl, i només ho fa amb factures de tipus Factura de client. D'aquesta comanda en treu la instància de Mirakl amb què es parla i l'identificador de la comanda a Mirakl.
Comparativa: enviament automàtic davant del botó
La factura pot arribar a Mirakl de forma automàtica, en validar l'albarà, si la instància està configurada per a això, o a mà amb el botó. Les dues vies passen per la mateixa rutina de pujada.
| Enviament automàtic | Botó Send to Mirakl | |
|---|---|---|
| Qui el llança | Odoo, en validar un albarà | Tu, des de la factura |
| Quan actua | Quan la instància té l'enviament de factura en automàtic, l'albarà encara no té data d'enviament de factura i la instància no està en pausa | Quan el botó es veu: factura de tipus Factura de client, en estat Publicat i marcada com a factura de Mirakl |
| Si ja s'havia enviat | Només actua si l'albarà encara no té aquesta data | No ho comprova: puja la factura i substitueix el document anterior de la comanda |
| Què deixa a la factura | La rutina de pujada omple Sent to Mirakl on | El mateix, i a més una nota a la factura amb el resultat |
Com llegir la taula
El camí automàtic penja del botó estàndard de validar de l'albarà, que el mòdul amplia.
El botó puja la factura a mà. No mira si l'albarà ja té data d'enviament: llança la pujada i reemplaça el document anterior de la comanda, també si la factura ja s'havia enviat. Aquesta substitució és un intent de millor esforç: primer es demanen a Mirakl els documents de la comanda del mateix tipus i s'esborren, i si l'operador de Mirakl no permet llistar o esborrar documents, es queda l'anterior.
Els camps, un a un
| Camp | On és | Quan s'amaga |
|---|---|---|
Sent to Mirakl on | Fitxa de la factura, només lectura | Quan la factura no és de Mirakl |
Mirakl order | Fitxa de la factura, només lectura | Quan la factura no és de Mirakl |
Mirakl invoice | No es veu en cap vista | No s'aplica: és la condició de la qual depenen els altres camps i el botó |
L'ajuda de Sent to Mirakl on diu: «Date/time this invoice PDF was last uploaded to the Mirakl marketplace.». Per tant, si la factura es reenvia, la data reflecteix l'últim enviament. El mòdul l'omple després de pujar el PDF.
El botó pas a pas
El botó Send to Mirakl només apareix quan es compleixen alhora aquestes condicions: la factura és de tipus Factura de client, està marcada com a factura de Mirakl (el camp Mirakl invoice, que no es veu) i el seu estat és Publicat. A Odoo 20.0, en prémer-lo, fa això, per ordre:
- Busca la comanda de venda de Mirakl darrere de les línies de la factura i en pren la instància. Si no hi ha instància, s'atura.
- Genera el PDF amb l'informe de factura que tingui indicat la instància o, si no en té cap, amb l'informe de factures estàndard d'Odoo.
- Demana a Mirakl els documents de la comanda del mateix tipus i esborra els que hi hagi, per substituir l'anterior en lloc de duplicar-lo.
- Puja el PDF a la comanda de Mirakl, amb un nom de fitxer tret del número de la factura (només caràcters ASCII, acabat en
.pdf) i amb el tipus de document que indiqui la instància; si no n'indica cap, el de factura de client. - Omple
Sent to Mirakl oni deixa una nota a la factura:Invoice sent to Mirakl (…)., amb l'identificador de la comanda de Mirakl on van els punts suspensius.
Amb Odoo en castellà el botó es diu Enviar a Mirakl; en alemany, An Mirakl senden; en francès, Envoyer à Mirakl; en italià, Invia a Mirakl; en portuguès, Enviar para o Mirakl.
Què passa quan falla
Si el mòdul no troba instància de Mirakl darrere de la factura, en prémer Send to Mirakl el procés s'atura amb This invoice is not linked to a Mirakl order.. Comprova que les línies de la factura vénen d'una comanda de venda lligada a una comanda de Mirakl.
Si la pujada falla per un altre motiu, el mòdul deixa a la factura una nota Mirakl invoice send failed: …, amb el motiu on van els punts suspensius, i torna a mostrar l'error. Si FlexigoTech Cloud no deixa passar la crida (perquè no hi ha subscripció o el servei està en pausa), l'error també es torna a mostrar, però en aquest cas no es marca res.
Cost i ajuda
El mòdul és de pagament únic per versió d'Odoo i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció i les dades es queden al teu Odoo. Pots veure el mòdul a la seva pàgina o a la fitxa d'Odoo Apps.
Si estàs implantant Odoo i vols que les factures de les teves comandes de Mirakl surtin amb l'informe i el flux que fas servir, 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): models/account_move.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): views/account_move_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html