Integracje (dawna zakładka „KSeF”)

W wersji 2024.0.0 dodano zakładkę „KSeF”. W wersji 2024.2.0 nazwa zakładki została zmieniona na „Integracje”.

Zakładka „Integracje” jest dostępna jedynie w trybie jednospółkowym i służy do wprowadzenia danych potrzebnych do uwierzytelnienia w KSeF oraz (od wersji 2024.2.0) danych wymaganych do pobierania i wysyłania wiadomości w ramach integracji z usługą e-Doręczenia.

Od wersji 2024.2.0 zakładka dzieli się na dwie sekcje:

 

Zakładka „Integracje”

 

Integracja z usługą KSeF

W ramach zakładki dostępne są dwa pola:

  • NIP firmy – w ramach tego pola należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF
  • Token KSeF – w ramach tego pola należy wprowadzić token uwierzytelniający w KSeF

Uwaga
Jeśli Comarch DMS pracuje w trybie wielospółkowym, wówczas należy uzupełnić pola „NIP firmy” i „Token KSeF” na zakładce „Połączenia z ERP” (zob. przykładowo Połączenia z ERP).

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umozliwia 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.Demowartość 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 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.

 

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”

 

Integracja z usługą e-Doręczenia

W ramach zakładki dostępne są trzy pola:

  • Adres skrzynkiadres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

 

Przykładowy adres do e-Doręczeń, który należy wprowadzić w polu „Adres skrzynki”

 

  • Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenianazwa systemu Comarch DMS integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w ramach pola „Systemy”.

 

Wskazówka

Instrukcja dodania zewnętrznego systemu w usłudze e-Doręczenia jest dostępna pod adresem:

https://www.gov.pl/attachment/07a8c8c5-b329-44cf-9e08-ed7c497f6d1c

 

Przykładowa nazwa systemu dodana w polu „System” podczas konfiguracji skrzynki e-Doręczenia, którą należy wprowadzić w polu „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia”

 

  • Klucz prywatny – pole, w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatudostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

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

 

Wskazówka

W kwestii:

1. pobierania wiadomości z usługi e-Doręczenia zob. Integracja Comarch DMS z systemem e-Doręczenia – pobieranie wiadomości

2. wysyłania wiadomości w ramach usługi e-Doręczenia zob. Wysyłanie wiadomości do usługi e-Doręczenia

 

Wybór klucza PEM w polu „Klucz prywatny”

 

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

Sprawdź Szkolenia Comarch DMS!

 




Połączenia z ERP

 

Po włączeniu wielofirmowego trybu pracy w Comarch DMS poprzez zmianę wartości klucza „MultiCompany=true” w pliku konfiguracyjnym Web.config, zakładka „Autoryzacja API” zostaje zastąpiona zakładką „Połączenia z ERP”, na której definiowane są spółki.

 

[Dodaj] – opcja dodania nowej spółki

 

zapisz32 [Zapisz] – opcja zapisu danych

 

D:\---- Z PULPITU ----\Grafika\& NOD Webowy 29-12-2014\Ikonki\Garbage-Closed32.png [Usuń] – opcja umożliwiająca usunięcie zdefiniowanej spółki (po uprzednim kliknięciu na nią)

 

Widoczna jest również lista dodanych spółek. Po kliknięciu na nazwę danej spółki na liście informacje o tej spółce są pokazywane na prawym panelu.

 

Lista utworzonych spółek. Podświetlenie nazwy spółki prezentuje jej definicję na prawym panelu

 

Definicja spółki

 

Definiowanie nowej spółki

Nową spółkę operator dodaje po przyciśnięciu ikony . Na prawym panelu pojawia się lista pól do wypełnienia danymi nowej spółki.

 

wskazanie systemu Comarch ERP do którego będzie definiowanie połączenie, oprócz Altum możliwe do wyboru opcje to XL, Optima i Enterprise.

 

definicja połączenia do bazy konfiguracyjnej systemu Comarch ERP Altum. Po przyciśnięciu linku „zmień” pojawia się formatka połączenia.

 

– w polu możliwe do wyboru są wszystkie bazy firmowe powiązane ze wskazaną bazą konfiguracyjną.

 

skrót nazwy spółki (max 5 znaków)

 

definicja połączenia do firmowej bazy Comarch ERP Altum. Połączenie jest automatycznie konfigurowane po wskazaniu nazwy spółki.

 

–  w polu możliwy jest  wybór spośród  wszystkich nazw firm powiązanych ze wskazaną bazą konfiguracyjną.

 

login operatora Comarch ERP Altum wykorzystywany przez operatorów natywnych Comarch DMS

 

hasło operatora Comarch ERP Altum

 

– po zaznaczeniu tego checkboxa możliwe jest logowanie operatora  przez domenę (zob. Domena)

 

– w tym polu możliwy jest wybór właściwej domeny z listy po zaznaczeniu parametru „Używaj domeny”

 

–  w ramach tego pola możliwy jest wybór z listy określonej grupy z danej domeny

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić NIP firmy, dla której ma odbywać się współpraca z KSeF;

 

– pole dodane w wersji 2024.0.0; w ramach tego pola należy wprowadzić token uwierzytelniający w KSeF

Istnieje możliwość wygenerowania tokenu KSeF z poziomu Comarch 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”.

 

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umozliwia 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.Demowartość 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

 

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

 

Wprowadzone dane należy zapisać, używając przycisku dyskietki zapisz32 [Zapisz].

 

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

 

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”

 

 – pole przeniesione do zakładki w wersji 2024.2.0; adres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

 

Przykładowy adres do e-Doręczeń, który należy wprowadzić w polu „Adres skrzynki”

 

– pole przeniesione do zakładki w wersji 2024.2.0; nazwa systemu Comarch DMS integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w ramach pola „Systemy”.

 

Wskazówka

Instrukcja dodania zewnętrznego systemu w usłudze e-Doręczenia jest dostępna pod adresem:

https://www.gov.pl/attachment/07a8c8c5-b329-44cf-9e08-ed7c497f6d1c

 

Przykładowa nazwa systemu dodana w polu „System” podczas konfiguracji skrzynki e-Doręczenia, którą należy wprowadzić w polu „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia”

 

– pole (przeniesione do zakładki w wersji 2024.2.0), w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatudostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

 

Wybór klucza PEM w polu „Klucz prywatny”

Wprowadzone dane należy zapisać, używając przycisku dyskietki  zapisz32  [Zapisz].

 

Przykładowe okno z właściwościami dodanej spółki




Definiowanie punktu konfiguracyjnego (Import dokumentów zakupu z KSeF)

W wersji 2024.0.0 został dodany nowy typ punktu ACD, który służy do współpracy z KSeF„Import dokumentów zakupu z KSeF”.

 

Uwaga

W wersji 2024.0.1 w pliku Web.config w folderze aplikacji serwerowej (dawnej web) dodano klucz add key=”KSeFWorkMode” value=”Demo” /> – klucz umozliwia 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.Demowartość 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

 

Zakładka Tryb współpracy

Aby utworzyć punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony , a następnie na liście trybów pracy punktu wybrać opcję „Import dokumentów zakupu z KSeF” .

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” , zakładka „Tryb współpracy”

 

Zakładka Ogólne

Wygląd zakładki „Ogólne” jest zależny od trybu pracy Comarch DMS.

W trybie jednospółkowym na zakładce należy w ramach pola:su_list icon=”icon: check” icon_color=”#009de0″]

  • Nazwa punktuokreślić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów;
  • Typ obieguwskazać typ obiegu, w ramach którego będą generowane dokumenty zawierające dane z KSeF.
    [/su_list]

Jeżeli Comarch DMS pracuje w trybie jednospółkowym, wówczas komunikacja z KSeF odbywa się na podstawie danych (numeru NIP firmy oraz tokena uwierzytelniającego), które zostały podane w ramach zakładki „KSeF” na zakładce [Ustawienia].(zob. Integracje (dawna zakładka „KSeF”)).

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Ogólne”, gdy Comarch DMS pracuje w trybie jednospółkowym

 

W trybie wielospólkowym na zakładce należy w ramach pola:

  • Nazwa punktuokreślić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów;
  • Spółkawskazać spółkę, dla której będzie odbywać się komunikacja z KSeF – na podstawie numeru NIP oraz/albo tokenu, które zostały zapisane podczas konfiguracji danej spółki na zakładce „Połączenia z ERP” na zakładce [Ustawienia].(zob. Połączenia z ERP). Zapytania, które są wprowadzane na zakładkach „Lista” oraz „Kontrolki” również są wykonywane w kontekście bazy danej spółki;
  • Typ obieguwskazać typ obiegu, w ramach którego będą generowane dokumenty zawierające dane z KSEF.

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Ogólne”, gdy Comarch DMS pracuje w trybie wielospółkowym

 

Zakładka Lista

Na zakładce „Lista”, analogicznie do pozostałych trybów pracy punktów konfiguracyjnych, należy za pomocą zapytania SQL określić listę dokumentów, która będzie wyświetlana w oknie ACD po pobraniu plików z KSeF.

 

Uwaga
W wersji 2024.3.0 nastąpiła zmiana zapytania SQL wyświetlającego listę dokumentów (zob. poniższy przykład).

Zapytanie SQL wprowadzone na zakładce „Lista” w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” jest odmienne od zapytań SQL dla innych typów punktów ACD, różni się także od zapytania SQL dotychczas wprowadzanego w ramach punktu ACD typu „Import dokumentów zakupu z KSeF”.

 

