Konfiguracja współpracy Comarch BPM z KSeF

Współpracę Comarch BPM z KSeF można skonfigurować zarówno w trybie jednospółkowym, jak i w trybie wielospółkowym.

Aby skonfigurować współpracę Comarch BPM z KSeF, należy:

  • dla trybu jednospółkowego:  na zakładce Ustawienia -> zakładka Integracje:


 

1.  w ramach pola  „Nip firmy” wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF

2. w ramach pola „Token KSeF” wprowadzić token uwierzytelniający w KSeF.

Uwaga
Jeśli autoryzacja przez token zakończy się niepowodzeniem, wówczas podczas próby importu dokumentów z KSeF zostanie wyświetlone okno z certyfikatami, w ramach którego należy wskazać właściwy certyfikat.

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umożliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie.

Klucz może przybierać jedną z następujących wartości:

1.Demo – wartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

 

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch BPM (dawniej DMS). W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający.

Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

Wprowadzone zmiany należy zapisać za pomocą przycisku  [Zapisz], dostępnego w ramach sekcji.

 

Uwaga
Aby wygenerować token konieczne jest zainstalowanie kwalifikowanego podpisu/pieczęci, za pomocą którego możliwe jest uwierzytelnienie się na stronach ministerstwa.

 

Zakładka „Integracje” – sekcja „Integracja z usługą KSeF”

 

Wybór certyfikatu po kliknięciu w link „Wygeneruj token”

 

Sekcja „Integracja z usługą KSeF” z uzupełnionymi polami

 

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”.

Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat.

Komunikat wyświetlany, jeśli nie wpisano numeru NIP w polu „NIP Firmy”, ale naciśnięto link „Wygeneruj token”

Wskazówka

Jeżeli operator pracuje w trybie testowym współpracy z KSeF 2.0 (w Comarch BPM dostępnym od wersji 2025.2.3), wówczas może:

  • wygenerować certyfikat zgodnie z instrukcją dostepną na stronie https://github.com/CIRFMF/ksef-docs/blob/main/auth/testowe-certyfikaty-i-podpisy-xades.md , a następnie uruchomić CMD jako administrator i wprowadzić następujęce polecenie:

    certutil -user -p "" -csp "Microsoft Enhanced Cryptographic Provider v1.0" -importpfx "C:\WINDOWS\system32\ksef-client-csharp\KSeF.Client.Tests.CertTestApp\cert-20251104-102647.pfx"

    gdzie: cert-20251104-102647.pfx to plik wygenerowany zgodnie z instrukcją ze strony https://github.com/CIRFMF/ksef-docs/blob/main/auth/testowe-certyfikaty-i-podpisy-xades.md

    Zaimportowany w ten sposób certyfikat (prawdopodobnie o nazwie A R) należy następnie wybrać w ramach okna wyświetlanego po kliknięciu w przycisk [Wygeneruj token]. Wówczas w polu „Token KSeF” zostanie wprowadzony token. Wprowadzone zmiany powinny zostac zapisane.

  • przejść na stronę https://web2te-ksef.mf.gov.pl/web/, kliknąć w pole „Uwierzytelnij sie w Krajowym Systemie e-Faktur”, a następnie w pole „Zaloguj uwierzytelnieniem testowym” – później należy uzupełnić pola: „NIP firmy” i „Numer NIP” i nacisnąć przycisk „Uwierzytelnij do aplikacji testowej”; następnie wybrać zakładkę „Tokeny”, sekcję „Generuj token” – w polu „Nazwa tokena” wprowadzić przykładową nazwę tokena, poniżej zaznaczyć uprawnienie „przeglądanie faktur” i kliknąć w pole „Generuj token”. Po odświeżeniu strony należy skopiować wyświetlany token, a potem wkleić go w polu „Token KSeF”. Wprowadzone zmiany powinny zostac zapisane.

Po ukończeniu konfiguracji należy przejść do konfiguracji punktu ACD współpracującego z KSeF (zob. Definiowanie punktu konfiguracyjnego (Import dokumentów zakupu z KSeF))

 

  • dla trybu wielospółkowego: na zakładce Ustawienia -> zakładka Połączenia z ERP  -> ustawienia odpowiedniej spółki:


