JPK i KSeF w Subiekcie nexo

Gdy JPK lub KSeF nie działa tak, jak powinien

Problem zwykle pojawia się podczas tworzenia pliku, sprawdzania dokumentów albo wysyłki danych. Subiekt nexo może wyświetlić komunikat o niepoprawnej strukturze, braku uprawnień, nieważnym certyfikacie, błędach danych lub problemie z połączeniem. Czasem plik zostaje utworzony, ale nie można go przekazać do właściwej usługi. Innym razem dokumenty sprzedaży są poprawne, lecz konfiguracja wysyłki nie odpowiada aktualnemu sposobowi uwierzytelniania.

Podobnie wygląda sytuacja, gdy e-faktura nie otrzymuje oczekiwanego statusu albo numer identyfikacyjny nie zapisuje się w programie. Nie oznacza to automatycznie uszkodzenia programu. Najpierw trzeba ustalić, na którym etapie występuje problem: w danych dokumentu, podczas tworzenia pliku, przy autoryzacji czy dopiero przy komunikacji z usługą zewnętrzną.

JPK, czyli pliki z danymi ewidencyjnymi

JPK, czyli Jednolity Plik Kontrolny, to ustandaryzowany plik zawierający określone dane księgowe lub ewidencyjne. Subiekt nexo może przygotowywać dane potrzebne do przekazania zgodnie z wybranym zakresem. Samo wygenerowanie pliku nie jest jednak równoznaczne z jego poprawnym wysłaniem. Najpierw należy sprawdzić okres, rodzaj dokumentów oraz kompletność informacji zapisanych w kartotekach.

Znaczenie mają między innymi dane firmy, numery identyfikacyjne, daty, wartości sprzedaży, stawki podatkowe i oznaczenia dokumentów. Błąd jednej pozycji może spowodować odrzucenie całego pliku. Z tego powodu nie powinno się poprawiać losowych pól bez ustalenia, jaki element został wskazany w komunikacie.

W praktyce analizuje się treść błędu, zakres pliku oraz dokumenty, które mogły wpłynąć na jego zawartość. Jeżeli problem dotyczy pojedynczej faktury, korekta może wymagać sprawdzenia kontrahenta, towaru, stawki lub rodzaju dokumentu. Jeżeli błąd występuje przy każdym okresie, bardziej prawdopodobna jest nieprawidłowa konfiguracja ogólna.

KSeF i przygotowanie do e-faktur

KSeF, czyli Krajowy System e-Faktur, służy do obsługi faktur ustrukturyzowanych przekazywanych do centralnego systemu. W Subiekcie nexo przygotowanie do pracy z e-fakturami obejmuje uporządkowanie danych firmy, kontrahentów, towarów oraz ustawień związanych z wysyłką. Ważne jest także ustalenie, kto może wykonywać operacje w imieniu firmy i na jakiej podstawie odbywa się autoryzacja.

Faktura elektroniczna nie jest tylko dokumentem zapisanym jako PDF. Dokument ustrukturyzowany ma określoną strukturę danych, dzięki której system może odczytać między innymi sprzedawcę, nabywcę, pozycje, wartości i podsumowania. Błąd w danych może więc ujawnić się dopiero podczas walidacji, czyli automatycznego sprawdzania zgodności dokumentu z wymaganym formatem.

Przygotowanie warto rozpocząć od przeglądu danych podstawowych i sposobu wystawiania dokumentów. Należy również sprawdzić, czy osoby obsługujące sprzedaż mają właściwe uprawnienia oraz czy w programie zapisano aktualne dane autoryzujące. Nie zastępuje to analizy obowiązków podatkowych. Konfiguracja techniczna i interpretacja przepisów to odrębne kwestie.

Najczęstsze przyczyny odrzucenia dokumentu

Najczęściej problem wynika z niekompletnych albo niespójnych danych. W kartotece kontrahenta może brakować wymaganego identyfikatora, adres może mieć nieprawidłowy format, a dokument może zawierać pozycję bez oczekiwanej jednostki miary. Czasem przyczyną jest ręczna zmiana danych po zapisaniu dokumentu lub użycie starej kartoteki utworzonej według innych zasad.

Drugą grupę stanowią błędy konfiguracji. Należą do niej niepoprawne ustawienia wysyłki, niewłaściwie wybrane środowisko, brak uprawnień użytkownika albo zapisane dane autoryzujące, które nie pasują do wybranej firmy. Środowisko testowe i produkcyjne to dwa różne miejsca pracy systemu. Dokument przygotowany w jednym z nich nie powinien być traktowany tak samo jak dokument wysłany w drugim.

Trzecia możliwość to problem z certyfikatem lub jego obsługą. Certyfikat cyfrowy, czyli elektroniczne potwierdzenie tożsamości używane podczas autoryzacji, może być nieważny, niedostępny dla bieżącego użytkownika albo zapisany w niewłaściwym magazynie systemowym. Nie każdy komunikat o autoryzacji oznacza jednak awarię certyfikatu. Czasem przyczyną jest brak odpowiedniego uprawnienia albo niezgodność danych firmy.

