Appearance
Walidacja i diagnostyka błędów
Spis treści
- Typy błędów: krytyczne, ostrzeżenia, informacyjne
- Panel błędów — jak czytać komunikaty
- Najczęstsze błędy i jak je naprawić
- Błąd HTTP 403 — Forbidden (brak dostępu do pliku)
- Błąd HTTP 404 — plik nie istnieje
- Błąd HTTP 401 — brak autoryzacji
- Timeout — przekroczenie czasu pobierania
- Błąd parsowania — niepoprawny format pliku
- Powiadomienie: Spadek produktów w feedzie
- Brakujące wymagane pola w feedzie wyjściowym
- Reguła zawiera błąd
- Eksport raportu błędów
Sembot monitoruje stan plików źródłowych i wyjściowych w sposób ciągły. Gdy pojawi się problem z pobieraniem, parsowaniem lub generowaniem pliku, system sygnalizuje to bezpośrednio na liście feedów i wysyła powiadomienie. Poniżej opisano jak rozumieć te sygnały i jak skutecznie diagnozować przyczyny błędów.
Typy błędów: krytyczne, ostrzeżenia, informacyjne
Sembot rozróżnia trzy poziomy istotności problemów z feedem:
| Poziom | Ikona na liście | Znaczenie |
|---|---|---|
| Błąd | Czerwona ikona błędu | Problem uniemożliwia pobranie lub przetworzenie pliku — feed nie działa poprawnie |
| Ostrzeżenie | Pomarańczowa ikona ostrzeżenia | Feed działa, ale dane są niekompletne lub niespełniające wymagań kanału — może obniżać jakość reklam |
| Informacyjny | Niebieska ikona informacji | Zmiana stanu wymagająca uwagi, ale niekrytyczna |
Poza poziomem istotności każdy błąd ma kategorię wskazującą gdzie leży przyczyna:
| Kategoria | Znaczenie | Kto powinien działać |
|---|---|---|
| Błąd po stronie klienta / feedu | Problem ze źródłem danych — plik niedostępny, zablokowany, niepoprawny format | Dział IT lub administrator sklepu |
| Błąd w ustawieniach / mapowaniu | Problem z konfiguracją w Sembocie — niepoprawne mapowanie, brakujące wymagane pola | Użytkownik Sembota |
| Błąd systemowy | Problem po stronie serwerów Sembot | Obsługa klienta Sembot |
Panel błędów — jak czytać komunikaty
Sygnalizacja na liście feedów
Na stronie Ustawienia feedów każdy wiersz z problemem oznaczony jest kolorową ikoną w pierwszej kolumnie tabeli:
- "Ten feed zawiera błędy" — plik nie jest pobierany lub generowany poprawnie
- "Ten feed zawiera ostrzeżenia" — plik działa, ale zawiera dane niekompletne lub niespełniające wymagań
Wiersz z błędem jest dodatkowo wyróżniony wizualnie (zmienione tło), żeby od razu przyciągał uwagę.
Strona weryfikacji feeda
Kliknij prawym przyciskiem myszy (lub ikonę menu) przy feedzie z błędem i wybierz Weryfikuj feed. Otworzy się strona Weryfikacja feeda z pełną diagnozą.
Co widać na stronie weryfikacji
Diagram przepływu statusu — schemat wizualny pokazujący w którym miejscu łańcucha pojawia się błąd:
Ty → Feed → Aplikacja Sembot → Serwer
[Działa] [Błąd] [Nieznany] [Nieznany]Każdy element diagramu może mieć jeden z trzech stanów:
- Działa (zielony) — etap działa poprawnie
- Błąd (czerwony) — tu zlokalizowany jest problem
- Nieznany (szary) — etap niezbadany (gdy błąd zatrzymał przetwarzanie wcześniej)
Kod i opis błędu — techniczny kod błędu (np. HTTP 403, HTTP 404, Timeout) oraz jego czytelne wyjaśnienie w języku polskim.
Instrukcje dla działu IT — jeśli Sembot zna rozwiązanie, przycisk Pokaż instrukcje IT odsłania gotowy blok tekstu z krokami technicznymi do wdrożenia. Całość można skopiować do schowka przyciskiem Kopiuj do schowka i przekazać informatykowi lub dostawcy platformy e-commerce.
Przycisk Zgłoś do obsługi klienta — gdy błąd nie jest możliwy do samodzielnego naprawienia (kategoria systemowa lub niejasna), kliknięcie przycisku automatycznie wysyła zgłoszenie do supportu Sembot. Potwierdzenie: "Zgłoszenie wysłane! Nasz zespół wsparcia został powiadomiony o problemie. Skontaktujemy się z Tobą wkrótce."
Baza wiedzy — link do artykułu pomocniczego dotyczącego danego błędu (dostępny dla błędów po stronie klienta i konfiguracyjnych).
Historia parsowania
Przy każdym pliku źródłowym i wyjściowym dostępna jest historia zadań — menu kontekstowe → Historia. Otwiera się modal z tabelą ostatnich operacji:
| Kolumna | Co pokazuje |
|---|---|
| Data | Kiedy odbyło się parsowanie / generowanie |
| Status | Sukces / Błąd / W toku / Oczekuje |
| Produkty | Liczba produktów w pliku po tej operacji |
| Błąd | Treść błędu jeśli operacja się nie powiodła |
Historia zawiera też wykres trendu — liczba produktów i czas operacji w czasie. Pozwala szybko zauważyć czy liczba produktów nagle spadła lub czy plik zaczął być pobierany wolniej.
Brak wpisów w historii oznacza, że feed nie był jeszcze parsowany lub historia jest starsza niż 7 dni: "Brak historii parsowania z ostatnich 7 dni."
Najczęstsze błędy i jak je naprawić
Błąd HTTP 403 — Forbidden (brak dostępu do pliku)
Przyczyna: Serwer sklepu lub platformy e-commerce blokuje pobieranie pliku przez zewnętrzne serwery. Najczęściej dotyczy platform takich jak IdoSell, które domyślnie ograniczają dostęp do eksportów feedu.
Komunikat: "Nie udało nam się pobrać feeda produktowego. Jeśli używasz IdoSell, włącz dostęp z zewnętrznego serwera w ustawieniach eksportu feedu na co najmniej 30 dni."
Rozwiązanie: Dodaj adresy IP Sembota do białej listy (whitelist) na serwerze lub w panelu platformy e-commerce. Adresy IP do dodania:
52.28.49.250
51.77.44.22
51.77.44.187
51.38.111.87
51.38.107.36Instrukcje dla konkretnej platformy dostępne są po kliknięciu Pokaż instrukcje IT na stronie weryfikacji. Gotowy blok tekstu możesz skopiować i przekazać do działu IT.
Błąd HTTP 404 — plik nie istnieje
Przyczyna: Adres URL podany przy dodawaniu feeda jest niepoprawny lub plik przestał być dostępny pod tym adresem (zmiana konfiguracji eksportu w sklepie).
Rozwiązanie: Wejdź do Ustawienia feedów, kliknij Edytuj przy pliku źródłowym i zaktualizuj URL do aktualnego adresu pliku feedu.
Błąd HTTP 401 — brak autoryzacji
Przyczyna: Plik jest chroniony hasłem, ale dane dostępowe (login/hasło) nie zostały podane lub są niepoprawne.
Rozwiązanie: Edytuj plik źródłowy, rozwiń sekcję Zaawansowane i wprowadź poprawny Login oraz Hasło do dostępu do pliku.
Timeout — przekroczenie czasu pobierania
Przyczyna: Serwer sklepu odpowiada zbyt wolno lub plik jest bardzo duży i pobieranie trwa dłużej niż dozwolony czas.
Rozwiązanie: Sprawdź czy serwer sklepu działa poprawnie. Jeśli plik jest duży (setki tysięcy produktów), rozważ podział na kilka mniejszych plików źródłowych lub skontaktuj się z obsługą klienta Sembot.
Błąd parsowania — niepoprawny format pliku
Przyczyna: Plik jest dostępny pod podanym URL, ale jego zawartość nie jest poprawnym XML lub CSV — np. serwer zwraca stronę HTML z błędem zamiast pliku feedu, plik jest uszkodzony lub ma niespójną strukturę.
Rozwiązanie: Otwórz URL pliku bezpośrednio w przeglądarce i sprawdź czy wyświetla się poprawny plik. Jeśli plik wygląda prawidłowo, sprawdź ustawienie Typ pliku przy feedzie (sekcja Zaawansowane) — możliwe że ustawiono zły format. Jeśli plik jest XML, a Sembot próbuje go parsować jako CSV — zmień typ na XML lub Autodetekcja.
Powiadomienie: Spadek produktów w feedzie
Przyczyna: Po ostatnim parsowaniu liczba produktów w feedzie znacząco spadła — np. z 10 000 do 200. Może to oznaczać: awarię eksportu po stronie sklepu, błąd w regułach produktowych, zmianę struktury pliku źródłowego lub celowe usunięcie produktów.
Typ powiadomienia: "Spadek produktów w feedzie wejściowym" / "Spadek produktów w feedzie wyjściowym"
Rozwiązanie: Sprawdź historię parsowania (menu kontekstowe → Historia) i porównaj liczbę produktów w poprzednich cyklach. Jeśli problem jest w pliku wejściowym — skontaktuj się z dostawcą feedu lub działem IT sklepu. Jeśli problem jest w pliku wyjściowym — sprawdź reguły i filtry produktów w tym feedzie.
Brakujące wymagane pola w feedzie wyjściowym
Przyczyna: Plik wyjściowy nie zawiera wszystkich pól wymaganych przez kanał (np. Google Merchant Center wymaga pola availability, którego nie ma w mapowaniu).
Typ powiadomienia: "Brakujące wymagane pola w feedzie wyjściowym"
Rozwiązanie: Wejdź do edycji pliku wyjściowego (menu kontekstowe → Edytuj), przejdź do kroku Mapowanie i uzupełnij brakujące pola wymagane przez wybrany kanał. Sprawdź czy odpowiedni atrybut istnieje w danych produktowych — jeśli nie, może być konieczne dodanie reguły uzupełniającej lub wzbogacenie pliku źródłowego.
Reguła zawiera błąd
Komunikat: "Reguła zawiera błędy." przy danej regule na liście reguł.
Przyczyna: Reguła odwołuje się do atrybutu, który nie istnieje w aktualnym schemacie produktów, lub zawiera niepoprawną konfigurację akcji.
Rozwiązanie: Kliknij Edytuj przy regule z błędem i sprawdź ustawienia akcji oraz filtrów. Reguły z błędem nie mogą być aktywowane — komunikat: "Reguła zawiera błąd i nie może zostać włączona."
Eksport raportu błędów
Sembot nie posiada dedykowanego przycisku eksportu raportu błędów do pliku. Dostępne są natomiast następujące sposoby pozyskania danych o błędach:
Kopiowanie instrukcji do schowka — na stronie weryfikacji feeda przycisk Kopiuj do schowka kopiuje pełną treść błędu wraz z instrukcjami dla działu IT. Skopiowany tekst można wkleić do e-maila, dokumentu lub zgłoszenia serwisowego.
Zgłoszenie do obsługi klienta — przycisk Zgłoś do obsługi klienta automatycznie przesyła do supportu Sembot pełne dane techniczne błędu (kod, kategorię, identyfikator feeda, projekt). Nie ma potrzeby ręcznego kopiowania danych technicznych.
Historia parsowania — tabela w modalu Historia zawiera kompletny log operacji z datami, statusami i treściami błędów. Dane można przeglądać i ręcznie kopiować.
Powiadomienia — centrum powiadomień Sembota przechowuje historię alertów o błędach feedów (błąd wejściowy, błąd wyjściowy, spadek produktów), które można przeglądać w sekcji Centrum powiadomień.