Przyklad

Przykład zapytania wyświetlającego listę dokumentów.

BEGIN TRY
select d.KSD_ID, NULL, KSD_NumerFaktury
from do.KS_Documents d 
left join do.KS_WorkAPProcess W on d.KSD_ID = KSW_DocumentID /*tabela przeprocesowanych dokumentów*/ 
left join do.KS_DocumentHeaders dh on d.KSD_ID = dh.KSH_DocumentId
left join do.KS_DocumentContractors dc on d.KSD_ID = dc.KSC_DocumentID
where KSW_APDId=@PointId@ -- id punktu ACD 
and KSW_OperatorID=@IdOperatorDMS@ /*dodatkowy warunek, aby na liście operator widział dokumenty przeprocesowane przez siebie*/
and ((@InvoiceStatus@ = 0 and KSW_Status <> 5 and KSW_Archival = 0) OR (@InvoiceStatus@ = 1 and KSW_Archival = 1) OR
(@InvoiceStatus@ = 2 and KSW_Status = 5) OR @InvoiceStatus@ = 3)
and (nullif(@SearchText@,'') is null OR (@SearchText@ <> '' and KSD_NumerFaktury LIKE @SearchText@ + '%'))
and (@Nip@ is null OR dc.KSC_PodatnikNIP = @Nip@)
and (@DateFrom@ is null or dh.KSH_DataWytworzeniaFa >= @DateFrom@)
and (@DateTo@ is null or dh.KSH_DataWytworzeniaFa <= @DateTo@)
and (@GrossAmountFrom@ is null or KSD_SumaBrutto >= @GrossAmountFrom@)
and (@GrossAmountTo@ is null or KSD_SumaBrutto <= @GrossAmountTo@)
and (@InvoiceType@ is null or KSD_RodzajFaktury = @InvoiceType@)
END TRY 
BEGIN CATCH 
DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd: ' + ERROR_MESSAGE(); 
THROW 50001, @ErrorMessage ,1; 
END CATCH

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Lista”

 

Zakładka Kontrolki

Na zakładce „Kontrolki” za pomocą zapytań SQL należy wskazać wartości, które będą wyświetlane w poszczególnych kontrolkach po pobraniu dokumentów z KSeF.

Przykłady zapytań SQL dla faktur pobranych z KSeF są dostępne w artykule: Przykłady zapytań SQL w zakładce Kontrolki dla punktu ACD „Import dokumentów zakupu z KSeF”

Od wersji 2024.3.0 operator może dodawać plik pdf z dokumentem KSeF do kontrolki typu Załącznik. W tym celu powinien w ramach konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” wykonać kolejno następujące czynności:

  • na zakładce „Ogólne” w polu „Typ obiegu” wybrać typ obiegu, w ramach którego znajduje się kontrolka typu Załącznik;
  • na zakładce „Kontrolki” wybrać kontrolkę typu Załącznik i w ramach pola po prawej stronie okna wprowadzić zapytanie SQL – w poniższym przykładzie nazwą pliku będzie nazwa faktury:
Select KSD_SourceContent,

CASE

WHEN KSD_NumerFaktury LIKE '%/%' THEN CONCAT(REPLACE(KSD_NumerFaktury, '/', '_'), '.pdf')

ELSE CONCAT(KSD_NumerFaktury, '.pdf')

END AS modified_column

from do.KS_Documents

where KSD_ID=@Id1@

 

Uwaga
W przypadku zastosowania powyższego zapytania jeżeli w nazwie faktury występuje znak /, zostanie zamieniony na _ .

 

Uwaga
Należy pamiętać, że w odróżnieniu od innych zapytań SQL w przypadku wprowadzania zapytania dla kontrolki typu Załącznik w ramach zakładki „Kontrolki” podczas konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” konieczne jest dodanie frazy ‘.pdf’, tak, jak przedstawiono w powyższym przykładzie.

 

Wprowadzanie zapytania dla kontrolki typu Załącznik w ramach zakładki „Kontrolki” podczas konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF”

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Kontrolki”

 

Zakładka Uprawnienia

Na zakładce „Uprawnienia” należy wskazać pracowników, którzy będą mogli procesować dokumenty w ramach punktu.

Uprawnienia mogą być dodawane wyłącznie poprzez wskazanie pracowników, nie ma możliwości dodania uprawnień dla pracowników wskazanego działu czy pracowników zajmujących określone stanowisko.

Na zakładce „Uprawnienia” w ramach typu punktu konfiguracyjnego „Import dokumentów zakupu z KSeF” znajduje się także dodatkowa kolumna „Edycja dokumentu”.

