Załącznik produktowy — TaskLine KSeF Gateway
Wersja: 1.0 Status: FINAL Obowiązuje od: 2026-10-07
1. Przedmiot załącznika
Załącznik określa szczególne prawa, obowiązki i zasady korzystania z TaskLine KSeF Gateway. Uzupełnia główny Regulamin TaskLine oraz model LOCAL_DESKTOP.
2. Charakter Produktu
TaskLine KSeF Gateway jest lokalną aplikacją Windows służącą do technicznej komunikacji z Krajowym Systemem e-Faktur, obsługi statusów i UPO, lokalnego obiegu dokumentów oraz integracji z obsługiwanymi systemami ERP.
Produkt nie jest programem księgowym ani usługą doradztwa podatkowego. TaskLine nie przejmuje obowiązków podatnika, wystawcy, odbiorcy faktury ani osoby uprawnionej do działania w KSeF.
3. Architektura LOCAL_DESKTOP
Aplikacja i jej dane operacyjne działają na urządzeniu Klienta.
Standardowa architektura obejmuje:
- natywną aplikację Windows,
- lokalny runtime i backend,
- lokalną komunikację po localhost,
- prywatny katalog danych Klienta,
- bezpośrednią komunikację z KSeF/MF,
- lokalne moduły integracyjne ERP,
- połączenie z TaskLine Center wyłącznie w zakresie control-plane.
TaskLine Center nie jest pośrednikiem treści faktur wysyłanych do KSeF.
4. Wymagania techniczne
Wspierane wydanie wymaga środowiska określonego w dokumentacji wersji. Dla obecnej linii desktopowej wymagane jest w szczególności:
- wspierany system Windows x64,
- uprawnienia administracyjne do instalacji,
- działający mechanizm WebView wymagany przez aplikację desktopową,
- możliwość uruchomienia lokalnego runtime TaskLine,
- możliwość komunikacji z localhost,
- połączenie z Internetem dla KSeF, licencjonowania, aktualizacji i funkcji wymagających Center,
- wystarczająca ilość miejsca na dokumenty, logi i lokalne kopie,
- legalnie używane i wspierane komponenty ERP wymagane przez wybraną integrację.
Instalator dostarcza własne komponenty TaskLine zgodnie z dokumentacją wydania; Klient nie powinien instalować narzędzi developerskich do zwykłego używania Produktu.
5. Instalacja i dane po odinstalowaniu
Program jest instalowany w katalogu programu, a dane Klienta są przechowywane oddzielnie w prywatnym katalogu danych.
Standardowe odinstalowanie usuwa pliki programu i mechanizmy runtime, ale nie usuwa automatycznie dokumentów, UPO, konfiguracji, certyfikatów, tokenów ani innych danych Klienta. Usunięcie danych musi być osobną, świadomą operacją.
Ma to zapobiec przypadkowej utracie danych przy aktualizacji lub reinstalacji.
6. Środowiska KSeF
Produkt może obsługiwać oddzielne środowiska testowe, demo/przedprodukcyjne i produkcyjne KSeF.
Operacje w środowisku produkcyjnym wymagają świadomej konfiguracji. Klient odpowiada za to, aby testowe dokumenty nie były wysyłane do środowiska produkcyjnego.
TaskLine może stosować dodatkowe techniczne blokady bezpieczeństwa przed niezamierzonym użyciem produkcji.
7. Uwierzytelnienie i uprawnienia KSeF
Klient odpowiada za:
- uzyskanie prawidłowych uprawnień do działania w KSeF,
- wybór i legalne użycie wspieranej metody uwierzytelnienia,
- prawidłowe przypisanie osób i podmiotów do firm/NIP-ów,
- unieważnienie lub wycofanie credentiali, które zostały utracone albo ujawnione,
- zgodność organizacyjnego użycia certyfikatów i innych metod uwierzytelnienia z zasadami KSeF.
TaskLine odpowiada za bezpieczną implementację obsługiwanych metod uwierzytelnienia i ochronę credentiali w lokalnym Produkcie w zakresie własnego kodu.
8. Ochrona certyfikatów, tokenów i kluczy
Certyfikaty KSeF, tokeny, klucze prywatne i hasła należy traktować jako sekrety o wysokiej wrażliwości.
Klient nie może udostępniać ich osobom nieuprawnionym i powinien chronić konto systemowe oraz urządzenie, na którym są przechowywane.
TaskLine nie przesyła ich standardowo do Center.
Jeżeli Product posiada lokalny sejf lub backup konfiguracji, TaskLine odpowiada za poprawność zastosowanego mechanizmu szyfrowania. Klient odpowiada za ochronę hasła lub materiału potrzebnego do odtworzenia kopii.
9. Dokumenty, XML i UPO
Dokumenty, XML, UPO, numery KSeF, konfiguracja firm i dane dostępowe są standardowo przechowywane lokalnie.
Dane są przekazywane poza urządzenie wyłącznie wtedy, gdy jest to wymagane przez:
- komunikację bezpośrednio z KSeF/MF,
- świadomie skonfigurowaną integrację ERP,
- funkcję Supportu lub diagnostyki uruchomioną przez Użytkownika i opisaną jako wysyłająca dane.
Standardowy heartbeat i licencjonowanie Center nie obejmują treści faktur.
10. Znaczenie statusów
Produkt prezentuje statusy techniczne otrzymane lub wyprowadzone z oficjalnego procesu KSeF.
Numer KSeF, UPO, komunikat błędu albo status sesji są prezentowane zgodnie z wynikiem uzyskanym z KSeF i nie stanowią samodzielnej opinii TaskLine co do prawidłowości podatkowej dokumentu.
Klient powinien reagować na odrzucenia, błędy walidacji i komunikaty KSeF oraz nie traktować samego utworzenia pliku lokalnego jako dowodu skutecznego przesłania faktury.
11. Poprawność faktury
Klient odpowiada za merytoryczną i podatkową poprawność danych źródłowych, w szczególności stron transakcji, stawek, kwot, pozycji, oznaczeń oraz rodzaju dokumentu.
TaskLine odpowiada za poprawność własnego parsera, mapowania, walidatora i transportu w zakresie, w którym Produkt sam przekształca lub obsługuje dane.
Jeżeli Produkt otrzymuje gotowy, poprawny dokument FA(3), powinien zachować go bez nieuzasadnionej przebudowy.
12. Walidacja techniczna
TaskLine może lokalnie walidować dokument względem wspieranej oficjalnej struktury logicznej.
Pozytywna walidacja techniczna nie zastępuje kontroli księgowej ani podatkowej.
Zmiana struktury logicznej, XSD albo API po stronie KSeF może wymagać aktualizacji Produktu przed dalszą wysyłką.
13. Komunikacja z KSeF/MF
TaskLine odpowiada za implementację własnego klienta KSeF zgodnie ze wspieranym, oficjalnym API.
KSeF/MF jest systemem zewnętrznym. TaskLine nie kontroluje jego dostępności, limitów, terminów odpowiedzi, zmian regulacyjnych ani przerw technicznych.
TaskLine odpowiada jednak za prawidłowe wykrywanie i obsługę błędów po stronie własnego kodu oraz za aktualizację integracji, jeżeli oficjalny kontrakt KSeF ulega zmianie i Produkt pozostaje wspierany.
14. Tryby szczególne i awaryjne
Jeżeli dana wersja Produktu obsługuje szczególne tryby KSeF, takie jak tryby offline, niedostępność systemu lub tryb awaryjny, Użytkownik musi stosować reguły i terminy wynikające z aktualnych przepisów i dokumentacji KSeF.
Samo posiadanie certyfikatu albo funkcji technicznej nie oznacza, że każda faktura może zostać wystawiona w takim trybie.
TaskLine nie powinien oznaczać funkcji jako dostępnej produkcyjnie, dopóki nie została technicznie wdrożona i zweryfikowana.
15. ERP i moduły integracyjne
TaskLine KSeF pozostaje neutralną bramką pomiędzy KSeF a systemami ERP.
Integracja może korzystać wyłącznie z:
- wspieranego eksportu/importu,
- oficjalnego API, SDK, Sfery, COM, WebAPI lub pluginu,
- albo innego udokumentowanego mechanizmu producenta.
TaskLine nie powinien wykonywać nieudokumentowanych bezpośrednich zapisów do baz ERP, jeżeli producent zapewnia wspierany mechanizm wymiany.
Nazwa producenta ERP w interfejsie oznacza zgodność techniczną w określonym zakresie i nie oznacza afiliacji, certyfikacji ani rekomendacji producenta, chyba że istnieje odrębne potwierdzenie.
16. Zakres gotowości connectora
Poszczególne connectory mogą mieć różny poziom automatyzacji.
Produkt powinien rozróżniać co najmniej:
- integrację automatyczną,
- integrację dwukierunkową,
- integrację wspomaganą,
- integrację jednokierunkową,
- funkcję planowaną lub niewspieraną.
Klient nie powinien zakładać pełnej automatyzacji tylko dlatego, że nazwa ERP znajduje się na liście obsługiwanych systemów.
Zakres konkretnego connectora wynika z aktualnej dokumentacji wydania.
17. Licencje i komponenty producentów ERP
Jeżeli określona funkcja wymaga odpłatnego modułu producenta ERP, SDK, Sfery, WebAPI, licencji serwerowej lub innego uprawnienia, ich legalne posiadanie i konfiguracja należą do Klienta, chyba że oferta TaskLine wyraźnie obejmuje taki komponent.
TaskLine nie redystrybuuje bibliotek producenta, których licencja nie zezwala na redystrybucję.
18. Multi-NIP i izolacja firm
Jeżeli licencja i wersja Produktu obsługują wiele firm/NIP-ów, każda firma posiada odrębny profil, credential i konfigurację integracji.
TaskLine odpowiada za izolację danych i sekretów pomiędzy profilami w ramach własnego kodu.
Klient odpowiada za prawidłowe przypisanie osoby, uprawnienia i credentialu do właściwej firmy.
19. Backup lokalny
Klient odpowiada za strategię backupu lokalnych dokumentów i katalogu danych, chyba że odrębna oferta przyjmuje inny zakres odpowiedzialności.
Wbudowany backup konfiguracji nie musi obejmować wszystkich dokumentów.
Jeżeli backup konfiguracji zawiera certyfikat, klucz prywatny, hasło klucza albo token KSeF, musi być przechowywany jako zaszyfrowany i chroniony przed nieuprawnionym dostępem.
Klient powinien okresowo sprawdzać możliwość odtworzenia danych i przechowywać co najmniej jedną kopię poza urządzeniem głównym, jeżeli wymagają tego jego potrzeby ciągłości działania.
20. Aktualizacje
Klient powinien instalować aktualizacje wymagane dla:
- zmiany API KSeF,
- nowej struktury logicznej,
- poprawki bezpieczeństwa,
- zgodności z connectorami ERP,
- działania licencji i komunikacji z Center.
TaskLine może zablokować niebezpieczną lub niekompatybilną funkcję w starej wersji, jeżeli jej dalsze używanie grozi błędnym wysłaniem dokumentu, utratą danych albo naruszeniem bezpieczeństwa.
21. TaskLine Center
Center może otrzymywać:
- identyfikator Produktu i Instancji,
- wersję i build,
- status licencji,
- stan techniczny,
- heartbeat,
- kody i fingerprinty błędów,
- status aktualizacji,
- dowody akceptacji dokumentów prawnych,
- treść Supportu świadomie wysłaną przez Użytkownika.
Center nie powinien otrzymywać automatycznie:
- XML faktur,
- PDF lub wizualizacji dokumentów,
- UPO,
- treści faktur,
- certyfikatów KSeF,
- kluczy prywatnych,
- tokenów KSeF,
- haseł,
- sekretów ERP.
22. Support
Zgłoszenie KSeF może zawierać dane kontaktowe, wersję, identyfikator Instancji, kod błędu i bezpieczny kontekst techniczny.
Nie należy przesyłać przez zwykły formularz:
- pełnego XML faktury,
- certyfikatu lub klucza prywatnego,
- tokenu KSeF,
- hasła,
- pełnej bazy danych,
- danych kontrahentów niewymaganych do diagnozy.
Jeżeli rozwiązanie konkretnego błędu wymaga wglądu w dokument, strony powinny uzgodnić bezpieczny, ograniczony i czasowy sposób przekazania materiału.
23. Obowiązki Klienta
Klient jest zobowiązany w szczególności do:
- utrzymywania prawidłowych danych firm i NIP-ów,
- zapewnienia ważnych uprawnień i credentiali KSeF,
- ochrony urządzenia i kont systemowych,
- kontroli osób mających dostęp do Produktu,
- weryfikacji poprawności merytorycznej dokumentów,
- kontroli statusów i błędów wysyłki,
- utrzymywania własnego ERP i wymaganych licencji producenta,
- instalowania krytycznych aktualizacji,
- wykonywania backupu przypisanego Klientowi,
- niezwłocznego reagowania na utratę lub podejrzenie przejęcia credentialu,
- przestrzegania obowiązujących terminów podatkowych i zasad KSeF.
24. Obowiązki TaskLine
TaskLine jest zobowiązany w szczególności do:
- utrzymywania własnego kodu zgodnie z deklarowanym zakresem Produktu,
- zabezpieczenia lokalnego vaultu i mechanizmu backupu konfiguracji,
- ograniczenia automatycznej telemetrii do dozwolonego zakresu,
- stosowania udokumentowanych connectorów ERP,
- nieprzechowywania treści faktur w Center w standardowym modelu,
- wydawania aktualizacji bezpieczeństwa dla wspieranej wersji,
- reagowania na potwierdzone błędy własnego transportu KSeF,
- utrzymywania wersjonowanych dokumentów Legal i dowodów akceptacji.
25. Prawa Klienta
Klient ma prawo:
- korzystać z Produktu zgodnie z aktywną licencją,
- znać aktualny zakres obsługiwanego connectora ERP,
- otrzymać informację, gdy funkcja jest wspomagana albo niepełna zamiast pełnej automatyzacji,
- uzyskać dostęp do statusu licencji i aktualnego pakietu Legal,
- zgłaszać błędy i reklamacje,
- zachować lokalne dane przy standardowej reinstalacji lub odinstalowaniu, o ile sam nie zleci ich usunięcia,
- korzystać z własnych danych niezależnie od Center w zakresie funkcji lokalnych, które nie wymagają aktywnej komunikacji z Center.
26. Prawa TaskLine
TaskLine może:
- aktualizować connector w związku ze zmianą oficjalnego API lub ERP,
- wyłączyć integrację, która stała się niebezpieczna lub niekompatybilna,
- odmówić implementacji nieudokumentowanego zapisu do bazy producenta,
- wymagać aktualizacji Produktu przed ponowną wysyłką do KSeF,
- wstrzymać aktywację, gdy brak wymaganej licencji lub aktualnej akceptacji dokumentów,
- odmówić przetwarzania w Support materiału zawierającego sekrety przekazane w sposób niebezpieczny.
27. Odpowiedzialność za awarie zewnętrzne
TaskLine nie odpowiada za sam fakt niedostępności KSeF/MF, Internetu, systemu ERP albo infrastruktury Klienta pozostającej poza kontrolą TaskLine.
Nie wyłącza to odpowiedzialności za błąd własnego kodu, który nieprawidłowo obsłużył prawidłowo działający system zewnętrzny albo błędnie zinterpretował jego odpowiedź.
28. Brak doradztwa podatkowego i księgowego
Produkt automatyzuje proces techniczny.
TaskLine nie rozstrzyga, czy dana czynność gospodarcza powinna zostać udokumentowana w określony sposób, jaka stawka lub procedura podatkowa jest właściwa ani czy Klient prawidłowo wykonał wszystkie obowiązki podatkowe.
29. Dane osobowe
Standardowy model LOCAL_DESKTOP nie powoduje powierzenia TaskLine pełnej treści faktur tylko dlatego, że Klient używa Produktu.
TaskLine jest administratorem danych przetwarzanych dla własnych celów związanych z licencjonowaniem, bezpieczeństwem, rozliczalnością i Supportem w zakresie opisanym w Polityce prywatności.
TaskLine działa jako procesor wyłącznie w takim zakresie, w jakim faktycznie przetwarza dane w imieniu Klienta na podstawie uzgodnionego procesu i DPA.
30. Zmiana modelu
Wprowadzenie hostowanego archiwum faktur, centralnego pośrednictwa XML, zdalnego connectora ERP albo przechowywania credentiali KSeF w infrastrukturze TaskLine wymaga odrębnej oceny bezpieczeństwa, przepływu danych i ról prawnych przed uruchomieniem.
31. Pierwszeństwo
W sprawach specyficznych dla TaskLine KSeF Gateway niniejszy Załącznik ma pierwszeństwo przed ogólnym Regulaminem.
DPA ma pierwszeństwo w zakresie faktycznego powierzenia danych osobowych, a indywidualnie uzgodniona umowa ma pierwszeństwo w zakresie, w którym jej postanowienia zostały uzgodnione odrębnie.