Subiekt GT ftp — poradnik praktyczny 2026

Subiekt GT ftp — poradnik praktyczny 2026

Wymiana plików między systemami to codzienność każdego biura rachunkowego i działu księgowego. W 2026 roku, gdy standardy bezpieczeństwa danych są wyższe niż kiedykolwiek, mechanizm ftp w Subiekcie GT pozostaje jednym z najważniejszych narzędzi automatyzacji. Ten poradnik odpowiada na konkretne pytania: jak skonfigurować ftp, jak go zabezpieczyć i co zrobić, gdy transfer nie działa. Zero domysłów — tylko sprawdzone procedury.

Dlaczego mechanizm ftp w Subiekcie GT jest kluczowy dla Twojej firmy

Subiekt GT od wielu lat oferuje wbudowany moduł ftp, który automatyzuje wysyłanie i odbieranie dokumentów handlowych. Mechanizm ten pozwala na bezobsługową wymianę faktur, zamówień i stanów magazynowych między oddziałami firmy, biurem rachunkowym a dostawcami. W praktyce oznacza to, że dokument sprzedaży wystawiony w centrali może w ciągu kilkudziesięciu sekund trafić na serwer oddziału w zupełnie innym mieście — bez udziału człowieka, bez ryzyka pomyłki przy ręcznym przesyłaniu załączników e-mailowych.

Warto podkreślić, że ftp w Subiekcie GT to nie zwykły klient ftp, który znamy z programów typu FileZilla. To dedykowany, wbudowany w strukturę programu moduł wymiany danych, który operuje bezpośrednio na bazie dokumentów. Działa w tle, może być uruchamiany według harmonogramu, a jego logi są dostępne bezpośrednio z poziomu programu. Dla firmy przetwarzającej kilkaset dokumentów miesięcznie to oszczędność godzin pracy i eliminacja błędów ludzkich.

Obsługiwane dokumenty i formaty przesyłania

Zanim przejdziemy do konfiguracji, musisz wiedzieć jedno: nie każdy typ dokumentu można przesłać przez ftp. Subiekt GT w wersji aktualnej na pierwszy kwartał 2026 obsługuje transfer następujących typów dokumentów handlowych: faktury sprzedaży (FS), faktury zakupu (FZ), zamówienia od odbiorców (ZO), zamówienia do dostawców (ZD), paragony (PA), dokumenty magazynowe (PZ, WZ, MM, PW, RW), a także cenniki i stany magazynowe.

Jeśli chodzi o formaty plików, masz do wyboru dwa główne standardy: rodzimy format wymiany Subiekta (XML o specyficznej strukturze Insert GT) oraz uniwersalny XML w standardzie ECOD. Wybór zależy od tego, jaki system znajduje się po drugiej stronie. Jeśli wymieniasz dane między dwiema instalacjami Subiekta GT — stosuj format Insert GT, bo zachowuje pełną strukturę dokumentu łącznie z analityką i powiązaniami. Jeśli wysyłasz dane do systemu zewnętrznego, np. hurtowni lub platformy B2B — wybierasz ECOD XML. Pamiętaj jednak, że standard ECOD ma swoje ograniczenia — nie przenosi pełnej analityki kont księgowych i szczegółów konfiguracji towarów.

Jak skonfigurować ftp w Subiekcie GT krok po kroku

Konfiguracja ftp w Subiekcie GT w 2026 roku różni się od wcześniejszych wersji przede wszystkim wymaganiami bezpieczeństwa. Program domyślnie wymusza teraz szyfrowane połączenia (TLS 1.3) i nie pozwala zapisać konfiguracji z hasłem w postaci jawnej. Oto dokładna ścieżka:

1. Z menu głównego wybierz Narzędzia → Wymiana danych → Konfiguracja ftp. Jeśli menu jest nieaktywne, sprawdź czy Subiekt GT działa w wersji Pro/Enterprise — wersja Start nie ma modułu ftp.

2. W oknie konfiguracji kliknij przycisk Dodaj nowy profil. Nadaj mu czytelną nazwę, np. "Oddział Warszawa — odbiór faktur" lub "Hurtownia ABC — wysyłka zamówień".

3. W zakładce Połączenie wprowadź dane serwera: adres hosta (może być IP lub domena), port (standardowy dla FTP to 21, dla FTPS — port 990, dla SFTP — port 22, przy czym SFTP wymaga osobnej biblioteki DLL opisanej w dalszej części), nazwę użytkownika i hasło. Przy haśle nie ma opcji "pokaż hasło" — Subiekt przechowuje je w zaszyfrowanym magazynie Windows Credential Manager.

4. W zakładce Tryb pracy wybierz kierunek transferu. Masz trzy opcje: tylko wysyłanie (upload), tylko odbieranie (download) lub obie operacje (synchronizacja dwukierunkowa). Dla większości scenariuszy polecam dwa osobne profile — jeden do wysyłki, drugi do odbioru — bo łatwiej diagnozować problemy z pojedynczą operacją.

5. W zakładce Katalogi określ ścieżki: folder zdalny na serwerze ftp (np. /subiekt/wymiana/warszawa/) oraz folder lokalny na Twoim komputerze. Folder lokalny musi istnieć fizycznie — Subiekt nie tworzy go automatycznie. Zalecam utworzenie dedykowanego katalogu, np. C:\SubiektGT_Wymiana\, zamiast używania pulpitu czy folderu tymczasowego.

6. W zakładce Harmonogram ustaw interwał czasowy automatycznego uruchamiania. W 2026 roku częstotliwości to: co 5, 15, 30 minut, co godzinę, lub ręcznie. Dla wymiany produkcyjnej rekomenduję 15 minut — to optymalny kompromis między świeżością danych a obciążeniem sieci.

7. Na koniec w Konfiguracja → Typy dokumentów zaznacz checkboxami, które typy dokumentów chcesz przesyłać. Zawsze testuj na jednym typie (np. tylko FS) zanim rozszerzysz zakres.

Bezpieczeństwo połączeń — szyfrowanie i uwierzytelnianie w 2026 roku

Rok 2026 nie wybacza zaniedbań w bezpieczeństwie. Subiekt GT od wersji 1.80 (wydanej w grudniu 2025) wprowadził obowiązkowe szyfrowanie TLS dla wszystkich połączeń ftp. Oznacza to, że jeśli Twój serwer ftp nie obsługuje FTPS (FTP over TLS), Subiekt odmówi połączenia i wyświetli błąd "Nie można nawiązać bezpiecznego połączenia". Nie da się tego obejść przełącznikiem — to celowa decyzja producenta.

Konkretnie, parametry techniczne połączenia w Subiekcie GT na 2026 rok są następujące: wymagane minimum TLS 1.2, zalecane TLS 1.3. Certyfikat serwera musi być ważny i wystawiony przez zaufane CA — certyfikaty self-signed nie są akceptowane w konfiguracji domyślnej. Jeśli używasz własnego certyfikatu, musisz go ręcznie dodać do magazynu zaufanych certyfikatów Windows na komputerze z Subiektem.

Dla użytkowników, którzy potrzebują szyfrowania end-to-end na poziomie plików a nie tylko transportu, Subiekt GT obsługuje również SFTP (SSH File Transfer Protocol). Wymaga to pobrania i zarejestrowania biblioteki InsERT_SFTP.dll — oficjalnego komponentu udostępnianego przez InsERT po zgłoszeniu do działu wsparcia technicznego. Po zarejestrowaniu biblioteki w konfiguracji ftp pojawia się dodatkowy przełącznik "SFTP", który zmienia port i protokół połączenia.

Co z firewallem? Komunikacja ftp używa dwóch połączeń: sterującego (port 21) i danych (porty dynamiczne w trybie aktywnym lub port 20 i uzgodniony zakres w trybie pasywnym). Subiekt GT domyślnie używa trybu pasywnego, który jest bardziej przyjazny dla zapór sieciowych po stronie klienta. Jeśli serwer znajduje się za NATem, upewnij się, że jego konfiguracja ftp uwzględnia zewnętrzny adres IP i zakres portów pasywnych.

Najczęstsze błędy i ich natychmiastowe rozwiązania

Doświadczenie pokazuje, że 80% problemów z ftp w Subiekcie GT wynika z trzech przyczyn. Oto one wraz z rozwiązaniami, które działają natychmiast:

