Przejdź do głównej treści
Mirakl

Pola instancji Mirakl w Odoo: co oznacza każde z nich i co wpisać

W karcie każdego marketplace'u w Mirakl Connector decydujesz, jak zamówienie trafia do Odoo: dostawa, rabat, prowizja, język, faktura i tempo importu. Poniżej każde pole według jego własnej pomocy i wskazówka, co zwykle wpisać.

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
6 min

Gdzie są te pola i dlaczego niektórych nie widać

Schemat wykonany w kodzie menu Marketplaces i karty instancji z polami opisanymi poniżej
Schemat wykonany w kodzie (to nie zrzut ekranu z Odoo): menu i pola karty instancji

Gdzie otwiera się te pola?

Z menu Mirakl › Configuration › Marketplaces otwierasz karty Mirakl Instances. Pola znajdują się w zakładce Orders and Returns, podzielone na grupy: Sales Bridge, Customer & Privacy, Sync Policy i Windows. Moduł jest opublikowany w Odoo Apps dla Odoo 17, 18, 19 i 20.

Dlaczego nie widzę pól Shipping Line, Commission Product ani Auto-post the created invoice?

Bo są ukrywane w zależności od innego pola i przy wartościach domyślnych ich nie widać.

  • Shipping Line jest ukryte, dopóki instancja nie ma produktu dostawy.
  • Commission Product pojawia się tylko wtedy, gdy Commission in sale order ma wartość Deduct commission (net you receive).
  • Auto-post the created invoice pojawia się tylko po włączeniu Auto-create invoice on delivery validation.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Cena zamówienia: dostawa, rabat i prowizja

Kiedy moduł dodaje pozycję dostawy do zamówienia sprzedaży?

Decyduje o tym Shipping Line. Pomoc każe wskazać powyżej Produkt dostawy, niezależnie od wybranej opcji. Przy Only when the marketplace charged shipping pozycji nie ma, jeśli marketplace wysłał towar za darmo. Przy Always, even when shipping is free (0.00) pozycja i tak powstaje z ceną 0.00, dzięki czemu wszystkie zamówienia mają tę samą strukturę, a rabat marketplace'u obejmuje także tę pozycję. Wartość domyślna to Only when the marketplace charged shipping.

Schemat wykonany w kodzie opcji Always, even when shipping is free (0.00) po hiszpańsku, niemiecku, francusku, włosku i portugalsku
Schemat wykonany w kodzie na podstawie opublikowanych tłumaczeń, to nie zrzut ekranu z Odoo: tak wygląda ta opcja zależnie od języka Odoo

Do czego służy Marketplace Discount (%)?

Pole Marketplace Discount (%) wpisuje procent w kolumnie Desc.% każdej importowanej pozycji, zarówno produktów, jak i dostawy. Pomoc przedstawia je na sytuację, gdy marketplace kupuje od Ciebie ze stałą marżą względem ceny widzianej przez kupującego: wtedy suma zamówienia zgadza się z tym, co fakturujesz operatorowi. Przykład z samej pomocy: suma w Mirakl 100.00 z rabatem 20%, pozycja w Odoo pokazuje 100.00 z Desc.% 20% i wartością częściową 80.00. Domyślnie wynosi 0, a przy 0 ceny są importowane bez zmian.

Jak Odoo odzwierciedla prowizję marketplace'u?

Zależy to od Commission in sale order, którego wartość domyślna to brak prowizji. Prowizja to kwota, którą marketplace pobiera od Ciebie i potrąca z Twojej wypłaty.

  • No commission (total paid by the customer): suma to produkt plus podatek, czyli to, co płaci klient. Prowizja jest zapisana tylko w zamówieniu Mirakl jako informacja.
  • Deduct commission (net you receive): dodawana jest pozycja ujemna z prowizją, z użyciem Commission Product, czyli produktu typu usługa. Suma to produkt plus podatek minus prowizja, czyli kwota netto, którą otrzymujesz.
  • Operator purchase price (the operator buys from you): dla marketplace'ów, w których operator kupuje od Ciebie towar i sam wystawia fakturę kupującemu (na przykład GACD). Każda pozycja przyjmuje cenę zakupu, którą Mirakl podaje dla niej, a Odoo dolicza podatki produktu, dzięki czemu zamówienie zgadza się z zamówieniem zakupu operatora. Do tych pozycji nie stosuje się rabatu marketplace'u. Jeśli Mirakl nie przesyła ceny zakupu dla danej pozycji, zachowuje ona cenę kupującego i rabat, a w zamówieniu sprzedaży i w logach Mirakl zostaje notatka.

Wybór zależy od tego, jaką kwotę chcesz widzieć w zamówieniu: to, co płaci klient, to, co otrzymujesz netto, czy zamówienie zakupu operatora.

Jaki język otrzymują klienci tworzeni przez marketplace?

