Przejdź do treści
Mój Wyjazd
Panel: wkrótceUmów demo

Struktura pliku nieprawidłowa: nazwy nagłówków kolumn

Ten komunikat oznacza, że pierwszy wiersz pliku CSV nie zgadza się ze wzorem dla wybranego typu pliku, najczęściej przez własne nazwy kolumn albo zły typ. Wklej dane do aktualnego szablonu UFG bez zmiany nagłówków i wybierz w portalu typ zgodny z plikiem.

Sprawdzono: 6.11.2026. Autor: Krzysztof Czapnik, KC Mobile. Podstawa: tabela walidacji UFG z 24.07.2026 r., pytania i odpowiedzi UFG z 9.07.2026 r.

W tym tekście

Treść komunikatu

Struktura pliku jest nieprawidłowa. Nazwy nagłówków kolumn nie odpowiadają wymaganemu schematowi.

Co to oznacza

Według tabeli UFG to walidacja po przyjęciu pliku: plik pojawi się w tabeli Dodane pliki, ale jego pozycje nie trafią do tabeli Umowy na formularzu szczegółów pliku. Dlatego błąd trzeba poprawić i dodać plik ponownie.

Dotyczy plików CSV, przy każdym typie: nowe dane, korekta, rozwiązanie i usunięcie. Pierwszy wiersz pliku nie zgadza się z wzorem dla wybranego typu.

Najczęstsze przyczyny

Tabela UFG nie podaje przyczyn. Oto, co warto sprawdzić po kolei.

  • Własne nazwy kolumn. Plik powstał z arkusza biura, na przykład z kolumną „Numer umowy” zamiast NrUmowyRezerwacji.
  • Zły typ pliku. Plik z zakładki nowych danych został dodany jako korekta albo odwrotnie.
  • Dodatkowe lub brakujące kolumny. Usunięte puste kolumny, na przykład ZakresTerytorialny5, albo dopisane własne uwagi.
  • Nagłówek nie w pierwszym wierszu. Nad tabelą został tytuł arkusza.
  • Zły separator. Prawidłowy plik otwarty w Notatniku ma średniki między kolumnami.

Jakie kolumny ma każdy typ

Typ plikuKolumny
Nowe dane38 kolumn, lista poniżej
Korekta (Zmiana i Błąd)40 kolumn: jak w nowych danych, plus PoprzedniNrUmowyRezerwacji jako druga oraz DataZmianyUmowy jako ostatnia
RozwiązanieNrUmowyRezerwacji, DataRozwiazaniaUmowy
UsunięcieNrUmowyRezerwacji

Nagłówek pliku typu Nowe dane, według przykładowego pliku UFG:

NrUmowyRezerwacji;PrzedmiotUmowy;DataZawarciaUmowy;TerminRealizacjiOd;TerminRealizacjiDo;LiczbaPodroznych;ZakresTerytorialny1;KrajRealizacjiUmowy1;MiejscowoscRealizacjiUmowy1;ZakresTerytorialny2;KrajRealizacjiUmowy2;MiejscowoscRealizacjiUmowy2;ZakresTerytorialny3;KrajRealizacjiUmowy3;MiejscowoscRealizacjiUmowy3;ZakresTerytorialny4;KrajRealizacjiUmowy4;MiejscowoscRealizacjiUmowy4;ZakresTerytorialny5;KrajRealizacjiUmowy5;MiejscowoscRealizacjiUmowy5;RodzajSrodkaTransportu1;KodLotniskaDocelowego1;RodzajSrodkaTransportu2;KodLotniskaDocelowego2;RodzajSrodkaTransportu3;KodLotniskaDocelowego3;LacznaCenaUslug1;WalutaUslug1;LacznaCenaUslug2;WalutaUslug2;LacznaCenaUslug3;WalutaUslug3;SposobPrzyjmowaniaWplat;WplataZwrot;DataWplatyDataZwrotu;KwotaWplatyKwotaZwrotu;WalutaWplatyWalutaZwrotu

Jak to naprawić

  1. Pobierz aktualne szablony UFG i wklej dane do właściwej zakładki, nie zmieniając nagłówków. UFG aktualizuje szablony, więc nie korzystaj ze starej kopii.
  2. Zapisz zakładkę jako „Plik CSV UTF-8”.
  3. Otwórz plik w Notatniku i porównaj pierwszy wiersz z listą powyżej.
  4. Przy dodawaniu w Portalu TFG wybierz typ zgodny z plikiem.

Pytania

Czy mogę usunąć kolumny, których nie używam?

Nie zalecamy. Puste kolumny, na przykład drugi i kolejne zakresy terytorialne, powinny zostać, tak jak w przykładowych plikach UFG. Puste są wtedy tylko wartości, a nie nagłówki.

Skąd wziąć poprawne nagłówki?

Z szablonu w Excelu i przykładowych plików CSV na stronie UFG Jak korzystać z Portalu TFG.

Konwerter Excel na wykaz umów

Wgraj arkusz, sprawdź błędy przed wysyłką i pobierz plik CSV. Plik jest przetwarzany w przeglądarce. Wersja testowa: ostateczne sprawdzenie wykonuje Portal TFG. Otwórz konwerter

System, w którym wykaz wynika z rezerwacji

Budujemy Mój Wyjazd dla biur organizujących wyjazdy grupowe. Zobacz, co działa, a co jest w przygotowaniu.

Cały proces w poradniku o wykazie umów oraz inne błędy.

Źródła