Importy inne - Magento 2

Instrukcja konfiguracji importu zamówień z Magento 2 do Polkurier.pl

Zaimportuj zamówienia ze swojego sklepu Magento 2 (także Adobe Commerce) i nadawaj przesyłki bezpośrednio, szybko i wygodnie. Import korzysta ze standardowego REST API Magento, więc w sklepie nie musisz instalować żadnego dodatkowego modułu — wystarczy utworzyć Integrację w panelu administracyjnym.

Krok 1: Utwórz Integrację w panelu Magento

Zaloguj się do panelu administracyjnego sklepu

Zaloguj się do panelu administracyjnego Magento kontem z uprawnieniami do zarządzania integracjami.

Dodaj nową Integrację

Przejdź do System → Rozszerzenia → Integracje (System → Extensions → Integrations).
Kliknij Dodaj nową integrację (Add New Integration).
W zakładce Informacje o integracji (Integration Info) wpisz nazwę, np. Polkurier.pl. Pozostałe pola możesz zostawić puste. Na dole formularza potwierdź operację hasłem swojego konta administratora.

Nadaj uprawnienia API

Przejdź do zakładki API i w polu dostępu do zasobów (Resource Access) wybierz Niestandardowy (Custom).
Zaznacz w drzewie zasobów:
- Sales → Operations → Orders → Actions → View — pobieranie zamówień,
- Sales → Operations → Orders → Actions → Ship oraz Sales → Operations → Shipments — odsyłanie numeru listu przewozowego do sklepu.
Zapisz Integrację.

Aktywuj Integrację i skopiuj klucze

Na liście integracji kliknij Aktywuj (Activate) przy nowej Integracji, a następnie Zezwól (Allow).
Sklep wyświetli cztery wartości: Consumer Key, Consumer Secret, Access Token i Access Token Secret. Skopiuj je — będą potrzebne w kolejnym kroku.
Jeśli później zmienisz uprawnienia Integracji, musisz ją aktywować ponownie (Aktywuj ponownie, Reauthorize).

Krok 2: Dodaj źródło importu w Polkurier.pl

Zaloguj się do swojego konta na Polkurier.pl

Przejdź do swojego systemu i zaloguj się na swoje konto.

Przejdź do sekcji Importy inne

W panelu klienta przejdź do zakładki Panel klienta → Import → Importy inne.

Przejdź do podstrony Źródła importu

Wybierz opcję Dodaj nowe → Magento 2.

Wypełnij formularz konfiguracji

Nazwa na liście: nazwa, pod jaką źródło importu będzie widoczne na liście.
Adres URL sklepu: adres strony głównej sklepu, np. https://mojsklep.pl. Jeśli pominiesz protokół, przyjęty zostanie https://. Gdy sklep działa w podkatalogu, wpisz adres razem z nim. Podaj adres, pod którym sklep działa bez przekierowania — jeśli sklep przekierowuje np. z wersji bez www na wersję z www, wpisz adres docelowy.
Kod widoku sklepu (Store View Code): pole opcjonalne. Puste oznacza widok domyślny sklepu i w większości przypadków tak warto je zostawić — import pobiera zamówienia ze wszystkich widoków. Kod może zawierać litery, cyfry i podkreślnik i musi zaczynać się od litery.
Klucz konsumenta (Consumer Key), Sekret konsumenta (Consumer Secret), Token dostępu (Access Token), Sekret tokenu (Access Token Secret): cztery wartości skopiowane z Integracji w kroku 1.

Zapisz zmiany

Kliknij przycisk Zapisz. Podczas zapisu Polkurier.pl łączy się ze sklepem i sprawdza poprawność danych. Jeśli coś jest nie tak, zobaczysz komunikat z przyczyną — patrz sekcja Najczęstsze problemy na końcu instrukcji.
Po pierwszym zapisie w formularzu pojawią się dodatkowe ustawienia importu opisane w kroku 3.

Krok 3: Ustawienia importu

Po zapisaniu źródła importu otwórz je ponownie do edycji. Pod danymi Integracji znajdziesz cztery grupy ustawień.

Filtr importu

Zaznacz statusy zamówień, które chcesz importować: Oczekujące (Pending), Oczekuje na płatność (Pending Payment), Weryfikacja płatności (Payment Review), Podejrzenie oszustwa (Suspected Fraud), W realizacji (Processing), Wstrzymane (On Hold), Zrealizowane (Complete), Zamknięte (Closed), Anulowane (Canceled).
Jeśli nie zaznaczysz żadnego statusu, importowane będą zamówienia we wszystkich statusach.
Lista zawiera statusy wbudowane w Magento. Statusów dodanych w Twoim sklepie nie da się zaznaczyć, bo Magento nie udostępnia ich listy przez API — zamówienia w takim statusie zaimportujesz, nie zaznaczając żadnego statusu.
Zamówienia wysłane w całości są pomijane niezależnie od statusu. W Magento zamówienie pozostaje w statusie W realizacji (Processing), dopóki nie jest jednocześnie wysłane i zafakturowane, dlatego import sprawdza, czy w zamówieniu zostały jeszcze produkty do wysłania. Liczba pominiętych zamówień wyświetla się po imporcie.
Zamówienia wirtualne (bez produktów do wysyłki) nie są importowane.

Płatność za pobraniem

