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:
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.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.
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
Uwaga
Jeśli Comarch DMS pracuje w trybie wielospółkowym, wówczas należy uzupełnić pola „Adres skrzynki”, „Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia” i „Klucz prywatny” na zakładce „Połączenia z ERP” (zob. przykładowo Połączenia z ERP).
Uwaga
W przypadku korzystania ze środowiska testowego dla usługi e-Doręczenia w pliku web.config w folderze z aplikacją serwerową należy zmodyfikować wartości kluczy, które dotyczą e-Doręczeń, jak na poniższej ilustracji:
W ramach zakładki dostępne są trzypola:
Adres skrzynki – 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”
Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia – 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:
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 certyfikatu – dostarczony 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.
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?
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.
W ramach zakładki dostępne są następujące przyciski:
[Dodaj] – opcja dodanianowej spółki
[Zapisz] – opcja zapisu danych
[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
Definiowanie nowej spółki
Operator dodaje nową spółkę, klikając ikonę . Prawy panel pokazuje listę pól, które należy wypełnićdanymi nowej spółki.
– wskazanie typu spółki, która ma zostać dodana, oprócz Standalone możliwe jest stworzenie spółek Comarch ERP Altum, Comarch ERP XL, Comarch ERP Optima i Comarch ERP Enterprise.
– definicja połączenia do bazy systemu Comarch ERP Optima. Po przyciśnięciu linku „zmień” pojawia się formatka połączenia.
– w polu należy wprowadzić pełną nazwę dodawanej spółki zgodnie z jej nazwą w bazie.
Uwaga
Od wersji 2023.0.0 po wyborze w polu „System ERP” opcji „Optima” pole „Nazwa spółki” zmienia nazwę na „Nazwa spółki (baza)”. W przypadku wyboru w polu „System ERP” innej opcji to pole nosi nadal nazwę „Nazwa spółki”.
– pole dodane w wersji 2023.0.0, dostępne tylko w przypadku, jeśli w polu „System ERP” wybrano opcję „Optima”. Pole pozwala na ukrycie nazwy spółek Comarch DMS Optima w oknie logowania do Comarch DMS. Jeśli:
Pole „Nazwa wyświetlana” zostało uzupełnione, wówczas wprowadzona nazwa będzie widoczna przy logowaniu do Comarch DMS
Pole „Nazwa wyświetlana” nie zostało uzupełnione, wówczas w oknie logowania widoczna będzie nazwa wprowadzona w polu „Nazwa spółki (baza)”.
Jeśli pole „Nazwa wyświetlana” zostało uzupełnione, wówczas wprowadzona nazwa jest wyświetlana na liście spółek dostępnych w oknie logowania Comarch DMS, ta nazwa jest także wyszukiwana w trybie wyszukiwania nazw spółek w oknie logowania.
Jeśli pole „Nazwa wyświetlana” nie zostało uzupełnione, wówczas na liście spółek widoczna jest nazwa, którą wpisano w polu „Nazwa spółki (baza)”, według niej także odbywa się wyszukiwanie w trybie wyszukiwania nazw spółek w oknie logowania.
Okno logowania z listą spółek według nazw uzupełnionych w polu „Nazwa wyświetlana”
Uwaga
Nazwa wprowadzona w polu „Nazwa wyświetlana” jest widoczna jedynie w oknie logowania do Comarch DMS i na zakładce Struktura organizacyjna.
– skrót nazwy spółki (maksymalnie 5 znaków)
– definicja połączenia do firmowej bazy Comarch ERP Optima. Połączenie jest automatycznie konfigurowane po wskazaniu nazwy spółki.
– nazwa serwera klucza licencji
– login operatora Comarch ERP Optimawykorzystywany przez operatorów natywnych Comarch DMS do wykonywania operacji typu: podniesienie formatek listy dokumentów, listy kontrahentów oraz towarów.
– hasło operatora Comarch ERP Optima
– 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.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.
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”
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;
Uwaga
W przypadku korzystania ze środowiska testowego dla usługi e-Doręczenia w pliku web.config w folderze z aplikacją serwerową należy zmodyfikować wartości kluczy, które dotyczą e-Doręczeń, jak na poniższej ilustracji:
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:
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 certyfikatu – dostarczony 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 [Zapisz].
Przykładowe okno z właściwościami dodanej spółki
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?
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.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.
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ółkowymna zakładce należy w ramach pola:su_list icon=”icon: check” icon_color=”#009de0″]
Nazwa punktu – określić nazwępod jaką punkt konfiguracyjny będzie widoczny na liście punktów;
Typ obiegu – wskazać 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ólkowymna zakładce należy w ramach pola:
Nazwa punktu – określić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów;
Spółka – wskazać 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 obiegu – wskazać 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 ACDpo 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.
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?
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?