Connections

Połączenie (Connection) reprezentuje pojedynczy marketplace Mirakl, na którym sprzedajesz w swoim sklepie. Każdy element danych obsługiwanych przez plugin — kategorie, atrybuty, oferty, zamówienia, faktury i logi — należy do jednego konkretnego połączenia. Dzięki temu możesz sprzedawać na kilku marketplace’ach z jednego sklepu Shopware, utrzymując dane każdego operatora czysto rozdzielone.

Jakie informacje zawiera połączenie

Tworząc połączenie w kreatorze, podajesz:

Connection Name — etykieta, która pomoże Ci rozpoznać tego operatora w listach w całym pluginie (na przykład Marketplace EU albo Marketplace UK).
Instance URL — adres API operatora, otrzymany od operatora (na przykład https://marketplace.example.com).
API Key — Twój klucz API sprzedawcy, wygenerowany w panelu sprzedawcy u operatora. Traktuj go jak hasło.
Shop ID — numeryczny identyfikator sklepu, przypisany Twojemu kontu sprzedawcy przez operatora.
Sales Channel — kanał sprzedaży Shopware, w którym będą tworzone zaimportowane zamówienia. Jego waluta, język i metody wysyłki zostaną użyte dla tych zamówień, więc musi pasować do regionu operatora.
Default Offer State (opcjonalne) — domyślny status oferty używany, gdy produkt jest synchronizowany jako nowa oferta i sam nie ma przypisanego statusu. Możesz to zmienić później w oknie Edit Connection lub nadpisać per produkt.

Plugin przechowuje również kilka mapowań per połączenie — mapowanie statusów zamówień, mapowanie typów dokumentów do auto-uploadu, format nazw wariantów i inne. Konfigurujesz je przez dedykowane okna z menu kontekstowego wiersza, po utworzeniu połączenia.

Gdzie zarządzać połączeniami

Otwórz Mirakl → Settings → Connections, żeby zobaczyć wszystkie skonfigurowane marketplace’y. Aby dodać nowe połączenie, kliknij przycisk Add Connection u góry listy — otworzy się 13-krokowy kreator.

Każdy wiersz ma menu kontekstowe (trzy kropki po prawej stronie) z następującymi akcjami:

Edit — otwiera okno Edit Connection, w którym możesz zmienić dane uwierzytelniające i podstawowe ustawienia. Stopka okna ma dodatkowe przyciski: Run Setup Wizard, Test Connection, Cancel i Save.
Run Setup Wizard — ponownie otwiera kreator dla istniejącego połączenia, zaczynając od kroku 2 (Categories). Użyj tego, aby odświeżyć dane referencyjne operatora albo wykonać mapowania od nowa.
Order Status Mapping — otwiera okno, w którym konfigurujesz, jak każdy status zamówienia w Mirakl odpowiada statusom zamówienia, dostawy i płatności w Shopware.
Reverse Status Mapping — otwiera okno, w którym konfigurujesz, które zmiany statusów w Shopware uruchamiają akcje po stronie Mirakl (akceptacja, wysyłka, odrzucenie).
Document Auto-Upload — otwiera okno, w którym mapujesz typy dokumentów Shopware na typy dokumentów Mirakl do automatycznego uploadu.
Variant Name Format — otwiera okno, w którym dostosowujesz, jak budowane są nazwy wariantów produktów wysyłanych do Mirakl.
Catalog Export — otwiera stronę Catalog Export dla tego połączenia, gdzie możesz wygenerować plik CSV z produktami dla kreatora mapowania katalogu u operatora.
Test Connection — wysyła małe żądanie testowe do operatora, używając zapisanego URL-a i klucza API. Wynik aktualizuje status połączenia (zobacz niżej).
Delete — usuwa połączenie i wszystko, co jest z nim powiązane, po oknie potwierdzenia.

Statusy połączenia

Każde połączenie ma jeden z trzech statusów, widoczny w kolumnie Status na liście:

Connected — ostatnie żądanie testowe do operatora powiodło się. Zaplanowane zadania w tle będą uruchamiane dla tego połączenia.
Disconnected — połączenie nie zostało jeszcze zweryfikowane albo zostało celowo wyłączone z synchronizacji. Zaplanowane zadania je pomijają. Nowe połączenie zawsze startuje w tym stanie.
Error — ostatnie żądanie testowe lub synchronizacja nie powiodło się. Najedź kursorem na status (albo otwórz Edit Connection), żeby zobaczyć treść błędu zwróconego przez operatora. Popraw dane uwierzytelniające i kliknij Test Connection, żeby spróbować ponownie.

Tylko połączenia w stanie Connected uczestniczą w zaplanowanych zadaniach w tle. Pozostawienie połączenia w stanie Disconnected lub Error efektywnie je wstrzymuje — cała historia danych jest zachowana, żadne synchronizacje się nie wykonują.

Kreator nie czeka na wynik testu, zanim pozwoli Ci kontynuować. Zapisuje połączenie w stanie Disconnected, uruchamia szybki test w tle i przechodzi do kroku 2 (Categories). Wynik testu pojawi się na liście połączeń, gdy tylko test się zakończy.

Uruchamianie wielu połączeń jednocześnie

Możesz połączyć się z tyloma marketplace’ami, ilu masz kont sprzedawcy. Każde połączenie zachowuje:

Własną kopię danych referencyjnych operatora — kategorii, atrybutów, pól oferty, statusów oferty, kodów powodów. Odświeżenie danych jednego połączenia nie wpływa na inne.
Własny postęp synchronizacji dla każdej funkcji — ofert, zamówień, wiadomości, dokumentów, faktur, logów transakcji. Wstrzymanie jednego połączenia nie zakłóca pozostałych.
Własne mapowania. Ta sama kategoria Shopware “Buty” może mapować się na kategorię 1234 u operatora A i 5678 u operatora B, bez żadnego konfliktu.

Usuwanie połączenia

Delete usuwa połączenie i wszystko, co jest z nim związane — mapowania, dane referencyjne operatora, stan synchronizacji. Same zamówienia Shopware są zachowane, ale ich powiązanie z Mirakl jest usuwane: nie będą już otrzymywały aktualizacji statusów od operatora.

Usuń połączenie tylko wtedy, gdy masz pewność, że nie potrzebujesz już jego historii. Tej operacji nie da się cofnąć.

Wybór odpowiedniego kanału sprzedaży

Sales Channel ma największe znaczenie przy imporcie zamówień. Zaimportowane zamówienia są tworzone w kontekście tego kanału sprzedaży, więc jego waluta, język i metody wysyłki muszą mieć sens dla regionu marketplace’u. Jeśli sprzedajesz na francuskim operatorze, powiąż połączenie z francuskim kanałem sprzedaży.

Default Offer State jest niezależny od kanału sprzedaży — to domyślny status oferty używany, gdy produkt jest synchronizowany jako nowa oferta bez własnego statusu. Ustaw go w oknie Edit Connection lub podczas kroku 4 kreatora.

Aby nadpisać go dla konkretnego produktu, otwórz produkt (Catalogues → Products → wybierz produkt) i przejdź na zakładkę Specifications. W sekcji Mirakl Marketplace dla każdego skonfigurowanego połączenia widoczne jest osobne pole Offer State (nazwa połączenia). Wybierz wartość, żeby nadpisać; zostaw puste, żeby używany był domyślny status z połączenia. Override jest zapisywany na produkcie, nie na połączeniu, więc różne połączenia mogą mieć różne nadpisania dla tego samego produktu.

Powiązane tematy

Connecting Mirakl — pierwsze uruchomienie i pełny przewodnik po kreatorze
Sync logs — przeglądaj, co synchronizacje każdego połączenia wykonały
Background tasks — jak zaplanowane zadania decydują, co uruchomić
Troubleshooting — typowe komunikaty błędów i jak je rozwiązać