Ten z pola Language of Imported Contacts. Stosuje się go do klientów i kontaktów dostawy, które ten marketplace tworzy w Odoo, i wyznacza język ich ofert, faktur i e-maili. Jeśli zostawisz puste, używany jest język domyślny Odoo. Dostępne są tylko zainstalowane języki: najpierw dodaj brakujący w Ajustes ▸ Traducciones ▸ Idiomas.

Faktury i tempo importu

Co wybrać w Invoice type (Spain)?

Pole Invoice type (Spain) określa, jak klasyfikowana jest faktura wygenerowana z zamówień Mirakl, gdy zainstalowano l10n_es (TicketBAI, VeriFACTU).

  • Automatic (Odoo decides): z numerem NIF powstaje pełna F1, bez NIF uproszczona F2. To wartość domyślna.
  • Simplified with Tax ID (F2 TicketBAI/VeriFACTU): wystawiana jest faktura uproszczona nawet wtedy, gdy kupujący ma NIF. Pomoc uznaje ją za prawidłową dla B2C w Kraju Basków (TicketBAI) lub gdy Twój doradca podatkowy wskaże, że F2 wystarcza.
  • Full (F1 TicketBAI/VeriFACTU): wystawiana jest faktura pełna nawet wtedy, gdy kupujący nie ma NIF, na przykład klienci zagraniczni, którzy tego wymagają.

W razie wątpliwości skonsultuj się z doradcą podatkowym.

Czy warto tworzyć, księgować i wysyłać fakturę do Mirakl automatycznie?

To osobne pola i każde ma własną pomoc.

  • Auto-create invoice on delivery validation: domyślnie wyłączone. Jeśli je włączysz, po zatwierdzeniu dostawy zamówienia Mirakl z jego zamówienia sprzedaży tworzona jest faktura sprzedaży. Respektuje politykę fakturowania (zamówione lub dostarczone) i nigdy nie blokuje dostawy, jeśli fakturowanie się nie powiedzie.
  • Auto-post the created invoice: pomoc zaleca pozostawienie wyłączonego przy TicketBAI, VeriFACTU lub SII, ponieważ księgowanie jest nieodwracalne i wysyła fakturę elektroniczną do urzędu skarbowego. Faktury niedodatnie pozostają w wersji roboczej.
  • Send invoice to Mirakl: przy Manual (with a button) nic nie jest wysyłane samo, a pomoc oznacza to jako zalecane, na przykład by wysłać fakturę po edycji klienta lub NIF. Przy Automatic (on delivery validation) faktura jest wysyłana przy zatwierdzeniu dostawy, tylko jeśli jest zaksięgowana, i wymaga, by operator miał włączone wysyłanie faktur. Ponowne wysłanie zastępuje poprzedni dokument w Mirakl, bez duplikatów.

Kiedy zmieniać Mirakl invoice document type i Invoice PDF report?

Pierwsze z nich ma wartość CUSTOMER_INVOICE, a pomoc mówi, żeby zmieniać je tylko wtedy, gdy Twój operator definiuje własny kod. Drugie to nazwa techniczna (XML id) raportu generującego PDF i ma wartość account.account_invoices.

Jak często importowane są zamówienia i jak uniknąć utraty zmian statusu?

Sterują tym poniższe pola.

  • Sync Orders Enabled, w Sync Policy oraz na liście instancji: włącza zaplanowany import zamówień dla tej instancji. Domyślnie jest wyłączone.
  • Order Sync Frequency (minutes), w grupie Windows: to minimalny czas między dwoma importami z tego marketplace'u. Zaplanowana akcja Mirakl - Sync Orders budzi się co 10 minut i przetwarza instancję, gdy upłynie tyle minut. Przy 0 importuje przy każdym przebudzeniu, a przy 60 co godzinę.
  • Filter Syncs by Last Update: prosi Mirakl o to, co zmieniło się od ostatniej synchronizacji, a nie o to, co zostało utworzone. Pomoc mówi, by zostawić włączone, bo przy filtrze według daty utworzenia zamówienie założone rano i wysłane po południu zostaje pominięte, a jego nowy status nie dociera do Odoo. Wyłącz tylko wtedy, gdy API Twojego operatora ignoruje ten filtr. Import początkowy zawsze używa daty utworzenia.

Co z subskrypcją i jak Ci pomagamy

Mirakl Connector jest płatny jednorazowo za wersję Odoo i wymaga subskrypcji FlexigoTech Cloud, plan Conector: 49 €/mies. lub 490 €/rok netto (bez VAT), z maksymalnie 3 kontami platformy. Połączenie przechodzi przez tę usługę, która przechowuje dane uwierzytelniające w postaci zaszyfrowanej i wysyła e-mail, jeśli synchronizacja zawiedzie. Bez subskrypcji przestaje działać to, co ona zapewnia, a dane pozostają w Twoim Odoo. Moduł zobaczysz w karcie w Odoo Apps lub na stronie modułu.

Jeśli wdrażasz Odoo i chcesz razem z nami przejrzeć te pola przed włączeniem synchronizacji, 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