Błąd "Połączenie odrzucone — timeout": Najczęściej winny jest firewall po stronie serwera lub komputera z Subiektem. Sprawdź, czy port 21 (lub 990 dla FTPS, 22 dla SFTP) jest otwarty na zaporze Windows oraz na routerze. W firmach często zapomina się dodać wyjątku po zmianie polityki bezpieczeństwa. Drugim winowajcą jest antywirus z modułem skanowania ruchu sieciowego — np. niektóre wersje ESET i Bitdefender blokują ruch ftp, traktując go jako potencjalnie złośliwy. Dodaj program Subiekt GT i proces GT.exe do wyjątków antywirusa.

Błąd "Nieprawidłowe dane logowania": Pomimo poprawnego hasła, błąd ten pojawia się gdy serwer ftp używa innego kodowania znaków niż Subiekt. Sprawdź, czy w nazwie użytkownika lub haśle nie ma polskich znaków (ą, ę, ś, ć itp.). W 2026 roku wiele hostingów domyślnie przechodzi na UTF-8, ale starsze serwery ftp używają Windows-1250. Jeśli to możliwe, zmień hasło na takie bez znaków diakrytycznych.

Błąd "Brak dostępu do katalogu zdalnego": Ścieżka na serwerze ftp musi być zapisana z użyciem separatorów uniksowych (ukośnik /), nawet jeśli serwer działa na Windows. Sprawdź też uprawnienia — użytkownik ftp musi mieć prawo do zapisu (dla wysyłki), odczytu (dla odbioru) i listowania zawartości katalogu. Bez uprawnienia listowania Subiekt nie może zweryfikować, czy pliki zostały poprawnie przesłane, i zgłosi błąd.

Błąd certyfikatu: Aktualnym problemem w 2026 roku jest wygasanie certyfikatów TLS. Nawet duże firmy hostingowe potrafią przeoczyć datę ważności. Objaw: Subiekt łączy się, ale po kilku sekundach rozłącza z komunikatem "Nieprawidłowy certyfikat". Rozwiązanie: sprawdź datę ważności certyfikatu narzędziem openssl (openssl s_client -connect host:21 -starttls ftp) i skontaktuj się z administratorem serwera.

Błąd "Nieobsługiwany typ dokumentu": Jeśli w logu widzisz ten komunikat, sprawdź czy zaznaczyłeś odpowiedni typ w konfiguracji profilu ftp — wystarczy przeoczyć jedno pole wyboru.

Automatyzacja i łączenie ftp z harmonogramem

Samodzielne klikanie "Wyślij dokumenty" ma sens tylko przy testowaniu. W codziennej pracy automatyzujesz całość harmonogramem. Subiekt GT używa do tego wbudowanego harmonogramu, który działa niezależnie od Harmonogramu zadań Windows — to ważne, bo wiele osób szuka wpisów w taskschd.msc i ich nie znajduje.

Harmonogram Subiekta konfigurujesz w tym samym oknie profilu ftp, w zakładce Harmonogram. Po ustawieniu interwału i zaznaczeniu "Aktywny", program będzie automatycznie inicjował transfer o określonych porach. Jest jeden haczyk: Subiekt GT musi być uruchomiony. Harmonogram nie działa jako usługa systemowa, więc jeśli zamykasz program na noc, transfer nie nastąpi.

Rozwiązaniem dla firm działających całodobowo jest pozostawienie Subiekta w trybie zminimalizowanym z aktywną sesją użytkownika Windows. Alternatywnie można skonfigurować automatyczne logowanie Windows i autostart Subiekta — to rozwiązanie dla wydzielonych komputerów pełniących rolę serwerów wymiany danych.

Warto wspomnieć o opcji Wymiana przy starcie programu. Po jej zaznaczeniu, przy każdym uruchomieniu Subiekt GT automatycznie wykona jeden cykl wymiany. To zabezpieczenie na wypadek restartu serwera w nocy — dokumenty z poprzedniego dnia trafią do odbiorców natychmiast po ponownym uruchomieniu programu.

Logi i diagnostyka — jak czytać komunikaty wymiany

