Raporty TFG w KSI CRM

Ręczna obsługa raportów TFG w KSI CRM

Ta funkcja pozwala przygotować w systemie KSI pliki z danymi rezerwacji (w formacie JSON) wymagane przez TFG/UFG, a następnie samodzielnie wysłać je przez panel TFG. System sam zbiera potrzebne dane — Twoim zadaniem jest wygenerować raport, pobrać pliki i przekazać je do TFG.

Raportowanie jest przyrostowe: po każdej ważnej zmianie w rezerwacjach (nowa umowa, zmiana danych, anulowanie, usunięcie) należy ponownie wygenerować i wysłać aktualną paczkę plików. Obowiązek dotyczy umów zawartych od 1 lipca 2026 r.

Zanim zaczniesz

• W systemie KSI musi być włączona opcja raportów TFG — bez niej przycisk nie będzie widoczny (skontaktuj się z nami, jeśli go nie masz).
• Potrzebujesz konta w panelu TFG (dane dostępowe otrzymujesz od UFG).
• Przygotuj na komputerze folder, w którym zapiszesz pobrane pliki.

Krok po kroku — generowanie raportu w KSI

1. Na liście rezerwacji naciśnij przycisk Więcej opcji.

   

2. W rozwiniętym menu wybierz Raporty TFG.

   

3. Pojawi się lista wcześniej wygenerowanych raportów (najnowsze są na górze). Aby przygotować nową paczkę plików, naciśnij Generuj raport.

   

4. Jeśli w danych są błędy — pojawi się komunikat wskazujący, w której rezerwacji i jaki błąd wystąpił. Popraw wszystkie wskazane rezerwacje, a następnie ponownie naciśnij Generuj raport.
   Ważne: gdy występują błędy, pliki nie zostają utworzone — cała paczka jest wstrzymywana do czasu poprawienia wszystkich rezerwacji.

   

5. Jeśli wszystko jest poprawne — pojawi się komunikat o prawidłowym wygenerowaniu raportu.

   

6. Zaznacz na liście najnowszy raport, naciśnij Pobierz pliki na dysk i wskaż folder, w którym mają się zapisać.

   

Które rezerwacje trafiają do raportu

Do TFG raportowane są rezerwacje w statusie Sprzedaż, Sprzedana oraz Anulowana (anulowane trafiają jako rozwiązanie umowy).

Rezerwacje w statusie Oferta i Nowa są pomijane — nie są jeszcze sprzedażą, więc nie podlegają zgłoszeniu.

Jakie pliki możesz otrzymać

Jeden raport może zawierać od jednego do czterech plików. W paczce znajdą się tylko te rodzaje, które akurat wymagają wysłania — nie zawsze będą wszystkie cztery.

Wysyłka do panelu TFG — kolejność ma znaczenie

1. Wejdź na https://tfg.ufg.pl/ i zaloguj się (konto w systemie TFG otrzymujesz od UFG).
2. Prześlij każdy pobrany plik JSON — nie pomijaj żadnego.
3. Jeśli w paczce jest kilka plików, wysyłaj je w kolejności:

• NOWEDANE
• →
• KOREKTA
• →
• ROZWIAZANIE
• →
• USUNIECIE

Na co zwrócić uwagę w danych rezerwacji

Poniższe dane muszą być zgodne z wymaganiami TFG — inaczej raport zgłosi błąd:

• Nazwy krajów muszą być zgodne ze słownikiem kodów wykazu umów TFG. Jeśli przy generowaniu pojawi się błąd dotyczący kraju, sprawdź pisownię nazwy kraju w rezerwacji — system dopasowuje ją do słownika TFG. Nie używaj własnych skrótów ani nazw spoza słownika.
• Kody walut w standardzie ISO 4217 — np. złotówki to PLN, euro to EUR, dolar amerykański to USD.
• Lotniska (gdy rezerwacja ma transport lotniczy) muszą mieć kod lotniska przylotu w standardzie IATA (3 litery, np. WAW, HRG) — uzupełniany w składniku samolotu rezerwacji.
• Liczba osób w rezerwacji musi być większa od zera.
• Kraj wyjazdu powinien być uzupełniony (w hotelu lub w planie oferty).

Kolumna TFG na liście rezerwacji

Ostatni stan eksportu dla danej rezerwacji jest widoczny w kolumnie TFG. Dzięki niej sprawdzisz, co zostało już przekazane, a co jeszcze wymaga wysłania.

Szybka ściągawka

× ‹ ›