Kreator integracji z InPost Buy służy do połączenia konta marketplace z xSale i przygotowania zasad, według których będą obsługiwane oferty oraz zamówienia. To właśnie w tym miejscu określasz, czy integracja ma służyć do wystawiania ofert, pobierania zamówień czy do pełnej obsługi sprzedaży w tym kanale.
Dobrze skonfigurowany kreator porządkuje dalszą pracę z InPost Buy. Dzięki temu użytkownik nie ustawia tych samych zasad osobno dla każdej oferty i od początku wie, jak będą zachowywać się dane przesyłane między xSale a marketplace.
W tym artykule znajdziesz
- jak uruchomić kreator integracji
- jak przebiega autoryzacja konta InPost Buy
- jak ustawić zakres integracji
- jak działa synchronizacja ofert
- jak ustawić parametry sprzedażowe
- jak działa synchronizacja zamówień i płatności
- jak ustawić mapowania dostaw i płatności
- jak aktywować integrację
- jak korzystać z edytora integracji
- jak wykonać dodatkową autoryzację integracji
Jak uruchomić kreator integracji
Aby dodać integrację InPost Buy, przejdź do listy integracji w xSale i wybierz dodanie nowej integracji dla tego marketplace. Po uruchomieniu kreatora przejdziesz przez kolejne kroki konfiguracji.
To pierwszy ważny etap z perspektywy organizacyjnej. Właśnie tutaj tworzysz integrację, która później będzie wykorzystywana przez oferty i zamówienia związane z InPost Buy.
Autoryzacja konta InPost Buy
| Ważne: Najłatwiej przejść autoryzację wtedy, gdy jeszcze przed rozpoczęciem konfiguracji kreatora w xSale zalogujesz się na osobnej karcie przeglądarki do konta merchanta InPost Buy. Aby autoryzacja mogła zakończyć się poprawnie, konto merchanta po stronie InPost musi być wcześniej właściwie skonfigurowane i przygotowane do rozpoczęcia sprzedaży na tym marketplace. Jeżeli onboarding po stronie InPost nie został jeszcze dokończony albo brakuje ukończenia któregoś z wymaganych kroków konfiguracji, autoryzacja konta InPost Buy w kreatorze integracji xSale nie będzie możliwa. |
Autoryzacja, gdy jesteś już zalogowany do konta merchanta
Pierwszy krok kreatora dotyczy autoryzacji. W tym miejscu podajesz nazwę integracji, która będzie widoczna na liście integracji w xSale, a następnie klikasz przycisk Autoryzuj.
Jeżeli jesteś już zalogowany do konta merchanta InPost Buy, przejście autoryzacji jest najprostsze. Po kliknięciu przycisku Autoryzuj xSale przechodzi do połączenia z kontem InPost Buy, a po poprawnym zakończeniu tego etapu pozwala wybrać organizację, która ma zostać powiązana z integracją.
To jest rekomendowany sposób pracy, ponieważ ogranicza dodatkowe ekrany logowania i pozwala szybciej przejść cały proces konfiguracji.
| Uwaga: Wpisanej nazwy integracji nie będzie można później zmienić. To właśnie ta nazwa będzie później wyświetlana w systemie przy tej integracji, dlatego warto od razu nadać jej czytelną i docelową nazwę. |
Autoryzacja, gdy nie jesteś wcześniej zalogowany do konta merchanta
Jeżeli przed rozpoczęciem pracy w kreatorze nie byłeś zalogowany do konta merchanta InPost Buy, proces autoryzacji nadal może zostać wykonany bezpośrednio podczas konfiguracji integracji w xSale.
W takiej sytuacji po kliknięciu przycisku Autoryzuj zostaniesz przekierowany do logowania po stronie InPost Buy. Może również pojawić się ekran po stronie InPostu, na którym trzeba zaakceptować połączenie i wyrazić zgodę na powiązanie konta z xSale.
Po wpisaniu adresu e-mail wyświetli się okno potwierdzające wysłanie wiadomości. To sygnał, że trzeba przejść do skrzynki mailowej i potwierdzić adres używany do logowania.
Na skrzynce mailowej pojawi się wiadomość od InPost. Należy otworzyć ją i kliknąć link potwierdzający.
Po kliknięciu w link z maila wyświetli się okno z informacją, że adres mailowy został zweryfikowany. To okno można zamknąć.
Następnie należy wrócić do okna, w którym wcześniej wpisywaliśmy adres e-mail do logowania w InPost Buy. To okno powinno odświeżyć się automatycznie i poprosić już o podanie hasła.
Po poprawnym podaniu hasła okna InPost całkowicie znikną. W tym momencie trzeba wrócić do kreatora integracji w xSale, gdzie pojawi się komunikat o prawidłowej autoryzacji, lista wyboru organizacji oraz przycisk Dalej, który pozwoli przejść do kolejnych kroków kreatora.
Z perspektywy użytkownika to bardzo ważny moment, bo od niego zależy, z jakim kontem i z jaką organizacją InPost Buy będzie pracować xSale. Warto więc od razu zadbać o czytelną nazwę integracji, szczególnie jeśli firma obsługuje więcej niż jedno konto lub więcej niż jeden kanał sprzedaży.
Zakres integracji
W kolejnym kroku określasz zakres działania integracji. Możesz zdecydować, czy chcesz:
- tylko pobierać zamówienia,
- tylko wystawiać oferty,
- uruchomić pełny zakres integracji.
To ustawienie ma bezpośredni wpływ na codzienną pracę zespołu. Jeśli wybierzesz tylko wystawianie ofert, integracja będzie służyła głównie do zarządzania publikacją danych produktowych. Jeżeli włączysz także pobieranie zamówień, xSale stanie się również miejscem bieżącej obsługi sprzedaży z InPost Buy.
Synchronizacja ofert
W kroku synchronizacji ofert ustawiasz, w jaki sposób mają być przekazywane do InPost Buy ceny, opisy oraz stany magazynowe.
Na tym etapie szczególnie ważne jest poprawne ustawienie pól Domyślny typ ceny, Typ ceny źródłowej oraz magazynu do pobierania stanów. To właśnie te ustawienia decydują, z jakich danych xSale będzie korzystać przy przygotowaniu oferty dla InPost Buy.
Z perspektywy codziennej pracy te ustawienia mają duże znaczenie, ponieważ wpływają na to, jakie ceny i jakie dostępne stany będą prezentowane w kanale sprzedaży. Warto więc od początku ustawić je zgodnie z rzeczywistym sposobem prowadzenia sprzedaży.
Parametry sprzedażowe
Po ustawieniach synchronizacji ofert przechodzisz do kroku parametrów sprzedażowych. W tym miejscu definiujesz domyślne wartości, które będą uzupełniały się na każdej wystawianej ofercie dla tej integracji.
To dobre miejsce do uzupełnienia danych wspólnych dla wszystkich ofert, na przykład takich jak czas wysyłki lub warunki reklamacji. Dzięki temu nie trzeba wpisywać tych samych informacji osobno przy każdej nowej ofercie.
Jeżeli jednak część danych różni się pomiędzy ofertami, lepiej pozostawić te pola puste na poziomie kreatora i uzupełniać je dopiero bezpośrednio na poszczególnych ofertach.
Uzupełnienie danych w tym kroku jest opcjonalne. Nie trzeba wpisywać wszystkich parametrów już na etapie tworzenia integracji. Do tych ustawień możesz zawsze wrócić później, edytując kreator i uzupełniając brakujące wartości w dogodnym momencie.
Synchronizacja zamówień
Na początku tego kroku warto sprawdzić, czy zaznaczone są flagi odpowiedzialne za pobieranie zamówień i płatności. Bez ich włączenia samo aktywowanie integracji nie spowoduje, że zamówienia z InPost Buy zaczną pojawiać się w systemie.
W kolejnym kroku określasz zasady obsługi nowych zamówień oraz płatności pobieranych z integracji InPost Buy. Możesz wskazać, jaki status mają otrzymywać nowe zamówienia w xSale, a także ustawić status zamówienia po anulowaniu.
W zależności od konfiguracji możesz również zdecydować o zachowaniu danych przekazywanych dalej do systemu ERP, na przykład o oznaczaniu zamówień odpowiednią serią lub o tym, czy przesyłać pozycję transport przy zamówieniach z darmową dostawą.
To ustawienie ma duże znaczenie operacyjne. Dobrze dobrane statusy i reguły przekazywania danych pomagają utrzymać porządek na liście zamówień, ograniczają ręczne poprawki i ułatwiają dalszą realizację sprzedaży.
Mapowania dostaw i płatności
To jeden z ostatnich kroków kreatora. Na tym etapie możesz ustawić mapowania form dostawy oraz płatności pomiędzy xSale a InPost Buy, ale uzupełnienie tych danych nie jest wymagane już podczas tworzenia integracji.
Uzupełnienie mapowań w tym kroku jest opcjonalne. Możesz pominąć ten etap podczas tworzenia integracji i wrócić do niego później, gdy integracja będzie już dodana i zaczniesz pracować z ofertami lub zamówieniami.
Mapowania dostaw
Dodatkowa uwaga: działanie InPost Buy opiera się o usługi kurierskie Paczkomaty oraz Kurier InPost. Z tego względu nie ma możliwości korzystania w tej integracji z innych rozwiązań logistycznych.
Jeżeli korzystasz z Konfiguratora dostaw, możesz zauważyć, że na zamówieniach z tej integracji pojawiają się tylko dwa sposoby dostawy, które można od razu zmapować na właściwe wartości w systemie xSale:
- APM – dla odbioru w Paczkomatach,
- COURIER – dla kuriera InPost.
To właśnie te wartości będą wspólne dla pola Nazwa sposobu dostawy w sklepie. Natomiast dane wpisywane w polach Nazwa sposobu dostawy w xSale oraz Kod usługi transportowej zależą już od indywidualnych ustawień i sposobu pracy danego użytkownika w systemie xSale.
Jeżeli chcesz lepiej zrozumieć sam mechanizm mapowania dostaw w xSale, zobacz też osobny wpis: Mapowania dostaw.
| Uwaga: W tym miejscu nie twórz nowego sposobu dostawy tylko na potrzeby integracji InPost Buy. W mapowaniu należy wybrać te sposoby dostawy, które są już skonfigurowane w xSale i odpowiadają usługom Paczkomaty oraz Kurier InPost. |
Dzięki temu zamówienia z tej integracji będą trafiały do właściwych, już używanych sposobów dostawy w systemie, bez tworzenia dodatkowych i zbędnych pozycji w konfiguracji.
To tylko przykładowe, poglądowe ustawienie, które można wpisać w tym kroku kreatora. Wartości w polach mapowania trzeba zawsze dostosować indywidualnie do sposobu pracy w danym systemie xSale, używanych sposobów dostawy i przyjętych kodów usług transportowych.
Mapowania płatności
W tej części określasz, jak formy płatności z InPost Buy mają zostać przypisane do form płatności używanych w systemie xSale.
Dzięki temu zamówienia pobierane z tej integracji od razu trafiają do właściwych form płatności w systemie i nie wymagają późniejszego ręcznego poprawiania.
Mapowanie płatności działa podobnie jak mapowanie dostaw. W polu odpowiadającym za nazwę płatności z kanału sprzedaży wskazujesz wartość przychodzącą z InPost Buy, a następnie przypisujesz do niej odpowiednią formę płatności skonfigurowaną już w xSale.
Z integracji InPost Buy mogą przyjść następujące sposoby płatności:
- CARD
- CARD_TOKEN
- GOOGLE_PAY
- APPLE_PAY
- BLIK_CODE
- BLIK_TOKEN
- PAY_BY_LINK
- SHOPPING_LIMIT
- DEFERRED_PAYMENT
- CASH_ON_DELIVERY
Jeżeli chcesz lepiej zrozumieć sam mechanizm mapowania płatności w xSale, zobacz też osobny wpis: Mapowania płatności.
| Uwaga: W tym miejscu nie twórz nowej formy płatności tylko na potrzeby integracji InPost Buy. W mapowaniu należy wybrać te formy płatności, które są już skonfigurowane w xSale i odpowiadają sposobowi rozliczania zamówień z tego kanału. |
Dzięki temu płatności z zamówień InPost Buy będą przypisywane do właściwych, już używanych form płatności w systemie xSale, bez tworzenia dodatkowych i zbędnych pozycji w konfiguracji.
Aktywacja integracji
Ostatni krok kreatora dotyczy tylko flagi Aktywny. To właśnie ona definiuje, czy integracja jest włączona i aktywna w systemie.
Po zakończeniu kreatora i zamknięciu okna możesz zawsze sprawdzić działanie tej integracji na liście Twoje integracje. Jeżeli wszystko jest ustawione poprawnie, przy logo integracji powinna być widoczna informacja Aktywna oraz zielone kółeczko.
Edytor integracji
Po utworzeniu integracji zawsze możesz wrócić do jej ustawień i edytować podane wcześniej dane. Nie trzeba tworzyć integracji od nowa tylko po to, aby poprawić wybrane ustawienia albo uzupełnić brakujące informacje.
W edytorze znajduje się zakładka informująca o Statusie integracji. To dobre miejsce do sprawdzenia bieżącego stanu działania integracji.
W kolejnym kroku Połączenia możesz skorzystać z flagi Aktywny i na przykład wyłączyć integrację. W tym miejscu dostępna jest również ponowna autoryzacja konta, resynchronizacja ofert oraz synchronizacja warunków sprzedaży.
Dodatkowa autoryzacja integracji
Ponowna autoryzacja może być potrzebna wtedy, gdy połączenie z kontem InPost Buy wygaśnie, przestanie działać poprawnie albo gdy chcesz ręcznie odświeżyć powiązanie integracji z kontem.
Jeżeli dla tej integracji wymagana jest ponowna autoryzacja, przejdź do zakładki Połączenia i kliknij przycisk Autoryzuj. Następnie koniecznie kliknij także Zapisz.
To ważny krok, którego nie należy pomijać. Samo kliknięcie Autoryzuj nie wystarczy, jeżeli zmiana nie zostanie potem zapisana.




