Każda operacja ftp w Subiekcie GT jest szczegółowo logowana. Aby zobaczyć logi, przejdź do Narzędzia → Wymiana danych → Podgląd logów. Plik logu znajduje się fizycznie w katalogu programu, standardowo C:\Program Files (x86)\InsERT\Subiekt GT\Logi\, a jego nazwa to ftp_wymiana_<data>.log.

Log składa się z wpisów o następującej strukturze: datownik, poziom (INFO, WARN, ERROR), nazwa profilu, identyfikator operacji i treść komunikatu. Przykładowo: 2026-03-15 08:15:22 | INFO | Oddział_Warszawa | UPLOAD_0042 | Rozpoczęto wysyłanie 3 dokumentów. Jeśli transfer się powiedzie, zobaczysz Transfer zakończony pomyślnie: 3/3 dokumentów. Jeśli nie — kod błędu i opis.

Kluczem do szybkiej diagnostyki jest odfiltrowanie wpisów ERROR. W logu znajdują się kody błędów zgodne ze standardem FTP (np. 550 — odmowa dostępu, 421 — serwer zamyka połączenie, 530 — błędne uwierzytelnienie). Znajomość tych kodów oszczędza godziny zgadywania.

W roku 2026 dodano również nowy poziom logowania: DEBUG. Aby go włączyć, należy dodać wpis DebugLevel=2 w pliku GT.ini w sekcji [Wymiana]. Tryb debug zapisuje surowe komendy FTP, co jest nieocenione przy diagnozowaniu problemów z routingiem i firewallem — pamiętaj jednak, by wyłączyć go po zakończeniu diagnostyki, bo logi rosną bardzo szybko.

Dezaktywacja, kasowanie konfiguracji i reset ftp

Czasem trzeba zacząć od nowa. Usunięcie profilu ftp jest proste — w oknie konfiguracji wybierasz profil z listy i klikasz Usuń. Jednak samo skasowanie profilu nie usuwa jego logów ani ewentualnych plików tymczasowych w folderze lokalnym. Jeśli chcesz kompletnie wyczyścić ślady wymiany, sprawdź trzy miejsca: listę profili (usuń), katalog logów (opróżnij pliki .log), oraz folder lokalny wymiany (usuń pliki .xml, .tmp i .lock).

Dezaktywacja profilu bez jego usuwania jest równie prosta — w zakładce Harmonogram odznaczasz pole "Aktywny". Profil pozostaje zapisany, ale nie jest wykonywany. Nadaje się to do sezonowego wyłączania wymiany, np. podczas urlopu czy inwentaryzacji.

Uwaga na pliki .lock. Są to blokady zapobiegające równoczesnemu dostępowi do plików w trakcie transferu. Jeśli Subiekt ulegnie awarii w trakcie wymiany, plik .lock może pozostać, blokując kolejne próby. Rozwiązanie: zamknij Subiekta, ręcznie usuń pliki .lock z folderu wymiany, uruchom program ponownie.

Częste pytania

Czy ftp w Subiekcie GT działa w wersji Start?

Nie. Moduł wymiany danych przez ftp dostępny jest wyłącznie w wersjach Pro i Enterprise. Subiekt GT Start obsługuje jedynie import i eksport plików XML z poziomu menu — bez automatyzacji i harmonogramów. Jeśli potrzebujesz ftp, musisz wykupić aktualizację wersji w ramach licencji producenta.

Jak sprawdzić, czy mój serwer ftp jest kompatybilny z Subiektem GT?

Najszybsza metoda: użyj dowolnego klienta ftp (np. WinSCP) i zaloguj się na te same dane, które planujesz wpisać w Subiekcie. Jeśli ręczny klient działa bez problemów, Subiekt też powinien. Sprawdź dodatkowo, czy serwer obsługuje tryb pasywny i szyfrowanie TLS — to dwa wymagania obligatoryjne dla Subiekta GT w 2026 roku.

Ile profili ftp mogę utworzyć w jednym Subiekcie GT?

Maksymalna liczba profili ftp w jednej instalacji Subiekta GT to 20. Każdy profil działa niezależnie — może łączyć się z innym serwerem, przesyłać inne typy dokumentów i działać według własnego harmonogramu. W praktyce rzadko przekracza się 5-6 profili, bo zarządzanie większą liczbą staje się nieczytelne.