W polu Kody metod płatności oznaczających pobranie sprawdź i uzupełnij kody metod płatności, które w Twoim sklepie oznaczają płatność przy odbiorze. Kilka kodów rozdziel przecinkami.
Kod metody to wewnętrzna nazwa metody płatności w Magento (w REST API pole payment.method), a nie nazwa widoczna dla klienta. Dla wbudowanej metody „Płatność przy odbiorze” (Cash On Delivery) jest to cashondelivery.
Ważne: przy pierwszej edycji pole jest wypełnione kodem cashondelivery, czyli wbudowaną metodą „Płatność przy odbiorze”. Jeśli sklep używa innych metod pobraniowych, dopisz ich kody po przecinku. Puste pole oznacza, że żadne zamówienie nie będzie traktowane jako pobranie.
Dla zamówień opłacanych tymi metodami kwota pobrania zostanie uzupełniona sumą zamówienia. Jeśli część zamówienia została już wysłana, kwota pobrania nie jest uzupełniana — wpisz ją sam w formularzu zamówienia, bo pierwsza paczka mogła już pobrać całość lub część należności.

Punkt odbioru

Magento nie ma standardowego pola na punkt odbioru (paczkomat, punkt przewoźnika), dlatego zapisują go moduły dostawy. Punkty z modułów Polkurier_Shipping, Smartmage_Inpost, MB_Inpost, Macopedia_OrlenShipping, Magento_RuchShip, GlsPoland_Shipping i DhlPoland_Dhl są odczytywane automatycznie — wtedy pole Własne pole z punktem odbioru zostaw puste.
Jeśli Twój sklep korzysta z innego modułu, wpisz ścieżkę do pola z kodem punktu w zamówieniu zwracanym przez REST API (GET /V1/orders): kolejne poziomy oddzielone kropką, pozycje listy numerem, np. extension_attributes.my_point_id.
Po zapisaniu ustawień Polkurier.pl sprawdza wpisaną ścieżkę na ostatnich zamówieniach sklepu i pokazuje pod polem znalezioną wartość. Jeśli niczego nie znajdzie, wyświetli listę dostępnych atrybutów rozszerzeń zamówienia, co ułatwia wybór właściwego pola.
Ścieżka działa tylko dla danych, które moduł dostawy udostępnia w REST API. Jeśli kod punktu nie jest tam widoczny, skontaktuj się z autorem modułu lub wybierz punkt ręcznie w formularzu zamówienia.

Po złożeniu zlecenia

Zaznacz Wyślij numer listu przewozowego do sklepu, jeśli numer listu ma trafić do Magento. Gdy przesyłka otrzyma numer listu, Polkurier.pl tworzy w sklepie wysyłkę (Shipment) z pozostałymi do wysłania produktami i dodaje do niej numer śledzenia z nazwą przewoźnika. Jeśli zamówienie zostało już wysłane w całości, numer zostanie dopisany do ostatniej wysyłki.
Status zamówienia w Magento ustala sam sklep — w standardowej konfiguracji zamówienie wysłane i zafakturowane przechodzi w status Zrealizowane (Complete).
Numer nie zostanie odesłany do zamówienia wstrzymanego, anulowanego lub oczekującego na weryfikację płatności — tak działa Magento.
Opcja wymaga uprawnień Ship i Shipments w Integracji (krok 1).

Po zmianie ustawień kliknij Zapisz.

Krok 4: Importuj transakcje

Wybierz z listy nazwę źródła importu, ustaw zakres dat, z jakiego chcesz pobrać zamówienia, i kliknij przycisk Importuj. Pobrane transakcje pojawią się poniżej.
Import pobiera adres dostawy, dane kontaktowe odbiorcy, produkty pozostałe do wysłania, metodę płatności i dostawy oraz kwoty zamówienia.
Kwoty są pobierane w walucie zamówienia. Jeśli zamówienie złożono w innej walucie niż złoty, kwoty nie są przeliczane, a przy transakcji pojawi się informacja o walucie — sprawdź kwoty przed nadaniem przesyłki.

Krok 5: Wysyłanie zamówień

Zaimportowane zamówienia możesz wysłać poprzez kliknięcie przycisku WYŚLIJ. Zostaniesz przeniesiony do formularza zamówienia, w którym automatycznie zostaną uzupełnione dane odbiorcy, a w miarę możliwości także punkt odbioru i kwota pobrania. Uzupełnij brakujące dane i nadaj przesyłkę.

Najczęstsze problemy

„Sklep odrzucił dane Integracji…” — sprawdź, czy wszystkie cztery wartości zostały skopiowane w całości i czy Integracja jest aktywna.
„Integracji w sklepie brakuje uprawnienia…” — dodaj wskazany zasób w zakładce API Integracji, zapisz ją i aktywuj ponownie.
„Pod tym adresem nie ma REST API Magento 2…” — sprawdź adres sklepu i kod widoku (najlepiej zostaw kod widoku pusty).
„Sklep przekierowuje na adres…” — wpisz w polu Adres URL sklepu adres podany w komunikacie.
Sklep musi być dostępny publicznie w internecie — adresy z sieci lokalnej nie są obsługiwane.

Uwagi dotyczące zabezpieczeń

Nigdy nie udostępniaj kluczy i tokenów Integracji osobom trzecim.
Nadawaj Integracji tylko uprawnienia wymienione w kroku 1 — import nie potrzebuje dostępu do innych zasobów sklepu.
Jeśli podejrzewasz, że klucze wyciekły, wygeneruj je ponownie w Magento (aktywując Integrację ponownie) i zaktualizuj dane źródła importu w Polkurier.pl.