Jeśli operator zaznaczy obok danego pracownika checkbox w ramach kolumny „Edycja dokumentu”, wówczas taki pracownik będzie mógł zmieniać wartości w kontrolkach bezpośrednio w punkcie ACD.

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Uprawnienia”, tryb jednospółkowy

 

Punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF”, zakładka „Uprawnienia”, tryb wielospółkowy

 

Uwaga
Dodanie operatora do uprawnień na punkcie konfiguracyjnym skutkuje nadaniem mu uprawnień do zakładki ACD (we właściwościach pracownika, na zakładce „Uprawnienia”, w sekcji „Funkcjonalności” zostaje zmieniona wartość parametr „Automatyczne generowanie dokumentów” na „TAK”)

Na każdej zakładce znajduje się ikona [Eksport], która umożliwia eksportowanie danego punktu ACD do zapisu na dysk (zob. Eksport punktu ACD). Istnieje również możliwość importu punktu konfiguracyjnego typu „Import dokumentów zakupu z KSeF”, podobnie jak w przypadku innych typów punktów ACD.( zob. Import punktu ACD).

 

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

Sprawdź Szkolenia Comarch DMS!

 




Przykłady zapytań SQL w zakładce Kontrolki dla punktu ACD „Import dokumentów zakupu z KSeF”

W ramach zakładki „Kontrolki”  w przypadku typu punktu ACD „Import dokumentów zakupu z KSeF” (zob. Definiowanie punktu konfiguracyjnego (Import dokumentów zakupu z KSeF)) można zastosować szereg zapytań SQL, aby z pliku został zmapowany określony rodzaj danych. Poniżej przedstawiono przykłady takich zapytań:

  • Załącznik – opcja dostępna od wersji 2024.3.0; użytkownik wybiera kontrolkę typu Załącznik, znajdującą się w danym typie obiegu (w poniższym przykładzie nazwą pliku będzie nazwa faktury)
Select KSD_SourceContent,

CASE

WHEN KSD_NumerFaktury LIKE '%/%' THEN CONCAT(REPLACE(KSD_NumerFaktury, '/', '_'), '.pdf')

ELSE CONCAT(KSD_NumerFaktury, '.pdf')

END AS modified_column

from do.KS_Documents

where KSD_ID=@Id1@

 

Uwaga
W przypadku zastosowania powyższego zapytania jeżeli w nazwie faktury występuje znak /, zostanie zamieniony na _ .

 

Uwaga
Należy pamiętać, że w odróżnieniu od innych zapytań SQL w przypadku wprowadzania zapytania dla kontrolki typu Załącznik w ramach zakładki „Kontrolki” podczas konfiguracji punktu ACD typu „Import dokumentów zakupu z KSeF” konieczne jest dodanie frazy ‘.pdf’, tak, jak przedstawiono w powyższym przykładzie.

 

  • Numer dokumentu – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
select KSD_NumerFaktury

from do.KS_Documents

where KSD_ID=@Id1@
  • Data wystawienia – użytkownik wybiera kontrolkę typu Data i godzina, znajdującą się w danym typie obiegu
Select KSD_DataWystawienia

from do.KS_Documents

where KSD_ID=@Id1@
  • Miejsce wystawienia – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_MiejsceWystawienia

from do.KS_Documents

where KSD_ID=@Id1@
  • Kontrahent – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
select KSC_PodatnikNazwa from do.KS_DocumentContractors p

join do.KS_Documents d on p.KSC_DocumentID=d.KSD_Id

where KSD_Id=@Id1@
  • Kontrahent (dla współpracy z Comarch ERP Optima) – użytkownik wybiera kontrolkę typu Kontrahent, znajdującą się w danym typie obiegu
select top 1 Knt_KntId, Knt_Kod

from [Nazwa_bazy_DMS].[do].[KS_DocumentContractors]

join [Nazwa_bazy_ERPOptima].[cdn].[Kontrahenci] on Knt_Nip = KSC_PodatnikNIP

where KSC_ID=@Id1@
  • Kontrahent (dla współpracy z Comarch ERP XL) – użytkownik wybiera kontrolkę typu Kontrahent, znajdującą się w danym typie obiegu
select top 1 Knt_gidnumer, knt_akronim

from [Nazwa_bazy_DMS].[do].[KS_DocumentContractors]

join [Nazwa_bazy_ERPXL].[cdn].[KntKarty] on Knt_Nip = KSC_PodatnikNIP

where KSC_ID=@Id1@
  • Towar – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
select KSI_ElementNazwa from do.KS_DocumentItems c

join do.KS_Documents d on c.KSI_DocumentID=d.KSD_Id

