• Konfiguracja połączenia z KSeF – Jak bezpiecznie autoryzować system Comarch BPM do komunikacji z serwerami rządowymi.

Zobacz instrukcję konfiguracji

• Automatyczne pobieranie dokumentów (Punkt ACD) – Jak skonfigurować mechanizm, który samoczynnie monitoruje skrzynkę KSeF i przesyła faktury do obiegu bez angażowania pracownika.

Dowiedz się więcej o automatyzacji

• Mapowanie danych i obieg faktury – Jak sprawić, by dane z pliku XML automatycznie uzupełniały się w Comarch BPM.

Sprawdź zasady mapowania danych z dokumentów

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

• 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

• Logowanie do SSMS: Należy zalogować się do SQL Server Management Studio przy użyciu konta z uprawnieniami administratora (np. konta sa).
• Dodanie loginu: W folderze Security -> Logins należy dodać nowy login dla użytkownika wskazanego w treści błędu (np. SRV2026\SERW_O).
• Konfiguracja uwierzytelniania: Podczas dodawania należy upewnić się, że wybrana jest opcja Windows authentication.
• Nadanie uprawnień: W sekcji Server Roles (Role serwera) konieczne jest zaznaczenie roli sysadmin.
• Finalizacja: Po zatwierdzeniu zmian przyciskiem OK, należy ponownie uruchomić skrypt instalacyjny.

• Eliminacja ręcznego wprowadzania pozycji dokumentów: Dane z faktury KSeF (pobrane do tabeli do.KS_DocumentItems) są automatycznie mapowane i wypełniają kontrolkę tabelaryczną na karcie obiegu.
• Automatyczne kalkulowanie wartości: Kontrolka tabelaryczna uzyskuje zdolność automatycznego przeliczania wszędzie tam, gdzie zmienione zostaną dane wejściowe (np. Netto, Stawka VAT, Brutto) przez użytkownika.
• Minimalizacja błędów i skrócenie czasu obsługi faktury: Proces akceptacji bazuje na poprawnych i spójnych danych, które są automatycznie kalkulowane i aktualizowane, zanim dokument zostanie zaksięgowany w Comarch ERP Optima.

• Definicja Typu Obiegu (Workflow): Wzorcowa ścieżka obiegu Faktury kosztowej z krokami akceptacji, konfiguracją kontrolki Dane tabelaryczne i wygenerowaniem dokumentu do Comarch ERP Optima
• Punkt konfiguracyjny ACD: Wzorcowa konfiguracja, która jest odpowiedzialna za pobranie ID dokumentu KSeF, Załącznika oraz wszystkich kluczowych danych nagłówkowych (Numer dokumentu, Kontrahent, Data zakupu, Data wystawienia, Data wpływu Termin płatności, Forma płatności, Waluta, Wartość Netto, Wartość Brutto, Numer KSeF, Data przyjęcia z KSeF) oraz utworzenie dokumentu obiegowego.

• Tryb Inicjowania (Pobieranie z KSeF): Wyzwalany, gdy kontrolka ID_KSeF zostanie uzupełniona. System pobiera dane z tabeli do.KS_DocumentItems z bazy BPM i łączy je ze stawkami VAT z bazy konfiguracyjnej Comarch ERP Optima.
• Konfiguracja wykorzystuje ID dokumentu KSeF (zapisane w dedykowanej kontrolce typu Liczba całkowita o nazwie np. ID_KSeF) jako identyfikator do pobrania danych.
• Kontrolka tabelaryczna obserwuje pole ID_KSeF, reagując na jego wypełnienie.
• Kluczowym elementem jest zapytanie SQL umieszczone na zakładce Inicjowanie Wartości kontrolki tabelarycznej.
• Zapytanie jest filtrowane za pomocą parametru @ID_KSeF@, dzięki czemu pobiera ono wiersze z właściwego dokumentu KSeF z tabeli do.KS_DocumentItems w bazie BPM.
• Tryb Edycji (Interaktywny): Kontrolka Dane Tabelaryczne (Elementy) obserwuje sama siebie (@^SenderControlName@ = ’Elementy’), co aktywuje logikę automatycznego przeliczania wartości w trybie edycji. Pozwala to na ręczne przypisanie stawki VAT oraz przeliczenie pozostałych wartości.

• ”Kategoria” (identyfikator kolumny: Kategoria) – typ Lista
• ”Opis” (identyfikator kolumny: Opis) – typ Tekst
• ”Kategoria2” (identyfikator kolumny: Kategoria2) – typ Lista
• ”Opis2” (identyfikator kolumny: Opis2) – typ Tekst
• ”Stawka” (identyfikator kolumny: Stawka) – typ Lista
• ”Netto” (identyfikator kolumny: Netto) – typ Liczba stałoprzecinkowa
• ”VAT” (identyfikator kolumny: VAT) – typ Liczba stałoprzecinkowa
• ”Brutto” (identyfikator kolumny: Brutto) – typ Liczba stałoprzecinkowa
• ”Rodzaj” (identyfikator kolumny: Rodzaj) – typ Lista
• ”Odliczenia” (identyfikator kolumny: Odliczenia) – typ Lista

• Kategoria:

select Kat_KatID, Kat_KodSzczegol--, (select top 1 Kat_KatID from cdn.Kategorie order by 1)
from cdn.Kategorie where Kat_Typ=1

• Stawka VAT:

SELECT Kon_KonId,
CASE
WHEN Kon_Opis='Stawka zwolniona' THEN 'ZW'
WHEN Kon_Opis='Nie podlega Vat' THEN 'NP'
WHEN Kon_Opis<>'Stawka zwolniona' and Kon_Opis<>'Nie podlega Vat' THEN CONCAT(LEFT(Kon_wartosc,6),' %')
END
FROM CDN_KNF_Konfiguracja.cdn.Konfig /* <<<<- Tu podmiana nazwy bazy>>>> */
where Kon_Numer=301 and Kon_wartosc like '%PL'

• Rodzaj:

SELECT 1, 'Towary'
UNION
SELECT 2,'Inne'
UNION
SELECT 3,'Środki trwałe'
UNION
SELECT 4,'Usługi'
UNION
SELECT 5,'Środki transportu'
UNION
SELECT 6,'Nieruchomości'
UNION
SELECT 7,'Paliwo'

• Odliczenia:

• Ta sekcja jest wywoływana tylko raz, podczas inicjowania obiegu:

Pierwsza sekcja zapytania SQL, rozpoczynająca się od bloku IF @^SenderControlName@ = 'ID_KSeF’ pobiera dane szczegółowe pozycji faktury z KSeF, standaryzuje identyfikatory stawek VAT i mapuje je na wartości procentowe z konfiguracji Comarch ERP Optima. Zapytanie to wypełnia kolumny z kwotami Netto/VAT/Brutto i ustala poprawną Stawkę procentową, jednocześnie inicjując kolumny  (Kategoria, Opis) wartością NULL, ponieważ te dane muszą być uzupełnione ręcznie.

IF @^SenderControlName@ = 'ID_KSeF'  /*Identyfikator kontrolki do której pobierane jest ID dokumentu KSeF */

BEGIN

/* Tryb 1: Inicjowanie pozycji z dokumentu KSeF */

WITH ProcessedDocumentItems AS (
/* CTE 1: Ujednolicenie stawek VAT z KSeF i ujęcie kluczowych kolumn */
SELECT
di.KSI_DocumentId,
KSI_ElementNazwa,
KSI_ElementWartoscNetto AS KSI_ElementWartoscNetto,
KSI_ElementStawkaVAT,
/* Ustandaryzowanie stawki KSeF do formatu liczbowego/ZW/NP ('23', '8', 'ZW', itp.) */
CASE
WHEN di.KSI_ElementStawkaVAT LIKE 'Stawka%' THEN LTRIM(RTRIM(SUBSTRING(di.KSI_ElementStawkaVAT, 7, LEN(di.KSI_ElementStawkaVAT) - 6)))
WHEN di.KSI_ElementStawkaVAT IN ('zw', 'np', 'oo', 'np') THEN UPPER(di.KSI_ElementStawkaVAT)
ELSE di.KSI_ElementStawkaVAT
END AS StandardizedKSeFVAT_Text
FROM
[NAZWA_BAZY_BPM].do.KS_DocumentItems AS di  /*Należy wskazać nazwę bazy BPM*/
WHERE KSI_DocumentId =  @ID_KSeF@  /*Identyfikator kontrolki liczba całkowita, do której pobierane jest ID dokumentu KSeF*/
),
OptimaVATRates AS (
/* CTE 2: Przygotowanie stawek VAT z Konfiguracji Optima */
SELECT
Kon_KonId,
Kon_Wartosc,
/* Ekstrakcja wartości liczbowej stawki (Poprawne SUBSTRING od indeksu 1) */
ISNULL(CAST(REPLACE(RTRIM(SUBSTRING(Kon_Wartosc, 1, CHARINDEX(' ', Kon_Wartosc, 2))), ',', '.') AS REAL), 1) AS StawkaVatValue,
/* NORMALIZACJA: Konwersja stawki Optima ('23.00') na format KSeF ('23') dla poprawnego JOIN */
CASE
WHEN Kon_Wartosc LIKE '%ZW%' THEN 'ZW'
WHEN Kon_Wartosc LIKE '%NP%' THEN 'NP'
WHEN Kon_Wartosc LIKE '%OO%' THEN 'OO'
WHEN Kon_Wartosc LIKE '%NP%' THEN 'NP'
ELSE CAST(ISNULL(CAST(REPLACE(RTRIM(SUBSTRING(Kon_Wartosc, 1, CHARINDEX(' ', Kon_Wartosc, 2))), ',', '.') AS REAL), 0) AS VARCHAR(10))
END AS StandardizedOptimaVAT_Text
FROM
[CDN_KNF_Konfiguracja].cdn.Konfig
WHERE Kon_Numer = 301 AND Kon_Wartosc LIKE '%PL'
)

/* Końcowy SELECT: Zwraca żądany zestaw kolumn */
SELECT

-- Wymagane jawne CAST na INT dla NULL (usuwa błąd konwersji)
CAST(NULL AS INT) AS 'Kategoria',
NULL AS 'Opis', -- pi.KSI_ElementNazwa AS 'Opis',
CAST(NULL AS INT) AS 'Kategoria 2',
NULL AS 'Opis 2',
ovr.Kon_KonId AS 'Stawka', -- INT
pi.KSI_ElementWartoscNetto AS 'Netto',
pi.KSI_ElementWartoscNetto * (ovr.StawkaVatValue / 100.0) AS 'VAT',
pi.KSI_ElementWartoscNetto * (1 + ovr.StawkaVatValue / 100.0) AS 'Brutto',
1,--  CAST(NULL AS INT) AS 'Rodzaj',
1-- CAST(NULL AS INT) AS 'Odliczenia'
FROM
ProcessedDocumentItems AS pi
LEFT JOIN
OptimaVATRates AS ovr
ON
pi.StandardizedKSeFVAT_Text = ovr.StandardizedOptimaVAT_Text;
END;

• Ta sekcja jest wywoływana przy każdej modyfikacji danych w kontrolce „Elementy” i wymaga użycia ELSE po sekcji KSeF:

• Załączniki

select KSD_SourceContent,CASEWHEN KSD_NumerFaktury LIKE '%/%' 
THEN CONCAT(REPLACE(KSD_NumerFaktury, '/', '_'), '.pdf')ELSE CONCAT(KSD_NumerFaktury, '.pdf')END AS modified_columnfrom do.KS_Documentswhere KSD_ID=@Id1@

• Załącznik XML

select KSD_Xml,CASEWHEN KSD_NumerFaktury LIKE '%/%' 
THEN CONCAT(REPLACE(KSD_NumerFaktury, '/', '_'), '.xml')ELSE CONCAT(KSD_NumerFaktury, '.xml')END AS modified_columnfrom do.KS_Documentswhere KSD_ID=@Id1@

• Dokument

select KSD_NumerFaktury from do.KS_Documents where KSD_ID=@Id1@

• Kontrahent

select top 1 Knt_KntId, Knt_Kod
from [do].[KS_DocumentContractors]
join [CDN_Optima].[cdn].[Kontrahenci] on Knt_Nip = KSC_PodatnikNIP
where KSC_DocumentId=@Id1@

• Data zakupu

SELECT CASE
WHEN KSD_DataDostawy IS NULL THEN KSD_DataWystawienia
ELSE KSD_DataDostawy
END
FROM do.KS_Documents WHERE KSD_ID=@id1@

• Data wpływu

select KSH_DataWytworzeniaFa from do.KS_DocumentHeaders where KSH_DocumentID=@Id1@

• Data wystawienia

select KSD_DataWystawienia from do.KS_Documents where KSD_ID=@Id1@

• Forma płatności

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_DocumentsWHERE KSD_Id=@ID1@

• Termin płatności

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

• Numer KSeF

select KSH_NumerReferencyjnyKSeF 
from do.KS_DocumentHeaderswhere KSH_DocumentID=@Id1@

• Waluta

select KSD_KodWaluty from do.KS_Documents where KSD_ID=@Id1@

• IDKSeF

select @Id1@

• Data przyjęcia KSeF

select KSH_DataWytworzeniaFa from do.KS_DocumentHeaders where KSH_DocumentID=@Id1@

• Numer rachunku bankowego

• Na podstawie przetworzonych danych z KSeF, w systemie Comarch BPM są generowane dokumenty w ramach wskazanej definicji typu obiegu.
• Po pomyślnym zainicjowaniu nagłówka dokumentu, system dokonuje pełnego uzupełnienia skonfigurowanych kontrolek na karcie obiegu.
• Kontrolka typu Dane Tabelaryczne zostaje automatycznie wypełniona pozycjami odczytanymi z dokumentu. Wypełnienie to odbywa się z wykorzystaniem dedykowanego zapytania SQL, które dokonuje normalizacji stawek VAT oraz przeliczeń kwot (Netto/Brutto).
• Kluczowe jest to, że kontrolka techniczna ID_KSeF (która przechowuje wewnętrzny identyfikator pobranego dokumentu KSeF) jest obserwowana przez kontrolkę Dane Tabelaryczne i na podstawie jej wartości (@ID_KSeF@ w zapytaniu SQL) kontrolka Danych Tabelarycznych jest uzupełniana danymi.

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

• programu (exe)
• procedury SQL
• pliku wykonywalnego na serwerze IIS
• kodu w języku C#

• Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
• Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
• Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
• Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
• Plik wykonywalny – użytkownik może uruchomić aplikację typu exe. Aplikacja musi znajdować się na dysku komputera, na którym działa Comarch BPM (dawniej DMS) lub w udostępnionym udziale dyskowym, do którego ma dostęp użytkownik systemu. Ścieżkę do aplikacji należy umieścić w cudzysłowie, np. „c:\windows\system32\calc.exe”.
• IIS – pole umożliwia uruchomienie plików wykonywalnych na serwerze IIS.
• Procedura – możliwe jest uruchomienie procedury znajdującej się w bazie obiegu. Należy wpisać nazwę procedury.
• Procedura ERP – możliwe jest uruchomienie procedury znajdującej się w bazie systemu ERP. Należy wpisać nazwę procedury.
• C# Script – istnieje możliwość wywołania procesu zdefiniowanego za pomocą kodu w języku C#.
• Nazwa spółki – opcja dostępna w trybie wielospółkowym. Operator może wybrać spółkę z rozwijanej listy.
• Potwierdzenie wykonania akcji –  użytkownik może zdefiniować własny komunikat, który ma się wyświetlić na szczegółach dokumentu po wykonaniu akcji na przycisku.
• Pytaj przed uruchomieniem – jeżeli parametru zostanie zaznaczony, po kliknięciu przycisku „własna akcja” system wyświetli komunikat „Czy uruchomić akcję?”.
• Zapisz przed uruchomieniem – zaznaczenie parametru sprawia, że po kliknięciu w przycisk własnej akcji, dokument najpierw jest automatycznie zapisywany, a następnie wykonywane jest polecenie zapisane w konfiguracji kontrolki.
• Odśwież po wykonaniu – parametr wprowadzony w wersji 2026.0.0; znajduje się na definicji kontrolki typu Własna akcja; jeśli checkbox „Odśwież po wykonaniu” jest zaznaczony, wówczas po wykonaniu akcji określonej w danej kontrolce karta obiegu zostanie przeładowana bez zapisywania obiegu.

• Data i godzina
• Dokument elektroniczny
• Kontrahent
• Liczba rzeczywista
• Liczba stałoprzecinkowa
• Liczba całkowita
• Lista
• Tekst
• Towar
• Wartość logiczna

• OpenSSL to oprogramowanie open source, oferujące prosty interfejs wiersza polecenia służący do generowania kluczy. Oprogramowanie dostępne jest np. na stronie: https://slproweb.com/products/Win32OpenSSL.html
• Do przygotowania żądania CSR potrzebny będzie klucz prywatny:
  • Aby wygenerować klucz prywatny, należy przejść do terminala i użyć polecenia:

openssl genrsa -out private_key.key 2048

• • Polecenie tworzy klucz prywatny o nazwie private_key.key o długości 2048

• Następnie za pomocą klucza prywatnego zostanie utworzone żądanie(CSR): do konsoli należy wkleić i wykonać komendę:

openssl req -new -key private_key.key -out request.pem

W efekcie otrzymamy plik request.pem z zapisanym żądaniem CSR, wygenerowany za pomocą klucza prywatnego private_key.key

• W trakcie wykonywania komendy, w konsoli zostanie wyświetlony komunikat w którym trzeba będzie podać dodatkowe informacje:
  • CountryName(kod kraju w formacie dwuliterowym),
  • State or Province Name(województwo),
  • Locality Name(miasto),
  • Organization Name(pełna nazwa organizacji),
  • Organizational Unit Name(dział organizacji),
  • Common Name(nazwa lub domena dla której wystawiany jest certyfikat).

• Po utworzeniu żądania CSR można zweryfikować jego zawartość za pomocą polecenia:

openssl req -text -noout -verify -in request.pem

Wyświetlony wynik powinien być zgodny z podanymi danymi

• Jeżeli dane są poprawne, plik request.pem można będzie przesłać do podmiotu certyfikującego w celu uzyskania kwalifikowanej pieczęci elektronicznej

2. Wygenerowane żądanie CSR request.pem przekazać do podpisu przy użyciu podpisu kwalifikowanego.

• Żądanie CSR (plik request.pem) musi być podpisane podpisem kwalifikowanym w formacie CAdES – jeśli Twoja aplikacja do podpisywania nie pozwala na złożenie podpisu w tym formacie skorzystaj z aplikacji Szafir do składania i weryfikacji podpisu elektronicznego: https://www.elektronicznypodpis.pl/aplikacje-i-sterowniki.
• Składanie i weryfikacja podpisu elektronicznego w aplikacji Szafir – w aplikacji Szafir należy kolejno:
  • przejść do sekcji Konfiguracja,
  • zmienić aktywną konfigurację,
  • ustawić format na CAdES (PKCS#7),
  • w sekcji Parametry podpisu zaznaczyć opcję Zapisz podpisywane dane razem z podpisem,
  • zapisać konfigurację i podpisać plik żądania certyfikatu, korzystając z aplikacji Szafir,

 Po podpisaniu żądania otrzymamy plik z rozszerzeniem .sig, który będzie można przekazać do KIR.

3.  przejść do sklepu Krajowej Izby Rozliczeniowej i odszukać produkt Pieczęć elektroniczna Szafir. Można skorzystać z tego linku.

• Na stronie sprzedawcy konieczne jest wybranie terminu ważności kwalifikowanej pieczęci elektronicznej. Dostępne opcje to: 1 rok lub 2 lata.
• Należy wybrać właściwą dla swojej organizacji wersję pieczęci wśród wymienionych poniżej:

• • Pieczęć elektroniczna kwalifikowana z wgraniem żądania CSR online:
    • Rozwiązanie wymaga posiadania kwalifikowanego podpisu, który jest niezbędny do podpisania żądania CSR związanego z certyfikatem. Dzięki temu sprawę można załatwić w pełni online.
    • Jeżeli żądanie CSR zostało wygenerowane, wówczas powinno zostać podpisane podpisem kwalifikowanym Prezesa lub Prokurenta. Szczegóły procesu podpisywania znajdują się w poprzednich krokach,
  • Pieczęć elektroniczna z dostarczeniem żądania CSR do placówki KIR:
    • Żądanie nie wymaga posiadania podpisu kwalifikowanego, ale konieczna jest fizyczna wizyta Prezesa lub Prokurenta w jednym z dwunastu Regionalnych Centrów Sprzedaży KIR (Krajowa Izba Rozliczeniowa), aby dostarczyć wygenerowany CSR z żądaniem certyfikatu.
• Nastepnie należy wykonać kolejno następujące kroki:
  • wybrać opcję Nowy zestaw, jeśli pieczęć kupujesz po raz pierwszy. Proszę NIE zaznaczać opcji Certyfikat do PSD2.
  • kliknąć Dodaj do koszyka,
  • przejść do koszyka i kliknąć Złóż zamówienie.
  • kliknąć Uzupełnij dane, w kolejnym kroku uzupełnić dane osoby upoważnionej do odebrania pieczęci elektronicznej,
  • przejść w dół do sekcji Dane do certyfikatu pieczęci elektronicznej i uzupełnić dane zgodnie z potrzebami organizacji oraz zgodnie z danymi przekazanymi w żądaniu CSR.
• Później należy przejść niżej do ostatniej sekcji:
  • Certyfikat online: Wgram żądanie PKCS#10 – w tym kroku należy przesłać plik CSR w rozszerzeniu .sig, który został podpisany kwalifikowanym podpisem.
  • Certyfikat w placówce KIR: Dostarczę żądanie PKCS#10 do placówki KIR – w tym kroku należy wybrać oddział, do którego zostanie dostarczone żądanie certyfikatu CSR.
• Następnie należy przejść do kroku 2 – Dane do zamówienia, a następnie do kroku 3 – Podsumowanie i płatność. W ramach wspomnianych kroków wykonać niezbędne działania opisane na stronie.
• Należy pobrać wygenerowane zamówienie wraz z umową i przekazać je do podpisu.

• W celu dalszej konfiguracji integracji z usługą e-Doręczenie należy przejść do artykułu Konfiguracja współpracy Comarch BPM z usługą e-Doręczenia

• Wybrać z listy dostępnej w polu „Z wzorca” wzorzec punktu konfiguracyjnego ACD do zaimportowania (wzorce to punkty konfiguracyjne wyeksportowane jako wzorce przez użytkowników – zob. Eksport punktu ACD)

lub

• Wybrać punkt konfiguracyjny ACD zapisany w formie pliku na dysku, zaznaczając opcję „Z pliku”

• W polu „ Nazwa punktu” wpisać wybraną przez użytkownika nazwę punktu konfiguracyjnego
• W polu „Typ obiegu” wybrać jeden z dostępnych typów obiegu (jeżeli w danym punkcie konfiguracyjnym występuje to pole)

• są automatycznie dopasowane do kontrolek na nowym typie obiegu tylko, jeżeli identyfikatory GUID tych kontrolek są zgodne.
• nie są automatycznie dopasowane do kontrolek na nowym typie obiegu, jeżeli identyfikatory GUID tych kontrolek nie są zgodne – w tym przypadku konieczne jest dopasowanie ręczne dostępnych kontrolek danego typu z listy z danym zapytaniem albo napisanie nowego zapytania.

• Nazwa punktu (pole „Nazwa punktu” na zakładce „Ogólne”)
• Typ obiegu (pole „ Typ obiegu” na zakładce „Ogólne”)
• Lista (numer id punktu ACD w bazie Comarch BPM (dawniej DMS) na zakładce „Lista”)
• Mapowanie kontrolek (zakładka „Kontrolki”, patrz uwagi powyżej)
• Ścieżka z punktu OCR (pole „ Zastosuj ścieżkę z punktu OCR” na zakładce „Ogólne” – w przypadku typu współpracy „Współpraca ze skrzynką pocztową (pobieranie załączników)”
• Pole „Kontrolka” – dostępne na zakładce „Ogólne” w przypadku typu współpracy „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM (dawniej DMS))
• Połączenie do bazy – w przypadku trybu współpracy z dowolnym programem OCR

• Skan (Zalaczniki) lub Załącznik (Zalaczniki)
• Data wpływu (Datawplywu)
• Data wystawienia (Datawystawienia)
• Data zakupu (Datazakupu)
• Kontrahent(Kontrahent)
• Dane kontrahenta (Danekontrahenta)
• Wartość brutto (Brutto)
• Numer dokumentu (Dokument)
• Waluta (Waluta)
• Numer rachunku bankowego (Numerrachunku_bankowego)
• Forma płatności (Formaplatnosci)
• Termin płatności (Terminplatnosci)
• Wartość netto (Netto)

• Jako wzorzec
• Do pliku