Osobno należy rozpatrywać błędy połączenia. Zapora sieciowa, czyli mechanizm kontrolujący ruch między komputerem a internetem, może blokować komunikację. Podobnie może działać program ochronny, filtr sieciowy albo czasowa niedostępność usługi zewnętrznej. W takim przypadku poprawianie faktury nie rozwiąże problemu.

Jak przygotowuje się plik do wysyłki

Praca zaczyna się od ustalenia, jaki plik ma zostać przygotowany i za jaki okres. Następnie sprawdza się dane firmy, zakres dokumentów oraz ustawienia odpowiedzialne za wygenerowanie pliku. Walidacja, czyli sprawdzenie danych według określonych reguł, pomaga znaleźć błędy przed wysyłką, ale nie zawsze wskazuje ich przyczynę w sposób zrozumiały dla użytkownika.

Jeżeli program wskazuje konkretny dokument, analizuje się go razem z powiązanymi kartotekami. W przypadku faktury sprzedaży mogą mieć znaczenie dane nabywcy, pozycje towarowe, rabaty, stawki i sposób płatności. W przypadku korekty ważne są także informacje o dokumencie pierwotnym. Usunięcie komunikatu bez poprawienia danych źródłowych zwykle prowadzi do ponownego odrzucenia pliku.

Po poprawie danych plik generuje się ponownie. Nie należy korzystać z wcześniej zapisanej wersji, jeżeli powstała przed korektą. Warto zachować komunikat błędu oraz informację, którego dokumentu dotyczył problem. Ułatwia to porównanie kolejnych prób i ogranicza ryzyko wielokrotnego poprawiania tego samego elementu.

Błędy wysyłki i komunikaty autoryzacyjne

Komunikat o braku możliwości wysłania pliku może oznaczać kilka różnych sytuacji. Jeżeli program nie pozwala rozpocząć wysyłki, należy sprawdzić ustawienia konta, dane autoryzujące i dostęp użytkownika. Jeżeli wysyłka rozpoczyna się, ale kończy błędem połączenia, trzeba zbadać komunikację sieciową oraz dostępność usługi.

Autoryzacja, czyli potwierdzenie, że dana osoba lub program ma prawo wykonać operację, może opierać się na certyfikacie, tokenie albo innym mechanizmie przekazanym przez usługę. Token to zapisany identyfikator uprawnień, który pozwala aplikacji potwierdzić dostęp bez wpisywania wszystkich danych przy każdej operacji. Nie należy kopiować takich danych do przypadkowych plików ani przekazywać ich osobom bez potrzeby.

Ważne jest odróżnienie błędu od statusu oczekiwania. Dokument może zostać przyjęty do przetwarzania, ale jego wynik nie musi być widoczny natychmiast. Ponowne wysyłanie tego samego dokumentu bez sprawdzenia statusu może doprowadzić do powielenia operacji albo utrudnić późniejsze ustalenie, która próba była skuteczna.

Certyfikaty i dane autoryzujące

Przy problemach z certyfikatem sprawdza się jego ważność, obecność na komputerze oraz dostępność dla konta użytkownika, z którego uruchamiany jest Subiekt nexo. Certyfikat może być zapisany w systemowym magazynie certyfikatów, czyli chronionym miejscu przeznaczonym do przechowywania elektronicznych poświadczeń. Sam fakt, że certyfikat jest widoczny dla administratora, nie oznacza jeszcze, że będzie dostępny dla innego użytkownika.

Analizuje się także certyfikat przypisany do konkretnej firmy i zakres jego uprawnień. Wymiana dokumentu lub zmiana osoby obsługującej wysyłkę może wymagać ponownego skonfigurowania dostępu. Jeżeli dane autoryzujące były zmieniane, nie powinno się mieszać starych i nowych wartości w jednej konfiguracji.

Dane dostępowe traktuje się jako poufne. Domyślnie nie jest potrzebne przekazywanie hasła klienta. Jeżeli do diagnozy wymagane są informacje z programu, można przygotować opis błędu, zrzut komunikatu bez danych wrażliwych albo konto techniczne o ograniczonych uprawnieniach. Przy pracy z bazą najpierw wykonywana jest kopia zapasowa.

Bezpieczny przebieg diagnozy Subiekta nexo

Diagnoza rozpoczyna się od odtworzenia problemu i zapisania dokładnego komunikatu. Następnie sprawdza się, czy błąd dotyczy jednego dokumentu, wybranego użytkownika, konkretnego komputera czy całego środowiska. Takie rozróżnienie pozwala oddzielić problem danych od problemu konfiguracji.

