Jak wypełnić plik konfiguracyjny – Sky-Shop?

Wpis wyjaśnia, jak uzupełnić formularz konfiguracyjny dla integracji Sky-Shop z xSale. Dane z formularza są potrzebne do uruchomienia połączenia, mapowania zamówień oraz poprawnego przekazywania informacji między Sky-Shop, xSale i systemem ERP.

Do pobrania:

• Formularz wdrożeniowy xSale – Sky-Shop
• Przykład wypełnionego formularza wdrożeniowego xSale – Sky-Shop

W tym artykule znajdziesz:

• jak uzupełnić dane dostępowe do Sky-Shop
• jak przygotować mapowanie statusów zamówień
• jak opisać sposoby dostawy
• jak opisać formy płatności
• jak wskazać typ ceny wysyłany do Sky-Shop
• jak sprawdzić kody produktów
• jak opisać produkty wielowariantowe
• co sprawdzić przed przekazaniem formularza

Dane dostępowe do Sky-Shop

W formularzu podaj adres sklepu Sky-Shop oraz dane potrzebne do przygotowania połączenia. Adres sklepu znajdziesz w pasku adresu przeglądarki, gdy otworzysz swój sklep.

Jeżeli sklep działa pod własną domeną, wpisz adres tej domeny, na przykład https://twojsklep.pl/. Jeżeli sklep działa pod adresem technicznym Sky-Shop, wpisz adres techniczny.

Technicznie integracja komunikuje się z API Sky-Shop z użyciem adresu API oraz klucza API. Dane logowania administratora mogą być potrzebne do przygotowania konfiguracji lub wygenerowania danych dostępowych po stronie Sky-Shop.

Możesz wskazać istniejącego użytkownika administracyjnego albo utworzyć osobnego użytkownika na potrzeby integracji z xSale.

Mapowanie statusów zamówień

W tej części formularza wpisz statusy zamówień ze Sky-Shop, które mają być obsługiwane przez xSale. Integracja pobiera zamówienia po wskazanym statusie, dlatego warto podać dokładną nazwę lub identyfikator statusu używany w sklepie.

Listę statusów znajdziesz w panelu Sky-Shop w sekcji Zamówienia → Konfiguracja zamówień → Kolory/Statusy.

Pole w formularzu	Co wpisać
Status zamówienia w Sky-Shop do pobrania do xSale	Status, na którym xSale ma wyszukiwać zamówienia do importu.
Status po poprawnym przesłaniu zamówienia do ERP	Status, który może zostać ustawiony w Sky-Shop po poprawnym zakończeniu procesu, jeżeli taki proces jest skonfigurowany.
Status po błędzie przesłania zamówienia do ERP	Status, który może zostać ustawiony w Sky-Shop, gdy proces zakończy się błędem, jeżeli taka obsługa jest wykorzystywana.

xSale może również przekazać do Sky-Shop numer listu przewozowego razem ze zmianą statusu, jeżeli proces wysyłania numeru listu jest uruchomiony.

Mapowanie sposobów dostawy

W formularzu uzupełnij sposoby dostawy zdefiniowane w Sky-Shop i wskaż, z jaką usługą transportową w ERP mają być powiązane. Dzięki temu zamówienie pobrane do xSale może zostać poprawnie przekazane dalej do ERP.

Nazwy sposobów dostawy znajdziesz w panelu Sky-Shop w sekcji Zamówienia → Formy dostawy.

Przykład mapowania:

Forma dostawy w Sky-Shop	Usługa transportowa w ERP
Kurier InPost	INPOST
Paczkomaty	PACZKOMATY
Kurier DHL	DHL
Allegro Kurier DPD	ALLEGRO DPD

Jeżeli w ERP używasz jednej, uniwersalnej usługi transportowej, możesz wskazać ją dla wszystkich form dostawy, na przykład TRANSPORT. Jeżeli pole zostanie puste, podczas konfiguracji należy ustalić, czy dla danej integracji ma być używana wartość domyślna.

Mapowanie form płatności

W tej części formularza wpisz formy płatności ze Sky-Shop i wskaż odpowiadające im formy płatności w ERP. Jeżeli płatności mają być importowane do ERP, uzupełnij także właściwy rejestr bankowy dla płatności elektronicznych.

Formy płatności w Sky-Shop znajdziesz w sekcji Zamówienia → Płatności i systemy ratalne → Pozostałe.

Przykład mapowania:

Forma płatności w Sky-Shop	Forma płatności w ERP	Rejestr bankowy
Wpłata na konto bankowe	Przelew	Uzupełnij, jeżeli płatność ma być rozliczana przez rejestr bankowy.
Pobranie	Pobranie	Zwykle nie dotyczy, ponieważ płatność nie jest zapłacona w chwili importu zamówienia.
Płatność online / szybka płatność	Przelew lub płatność elektroniczna	Wskaż rejestr bankowy, jeżeli płatność ma być importowana do ERP jako zapłacona.

Integracja pobiera z API Sky-Shop nazwę formy płatności z zamówienia. Jeżeli nazwa nie zostanie poprawnie zmapowana, zamówienie może trafić do xSale, ale dalsze przekazanie do ERP może wymagać poprawy konfiguracji.

Typ ceny wysyłany do Sky-Shop

Jeżeli integracja ma aktualizować ceny w Sky-Shop, w formularzu wskaż typ ceny z ERP, który ma być wysyłany do sklepu. xSale przekazuje cenę produktu do Sky-Shop jako cenę sprzedaży produktu.

Warto upewnić się, że wskazany typ ceny jest uzupełniony na towarach, które mają być synchronizowane. Brak ceny w wybranym typie może spowodować, że aktualizacja ceny nie wykona się prawidłowo.

Kody produktów w Sky-Shop i ERP

W formularzu zaznacz, czy kody produktów w Sky-Shop są takie same jak kody produktów w ERP. Integracja wyszukuje produkty w Sky-Shop między innymi po symbolu produktu, dlatego zgodność kodów ma znaczenie przy aktualizacji produktów, cen i stanów.

Jeżeli kody różnią się między systemami, opisz zasadę ich powiązania. Taka informacja jest potrzebna, aby prawidłowo ustawić synchronizację i uniknąć aktualizacji niewłaściwych produktów.

Produkty wielowariantowe

Jeżeli w Sky-Shop korzystasz z produktów wielowariantowych, zaznacz to w formularzu i dopisz, jak duża część asortymentu działa w ten sposób. Integracja obsługuje warianty na podstawie atrybutów produktu i wartości wariantów pobieranych z API Sky-Shop.

Przy produktach wielowariantowych zwróć szczególną uwagę na ceny i stany wariantów. Jeżeli warianty mają różne ceny, należy sprawdzić, czy sposób ich zapisania w Sky-Shop jest zgodny z obsługiwanym mechanizmem integracji.

Co sprawdzić przed przekazaniem formularza?

• czy adres sklepu i dane dostępowe pozwalają na przygotowanie połączenia z API Sky-Shop,
• czy wpisano status zamówienia, z którego xSale ma pobierać zamówienia,
• czy uzupełniono statusy używane po poprawnym imporcie i po błędzie, jeżeli mają być wykorzystywane,
• czy nazwy sposobów dostawy i płatności są wpisane tak, jak występują w Sky-Shop,
• czy dla płatności elektronicznych wskazano właściwy rejestr bankowy, jeżeli płatności mają być importowane do ERP,
• czy wskazano typ ceny, który ma być wysyłany do Sky-Shop,
• czy kody produktów w Sky-Shop i ERP są zgodne albo czy opisano sposób ich powiązania,
• czy zaznaczono, czy sklep korzysta z produktów wielowariantowych.