where KSD_Id=@Id1@
  • Kod waluty – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_KodWaluty

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży objętej stawką 0% w przypadku wewnątrzwspólnotowej dostawy towarów – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNetto0_WDT

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży objętej stawką 0% w przypadku eksportu – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNetto0_Export

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży zwolnionej od podatku – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNettoZW

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży w przypadku dostawy towarów oraz świadczenia usług poza terytorium kraju, z wyłączeniem kwot wykazanych w polach P_13_5 i P_13_9 – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNettoInna

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości świadczenia usług, o których mowa w art. 100 ust. 1 pkt 4 ustawy – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNettoRS

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży w procedurze odwrotnego obciążenia, dla której podatnikiem jest nabywca zgodnie z art. 17 ust. 1 pkt 7 i 8 ustawy oraz innych przypadków odwrotnego obciążenia występujących w obrocie krajowym – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNettoOOKraj

from do.KS_Documents

where KSD_ID=@Id1@
  • Suma wartości sprzedaży w procedurze marży, o której mowa w art. 119 i art. 120 ustawy – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaNettoMarza

from do.KS_Documents

where KSD_ID=@Id1@
  • Kwota należności ogółem – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_SumaBrutto

from do.KS_Documents

where KSD_ID=@Id1@
  • Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w przepisach Działu VI ustawy na fakturach, o których mowa w art. 106b ust. 1 pkt 4 ustawy – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu
Select KSD_KursWalutyZ

from do.KS_Documents

where KSD_ID=@Id1@
  • Przepis ustawy albo aktu wydanego na podstawie ustawy, na podstawie którego podatnik stosuje zwolnienie od podatku – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_SprzedazZWUstawa

from do.KS_Documents

where KSD_ID=@Id1@
  • Przepis dyrektywy 2006/112/WE, który zwalnia od podatku taką dostawę towarów lub takie świadczenie usług – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_SprzedazZWDyrektywa

from do.KS_Documents

where KSD_ID=@Id1@
  • Inna podstawa prawna wskazująca na to, że dostawa towarów lub świadczenie usług korzysta ze zwolnienia – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_SprzedazZWPodstawa

from do.KS_Documents

where KSD_ID=@Id1@
  • Data dopuszczenia nowego środka transportu do użytku – użytkownik wybiera kontrolkę typu Data i godzina, znajdującą się w danym typie obiegu
Select KSD_NSTWDT

from do.KS_Documents

where KSD_ID=@Id1@
  • Dane dla przypadków, gdy pole RodzajFaktury przyjmuje wartości KOR, KOR_ZAL lub KOR_ROZ – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_RodzajFaktury

from do.KS_Documents

where KSD_ID=@Id1@
  • Przyczyna korekty dla faktur korygujących – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_PrzyczynaKorekty

from do.KS_Documents

where KSD_ID=@Id1@
  • Data wystawienia faktury korygowanej – użytkownik wybiera kontrolkę typu Data i godzina, znajdującą się w danym typie obiegu
Select KSD_DataWystFaKorygowanej
from do.KS_Documents
where KSD_ID=@Id1@

 

  • Numer faktury korygowanej – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_NrFaKorygowanej

from do.KS_Documents

where KSD_ID=@Id1@
  • Numer identyfikujący fakturę korygowaną w Krajowym Systemie e-Faktur (KSeF) – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_NrKSeFFaKorygowanej

from do.KS_Documents

where KSD_ID=@Id1@
  • Dla faktury korygującej – okres, do którego odnosi się udzielany opust lub obniżka, w przypadku gdy podatnik udziela opustu lub obniżki ceny w odniesieniu do wszystkich dostaw towarów lub usług dokonanych lub świadczonych na rzecz jednego odbiorcy w danym okresie – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_OkresFaKorygowanej

from do.KS_Documents

where KSD_ID=@Id1@
  • Poprawny numer faktury korygowanej w przypadku, gdy przyczyną korekty jest błędny numer faktury korygowanej – użytkownik wybiera kontrolkę typu Tekst, znajdującą się w danym typie obiegu
Select KSD_NrFaKorygowany

from do.KS_Documents

where KSD_ID=@Id1@



Praca z punktem ACD (pobieranie dokumentów zakupu z KSeF)

W prawym panelu punktu ACD typu „Import dokumentów zakupu z KSeF” znajduje się przycisk [Import faktur z KSeF], który odpowiada za włączenie importu dokumentów z KSeF.

 

Uwaga
W systemie Comarch DMS integracja z KSeF obejmuje wyłącznie import dokumentów.

 

Widok punktu ACD typu „Import dokumentów zakupu z KSeF”

W wersji 2024.3.0 wprowadzono zmiany dotyczące okna „Import faktur z KSeF”, które jest wyświetlane po kliknięciu w przycisk [Import faktur z KSeF]. W ramach okna „Import faktur z KSeF” dostępne są trzy opcje:

  • Nowe – opcja zaznaczona domyślnie; operator powinien zaznaczyć tę opcję, jeśli chce, aby zostały pobrane dane wszystkich faktur zarejestrowanych od czasu ostatniego importu faktur (przyjęte w KSeF w dniu, gdy ostatnio dokonywano importu lub później);

