Oprogramowanie i strony www dla organizatora turystyki
Raporty UFG/TFG

Wysyłanie raportów do UFG/TFG

W związku z wejściem w życie nowych obowiązków raportowania danych do UFG chcielibyśmy przekazać aktualne informacje dotyczące możliwości przygotowania raportów z systemu KSI.

Dane wymagane do raportowania są dostępne w systemie KSI

System KSI przechowuje dane dotyczące rezerwacji, uczestników, płatności oraz rozliczeń imprez turystycznych w sposób uporządkowany i umożliwiający ich dalsze przetwarzanie.

Już obecnie użytkownicy mogą eksportować dane do formatów Excel oraz CSV między innymi z:

  • rejestru rezerwacji,
  • rejestru wpłat gotówkowych,
  • rejestru wpłat bezgotówkowych,
  • innych zestawień i raportów dostępnych w systemie.

Ponadto szczegółowe dane dotyczące przebiegu i rozliczenia imprez turystycznych są dostępne w funkcjonującym od lat raporcie „Rozliczenie imprezy".

Oznacza to, że wymagane przez ustawę dane znajdują się w systemie i mogą stanowić podstawę do przygotowania raportów wymaganych przez UFG.

Wybierz opcję wygodną dla Twojego biura

Po opublikowaniu przez UFG kompletnej dokumentacji technicznej oraz uruchomieniu wszystkich niezbędnych usług integracyjnych użytkownicy systemu KSI będą mogli wybrać jeden z dwóch sposobów realizacji obowiązku raportowania.

Wariant 1: generowanie plików CSV/JSON

W przypadku wyboru raportowania ręcznego system KSI będzie umożliwiał przygotowanie raportów w formatach wymaganych przez UFG (np. CSV, JSON lub innych, jeżeli zostaną określone przez UFG).

Użytkownik będzie mógł wygenerować raport w systemie KSI, a następnie samodzielnie przekazać go do UFG zgodnie z procedurami udostępnionymi przez UFG.

Funkcjonalność ta planowana jest jako standardowy element systemu KSI dostępny dla użytkowników posiadających aktywny abonament.

Wariant 2: automatyczna integracja z API UFG

Dla organizatorów turystyki zainteresowanych pełną automatyzacją procesu raportowania planowane jest udostępnienie integracji systemu KSI z API UFG.

Uruchomienie takiej integracji będzie wymagało:

  • zawarcia odpowiedniej umowy lub aneksu dotyczącego rozszerzenia funkcjonalności systemu KSI,
  • uzyskania przez organizatora turystyki dostępu do usług API UFG,
  • przekazania danych niezbędnych do konfiguracji integracji, zgodnie z wymaganiami określonymi przez UFG,
  • przeprowadzenia testów integracyjnych przed uruchomieniem środowiska produkcyjnego.

Zakres wymaganych danych autoryzacyjnych oraz procedura ich uzyskania zależą od ostatecznej dokumentacji technicznej opublikowanej przez UFG.

Wykonanie raportów do plików CSV i JSON

Przepisy określają zakres informacji, które mają być przekazywane do UFG, jednak na chwilę obecną UFG nie opublikował kompletnych wzorów plików, pełnych schematów danych ani wszystkich zasad walidacji raportów.

W praktyce oznacza to, że obecnie nie jest możliwe przygotowanie gotowego eksportu CSV lub JSON zgodnego z wymaganiami UFG, ponieważ nie są znane ostateczne formaty plików przyjmowanych przez system.

Po opublikowaniu przez UFG kompletnej dokumentacji technicznej, wzorów plików oraz zasad ich przetwarzania przygotujemy odpowiednie funkcje eksportu danych.
Funkcjonalność ta zostanie udostępniona jako dodatkowy moduł w systemie KSI.

Integracja automatyczna przez API

W ostatnich dniach została opublikowana pierwsza wersja dokumentacji API UFG. Jest to krok we właściwym kierunku, jednak dokumentacja nadal pozostaje niekompletna.

Pomimo rozszerzenia zakresu opisu nadal brakuje części kluczowych informacji niezbędnych do przygotowania i przetestowania w pełni automatycznej integracji, między innymi:

  • pełnych słowników wartości,
  • części opisów pól i zależności między danymi,
  • kompletnej specyfikacji procesów biznesowych,
  • pełnych przykładów komunikacji,
  • niektórych informacji związanych z autoryzacją i obsługą błędów.

W związku z tym przygotowanie produkcyjnej integracji automatycznej nie jest jeszcze możliwe.

Co będzie potrzebne do uruchomienia integracji API

Po udostępnieniu przez UFG kompletnej dokumentacji technicznej oraz wszystkich wymaganych materiałów będziemy mogli przygotować i wdrożyć automatyczną integrację systemu KSI z UFG.

Należy również pamiętać, że dostęp do API jest nadawany indywidualnie dla każdego organizatora turystyki. Oznacza to, że każdy organizator będzie musiał wystąpić do UFG o przyznanie odpowiednich dostępów zarówno do środowiska testowego, jak i produkcyjnego.

Po otrzymaniu tych danych dostępowych od Państwa będziemy mogli skonfigurować połączenie systemu KSI z UFG oraz przeprowadzić niezbędne testy integracyjne.

Kontakt

Jeżeli są Państwo zainteresowani wdrożeniem funkcjonalności raportowania do UFG w systemie KSI, zapraszamy do kontaktu.

Zapytaj

Podsumowanie

Chcemy podkreślić, że dane wymagane do raportowania są dostępne w systemie KSI i nie przewidujemy przeszkód technicznych uniemożliwiających przygotowanie odpowiednich funkcjonalności.

Realizacja zarówno raportów ręcznych (CSV/JSON), jak i pełnej automatycznej integracji przez API będzie możliwa niezwłocznie po spełnieniu dwóch warunków:

  1. UFG opublikuje kompletną dokumentację techniczną, wzory plików oraz pełne wytyczne integracyjne.
  2. Organizator turystyki uzyska i przekaże dane dostępowe do środowisk API udostępnianych przez UFG.

Do tego czasu monitorujemy publikowane materiały i na bieżąco analizujemy pojawiające się informacje, aby możliwie szybko przygotować gotowe rozwiązania dla użytkowników systemu KSI.