Integracja Comarch Mobile z KSeF

Artykuł opisuje najnowsze zmiany w aplikacji Comarch Mobile związane z korzystaniem z Krajowego Systemu e-Faktur (KSeF), który daje możliwość wystawiania faktur ustrukturyzowanych, jako jednej z dopuszczalnych form dokumentowania transakcji obok faktur papierowych i obecnie występujących w obrocie gospodarczym faktur elektronicznych.

Faktury ustrukturyzowane to faktury wystawiane przez podatników za pośrednictwem systemu teleinformatycznego (KSeF) oznaczone przydzielonym numerem identyfikującym fakturę w tym systemie.

Po aktywacji obsługi KSeF w Comarch Mobile możliwa jest praca w dwóch trybach:

  • Tryb Online – faktury są wystawiane i wysyłane do systemu KSeF w czasie rzeczywistym bezpośrednio z poziomu aplikacji Comarch Mobile. Proces ten odbywa się z wykorzystaniem uwierzytelnienia za pomocą tokena. Dokumenty zawierają kod QR, a synchronizacja UPO między aplikacją a systemem ERP gwarantuje spójność danych.
  • Tryb Offline – umożliwia wystawianie faktur w Comarch Mobile w sytuacjach braku stałego połączenia z KSeF lub niedostępnością/awarią KSeF. Proces ten odbywa się za pomocą certyfikatu typu 2. Faktury są generowane z dodatkowym kodem potwierdzającym tożsamość wystawcy oraz linkiem weryfikacyjnym. Po synchronizacji dokumentu do systemu ERP konieczne jest zlecenie jego wysyłki w późniejszym terminie, zgodnie z obowiązującymi przepisami prawa.

W momencie wystawiania faktury na kontrahenta innego niż krajowy zostanie dla niego zablokowana możliwość zatwierdzenia i wysłania faktury do KSeF.

Konfiguracja systemu ERP Altum na potrzeby obsługi Krajowego Systemu Obsługi e-Faktur została opisana TUTAJ.

Poniższe nagranie prezentuje funkcje aplikacji Comarch Mobile umożliwiające wystawianie i automatyczną wysyłkę faktur do systemu KSeF. Materiał przedstawia m.in. ustawienia aplikacji, możliwość weryfikacji poprawności faktur przed wysyłką, zmiany na wydruku faktury, proces automatycznej synchronizacji dokumentów. Opis dotyczący konfiguracji systemu ERP w celu wysyłania faktur z Comarch Mobile do KSeF został opisany poniżej.

Wskazówka
Jeżeli w Comarch Mobile włączona jest obsługa KSeF, zaleca się korzystanie z opcji automatycznej synchronizacji dokumentów. W tym celu należy włączyć funkcjonalność synchronizacji dokumentów w momencie zatwierdzania dokumentu, która została opisana TUTAJ. Taka konfiguracja pozwala zapobiec sytuacji, w której dokument zostanie wysłany do KSeF, ale nie zostanie zsynchronizowany z systemem ERP, a następnie zajdzie konieczność wygenerowania nowej bazy mobilnej. W efekcie mogłaby powstać rozbieżność w dokumentach pomiędzy KSeF a systemem ERP.
W przypadku, gdy użytkownik nie korzysta z KSeF w Comarch Mobile, automatyczna synchronizacja daje pewność, że dokument został terminowo zarejestrowany w systemie ERP i że możliwe jest jego przekazanie do KSeF zgodnie z obowiązującymi terminami. Brak wysłania faktury do KSeF w wymaganym czasie może w przyszłości skutkować konsekwencjami finansowymi.

 

Warunki konieczne w celu wysłania Faktury z Comarch Mobile do KSeF

Na potrzeby integracji i obsługi wysyłki faktur z Comarch Mobile do KSeF należy:

1. Na formularzu firmy w zakładce Konfiguracja\Struktura Firmy\Firma zaznaczyć parametr Obsługa KSeF. Parametr ten prezentowany jest na formularzu wyłącznie, jeżeli Grupa stawek VAT ma ustawioną wartość PL. Po zaznaczeniu parametru prezentowane pole umożliwiające wskazanie daty rozpoczęcia obsługi KSeF (domyślnie ustawiania jest data bieżąca).

2. Na formularzu firmy w zakładce Dokumenty w definicji dokumentu Faktura Sprzedaży w zakładce Ogólne zaznaczyć parametr Automatycznie prześlij do KSeF.

3. Na formularzu grupy operatorów Konfiguracja/Grupy operatorów w zakładce Inne uprawnienia zaznaczyć parametr Wysyłanie faktur do KSeF.

4. Na karcie kontrahenta zaznaczyć parametr Odbiór faktur przez KSeF.

