Najczęstsze błędy w pliku CSV do dane.gov.pl i jak ich uniknąć
Większość problemów z feedem nie wynika z trudnych przepisów, lecz z drobnych błędów w pliku CSV. Oto te, które najczęściej blokują publikację — i jak ich uniknąć, zanim plik trafi do portalu.
W skrócie
- Złe kodowanie i separatory psują polskie znaki i układ kolumn.
- Brakująca lub przestawiona kolumna potrafi unieważnić cały plik.
- Ceny muszą być liczbami w spójnym formacie.
- Statusy lokali powinny mieć dozwolone, jednolite wartości.
1. Złe separatory i kodowanie
CSV to z pozoru banał, ale to tu zaczyna się większość kłopotów. Niewłaściwy separator (przecinek vs średnik) rozjeżdża kolumny, a kodowanie inne niż UTF-8 zamienia polskie znaki w „krzaki”. Ustal jeden standard i trzymaj się go w każdym wygenerowanym pliku.
2. Brakujące lub przestawione kolumny
Format ma stałą strukturę. Jeśli kolumna zniknie albo zamieni się miejscami z inną, dane przestają być czytelne dla odbiorcy. Najczęściej dzieje się tak przy ręcznej edycji pliku — dlatego lepiej, gdy generuje go automat z jednego mapowania.
3. Format cen i liczb
Cena to liczba, a nie tekst. Spacje jako separator tysięcy, znak waluty w komórce albo przecinek zamiast kropki w niespodziewanym miejscu potrafią popsuć odczyt. Trzymaj ceny w jednolitym, czysto liczbowym formacie.
Otwarcie i zapisanie CSV w arkuszu kalkulacyjnym potrafi „po cichu” zmienić format liczb i dat. Generuj plik programowo.
4. Niespójne statusy lokali
„Dostępny”, „dostepny”, „wolny”, „w sprzedaży” — jeśli ten sam stan opisujesz na kilka sposobów, dane tracą porównywalność. Ustal słownik statusów i mapuj swoje wartości na jeden, spójny zestaw.
5. Lista kontrolna przed wysyłką
- Kodowanie UTF-8 i właściwy separator
- Wszystkie wymagane kolumny, w poprawnej kolejności
- Ceny jako liczby, bez waluty i spacji
- Statusy z jednego, dozwolonego słownika
- Plik otwiera się i wygląda poprawnie po wygenerowaniu
Najczęstsze pytania
Dlaczego mój plik ma „krzaki" zamiast polskich znaków?
To problem kodowania. Zapisz i generuj plik w UTF-8 — wtedy znaki diakrytyczne wyświetlą się poprawnie.
Czy mogę edytować CSV w arkuszu kalkulacyjnym?
Można, ale ostrożnie — arkusze potrafią zmienić format liczb i dat przy zapisie. Bezpieczniej generować plik automatycznie.
Co zrobić, gdy portal odrzuca plik?
Sprawdź kolejno: kodowanie, separator, komplet kolumn i format cen. Najczęściej przyczyna leży w jednym z tych punktów.
Jak uniknąć błędów na stałe?
Zautomatyzować generowanie feedu z jednego mapowania pól, zamiast ręcznie składać plik za każdym razem.
Zgodność z dane.gov.pl bez przepisywania CRM
Skonfigurujemy codzienny feed cen mieszkań po Twojej stronie — od A do Z.