Uwaga
Jeżeli nie pobierano do tej pory żadnych faktur, wówczas po zaznaczeniu tej opcji i kliknięciu w przycisk „Importuj” importowane są dane faktur z bieżącego oraz poprzedniego miesiąca. W ramach tej opcji nie następuje weryfikacja, czy w historii importowania faktur są luki.

  • Za okres Od [dzień.miesiąc.data] Do [dzień.miesiąc.data] – operator powinien zaznaczyć tę opcję, a następnie wybrać daty w polach „Od” i „Do”, jeśli chce, aby zostały pobrane dane faktur przyjętych w KSeF w wybranym okresie; domyślnie w polach wybrana jest aktualna data;

Uwaga
W ramach opcji Za okres Od [dzień.miesiąc.data] Do [dzień.miesiąc.data] konieczny jest wybór wartości zarówno w polu „Od”, jak i „Do”. System sprawdza według numeru KSeF dokumentu, czy pobierane faktury zostały już zaimportowane do bazy Comarch DMS.

  • Numer KSeF – operator powinien zaznaczyć tę opcję, jeżeli chce pobrać dane konkretnej faktury przjętej w KSeF. Po zaznaczeniu opcji należy wprowadzić w wyznaczonym polu numer KSeF wybranej faktury;

Uwaga
System sprawdza według numeru KSeF dokumentu, czy dana faktura została już zaimportowana do bazy Comarch DMS

Po wyborze opcji w oknie „Import faktur z KSeF” i ewentualnym wypełnieniu wymaganych pól należy kliknąć w przycisk [Importuj], aby pobrać dane faktur z bazy KSeF do bazy Comarch DMS, zgodnie z wybranymi kryteriami.

Jeżeli natomiast operator kliknie w przycisk [Anuluj] w ramach okna „Import faktur z KSeF”, wówczas okno zostanie zamknięte, a dane faktur z KSeF nie zostaną pobrane do Comarch DMS.

 

Okno „Import faktur z KSeF”

Kiedy użytkownik kliknie w przycisk [Importuj], wówczas:

  • jeśli przedtem na zakładce „KSeF” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono tylko pole „NIP firmy”, a nie uzupełniono pola „Token KSeF” – zostanie otwarte okno „Importowanie dokumentów” oraz okno „Wybierz certyfikat”, w którym należy wybrać certyfikat uwierzytelniający do KSeF. Jeżeli użytkownik nie uzupełni pola „Token KSeF”, wówczas za każdym razem po naciśnięciu przycisku [Importuj] konieczny będzie wybór certyfikatu.

 

Uwaga
Zalecane jest uwierzytelnianie za pomocą tokena.

 

Wybór certyfikatu w oknie „Wybierz certyfikat”

 

  • jeśli przedtem na zakładce „KSeF” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono zarówno pole „NIP firmy”, jak również pole „Token KSeF” – zostanie otwarte okno „Importowanie dokumentów”, bez konieczności wyboru certyfikatu

 

Uwaga
Jeśli token, który wprowadzono w polu „Token KSeF” został unieważniony w systemie KSeF, wówczas po kliknięciu przycisku [Importuj] również konieczny jest wybór certyfikatu.

 

W przypadku wyboru niewłaściwego certyfikatu lub wystąpienia innego błędu (zob. rozdział Przykładowe błędy poniżej) pobieranie faktur z KSeF nie będzie możliwe – zostaje wówczas wyświetlony następujący komunikat:

 

Komunikat wyświetlany, jeśli próbowano pobrać faktury z KSeF po wyborze niewłaściwego certyfikatu

 

Dokumenty, które zostały zarejestrowane w Comarch DMS, a nie zostały jeszcze wygenerowane do dokumentu Comarch DMS, są widoczne na liście dokumentów w prawym panelu.

Nazwy dokumentów KSeF, które nie zostały jeszcze otwarte w danym punkcie ACD, są zaznaczone pogrubioną czcionką na liście dokumentów.

 

Widok punktu ACD typu „Import dokumentów zakupu z KSeF” z nieprzeczytanym dokumentem (FS-30/24)

 

W wersji 2024.3.0 wprowadzono następujące zmiany na liście dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”:

  • Dotychczasową nazwę kolumny z listą dokumentów „Numer dokumentu” zmieniono na „Dokument”;
  • Gdy operator kliknie w nazwę kolumny „Dokument” obok niej pojawi się ikona – w takim przypadku lista jest posortowana w danej kolumnie według wartości rosnąco. Jeśli operator kliknie ponownie w nazwę kolumny „Dokument”, wówczas obok tej nazwy wyświetlona zostaje ikona – wtedy lista zostaje posortowana w danej kolumnie według wartości malejąco

Sortowanie dokumentów rosnąco ma miejsce według następującej kolejności:

1. Uszeregowane alfabetycznie;

2. Uszeregowane według kolejności numerycznej (0-9);

3. Uszeregowane według znaków specjalnych.

Sortowanie dokumentów malejąco ma miejsce według następującej kolejności:

1. Uszeregowane według znaków specjalnych;

2. Uszeregowane według kolejności numerycznej (9-0);

3. Uszeregowane alfabetycznie.

 

Lista dokumentów w punkcie ACD posortowana rosnąco (gdy ikona strzałki jest skierowana do góry)

  • Dodano nowe ikony nad listą dokumentów:

[Filtry] – po kliknięciu w tę ikonę wyświetlane jest okno, które pozwala na zdefiniowanie warunków do wyszukiwania dokumentów na liście. W ramach okna dostępne są następujące pola:

    • NIP firmy – w ramach pola można zawęzić pobieranie danych według wprowadzonej wartości NIP; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Data przyjęcia w KSeF – od – w ramach pola można wybrać datę, zgodnie z którą będzie filtrowana lista dokumentów w punkcie ACD – widoczne będą tylko faktury przyjęte w KSeF od wybranej daty; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Data przyjęcia w KSeF – do – w ramach pola można wybrać datę, zgodnie z którą będzie filtrowana lista dokumentów w punkcie ACD – widoczne będą tylko faktury przyjęte w KSeF do wybranej daty; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Wartość brutto [wartość od] [wartość do] – w ramach filtra można wprowadzić zakres wartości brutto faktury, zgodnie z którym nastąpi zawężenie pobieranych danych; dostępne są dwa pola: pierwsze pole od lewej strony, to pole „wartość od”, drugie pole od lewej strony to „wartość do”; operator może wybrać wartość w jednym z pól lub w obu
    • Typ dokumentu – w ramach filtra można wybrać jeden typ dokumentu według którego ma zostać zawężone pobranie danych dokumentów. Dostępne opcje to:
      • faktura VAT
      • faktura uproszczona
      • faktura rozliczeniowa
      • faktura zaliczkowa
      • faktura korygująca
      • faktura korygująca fakturę rozliczeniową
      • korekta faktury zaliczkowej

 

Wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola.

 

Lista opcji dostępnych w polu „Typ dokumentu”

    • Stan faktury – w ramach filtra można wybrać jeden stan dokumentu, według którego ma zostać zawężone pobranie danych dokumentów. Dostępne opcje to:
    • zarejestrowane w DMS – tzn. wygenerowano wcześniej w Comarch DMS dokumenty o takich samych numerach KSeF i nie zostały one odrzucone w punkcie ACD;
    • niezarejestrowane w DMS – opcja domyślnie zaznaczona; nie wygenerowano wcześniej w Comarch DMS dokumentów o takich samych numerach KSeF i nie zostały one odrzucone w punkcie ACD;
    • odrzucone – dokumenty, które odrzucono na punkcie ACD
    • wszystkie – wszystkie dokumenty: zarejestrowane, niezarejestrowane i odrzucone

Aby uruchomić filtrowanie listy dokumentów według warunków zdefiniowanych w oknie filtry, należy kliknąć w przycisk [Filtruj] – wówczas lista dokumentów w punkcie ACD zostanie zawężona zgodnie z wybranymi wartościami.

 

Okno „Filtry”

 

[Usuń filtry] – jeśli operator kliknie w tę ikonę, wtedy wszystkie warunki wyszukiwania dokumentu, które zdefiniowano w oknie „Filtry” oraz w ramach wyszukiwarki obok przycisku „Szukaj”, zostaną usunięte

 

[Odśwież] – gdy operator kliknie w tę ikonę, wówczas zostanie wyświetlona aktualna lista dokumentów

Operator może również zawęzić listę dokumentów lub wyszukać na niej dokument, wpisując frazę w polu wyszukiwarki nad listą dokumentów, a następnie klikając przycisk [Szukaj], podobnie, jak miało to miejsce w dotychczasowych wersjach.

  • Dodano opcję odrzucenia dokumentu w punkcie ACD – w tym celu operator powinien kliknąć prawym przyciskiem myszy na daną pozycję na liście dokumentów w punkcie ACD i kliknąć wyświetlony wówczas przycisk [Odrzuć] – wtedy dokument zniknie z listy dokumentów niezarejestrowanych (jeśli miał taki status) i zostanie zarchiwizowany;

 

Uwaga
Wybór opcji „Odrzuć” jest możliwy tylko dla jednego dokumentu na raz.

 