5. W pliku konfiguracyjnym [configuration.altum20240.statement] w folderze [Methods] włączyć parametr [SendToKSeF] (Lokalizacja pliku C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration). Domyślna wartość parametru to „0”, która blokuje możliwość wysyłania dokumentów. Zmiana parametru na „1” odnosić będzie się do wszystkich operatorów mobilnych i umożliwi wysyłanie faktur do KSeF. Więcej informacji nt. tego parametru znajduje się TUTAJ.

6. Funkcjonalność przesyłania dokumentu faktury do KSEF wymaga dostępu do Internetu i poprawnego połączenia z Serwerem synchronizacji.

Uwaga
W Comarch Mobile wysyłka dokumentów do KSEF odbywa się automatycznie w trakcie zatwierdzenia. Każda taka faktura będzie wówczas sprawdzana pod względem zgodności ze schematem e-faktury tzw. poprawności semantycznej.
Uwaga
Jeżeli parametr SendToKSeF w pliku konfiguracyjnym będzie wyłączony, a pozostałe parametry w ERP Altum będą zaznaczone, wówczas dokument nie będzie wysyłany z Comarch Mobile do KSeF.
Uwaga
Jeżeli parametr Wysyłanie faktur do KSeF na grupie operatorów będzie włączony, ale nie będą włączone pozostałe parametry, to faktura z Comarch Mobile nie będzie mogła być zatwierdzona z powodu niepoprawnej konfiguracji parametrów odpowiadający za wysyłanie do KSeF.

Zmiany funkcjonalne w aplikacji Comarch Mobile dotyczące obsługi KSeF

Praca w trybie online – uwierzytelnienie tokenem KSeF

Tryb Online to podstawowy mechanizm operacyjny zapewniający pełną, dwukierunkową integrację z Krajowym Systemem e-Faktur (KSeF) w czasie rzeczywistym. Tryb ten umożliwia natychmiastowe przesyłanie wystawionych dokumentów do serwerów Ministerstwa Finansów, co jest warunkiem koniecznym do nadania fakturze statusu dokumentu ustrukturyzowanego oraz uzyskania oficjalnej daty wystawienia.

W sekcji KSeF w ustawieniach aplikacji należy uzupełnić token. Po jego uzupełnieniu i zapisaniu token zostaje w pełni zaszyfrowany.

Pole Token przed uzupełnieniem i po uzupełnieniu i zaszyfrowaniu

Jeżeli pole Token nie zostanie uzupełnione, w momencie przesyłania dokumentu do KSeF zostanie wyświetlony komunikat „Nie wykryto tokenu uwierzytelniającego. Komunikacja z systemem KSeF jest niemożliwa.”.

Jeżeli pole Token zostanie uzupełnione błędnym tokenem, w momencie przesyłania dokumentu do KSeF zostanie wyświetlony komunikat „Uwierzytelnienie w KSeF nie powiodło się. Skontaktuj się z administratorem systemu.”.

Praca w trybie offline – podpisywanie faktur i potwierdzanie tożsamości wystawcy certyfikatem KSeF typu 2

Tryb Offline to mechanizm zapewniający ciągłość pracy i możliwość wystawiani, zatwierdzania faktur wraz z potwierdzeniem tożsamości wystawcy w sytuacjach, gdy występują trudności techniczne w komunikacji z Krajowym Systemem e-Faktur (KSeF). Umożliwia to minimalizację przerw w procesie fakturowania spowodowanych problemami z jakością sieci transmisyjnej, brakiem połączenia z Internetem lub awarią wywołaną ze strony serwerów ministerstwa.

W zależności od przesłanek, pomimo stosowania od strony technicznej wysyłki w trybie offline, mogą wystąpić różne terminy późniejszego dosłania faktury do systemu, odmienne reguły ich udostępnienia nabywcy czy opatrywania kodami QR. Dlatego wyróżniamy kilka trybów pracy Offline: Offline24NiedostępnośćAwaria Awaria całkowita.

Jeśli podczas pracy w trybie online próba wysyłki faktury do KSeF nie powiedzie się (np. z powodu utraty połączenia z Internetem), aplikacja wyświetli komunikat z pytaniem o kontynuację wystawiania dokumentu w trybie offline. Fakturę wystawioną w ten sposób należy zsynchronizować do centrali, a następnie przesłać do KSeF nie później niż w kolejnym dniu roboczym.

Certyfikat KSeF (offline) – utworzenie i import w Comarch Mobile

