Przejdź do głównej treści
Mirakl

Co Mirakl Connector dodaje do faktur w Odoo: pola, przycisk i moment działania

Mirakl Connector dodaje do faktury sprzedaży w Odoo pola tylko do odczytu oraz przycisk Send to Mirakl, który ręcznie wysyła PDF zaksięgowanej faktury do jej zamówienia w Mirakl; jeśli instancja jest tak skonfigurowana, faktura trafia tam też sama po zatwierdzeniu dokumentu wydania.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
Mirakl
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Co zmienia się w fakturze po instalacji modułu

Mirakl Connector rozszerza fakturę ze standardowej aplikacji «Fakturowanie» w Odoo o przycisk i kilka pól: przycisk Send to Mirakl oraz pola tylko do odczytu Sent to Mirakl on i Mirakl order. Moduł jest opublikowany w Odoo Apps dla Odoo 17, 18, 19 i 20, a warunek decydujący o tym, kiedy widać przycisk, jest taki sam we wszystkich czterech wersjach.

Schemat wykonany kodem, nie ekran Odoo: standardowa aplikacja Invoicing, a pod nią to, co dodaje moduł: Send to Mirakl, Sent to Mirakl on i Mirakl order
Schemat (to nie zrzut ekranu Odoo) tego, co Mirakl Connector dodaje do aplikacji Invoicing; etykiety są po angielsku, tak jak w kodzie modułu.

Wszystko kręci się wokół jednej idei: faktury sprzedaży, której pozycje pochodzą z zamówienia sprzedaży powiązanego z zamówieniem w Mirakl. Moduł szuka wśród zamówień sprzedaży z pozycji faktury pierwszego, które jest powiązane z Mirakl, i robi to tylko dla faktur typu Faktura sprzedaży. Z tego zamówienia bierze instancję Mirakl, z którą się komunikuje, oraz identyfikator zamówienia w Mirakl.

Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Porównanie: wysyłka automatyczna a przycisk

Faktura może trafić do Mirakl automatycznie, po zatwierdzeniu dokumentu WZ, jeśli instancja jest tak skonfigurowana, albo ręcznie przyciskiem. Obie drogi korzystają z tej samej procedury wysyłania.

Wysyłka automatycznaPrzycisk Send to Mirakl
Kto ją uruchamiaOdoo, przy zatwierdzaniu dokumentu WZTy, z poziomu faktury
Kiedy działaGdy instancja ma wysyłkę faktury ustawioną jako automatyczną, dokument WZ nie ma jeszcze daty wysłania faktury, a instancja nie jest wstrzymanaGdy przycisk jest widoczny: faktura typu Faktura sprzedaży, w stanie Zaksięgowano i oznaczona jako faktura Mirakl
Jeśli już wysłanoDziała tylko wtedy, gdy dokument WZ nie ma jeszcze tej datyNie sprawdza tego: wysyła fakturę i zastępuje poprzedni dokument w zamówieniu
Co zostaje w fakturzeProcedura wysyłania wypełnia Sent to Mirakl onTo samo, a dodatkowo notatka w fakturze z wynikiem

Jak czytać tabelę

Ścieżka automatyczna zależy od standardowego przycisku zatwierdzania dokumentu WZ, który moduł rozszerza.

Przycisk wysyła fakturę ręcznie. Nie sprawdza, czy dokument WZ ma już datę wysłania: uruchamia wysyłkę i zastępuje poprzedni dokument w zamówieniu, także gdy faktura została już wcześniej wysłana. To zastąpienie jest próbą w miarę możliwości: najpierw pobierane są z Mirakl dokumenty zamówienia tego samego typu i są usuwane, a jeśli operator Mirakl nie pozwala wyświetlać lub usuwać dokumentów, poprzedni zostaje.

Pola, jedno po drugim

PoleGdzie jestKiedy jest ukryte
Sent to Mirakl onKarta faktury, tylko do odczytuGdy faktura nie jest fakturą Mirakl
Mirakl orderKarta faktury, tylko do odczytuGdy faktura nie jest fakturą Mirakl
Mirakl invoiceNie widać go w żadnym widokuNie dotyczy: to warunek, od którego zależą pozostałe pola i przycisk