1.  w ramach pola  „Nip firmy” należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF

2. w ramach pola „Token KSeF” należy wprowadzić token uwierzytelniający w KSeF.

Uwaga
Jeśli autoryzacja przez token zakończy się niepowodzeniem, wówczas podczas próby importu dokumentów z KSeF zostanie wyświetlone okno z certyfikatami, w ramach którego należy wskazać właściwy certyfikat.

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umożliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie.

Klucz może przybierać jedną z następujących wartości:

1.Demo – wartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

Zakladka „Połączenia z ERP”, pola „Nip firmy” i „Token KSeF”

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch BPM (dawniej DMS). W tym celu należy kliknąć w link [Wygeneruj token] znajdujący się obok pola „Token KSeF”, a następnie w oknie „Wybierz certyfikat” wybrać odpowiedni certyfikat uwierzytelniający.

Po wyborze certyfikatu zostanie wygenerowany token KSeF, który zostanie automatycznie wprowadzony w ramach pola „Token KSeF”.

Wprowadzone zmiany należy zapisać za pomocą przycisku  [Zapisz], dostępnego w ramach sekcji.

 

Uwaga
Aby wygenerować token konieczne jest zainstalowanie kwalifikowanego podpisu/pieczęci, za pomocą którego możliwe jest uwierzytelnienie się na stronach ministerstwa.

 

Aby wygenerować token uwierzytelniający, należy najpierw uzupełnić pole „NIP Firmy”.

Jeżeli użytkownik nie uzupełni pola „NIP Firmy” i naciśnie link [Wygeneruj token], wówczas zostanie wyświetlony następujący komunikat.

Komunikat wyświetlany, jeśli nie wpisano numeru NIP w polu „NIP Firmy”, ale naciśnięto link „Wygeneruj token”

 

Wskazówka

Jeżeli operator pracuje w trybie testowym współpracy z KSeF 2.0 (w Comarch BPM dostępnym od wersji 2025.2.3), wówczas może:

certutil -user -p "" -csp "Microsoft Enhanced Cryptographic Provider v1.0" -importpfx "C:\WINDOWS\system32\ksef-client-csharp\KSeF.Client.Tests.CertTestApp\cert-20251104-102647.pfx"

gdzie: cert-20251104-102647.pfx to plik wygenerowany zgodnie z instrukcją ze strony https://github.com/CIRFMF/ksef-docs/blob/main/auth/testowe-certyfikaty-i-podpisy-xades.md

Zaimportowany w ten sposób certyfikat (prawdopodobnie o nazwie A R) należy następnie wybrać w ramach okna wyświetlanego po kliknięciu w przycisk [Wygeneruj token]. Wówczas w polu „Token KSeF” zostanie wprowadzony token. Wprowadzone zmiany powinny zostac zapisane.

 

lub

 

  • przejść na stronę  https://web2te-ksef.mf.gov.pl/web/, kliknąć w pole „Uwierzytelnij sie w Krajowym Systemie e-Faktur”, a następnie w pole „Zaloguj uwierzytelnieniem testowym” – później należy uzupełnić pola: „NIP firmy” i „Numer NIP” i nacisnąć przycisk „Uwierzytelnij do aplikacji testowej”; następnie wybrać zakładkę „Tokeny”, sekcję „Generuj token” – w polu „Nazwa tokena” wprowadzić przykładową nazwę tokena, poniżej zaznaczyć uprawnienie „przeglądanie faktur” i kliknąć w pole „Generuj token”. Po odświeżeniu strony należy skopiować wyświetlany token, a potem wkleić go w polu „Token KSeF”. Wprowadzone zmiany powinny zostac zapisane.

 

Po ukończeniu konfiguracji należy przejść do konfiguracji punktu ACD współpracującego z KSeF (zob. Definiowanie punktu konfiguracyjnego (Import dokumentów zakupu z KSeF))

 

Wybór certyfikatu po kliknięciu w link „Wygeneruj token”

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu