Przejdź do głównej treści
Mirakl

Lista kontrolna instancji Mirakl Connector, pole po polu

Karta instancji Mirakl łączy dostęp do połączenia, konta rozliczeń i kilka opcji; oto pole po polu, co oznacza każde z nich według jego pomocy i co warto 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
4 min

Karty otwierasz z menu Mirakl › Configuration › Marketplaces, z listy Mirakl Instances.

Schemat z menu Mirakl, Configuration, Marketplaces i polami karty instancji
Schemat wykonany kodem na podstawie opublikowanego kodu modułu (to nie zrzut ekranu z Odoo): menu i pola karty.

Zanim ruszysz kartę

  • Uprawnienie. Żeby zobaczyć klucz, trzeba być Mirakl Managerem: pomoc pola Api Key mówi, że tylko Mirakl Managerowie mogą go zobaczyć lub zmienić, a Mirakl API key (FlexigoTech Cloud) widzą tylko użytkownicy z tym uprawnieniem.
  • Konto sprzedawcy w marketplace. Otwórz je w drugiej karcie: stamtąd pochodzi host operatora i klucz API, zgodnie z pomocą tych pól.
  • Subskrypcja. Moduł wymaga subskrypcji FlexigoTech Cloud (plan Konektor). Cena jest na końcu.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Profil marketplace

  • Provider Code. Widać go na karcie i na liście Mirakl Instances. To profil marketplace/dostawcy używany przez instancję; według jego pomocy po zainstalowaniu dodatków dostawców pojawiają się profile specyficzne dla operatora, jak Leroy Merlin. Wartość domyślna to Generic Mirakl.

Zakładka Połączenie, grupa Dostęp

Te pola są w zakładce Connection, w grupie Access.

  • Mirakl connection. Tylko do odczytu, domyślnie FlexigoTech Cloud. Jego pomoc mówi, że nowe marketplace łączą się przez FlexigoTech Cloud, a Direct (API key stored in Odoo) zostaje tylko dla tych, które istniały przed tą wersją i nadal działają tak, jak zostały kupione. Nic tu nie wpisujesz: sprawdź tylko, jaką drogę ma Twoja instancja.
  • Mirakl API key (FlexigoTech Cloud). Jest w grupie FlexigoTech Cloud. Przy wartościach domyślnych jest widoczne, a ukrywa się, gdy połączenie nie jest przez FlexigoTech Cloud. Jego pomoc mówi, że klucz jest wysyłany raz, zaszyfrowany, do FlexigoTech Cloud i nigdy nie jest zapisywany w Odoo.
  • Base Url. To rzeczywisty host operatora. Jego pomoc ostrzega, że Mirakl nie udostępnia jednego uniwersalnego hosta wspólnego dla wszystkich marketplace. Dla znanych operatorów wypełnia się samo; w przeciwnym razie wpisz go ze swojego konta sprzedawcy. Przykład z pomocy: https://adeo-marketplace.mirakl.net. Jest wymagany, zanim będzie można przetestować połączenie lub synchronizować.
  • API Base URL. To rzeczywisty bazowy adres URL API dla wybranego operatora. Jego pomoc mówi, że zwykle jest to bazowy adres URL plus /api, z takim przykładem: https://adeo-marketplace.mirakl.net/api.
  • Api Key. Przy wartościach domyślnych nie jest widoczny: ukrywa się, gdy połączenie to FlexigoTech Cloud, więc pojawia się w instancjach z połączeniem Directa. To klucz API sprzedawcy (Settings > API key na Twoim koncie sprzedawcy) i jest potrzebny, zanim użyjesz Test Connection lub zaczniesz synchronizować.
  • Shop. Widać go na karcie i w tej grupie. To opcjonalny identyfikator dla środowisk wielosklepowych. Według jego pomocy Test Connection wypełnia go automatycznie, gdy Mirakl udostępnia sklep sprzedawcy.

Zakładka Finanse

Tu znajduje się księgowanie rozliczeń. W zakładce Finances są dwie grupy.