Przed ingerencją w bazę danych wykonywana jest kopia zapasowa. Baza danych, czyli uporządkowany magazyn informacji programu, zawiera dokumenty, kartoteki i ustawienia. Bez kopii nie powinno się wykonywać naprawczych zmian bezpośrednio w jej strukturze. Korekta danych w bazie wymaga ostrożności, ponieważ pozornie niewielka zmiana może wpłynąć na dokumenty lub zależności między nimi.

W dalszej kolejności sprawdza się konfigurację Subiekta nexo, dostęp użytkownika, certyfikat, ustawienia sieciowe oraz wynik walidacji. Jeżeli problem jest związany z integracją, analizuje się również sposób wymiany danych z usługą zewnętrzną. Integracja to połączenie dwóch systemów, które pozwala przekazywać między nimi informacje bez ręcznego przepisywania.

W razie potrzeby można także sprawdzić integrację ze sklepem internetowym lub marketplace przez BaseLinkera. Taka konfiguracja może wpływać na dane dokumentów sprzedaży, ale nie każdy problem z wysyłką JPK lub KSeF pochodzi z BaseLinkera. Najpierw ustala się, gdzie informacja została utworzona i na którym etapie została zmieniona.

Co można sprawdzić samodzielnie

Bezpieczne są podstawowe czynności porządkowe. Można zapisać dokładny komunikat, zanotować godzinę wystąpienia problemu, sprawdzić, czy dotyczy jednego dokumentu, oraz zweryfikować, czy komputer ma dostęp do internetu. Warto też ustalić, czy problem występuje wszystkim użytkownikom, czy tylko na jednym stanowisku.

Można sprawdzić, czy data i godzina systemowa są prawidłowe, ponieważ niektóre mechanizmy autoryzacji wykorzystują czas do oceny ważności poświadczeń. Należy również upewnić się, że używane konto jest właściwe i że certyfikat nie utracił ważności. Przydatne jest zachowanie kopii komunikatu, ale bez publikowania haseł, tokenów i prywatnych kluczy.

Nie należy usuwać certyfikatu w ciemno, kasować bazy danych, zmieniać dokumentów źródłowych bez kopii ani wielokrotnie wysyłać tego samego pliku. Nie powinno się także instalować przypadkowych narzędzi znalezionych w internecie ani przekazywać pełnych danych autoryzujących osobom, które nie uczestniczą w obsłudze systemu.

Czy każdy błąd KSeF dotyczy Subiekta nexo?

Nie. Problem może występować po stronie usługi zewnętrznej, połączenia internetowego, certyfikatu albo uprawnień. Jeżeli ten sam dokument nie przechodzi na kilku komputerach, a inne funkcje programu działają poprawnie, trzeba porównać komunikat ze stanem usługi i konfiguracją firmy.

Czy problem z dokumentem oznacza błąd danych kontrahenta?

Nie zawsze. Przyczyną może być także sposób wystawienia korekty, brak powiązania z dokumentem pierwotnym, ustawienie stawki lub niezgodność konfiguracji wysyłki. Sama kartoteka kontrahenta powinna być sprawdzana razem z dokumentem i jego pozycjami, a nie jako jedyny możliwy powód odrzucenia.

Czy certyfikat wystarczy do poprawnej wysyłki?

Nie. Certyfikat potwierdza tożsamość lub uprawnienie w określonym mechanizmie, ale potrzebne są także właściwe ustawienia programu, dostęp użytkownika, poprawne dane firmy i działająca komunikacja z usługą. Certyfikat może być ważny, a mimo to niedostępny dla konta używanego do uruchomienia Subiekta nexo.

Podsumowanie przygotowania do JPK i KSeF

Problemy z JPK i KSeF w Subiekcie nexo wymagają rozdzielenia kilku obszarów: danych dokumentów, generowania pliku, walidacji, autoryzacji i połączenia. Najpierw ustala się dokładny etap błędu, następnie sprawdza najczęstsze przyczyny i dopiero później wykonuje zmiany.

Bezpieczna obsługa obejmuje kopię bazy przed ingerencją, ochronę danych autoryzujących oraz unikanie wielokrotnych prób wysyłki bez sprawdzenia statusu. W razie potrzeby możliwa jest konfiguracja i diagnoza przez dojazd serwisanta, z bezpłatnym dojazdem, przy czym praca serwisanta jest zawsze płatna. W trybie door-to-door diagnoza laptopa jest bezpłatna. Większość usterek usuwana jest podczas pierwszej wizyty, a naprawa z reguły trwa do 3 dni.

Warszawskie Pogotowie Komputerowe 24/7 działa przez całą dobę, także w weekendy i święta. Kierowca lub serwisant może dojechać do 1 godziny od zgłoszenia telefonicznego, bez dopłat za porę nocną, weekend ani święto. W przypadku prac dotyczących Subiekta nexo najważniejsze pozostają poprawne dane, zabezpieczenie bazy i dokładne ustalenie przyczyny komunikatu.