W celu przygotowania certyfikatu należy:

  1. Zalogować się na stronie Zaloguj – Krajowy System e-Faktur i wygenerować z poziomu Certyfikaty\Wnioskuj o certyfikat pliki z rozszerzeniem  *.key i *.crt. Nazwy certyfikatów nie powinny zawierać spacji. Wprowadzone hasło do certyfikatu musi zostać zapamiętane i przechowywane w bezpiecznym miejscu. Zalecanym jest zapisanie certyfikatu w lokalizacji C:\KSEF\.
  2. Oba certyfikaty .cert oraz .key muszą zostać ze sobą scalone za pomocą darmowego programu OPEN SSL – https://slproweb.com/download/Win64OpenSSL_Light-3_6_1.exe. Po pobraniu należy program zainstalować z domyślnymi ustawieniami.
  3. Wybrać przycisk [Start] na pasku zadań Windows, wpisać cmd i nacisnąć [Enter]. Uruchomiony zostanie Wiersz Poleceń.
  4. W oknie należy wprowadzić: cd  C:\Program Files\OpenSSL-Win64\bin i zatwierdzić Enterem.
  5. Kolejno należy wpisać poniższe polecenie wcześniej zmieniając w nim nazwy plików „NAZWA_PLIKU” na nazwę wygenerowanego certyfikatu typu 2:openssl pkcs12 -export -out C:\KSEF\cert_export.pfx -inkey C:\KSEF\ NAZWA_PLIKU.key -in C:\KSEF\ NAZWA_PLIKU.crt
  6. Podczas wykonywania skryptu pojawi się pytania o hasło – należy wpisać hasło z pkt.1 (hasło należy powtórzyć kilka razy zgodnie z wyświetlonymi poleceniami). Wpisywane hasło nie jest widoczne.
  7. Zamknąć wiersz poleceń i przejść do C:\KSEF w którym utworzył się plik z rozszerzeniem cert_export.pfx
  8. Wygenerowany certyfikat .pfx należy przenieść na urządzenie mobilne.
  9. W ustawieniach aplikacji Comarch Mobile w sekcji związanej z KSeF należy wybrać opcję Certyfikat KSeF (offline). W momencie pierwszego wskazania certyfikatu zostanie podniesione okno systemowe z wyborem odpowiedniego pliku, który należy wskazać. Po wskazaniu odpowiedniego pliku, wpisaniu hasła, certyfikat zostanie umieszczony w bezpiecznym magazynie sprzętowym na urządzeniu mobilnym, a użytkownik zostanie poinformowany odpowiednim komunikatem.
Uwaga
Ręczna instalacja certyfikatu w systemie Android nie gwarantuje poprawnej komunikacji Comarch Mobile z systemem KSeF. Certyfikat należy zaimportować zgodnie z powyższą instrukcją.
Wskazówka

W procesie przygotowania certyfikatów do komunikacji z systemami zewnętrznymi może wystąpić sytuacja, w której standardowa metoda szyfrowania nie jest obsługiwana przez niektóre urządzenia mobilne. W takim przypadku wymagane jest zastosowanie alternatywnej metody zabezpieczenia pliku i zastosowania w punkcie 5 poniższego polecenia w wierszu poleceń:openssl pkcs12 -export -out C:\KSEF\cert_export.pfx -inkey C:\KSEF\ NAZWA_PLIKU.key -in C:\KSEF\ NAZWA_PLIKU.crt -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES

Parametr „Wysyłaj dokumenty do KSeF” na karcie kontrahenta

Parametr „Wysyłaj dokumenty do KSeF” jest widoczny na karcie kontrahenta:

Karta kontrahenta bez obsługi KSeF oraz z obsługą KSeF

Gdy na karcie kontrahenta zaznaczony jest parametr „Wysyłaj dokumenty do KSeF poza systemem”, po poprawnej konfiguracji, faktura sprzedaży będzie wysyłana do KSeF bezpośrednio z aplikacji Comarch Mobile, z pominięciem systemu ERP.

Zmiany na liście dokumentów w Comarch Mobile

Na liście dokumentów umożliwiono wyświetlanie dodatkowej informacji dotyczącej statusu KSeF dla faktur sprzedaży. To, czy informacje te są widoczne na liście, zależy od użytkownika aplikacji. Konfiguracja jest dostępna w Ustawieniach listy dokumentów, w sekcji Parametry aplikacji, znajdującej się w ustawieniach aplikacji. Po wejściu w tę opcję użytkownik może włączyć lub wyłączyć wyświetlanie statusów KSeF na liście dokumentów.

Ustawienia listy dokumentów
Przykładowy widok listy dokumentów

Zmiany na dokumencie faktury w Comarch Mobile

Wprowadzona została nowa zakładka KSeF na dokumencie faktury sprzedaży, dzięki której użytkownik ma możliwość podglądu dodatkowych informacji. Zakładka jest widoczna po aktywacji obsługi KSeF w Comarch Mobile oraz po spełnieniu standardowych warunków wysyłki dokumentu do KSeF.

Przykładowy widok listy dokumentów

