Konfiguracja integracji sklepu Magento w interfejsie xSale V1
Przejście do konfiguracji integracji
W celu rozpoczęcia konfiguracji integracji między sklepem Magento a systemem xSale należy zalogować się do panelu xSale w wersji V1.
Następnie należy przejść do sekcji:
Konfiguracja → Ogólne → Integracje,
a następnie wybrać opcję z listy rozwijalnej „WorkerShopERPIntegration – Magento2″

Na kolejnym ekranie uzupełnij:
-
- Nazwę integracji (zalecamy „Magento_NazwaSklepu”)
- Język – wybierz domyślny język dla integracji z Magento z listy dostępnych
- W polu Nazwa statusu na który mają być pobierane zamówienia wpisz „Nowe”
- W polu Nazwa statusu na który mają być pobierane płatności wpisz „Nowe”
- Zaznacz check-box Włączone, wtedy integracja po dodaniu będzie od razu aktywna
- Kliknij Zapisz i przejdź do instalatora.

Kreator integracji Magento
Poniżej przedstawiono kroki dostępne w konfiguracji kreatora integracji, które wymagają uzupełnienia.
1. Dane konta Magento
Po utworzeniu sklepu w serwisie Magento generowane są dane dostępowe: login, hasło oraz adres URL sklepu. Informacje te należy wprowadzić w odpowiednich polach formularza. Adres URL sklepu występuje w formacie: https://mojsklep.pl/.

Po uzupełnieniu wymaganych pól należy wybrać opcję „Autoryzuj”, co umożliwia przejście do kolejnego kroku kreatora.
2. Ustawienia synchronizacji
Na tym etapie konfiguracji definiowane są nazwy statusów zamówień w Magento, które będą ustawiane przez xSale po poprawnym imporcie, a także status, jaki ma zostać nadany w panelu administracyjnym sklepu w przypadku niepowodzenia importu.

W tym kroku określane są również atrybuty produktów, które mają być synchronizowane pomiędzy systemami, np. opisy, zdjęcia itp.
W sekcji „Zamówienia” należy wskazać datę i godzinę, od której zamówienia mają być pobierane ze sklepu do panelu xSale. Datę wprowadza się ręcznie.
Po poprawnym uzupełnieniu danych należy przejść dalej, wybierając przycisk „Dalej”.
3. Typ ceny
W tym kroku wybierany jest typ ceny, który będzie pobierany i wysyłany pomiędzy systemami. Domyślnie ustawiony jest typ Brutto.

4. Mapowanie form płatności
W tym kroku definiowane jest powiązanie form płatności pomiędzy Magento a systemem ERP.
- W kolumnie Sklep należy wprowadzić nazwę formy płatności z Magento, np. „Płatność przy odbiorze”.
- W kolumnie ERP należy wskazać odpowiednik tej formy w systemie ERP, np. „Pobranie”.
- Jeżeli płatności mają być księgowane na określony rejestr kasowo‑bankowy w ERP, należy uzupełnić kolumnę Rejestr w formacie:
REJESTR;TYPOPERACJI

Instrukcja dodawania form płatności dostępna jest pod adresem:
https://xsale.ai/docs/konfiguracja-systemu/formy-platnosci/dodawanie-formy-platnosci/
5. Mapowanie form dostawy
Po zdefiniowaniu mapowania płatności należy uzupełnić mapowanie sposobów dostawy.
- W kolumnie Sklep należy wprowadzić dokładną nazwę formy dostawy z Magento.
- W kolumnie ERP należy wskazać odpowiednik sposobu dostawy w ERP. Każdy wpis musi odpowiadać pozycji na liście sposobów dostawy w:
Integracje > Sposoby dostaw

Dodatkowe informacje dotyczące dodawania sposobów dostawy znajdują się w dokumentacji:
https://xsale.ai/docs/konfiguracja-xsale/sposoby-dostawy/dodawanie-sposobu-dostawy/
- W kolumnie Transport należy wprowadzić kod usługi transportowej, na którą ma zostać dodana pozycja z kosztem transportu w zamówieniu ERP.
- Kod usługi transportowej musi być powiązany z ofertą w xSale, dlatego każdy wpis w kolumnie Transport musi odpowiadać pozycji na liście ofert.
Ważne jest zachowanie poprawnej wielkości liter podczas wprowadzania danych.
6. Mapowanie statusów
W ostatnim kroku kreatora możliwe jest zdefiniowanie statusu xSale, który będzie zmieniał status zamówienia w Magento, np.:
Sklep: Wysłane → ERP: Zrealizowane

Opis statusów zamówień w panelu xSale znajduje się w dokumentacji:
https://xsale.ai/docs/obsluga-zamowien/status-zamowienia/lista-statusow/
Podsumowanie
Integracja Magento w xSale polega na wprowadzeniu danych dostępowych do sklepu, skonfigurowaniu zasad synchronizacji oraz określeniu sposobu wymiany cen i danych produktów. Następnie definiowane są powiązania form płatności, metod dostawy oraz statusów zamówień pomiędzy Magento a ERP, aby oba systemy mogły poprawnie wymieniać informacje. Całość kończy się ustawieniem mapowań, które zapewniają spójne działanie integracji.