Pomoc pola Sent to Mirakl on brzmi: «Date/time this invoice PDF was last uploaded to the Mirakl marketplace.». Zatem jeśli faktura jest wysyłana ponownie, data odzwierciedla ostatnią wysyłkę. Moduł wypełnia ją po wysłaniu PDF.

Przycisk krok po kroku

Przycisk Send to Mirakl pojawia się tylko wtedy, gdy jednocześnie spełnione są te warunki: faktura jest typu Faktura sprzedaży, jest oznaczona jako faktura Mirakl (pole Mirakl invoice, którego nie widać) i ma stan Zaksięgowano. W Odoo 20.0 po kliknięciu robi to, po kolei:

  1. Szuka zamówienia sprzedaży Mirakl za pozycjami faktury i bierze z niego instancję. Jeśli nie ma instancji, zatrzymuje się.
  2. Generuje PDF za pomocą raportu faktury wskazanego w instancji lub, jeśli żaden nie jest wskazany, standardowego raportu faktur Odoo.
  3. Pobiera z Mirakl dokumenty zamówienia tego samego typu i usuwa te, które są, aby zastąpić poprzedni zamiast go dublować.
  4. Wysyła PDF do zamówienia w Mirakl, z nazwą pliku utworzoną z numeru faktury (tylko znaki ASCII, zakończoną .pdf) i z typem dokumentu wskazanym w instancji; jeśli żaden nie jest wskazany, jako faktura klienta.
  5. Wypełnia Sent to Mirakl on i zostawia w fakturze notatkę: Invoice sent to Mirakl (…)., z identyfikatorem zamówienia Mirakl w miejscu wielokropka.

Przy Odoo po hiszpańsku przycisk nazywa się Enviar a Mirakl; po niemiecku An Mirakl senden; po francusku Envoyer à Mirakl; po włosku Invia a Mirakl; po portugalsku Enviar para o Mirakl.

Schemat wykonany kodem na podstawie tłumaczeń modułu, nie ekran Odoo: tekst Send to Mirakl po hiszpańsku, niemiecku, francusku, włosku i portugalsku
Schemat (to nie zrzut ekranu Odoo) z etykietą przycisku zależnie od języka Odoo.

Co się dzieje, gdy coś zawiedzie

Jeśli moduł nie znajdzie instancji Mirakl za fakturą, po kliknięciu Send to Mirakl proces zatrzymuje się z komunikatem This invoice is not linked to a Mirakl order.. Sprawdź, czy pozycje faktury pochodzą z zamówienia sprzedaży powiązanego z zamówieniem w Mirakl.

Jeśli wysyłka nie powiedzie się z innego powodu, moduł zostawia w fakturze notatkę Mirakl invoice send failed: …, z przyczyną w miejscu wielokropka, i ponownie pokazuje błąd. Jeśli FlexigoTech Cloud nie przepuści wywołania (bo nie ma subskrypcji lub usługa jest wstrzymana), błąd również jest pokazywany ponownie, ale w takim przypadku nic nie jest oznaczane.

Koszt i pomoc

Moduł kosztuje jednorazowo za każdą wersję Odoo i wymaga subskrypcji FlexigoTech Cloud, plan Connector: 49 €/mies. lub 490 €/rok netto (bez VAT). Bez subskrypcji lub przy zawieszonej usłudze zatrzymuje się to, co daje subskrypcja, a dane zostają w Twoim Odoo. Moduł możesz zobaczyć na jego stronie lub w karcie w Odoo Apps.

Jeśli wdrażasz Odoo i chcesz, aby faktury Twoich zamówień z Mirakl wychodziły z raportem i przepływem, których używasz, FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie.

Czytaj dalej

Lista kontrolna instancji Mirakl Connector, pole po poluLista kontrolna do wypełnienia instancji Mirakl Connector w Odoo: połączenie, konta rozliczeń i opcje, z tym, co mówi pomoc każdego pola.Pola instancji Mirakl w Mirakl Connector: co znaczą i co wpisaćPorównanie pól karty Mirakl Instances w Mirakl Connector dla Odoo: co mówi pomoc przy każdym polu, jaka jest wartość domyślna i co wpisać w praktyce.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła