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

• Klucz prywatny certyfikatu KSeF – w ramach tego pola po kliknięciu w przycisk [Dodaj] można dodać z dysku plik o rozszerzeniu .key – klucz, który uzyskano podczas wnioskowania o certyfikat KSeF. Dodany plik zostanie wyświetlony zgodnie ze swoją nazwą. Operator może go zapisać na dysku, klikając w ikonę [Zapisz] lub usunąć z aplikacji Comarch BPM, klikając w przycisk kosza [Usuń]. Dane klucza prywatnego są zaszyfrowane i przechowywane w bazie danych Comarch BPM;
• Odcisk certyfikatu KSeF – w tym polu operator może wybrać certyfikat KSeF, z którym jest powiązany klucz prywatny, który wybrano w polu „Klucz prywatny certyfikatu KSeF“. W tym celu nalezy kliknąc w link [Wybierz certyfikat], a następnie w ramach okna Eksploratora plików wybrać odpowiedni plik i nacisnąć przycisk „Otwórz“. Dodawany plik powinien być certyfikatem z rozszerzeniem .crt, który uzyskano poprzez wnioskowanie o certyfikat KSeF Jeżeli operator wybrał pllik w poprawnym formacie, wówczas pole „Odcisk certyfikatu KSeF“ zostanie automatycznie wypełnione danymi odcisku palca tego certyfikatu, a obok pola zamiast linku [Wybierz certyfikat] zostanie wyświetlony link [Usuń certyfikat]. Dodany certyfikat jest przechowywany w formie zaszyfrowanej w bazie danych Comarch BPM. Ręczna edycja pola „Odcisk certyfikatu KSeF“ nie jest możliwa.
  • Jeśli operator kliknie w link [Usuń certyfikat], wówczas dane certyfikatu (odcisk odciska palca certyfikatu i certyfikat) zostaną usunięte zarówno z bazy Comarch BPM, jak i z pola „Odcisk certyfikatu KSeF“. Gdy certyfikat zostanie usunięty, link [Usuń certyfikat] zmieni się ponownie w link [Wybierz certyfikat] i bdzie możliwe ponowne wybranie certyfikatu.

• Hasło certyfikatu KSeF – pole, w ramach którego należy wprowadzić hasło, które wprowadzono podczas wnioskowania o certyfikat KSeF. Wprowadzone hasło jest przechowywane w formie zaszyfrowanej w bazie danych Comarch BPM.

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

• Klucz prywatny certyfikatu KSeF – w ramach tego pola po kliknięciu w przycisk [Dodaj] można dodać z dysku plik o rozszerzeniu .key – klucz, który uzyskano podczas wnioskowania o certyfikat KSeF. Dodany plik zostanie wyświetlony zgodnie ze swoją nazwą. Operator może go zapisać na dysku, klikając w ikonę [Zapisz] lub usunąć z aplikacji Comarch BPM, klikając w przycisk kosza [Usuń]. Dane klucza prywatnego są zaszyfrowane i przechowywane w bazie danych Comarch BPM;
• Odcisk certyfikatu KSeF – w tym polu operator może wybrać certyfikat KSeF, z którym jest powiązany klucz prywatny, który wybrano w polu „Klucz prywatny certyfikatu KSeF“. W tym celu nalezy kliknąc w link [Wybierz certyfikat], a następnie w ramach okna Eksploratora plików wybrać odpowiedni plik i nacisnąć przycisk „Otwórz“. Dodawany plik powinien być certyfikatem z rozszerzeniem .crt, który uzyskano poprzez wnioskowanie o certyfikat KSeF Jeżeli operator wybrał pllik w poprawnym formacie, wówczas pole „Odcisk certyfikatu KSeF“ zostanie automatycznie wypełnione danymi odcisku palca tego certyfikatu, a obok pola zamiast linku [Wybierz certyfikat] zostanie wyświetlony link [Usuń certyfikat]. Dodany certyfikat jest przechowywany w formie zaszyfrowanej w bazie danych Comarch BPM. Ręczna edycja pola „Odcisk certyfikatu KSeF“ nie jest możliwa.
  • Jeśli operator kliknie w link [Usuń certyfikat], wówczas dane certyfikatu (odcisk odciska palca certyfikatu i certyfikat) zostaną usunięte zarówno z bazy Comarch BPM, jak i z pola „Odcisk certyfikatu KSeF“. Gdy certyfikat zostanie usunięty, link [Usuń certyfikat] zmieni się ponownie w link [Wybierz certyfikat] i bdzie możliwe ponowne wybranie certyfikatu.

• Hasło certyfikatu KSeF – pole, w ramach którego należy wprowadzić hasło, które wprowadzono podczas wnioskowania o certyfikat KSeF. Wprowadzone hasło jest przechowywane w formie zaszyfrowanej w bazie danych Comarch BPM.

• 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; od wersji 2026.0.0 należy dokonać wyboru jednego lub wielu typów obiegów – po kliknięciu w pole rozwijana jest lista wszystkich typów obiegów dostępnych w systemie, a administrator powinien zaznaczyć checkbox obok jednego lub więcej typu obiegu – liczba zaznaczonych typów obiegów może być dowolna. Jeśli lista jest długa, po prawej stronie dostępny jest suwak.

Gdy operator zaznaczy typy obiegów i kliknie obok listy, wówczas zostanie ona zamknięta, a w polu „Typ obiegu“ będzie widoczny napis „Wybrano: [liczba wybranych typów obiegów]“.

• 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; od wersji 2026.0.0 należy dokonać wyboru jednego lub wielu typów obiegów – po kliknięciu w pole rozwijana jest lista wszystkich typów obiegów dostępnych w systemie, a administrator powinien zaznaczyć checkbox obok jednego lub więcej typu obiegu – liczba zaznaczonych typów obiegów może być dowolna. Jeśli lista jest długa, po prawej stronie dostępny jest suwak.

Gdy operator zaznaczy typy obiegów i kliknie obok listy, wówczas zostanie ona zamknięta, a w polu „Typ obiegu“ będzie widoczny napis „Wybrano: [liczba wybranych typów obiegów]“.

• Nazwy atrybutów na liście dokumentów w punkcie ACD  – w wersji 2025.0.0 na zakładce „Ogólne” na punkcie konfiguracyjnym punktu ACD typu „Import dokumentów zakupu z KSeF” dodano pole „Nazwy atrybutów na liście dokumentów w punkcie ACD”, w ramach którego dostępne są pola: „Atrybut 1”, Atrybut 2” i „Atrybut 3”.  Nowododane pola umożliwiają wprowadzenie dodatkowych informacji opisujących daną fakturę, co pozwala na bardziej szczegółową identyfikację i klasyfikację dokumentów w procesie ich przetwarzania.

W ramach pól „Atrybut 1”, „Atrybut 2” i „Atrybut 3” można zdefiniować maksymalnie 3 nazwy dodatkowych pól (atrybutów), które będą widoczne na liście dokumentów w punkcie ACD jako nazwy kolumn.

Informacje o nazwach atrybutów/kolumn są dostępne w tabeli do.DF_ConfAPDictionary.

Jeśli uprawniony operator nie wprowadzi żadnej nazwy atrybutu, wówczas kolumny z atrybutami nie zostaną utworzone, a na liście dokumentów będzie widoczna tylko jedna kolumna „Dokument”.

Jeżeli operator wprowadzi wartość w jednym z dodatkowych pól (atrybutów), wówczas na liście będzie widoczna jedna dodatkowa kolumna z taką nazwą, jaką wprowadzono w polu; analogicznie, jeśli uzupełniono dwa pola, będą widoczne dwie dodatkowe kolumny.

• Zmiana wartości na podstawie kontrolek obserwowanych (Obserwatory) – pole dodane w wersji 2026.0.0; umożliwia wyłączenie obserwatorów, które wykonują się w czasie dodawania dokumentów do obiegu z punktu ACD. Jeśli w polu parametru:

• • Wybrano wartość „Włączona” – wartości kontrolek mogą zostać nadpisane podczas generowania dokumentu do obiegu, zgodnie z kontrolkami obserwowanymi; wartość domyślna;
  • Wybrano wartość „Wyłączona” – wartości kontrolek nie zostaną nadpisane zgodnie z kontrolkami obserwowanymi podczas generowania dokumentu do obiegu (wartości zgodne z podglądem w punkcie ACD).

• 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ć dany typ obiegu (od wersji 2026.0.0),  następnie 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:

• Dla kontrolki „Numer KSeF”:

select isnull (KSH_NumerReferencyjnyKSeF, ' ')

from do.KS_DocumentHeaders

join do.KS_Documents on ksd_id=KSH_DocumentId

where KSD_ID=@Id1@

• Dla kontrolki „Data przyjęcia KSeF”:

• 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);

• 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;

• 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;

• 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.

• 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

[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.

• • 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 BPM (dawniej DMS) – tzn. wygenerowano wcześniej w Comarch BPM (dawniej DMS) dokumenty o takich samych numerach KSeF i nie zostały one odrzucone w punkcie ACD;
  • niezarejestrowane w BPM (dawniej DMS) – opcja domyślnie zaznaczona; nie wygenerowano wcześniej w Comarch BPM (dawniej 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

W wersji 2023.0.0 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.

W wersji 2023.0.0 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).

• Uszeregowane alfabetycznie;
• Uszeregowane według kolejności numerycznej (0-9);
• Uszeregowane według znaków specjalnych.

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

• Uszeregowane według znaków specjalnych;
• Uszeregowane według kolejności numerycznej (9-0);
• Uszeregowane alfabetycznie.

• 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:

• 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:

•  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 i zostaje wyświetlony następujacy komunikat:

• 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:
  

• 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@

• 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_DocumentId=@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_DocumentId=@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@

• Termin płatności – użytkownik wybiera kontrolkę typu Data i godzina, znajdującą się w danym typie obiegu

select KSP_TerminPlatnosci from do.KS_PaymentDates
where KSP_DocumentId=@Id1@

• Forma płatności – użytkownik wybiera kontrolkę typu Lista, znajdującą się w danym typie obiegu

SELECT

    (
        CASE
            WHEN KSD_FormaPlatnosci = 1 THEN 'Gotówka'

            WHEN KSD_FormaPlatnosci = 2 THEN 'Karta'

            WHEN KSD_FormaPlatnosci = 3 THEN 'Bon'

            WHEN KSD_FormaPlatnosci = 4 THEN 'Czek'

            WHEN KSD_FormaPlatnosci = 5 THEN 'Kredyt'

            WHEN KSD_FormaPlatnosci = 6 THEN 'Przelew'

            WHEN KSD_FormaPlatnosci = 7 THEN 'Płatność Mobilna'

            ELSE 'Inna'

        END

    ) AS FormaPlatnosci

FROM

    do.KS_Documents

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 netto – użytkownik wybiera kontrolkę typu Liczba stałoprzecinkowa, znajdującą się w danym typie obiegu

Select isnull(KSD_SumaNettoStawkaPodstawowa,0)

+ isnull(KSD_SumaNettoStawkaObnizona,0)

+ isnull(KSD_SumaNettoStawkaObnizonaDruga,0)

+ isnull(KSD_SumaNettoStawkaObnizonaTrzecia,0)

+ isnull(KSD_SumaNettoStawkiExportowe,0)

+ isnull(KSD_SumaVATOSS,0)

+ isnull(KSD_SumaNetto0_noWDT_NoExport,0)

+ isnull(KSD_SumaNetto0_WDT,0)

+ isnull(KSD_SumaNetto0_Export,0)

+ isnull(KSD_SumaNettoZW,0)

+ isnull(KSD_SumaNettoInna,0)

+ isnull(KSD_SumaNettoRS,0)

+ isnull(KSD_SumaNettoOOKraj,0)

+ isnull(KSD_SumaNettoMarza,0)

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

• Demo –  w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo:
  • Środowisko przedprodukcyjne (Demo) opiera się o faktyczne dane uwierzytelniające zgodne z rejestrem informacji o właścicielach firm. W celu zalogowania się do usługi konieczne jest posiadanie faktycznych uprawnień, analogicznych jak dla środowiska produkcyjnego
  • W ramach środowiska testowego oraz przedprodukcyjnego (Demo) należy używać zanonimizowanych danych;
  • Działanie środowiska przedprodukcyjnego (Demo) jest analogiczne do systemu produkcyjnego z tą różnicą, że znajdujące się tam dane nie są dokumentami księgowymi.
  • Faktury wystawione w środowisku testowym i przedprodukcyjnym (Demo) nie będą wywierały żadnych skutków prawnych i po określonym czasie zostaną usunięte z systemu.
• Production –  wartość domyślna od wersji 2026.0.0; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu:
  • praca w tym trybie wymaga poświadczeń za pomocą realnych danych– aby zalogować się do usługi, należy posiadać rzeczywiste uprawnienia;
  • dokumenty są realnymi dokumentami księgowymi.
• Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym
  • praca w tym trybie wymaga poświadczeń za pomocą fikcyjnych danych;
  • autoryzacja odbywa się za pomocą testowych certyfikatów;
  • dokumenty nie są realnymi dokumentami księgowymi.

• ImportKSeFDocuments() – metoda do automatycznej obsługi pobierania nowych dokumentów z usługi KSeF – ta metoda:
  • Nie posiada parametrów wejściowych
  • Zwraca wyniki:
    • 0 – jeśli operacja wykonała się poprawnie
    • -1- jeśli wystąpił błąd
  • int ImportKSeFDocuments()

return: 0 – ok, -1 – error

• SetKSeFFilters(string, DateTime?,DateTime?, decimal?, decimal?, byte?, byte) – metoda służąca do ustawiania filtrów dla punktów ACD typu „Import dokumentów zakupu z KSeF” według określonych kryteriów. Uruchomienie metody powoduje przeładowanie listy dokumentów przy uwzględnieniu nowych wartości filtrów. Ta metoda:
  • Posiada parametry wejściowe – podanie wszystkich parametrów nie jest wymagane:
    • string – NIP firmy
    • DateTime? – Data przyjęcia dw KSeF- od
    • DateTime? – Data przyjęcia dw KSeF- do
    • decimal? – Wartość brutto – od
    • decimal? – Wartość brutto – do
    • byte? – Typ dokumentu
    • byte – Stan faktury
  • Zwraca wyniki:
    • 0 – jeśli operacja wykonała się poprawnie
    • -1- jeśli wystąpił błąd
  • int SetKSeFFilters(string, string?, string?, decimal?,decimal?, byte?, byte)

string: KSeF NIP

DateTime?: KSeF date from

DateTime?: KSeF date to

decimal?: KSeF gross amount from

decimal?: KSeF gross amount value to

byte?: 0 – VAT invoice, 1 – corrective invoice, 2 – advance invoice, 3 – settlement invoice, 4 – simplified                               invoice,  5 – correction of advance invoice, 6 – corrective settlement invoice

byte: 0 – unregistered, 1 – rejected, 2 – registered, 3 – all

return: 0 – ok, -1 – error

• ResetKSeFFilters() – metoda służąca do resetowania filtrów dla punktów ACD typu „Import dokumentów zakupu z KSeF”. Domyślne ustawienia to brak filtrów: NIP firmy, Data przyjęcia w KSeF – od, Data przyjęcia w KSeF – do, Wartość brutto – od, Wartość brutto – do Typ dokumentu. Filtr Stan faktury jest ustawiony na faktury niezarejestrowane w Comarch BPM. Ta metoda:
  • Nie posiada parametrów wejściowych
  • Zwraca wyniki:
    • 0 – jeśli operacja wykonała się poprawnie
    • -1- jeśli wystąpił błąd
  • int ResetKSeFFilters()

return: 0 – ok, -1 – error

• SetDocumentFlow(string) – metoda dodana w wersji 2026.0.0; ustawia jeden wybrany obieg, co umożliwia uruchomienie automatyzacji procesu wskazywania typu obiegu dokumentów, którym ma posługiwać się program procesu. Ta metoda:
  • Ma parametr wejściowy: nazwę typu obiegu – jest to parametr obowiązkowy
  • Zwraca wyniki:
    • 0 – operacja wykonała się poprawnie
    • -1 – wystąpił błąd
    • -2 – podany obieg dokumentów nie istnieje