Grupa Księgowanie rozliczeń

  • Settlement Journal. Jeden z kilku dzienników do księgowania zapisów rozliczeń Mirakl. Jeśli zostawisz puste, przy pierwszym użyciu powstaje dedykowany dziennik Mirakl Settlements. Wybierz własny, jeśli wolisz, żeby tamten nie powstawał.
  • Marketplace Clearing Account. Bilansowe konto rozliczeniowe, które odzwierciedla to, co marketplace jest Ci winien za zamówienia: obciążają je sprzedaże, a uznawane jest, gdy rozliczenie realizuje wypłatę.
  • Commission Expense Account. Konto kosztowe dla prowizji i opłat marketplace.
  • Payout / Bank Suspense Account. Obciążane netto wypłatą, którą Ci przelewają, a potem uzgadniane z rzeczywistym wpływem na rachunek: ręcznie w Community, z synchronizacją bankową w Enterprise, według jego pomocy.

Grupa Opcje

  • Analytic Account. Opcjonalne. Dzięki niemu rozliczenia tego marketplace zasilają rachunek zysków i strat według kanału w raportach analitycznych Odoo. Ustaw je, jeśli chcesz taki widok według kanału.
  • Auto-post settlements. Automatycznie tworzy zapis księgowy, gdy importowane jest rozliczenie. Domyślnie jest wyłączone: zaznacz je tylko, jeśli chcesz mieć ten zapis przy imporcie.

Zakładka AI (opcjonalnie)

  • Enable AI insights. Jest w zakładce AI (optional) i domyślnie jest wyłączone. Przy Odoo po polsku jego pomoc brzmi Optional. The connector works fully without AI. If you don't enable this / don't set a key, no AI call is ever made and nothing changes. Jeśli tego nie potrzebujesz, zostaw bez zmian.
Schemat z tekstem pomocy pola analiz AI w pięciu językach
Schemat wykonany kodem na podstawie opublikowanych tłumaczeń modułu (to nie zrzut ekranu z Odoo): pomoc pola Habilitar análisis de IA po hiszpańsku, niemiecku, francusku, włosku i portugalsku.

Przegląd przed uznaniem instancji za gotową

  • Sprawdź, czy Base Url i API Base URL wskazują tego samego operatora; zwykle drugi to pierwszy plus /api, jak w przykładach z pomocy.
  • Jeśli Twoja instancja używa połączenia Directa, upewnij się, że Base Url i Api Key są wypełnione, zanim spróbujesz przetestować połączenie lub synchronizować.
  • Po teście połączenia zajrzyj do Shop: jego pomoc mówi, że wypełnia się samo, gdy Mirakl udostępnia sklep sprzedawcy.
  • Przejrzyj z księgowym konta z grupy Settlement Accounting.

Cena i pomoc przy uruchomieniu

Moduł jest płatny jednorazowo za wersję Odoo i opublikowany w Odoo Apps dla wersji 17, 18, 19 i 20 (zobacz kartę w Odoo Apps lub stronę modułu). Wymaga subskrypcji FlexigoTech Cloud, plan Konektor: 49 €/mies. lub 490 €/rok, netto (bez VAT), do 3 kont platformy. Połączenie przechodzi przez FlexigoTech Cloud, który przechowuje poświadczenia w postaci zaszyfrowanej, pilnuje synchronizacji i wysyła e-mail, jeśli się nie powiedzie. Z subskrypcją moduł dla nowszych wersji Odoo jest w cenie, jeśli kupiłeś go na flexigotech.com; w Odoo App Store każdą wersję Odoo kupuje się tam osobno.

FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie. Jeśli chcesz, żebyśmy razem z Tobą przejrzeli kartę Twojej instancji, napisz do nas.

Czytaj dalej

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.Pola instancji Mirakl w Odoo: co oznacza każde z nich i co wpisaćPrzewodnik po polach instancji Mirakl Connector dla Odoo: dostawa, rabat, prowizja, język, faktury i synchronizacja, zgodnie z ich pomocą.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła