Integracje

⌘K
  2. Strona główna
  4. Integracje
  6. Sklep – Sky-Shop
  8. Najczęstsze problemy - Sky-Shop

Najczęstsze problemy – Sky-Shop

Wpis opisuje najczęstsze problemy, które mogą pojawić się podczas pracy integracji Sky-Shop z xSale. Przy każdym przypadku znajdziesz informację, co sprawdzić w pierwszej kolejności i kiedy zgłosić sprawę do wsparcia xSale.

W tym artykule znajdziesz:

Zamówienia nie pobierają się ze Sky-Shop do xSale

xSale pobiera zamówienia ze Sky-Shop po statusie wskazanym w konfiguracji integracji. Jeżeli zamówienia nie pojawiają się w xSale, sprawdź:

  • czy integracja Sky-Shop jest aktywna,
  • czy w konfiguracji podano poprawny adres API sklepu i klucz API,
  • czy adres API ma właściwy format, na przykład https://adres-sklepu.pl/api/?,
  • czy w Sky-Shop istnieją zamówienia na statusie wskazanym do importu,
  • czy status wpisany w konfiguracji odpowiada statusowi używanemu w Sky-Shop,
  • czy data rozpoczęcia importu zamówień nie jest ustawiona później niż data zamówień, które chcesz pobrać.

Jeżeli konfiguracja jest poprawna, a zamówienia nadal się nie pobierają, sprawdź komunikat błędu w procesie integracji. Treść błędu zwykle wskazuje, czy problem dotyczy API, danych zamówienia, mapowania płatności albo mapowania dostawy.

Błąd „Pole 'Nazwa’ nie może być puste”

Ten błąd oznacza, że podczas importu zamówienia brakuje danych wymaganych do utworzenia kontrahenta, odbiorcy albo pozycji zamówienia.

Sprawdź w zamówieniu w Sky-Shop:

  • czy uzupełnione są dane kupującego lub dane do faktury,
  • czy uzupełnione są dane odbiorcy przesyłki,
  • czy zamówienie ma co najmniej jedną pozycję towarową,
  • czy pozycje zamówienia mają nazwę, kod i ilość,
  • czy dane adresowe nie zostały zapisane w nietypowy sposób, na przykład tylko w uwagach.

Po poprawieniu danych w Sky-Shop ponów import zamówienia lub uruchom ponownie proces, który pobiera zamówienia.

Błąd „Nie można dodać pozycji 'TRANSPORT’”

Ten błąd pojawia się przy przekazywaniu zamówienia dalej do ERP, gdy koszt dostawy ma zostać dodany jako pozycja transportowa, ale konfiguracja nie pozwala poprawnie wskazać takiej pozycji.

Sprawdź:

  • czy w xSale uzupełniono mapowanie sposobów dostawy dla nazwy dostawy pobranej ze Sky-Shop,
  • czy w mapowaniu wskazano właściwy kod usługi transportowej w ERP,
  • czy towar lub usługa transportowa, na przykład TRANSPORT, istnieje w ERP i może zostać dodana do dokumentu,
  • czy nazwa dostawy w mapowaniu jest wpisana tak samo, jak w Sky-Shop, z uwzględnieniem spacji i znaków specjalnych.

Opis konfiguracji mapowań znajduje się we wpisie Jak prawidłowo skonfigurować mapowania płatności i dostaw?.

Nieprawidłowa forma płatności lub dostawy na zamówieniu

xSale pobiera ze Sky-Shop nazwę formy płatności i nazwę sposobu dostawy. Następnie używa mapowań, aby przypisać je do odpowiednich wartości w ERP.

Jeżeli na zamówieniu w xSale albo w ERP pojawia się nieprawidłowa forma płatności lub dostawy, sprawdź:

  • czy dana forma płatności lub dostawy została dodana w mapowaniu integracji,
  • czy nazwa po stronie sklepu jest wpisana dokładnie tak, jak występuje w Sky-Shop,
  • czy po zmianie nazwy dostawy lub płatności w Sky-Shop zaktualizowano również mapowanie w xSale,
  • czy dla płatności elektronicznych uzupełniono rejestr bankowy, jeżeli płatności mają być przekazywane do ERP.

Jeżeli w Sky-Shop dodano nową metodę dostawy albo nową płatność, trzeba dopisać ją także w konfiguracji xSale.

Problem z numerem paczkomatu

Dla dostaw paczkomatowych integracja rozpoznaje dostawę po funkcji lub nazwie zawierającej informację o paczkomacie, a numer punktu pobiera z danych dostawy zamówienia.

Jeżeli pojawia się błąd dotyczący numeru paczkomatu, sprawdź:

  • czy w Sky-Shop na zamówieniu zapisany jest punkt odbioru,
  • czy numer punktu nie został usunięty lub zapisany wyłącznie w uwagach klienta,
  • czy sposób dostawy w Sky-Shop jest skonfigurowany jako dostawa do paczkomatu,
  • czy nazwa sposobu dostawy w mapowaniu xSale odpowiada nazwie używanej w Sky-Shop.

Ceny, stany lub towary nie aktualizują się w Sky-Shop

Aktualizacja produktów w Sky-Shop wymaga poprawnego połączenia towaru z produktem w sklepie. Integracja wyszukuje produkt między innymi po identyfikatorze lub symbolu produktu.

Sprawdź:

  • czy produkt istnieje w Sky-Shop,
  • czy kod produktu w xSale lub ERP odpowiada symbolowi produktu w Sky-Shop,
  • czy w konfiguracji wskazano właściwy typ ceny do wysyłania do Sky-Shop,
  • czy cena jest uzupełniona na towarze w wybranym typie ceny,
  • czy towar ma stan magazynowy, który ma być wysyłany do sklepu,
  • czy produkt nie został usunięty bezpośrednio w Sky-Shop po wcześniejszym połączeniu z xSale.

Jeżeli produkt został usunięty w Sky-Shop, xSale może nie mieć już do czego wysłać aktualizacji. W takiej sytuacji sprawdź powiązanie oferty z produktem albo wystaw produkt ponownie zgodnie z aktualnym procesem obsługi ofert.

Błędy API Sky-Shop

Jeżeli w komunikacie błędu pojawia się odpowiedź API Sky-Shop, najczęściej oznacza to problem z dostępem, adresem API, parametrami zapytania albo produktem, którego dotyczy operacja.

Komunikat Co oznacza Co sprawdzić
Access denied lub code_403 Brak dostępu do API. Sprawdź klucz API, uprawnienia i adres API w konfiguracji integracji.
Item(s) not found lub code_404 Sky-Shop nie znalazł wskazanego obiektu, na przykład produktu. Sprawdź, czy produkt lub zamówienie nadal istnieje w Sky-Shop i czy identyfikator/kod jest poprawny.
Function not found lub code_500 Wywołana funkcja API nie została rozpoznana. Sprawdź adres API i konfigurację połączenia.
Missing or wrong parameters lub code_501 Do API wysłano brakujące albo nieprawidłowe dane. Sprawdź dane zamówienia, produktu, mapowania i wymagane pola.

Jeżeli po sprawdzeniu powyższych punktów problem nadal występuje, przekaż do wsparcia xSale numer zamówienia lub kod produktu, nazwę integracji oraz pełną treść komunikatu błędu.

Czego brakuje w tym artykule?