Odrzucenie dokumentu w punkcie ACD

 

  • Dodano opcję przywrócenia dokumentu w punkcie ACD – w tym celu operator powinien kolejno:
    • Nacisnąć przycisk [Filtry];
    • Zaznaczyć opcję „odrzucone” lub „wszystkie” w ramach pola „Stan faktury”;
    • Nacisnąć przycisk [Filtruj];
    • Na wyświetlonej liście wszystkich dokumentów lub dokumentów odrzuconych kliknąć prawym przyciskiem myszy na daną pozycję i nacisnąć wyświetlony wówczas przycisk [Przywróć] – wtedy dokument zostaje przywrócony i jest widoczny na liście dokumentów niezarejestrowanych (jeśli przedtem miał taki status).

 

Uwaga
Wybór opcji „Przywróć” jest możliwy tylko dla jednego dokumentu na raz.

 

Przywrócenie dokumentu w punkcie ACD

 

Po kliknięciu na daną pozycję na liście dokumentów podgląd dokumentu z KSeF zostanie wyświetlony w lewym panelu, a pod nim widoczna będzie lista kontrolek, którą określono w ramach zakładki „Kontrolki” podczas definiowania danego punktu konfiguracyjnego.

Jeśli dany operator nie ma prawa do edycji dokumentu KSeF w punkcie ACD (podczas konfiguracji danego punktu ACD typu „Import dokumentów zakupu z KSeF” w ramach zakładki „Uprawnienia” nie zaznaczono dla niego parametru „Edycja dokumentu”), wówczas kontrolki na danym dokumencie w punkcie ACD są wyszarzone i niedostępne do edycji.

 

Zaznaczanie parametru „Edycja dokumentu” dla operatora „Administrator”

 

Pracujący punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” (gdy użytkownik ma prawo do edycji wartości w kontrolkach)

 

Pracujący punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” (gdy użytkownik nie ma prawa do edycji wartości w kontrolkach)

 

Po sprawdzeniu danych w kontrolkach i ewentualnym uzupełnieniu wartości należy kliknąć w przycisk [Generuj], aby został utworzony nowy dokument w ramach typu obiegu, który zdefiniowano dla danego punktu ACD.

Istnieje możliwość zatrzymania generowania dokumentów – w tym celu należy kliknąć w przycisk [Zatrzymaj], który znajduje się w oknie „Inicjowanie dokumentów”. Generowanie dokumentów zostanie wówczas przerwane.

 

Okno „Inicjowanie dokumentów” z przyciskiem „Zatrzymaj”

 

 

Dokument, który wygenerowano z punkt konfiguracyjnego typu „Import dokumentów zakupu z KSeF”

Jeżeli poprawnie skonfigurowano punkt ACD i zapisano zmiany, wówczas po wygenerowaniu danego dokumentu do Comarch DMS nastąpi automatyczne dodanie załącznika w formacie pdf z fakturą KSeF na tym dokumencie, z nazwą faktury jako nazwą załącznika (zgodnie z nazwą faktury w kolumnie KSD_NumerFaktury w tabeli do.KS_Documents). Po kliknięciu w nazwę załącznika lub automatycznie po otwarciu dokumentu podgląd dokumentu zostanie wyświetlony w oknie po prawej stronie karty obiegu, podobnie jak w przypadku innych załączników.

 

Podgląd pliku pdf z fakturą z KSeF

Przykładowe błędy

Jeśli po kliknięciu w przycisk [Importuj]:

 

  • w ramach okna „Wybierz certyfikat” użytkownik kliknie przycisk [Anuluj] lub znak X w oknie „Wybierz certyfikat”, wówczas okno zostanie zamknięte i wyświetlony zostanie poniższy komunikat:

Komunikat wyświetlany, jeśli nie wybrano certyfikatu

 

  • w ramach okna „Wybierz certyfikat” użytkownik wybrał niewłaściwy certyfikat, wtedy okno zostanie zamknięte i wyświetlony zostanie następujący komunikat:

 

Komunikat wyświetlany, jeśli wybrano niewłaściwy certyfikat

 

  •  przedtem na zakładce „Integracje” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono poprawnie pole „Token KSeF”, ale nie uzupełniono pola „NIP firmy”, wówczas pobieranie faktur nie jest możliwe i zostaje wyświetlony następujacy komunikat:

Komunikat wyświetlany, jeśli nie uzupełniono pola „NIP firmy”

 

  • przedtem na zakładce „Integracje” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono poprawnie pole „Token KSeF”, ale uzupełniono niepoprawnie pole „NIP firmy”, wówczas pobieranie faktur nie jest możliwe – zostanie wyświetlone okno „Wybierz certyfikat”, a po wyborze właściwego certyfikatu wyświetli się następujący komunikat:

Komunikat wyświetlany, jeśli nie uzupełniono pola „NIP firmy”

 

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

Sprawdź Szkolenia Comarch DMS!