Zmiany na wydruku faktury w Comarch Mobile

W zależności od trybu pracy online i offline wydruki faktur sprzedaży różnią się zawartością.

W trybie online faktury wysłane do KSeF oprócz standardowych danych prezentują kod QR. W kontekście KSeF to zakodowany link zawierający dane identyfikujące fakturę — taki format pozwala na szybkie odczytanie informacji przy pomocy urządzeń końcowych (smartfonów lub skanerów optycznych). Dzięki temu link może być zeskanowany i przekierowany bezpośrednio do odpowiedniego zasobu systemu KSeF odpowiedzialnego za wizualizację i weryfikację faktury.

Sposób prezentacji danych na wydrukach oraz obecność kodów QR uzależnione są od ustawień systemu ERP oraz statusu kontrahenta:

  • W przypadku, gdy w systemie ERP funkcjonalność KSeF jest wyłączona, wydruki są generowane według dotychczasowego standardowego wzorca, bez kodów QR,
  • Jeżeli obsługa KSeF została włączona w systemie ERP, a w Comarch Mobile pozostaje wyłączona, to wydruki są realizowane zgodnie z wytycznymi Ministerstwa Finansów. Z wyjątkiem przypadków, gdy na karcie kontrahenta zaznaczono informację, że dany kontrahent nie korzysta z KSeF – w takim przypadku generowany jest wydruk według dotychczasowego wzorca.
Przykładowy wydruk faktury sprzedaży

Gdy aplikacja pracuje w trybie offline, aby Klient miał pewność co do autentyczności dokumentu, Comarch Mobile automatycznie generuje i drukuje dwa obowiązkowe kody QR:

  • KOD QR 1 – umożliwia weryfikację e-faktury w KSeF
  • KOD QR 2 – potwierdza, że faktura została wystawiona przez podmiot posiadający ważny certyfikat KSeF

Faktura w systemie Comarch Mobile otrzymuje wtedy status KSeF Nie wysłano. Fakturę wystawioną w ten sposób należy zsynchronizować do centrali, a następnie przesłać do KSeF nie później niż w kolejnym dniu roboczym.

Przykładowy wydruk faktury sprzedaży (tryb offline)

 

Opcja „Sprawdź poprawność KSeF”

Operacja sprawdzania poprawności w KSeF polega na wstępnym sprawdzeniu czy dany dokument zostałby uznany za poprawny gdyby w tej chwili został przesłany do KSeF. Podczas tej operacji następuje sprawdzenie, czy dokument zawiera wszystkie obowiązkowe informacje oraz czy format przekazanych informacji jest zgodny ze schematem e-faktury.

Uwaga
Weryfikacja obejmuje tylko i wyłącznie poprawność semantyczną danych. Merytoryczna poprawność faktury nie jest sprawdzana.

Sprawdzenie poprawności w Comarch Mobile odbywa się:

  • Automatycznie w momencie próby zatwierdzenia dokumentu,
  • W momencie wywołania akcji z poziomu menu kontekstowego dokumentu FS w buforze „Sprawdź poprawność w KSeF” na liście dokumentów,
  • W menu kontekstowym na podglądzie dokumentu.
Opcja sprawdzania poprawności KSeF z poziomu listy dokumentów

Jeżeli weryfikacja będzie pozytywna, wówczas wyświetlony zostaje komunikat: „Dokument [numer dokumentu] jest zgodny ze strukturą e-faktury”

Jeżeli weryfikacja nie będzie pozytywna, wówczas wyświetlony zostaje komunikat: „Dokument [numer dokumentu] jest niezgodny ze strukturą e-faktury”

Eksport faktury do KSeF

Zatwierdzenie faktury w Comarch Mobile jest poprzedzone automatyczną walidacją zgodności ze strukturą e-faktury. Tylko poprawne dokumenty podlegają zatwierdzeniu i automatycznej wysyłce do systemu KSeF. W przypadku wykrycia nieprawidłowości, proces jest przerywany, a dokument zostaje zapisany do bufora.

Komunikat informacyjny po zatwierdzeniu faktury wysłanej automatycznie do KSeF
Uwaga
Po włączeniu obsługi KSeF w aplikacji edycja zatwierdzonych faktur sprzedaży nie będzie możliwa.
Uwaga
Jeżeli eksport dokumentu do KSeF nie powiedzie się, wówczas użytkownik zostanie poinformowany odpowiednim komunikatem, a dokument faktury sprzedaży zostanie zapisany do bufora.
Uwaga
Urzędowe poświadczenie odbioru (UPO) pobierane jest automatycznie po poprawnym przesłaniu dokumentu do KSeF. W przypadku przeciążenia serwerów KSeF UPO może nie zostać pobrane automatycznie. Wówczas należy pobrać je ręcznie.