Jak odzyskać dane, jeśli Subiekt GT nie może połączyć się z ftp od dłuższego czasu?

Dokumenty do wysłania są kolejkowane w bazie Subiekta i nie przepadają. Gdy połączenie zostanie przywrócone, wszystkie zaległe dokumenty zostaną wysłane w kolejności chronologicznej. Dokumenty oczekujące możesz sprawdzić w module wymiany — lista oczekujących pokazuje wszystkie niewysłane pozycje. Jedyne ryzyko to zmiana konfiguracji ftp w międzyczasie — stare dokumenty zakolejkowane pod nieaktualny profil nie zostaną automatycznie przeniesione do nowego.

Czy można przesyłać pliki PDF razem z xml?

Nie. Subiekt GT przesyła wyłącznie pliki danych w formacie XML (Insert GT lub ECOD). Jeśli potrzebujesz wysyłać wizualizacje faktur w PDF, musisz to zrobić osobnym kanałem — np. e-mailem przez moduł wysyłki dokumentów Subiekta lub zewnętrznym skryptem kopiującym PDF na serwer ftp po wygenerowaniu przez program.

Czy Subiekt GT obsługuje WebDAV lub API REST zamiast ftp?

Na rok 2026 — nie natywnie. Subiekt GT wspiera wyłącznie protokoły FTP, FTPS i SFTP (ten ostatni przez dodatkową bibliotekę). Jeśli Twój partner biznesowy udostępnia tylko WebDAV lub REST, potrzebujesz pośrednika — albo serwer ftp wystawiony przez partnera, albo zewnętrzne narzędzie konwertujące API na katalog ftp (np. poprzez skrypt PowerShell z mapowaniem dysku sieciowego).

Co zrobić, gdy okno konfiguracji ftp jest nieaktywne (szare)?

Przyczyną jest zazwyczaj otwarty inny formularz w Subiekcie — np. okno edycji dokumentu, faktury czy kartoteki towaru. Subiekt GT blokuje dostęp do konfiguracji wymiany, gdy trwa edycja danych. Zamknij wszystkie otwarte okna i spróbuj ponownie. Drugą możliwością jest brak uprawnień — sprawdź w Narzędzia → Uprawnienia użytkowników, czy Twój login ma zaznaczoną opcję "Zarządzanie wymianą danych".

Czy w przypadku Subiekta GT ftp istnieje limit wielkości plików?

Tak. Maksymalny rozmiar pojedynczego pliku XML przesyłanego przez ftp w Subiekcie GT to 50 MB. Ograniczenie to nie dotyczy samego protokołu ftp, a sposobu pakietowania danych przez Subiekta przed wysyłką. Przy bardzo dużych bazach (powyżej kilkudziesięciu tysięcy dokumentów) program automatycznie dzieli transfer na paczki po 500 dokumentów każda, co utrzymuje rozmiar pojedynczego pliku w bezpiecznych granicach.

Czy stara wersja Subiekta GT (sprzed 2023) nadal łączy się przez ftp?

Łączy się, ale bez szyfrowania i z coraz większym ryzykiem odmowy połączenia przez nowoczesne serwery. Większość hostingów w 2026 roku domyślnie wyłącza nieszyfrowane FTP i wymusza TLS. Jeśli używasz Subiekta GT w wersji sprzed 1.70, prawdopodobnie nie masz wsparcia dla TLS 1.2 i nie połączysz się z żadnym aktualnym serwerem. InsERT oficjalnie wspiera tylko dwie ostatnie wersje główne programu.

Jaka jest alternatywa, jeśli nie mogę skonfigurować ftp?

Najprostszym substytutem jest ręczny eksport XML z menu Narzędzia → Eksport danych i przesłanie pliku dowolnym klientem ftp. Jest to rozwiązanie tymczasowe, ręczne, ale w 100% skuteczne w przypadku problemów z modułem automatycznej wymiany. Długoterminowo warto rozważyć serwer ftp w modelu subskrypcyjnym z pełną kompatybilnością z Subiektem GT — dostępny w ofercie na kluczesoft.pl, gdzie znajdziesz gotowe konfiguracje sprawdzone z oprogramowaniem InsERT.