Rozwiązywanie problemów z importem XML

Import XML to potężne narzędzie, ale czasem mogą pojawić się problemy. W tym artykule opisujemy najczęstsze błędy i sposoby ich rozwiązania.

Błąd: "Nie można pobrać pliku XML"

Przyczyny:

• URL do pliku jest nieprawidłowy lub zmienił się.
• Serwer CRM jest chwilowo niedostępny.
• Plik wymaga autoryzacji (login/hasło).
• Firewall blokuje połączenie.

Rozwiązanie:

1. Sprawdź URL – wklej go w przeglądarkę i zobacz, czy plik się otwiera.
2. Skontaktuj się z dostawcą CRM – może zmienili adres feedu.
3. Jeśli plik wymaga autoryzacji, skonfiguruj dane dostępowe w ustawieniach importu.
4. Poczekaj i spróbuj ponownie za godzinę – może to chwilowa awaria.

Błąd: "Nieprawidłowy format XML"

Przyczyny:

• Plik zawiera błędy składni XML (np. niezamknięte tagi).
• Kodowanie znaków jest nieprawidłowe (problemy z polskimi znakami).
• Plik jest pusty lub zawiera HTML zamiast XML.

Rozwiązanie:

1. Otwórz plik XML w przeglądarce – zobaczy błąd składni, jeśli istnieje.
2. Użyj walidatora XML online (np. xmlvalidation.com).
3. Sprawdź, czy plik zaczyna się od <?xml version="1.0"?>.
4. Skontaktuj się z dostawcą CRM – to prawdopodobnie błąd po ich stronie.

Błąd: "Brakujące wymagane pola"

Przyczyny:

• Oferta w XML nie ma wszystkich wymaganych danych (np. brak ceny, tytułu, lokalizacji).
• Nazwy pól są inne niż oczekiwane (błędne mapowanie).

Rozwiązanie:

1. Sprawdź, które pola są wymagane – w raporcie importu zobaczysz szczegóły.
2. Uzupełnij brakujące dane w CRM i poczekaj na synchronizację.
3. Jeśli nazwy pól są niestandardowe, skonfiguruj ręczne mapowanie w ustawieniach feedu.

Problem: Zdjęcia nie są pobierane

Przyczyny:

• URL do zdjęć jest nieprawidłowy lub wygasł.
• Zdjęcia są za duże (powyżej 10 MB).
• Serwer ze zdjęciami blokuje pobieranie.
• Format zdjęć nie jest obsługiwany.

Rozwiązanie:

1. Sprawdź URL do zdjęcia w przeglądarce – czy się otwiera?
2. Upewnij się, że zdjęcia są w formacie JPG, PNG lub WebP.
3. Zmniejsz rozmiar zdjęć w CRM (zalecane: max 2 MB).
4. Skontaktuj się z dostawcą CRM, jeśli problem dotyczy wielu ofert.

Problem: Duplikaty ofert

Przyczyny:

• Ta sama oferta ma różne ID w różnych eksportach.
• Skonfigurowano dwa feedy z tym samym źródłem.
• Oferta została ręcznie dodana i jest też w XML.

Rozwiązanie:

1. Upewnij się, że każda oferta ma unikalne, stałe ID w CRM.
2. Sprawdź, czy nie masz dwóch aktywnych feedów z tego samego CRM.
3. Usuń ręcznie dodane duplikaty i zostaw te z importu (lub odwrotnie).

Problem: Oferty nie są aktualizowane

Przyczyny:

• ID oferty w XML się zmienia przy każdym eksporcie.
• Synchronizacja jest ustawiona zbyt rzadko.
• Import jest wstrzymany z powodu wcześniejszych błędów.

Rozwiązanie:

1. Sprawdź, czy ID oferty jest stałe (nie zmienia się między eksportami).
2. Zwiększ częstotliwość synchronizacji (np. co 1-6 godzin).
3. Sprawdź status feedu – może wymaga ręcznego wznowienia.

Problem: Polskie znaki są uszkodzone

Przyczyny:

• Plik XML ma złe kodowanie (np. ISO-8859-2 zamiast UTF-8).
• Deklaracja kodowania w pliku nie zgadza się z faktycznym kodowaniem.

Rozwiązanie:

1. Upewnij się, że plik XML ma kodowanie UTF-8.
2. Sprawdź nagłówek pliku: powinien być <?xml version="1.0" encoding="UTF-8"?>.
3. Skontaktuj się z dostawcą CRM, żeby poprawili eksport.

Kiedy skontaktować się ze wsparciem?

Jeśli:

• Próbowałeś powyższych rozwiązań i problem nadal występuje.
• Błąd dotyczy wielu ofert i blokuje pracę agencji.
• Komunikat błędu jest niezrozumiały.
• Potrzebujesz niestandardowego mapowania pól.

Skontaktuj się z nami – pomożemy rozwiązać problem. Przygotuj:

• URL do problematycznego feedu XML.
• Treść komunikatu błędu.
• Przykładowy ID oferty, która nie działa.