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

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

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

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

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

• 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 nie uzupełniono pola „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_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

• ImportEDorMessages() – metoda do automatycznej obsługi pobierania nowych wiadomości z usługi e-Doręczenia – 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 ImportMessages()

return: 0 – ok, -1 – error

• 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

• kontrolkę typu Własna akcja „Sprawdź numer KSeF” (identyfikator: Sprawdz_numer_KSeF), która zawiera procedurę ERP, dzięki której możliwa jest weryfikacja, czy dokument z danym numerem KSeF w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP Optima;

• kontrolkę typu Komunikat (identyfikator: Msg2), która odpowiada za wyświetlenie komunikatu „Dokument o numerze KSeF [numer] znajduje się już w Comarch ERP Optima” – jeśli dokument o numerze znajdującym się w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP Optima

• kontrolkę typu Tekst „Status KSeF w Optimie” (identyfikator: StatusKSeFOptima), która zawiera informację zależną od wyniku weryfikacji za pomocą kontrolki „Sprawdź numer KSeF” – jeśli dokument znajduje się w Comarch ERP Optima, w kontrolce „Status KSeF w Optimie” widnieje napis „Dokument o takim numerze istnieje już w ERP”, jeśli zaś nie – „Dokument o takim numerze nie istnieje w ERP”.

W ramach definicji obiegów:

• OptimaVatRegisterGeneration.workflow dostępnego wraz z generatorem dokumentów do rejestru VAT Comarch ERP Optima
• OptimaVatRegisterGenerationAndAnalyticalDescription.workflow dostępnego wraz z generatorem dokumentów i opisu analitycznego do rejestru VAT Comarch ERP Optima

dodano następujące kontrolki, z których dane przekazywane są przez generator dokumentów Rejestr VAT do Comarch ERP Optima:

• kontrolkę typu Data „Data przyjęcia KSeF” (identyfikator: DataKSeF)
• kontrolkę typu Tekst „Numer KSeF” (identyfikator: NumerKSeF).

Dla tych kontrolek wprowadzono także odpowiednie klucze w pliku OptimaVatRegisterGenerator.exe.config (<add key=”KSeFNumberControl” value=”NumerKSeF” /> oraz <add key=”KSeFReceiptDateControl” value=”DataKSeF” />).

Kontrolki: „Data przyjęcia KSeF” „Numer KSeF” nie są wymagane do wygenerowania dokumentu w Comarch ERP Optima.

Dodatkowo na definicjach obiegów: OptimaVatRegisterGeneration.workflow i OptimaVatRegisterGenerationAndAnalyticalDescription.workflow wprowadzono następujące zmiany:

• dodano kontrolkę typu Własna akcja z procedurą ERP akcja „Sprawdź numer KSeF” (identyfikator: Sprawdz_numer_KSeF), która sprawdza, czy dokument z danym numerem KSeF w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP Optima
• dodano kontrolkę typu Komunikat (identyfikator: Msg2), która odpowiada za wyświetlenie komunikatu „Dokument o numerze KSeF [numer] znajduje się już w Comarch ERP Optima” – jeśli dokument o numerze znajdującym się w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP Optima
• dodano kontrolkę typu Tekst „Status KSeF w Optimie” (identyfikator: StatusKSeFOptima), która zawiera informację zależną od wyniku weryfikacji za pomocą kontrolki „Sprawdź numer KSeF” – jeśli dokument znajduje się w Comarch ERP Optima, w kontrolce „Status KSeF w Optimie” widnieje napis „Dokument o takim numerze istnieje już w ERP”, jeśli zaś nie – „Dokument o takim numerze nie istnieje w ERP”.

• Faktura zakupu
• (A)Faktura zakupu
• (A)Faktura zakupu uproszczona

• Faktura kosztowa (Nagłówek);
• Faktura kosztowa (Elementy);
• Faktura kosztowa (Waluty)

dodano:

• kontrolkę typu Tekst „Numer KSeF” (identyfikator: NumerKSeF) – w ramach kontrolki można wprowadzić numer KSeF; zostanie on przekazany do Comarch ERP XL do kolumny KSF_Numer w tabeli KSeFDokumenty; wypełnienie kontrolki nie jest obowiązkowe do wygenerowania dokumentu ERP XL;
• kontrolkę typu Data i godzina „Data przyjęcia KSeF” (identyfikator: DataKSeF) – w ramach kontrolki można wybrać date przyjęcia faktury KSeF; zostanie ona przekazany do Comarch ERP XL do kolumny KSF_TStampPrzyjecia w tabeli KSeFDokumenty; wypełnienie kontrolki nie jest obowiązkowe do wygenerowania dokumentu ERP XL;
• kontrolkę typu Własna akcja „Sprawdź numer KSeF” (identyfikator: Sprawdz_numer_KSeF), która zawiera procedurę ERP, dzięki której możliwa jest weryfikacja, czy dokument z danym numerem KSeF w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP XL;

• kontrolkę typu Komunikat (identyfikator: Msg2), która odpowiada za wyświetlenie komunikatu „Dokument o numerze KSeF [numer] znajduje się już w Comarch ERP XL” – jeśli dokument o numerze znajdującym się w kontrolce „Numer KSeF” (identyfikator: NumerKSeF) jest już w Comarch ERP XL

• kontrolkę typu Tekst „Status KSeF w ERP XL” (identyfikator: StatusKSeFXL), która zawiera informację zależną od wyniku weryfikacji za pomocą kontrolki „Sprawdź numer KSeF” – jeśli dokument znajduje się w Comarch ERP XL, w kontrolce „Status KSeF w ERP XL” widnieje napis „Dokument o takim numerze istnieje już w ERP”, jeśli zaś nie – „Dokument o takim numerze nie istnieje w ERP”.

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

• 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. Cena, Ilość, Stawka VAT) 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 ERP XL.

Zawartość przykładu

• Definicja Typu Obiegu (Workflow): Wzorcowa ścieżka obiegu dokumentu kosztowego z krokami akceptacji, konfiguracją kontrolki Dane tabelaryczne i wygenerowaniem dokumentu do Comarch ERPXL
• 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) oraz inicjację dokumentu obiegowego. W przypadku kontrolki Kontrahent w zapytaniu przed nazwą tabeli CDN.KntKarty należy wskazać właściwą nazwę bazy Comarch ERXL.

Kliknij tutaj, aby pobrać przykład

Zasada działania

Mechanizm opiera się na dwóch trybach działania zintegrowanych w jednej kontrolce Dane Tabelaryczne (Elementy), wykorzystując dane z bazy Comarch BPM, które zostały zapisane po przetworzeniu faktury z KSeF w punkcie ACD.

• 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 to pole (ID_KSeF), reagując na jego wypełnienie.
• Kluczowym elementem jest zapytanie SQL umieszczone na zakładce Inicjowanie Wartości kontrolki typu dane 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.
• W zapytaniu SQL zawarta jest niezbędna logika konwersji (CTE z ROW_NUMBER), która mapuje stawki VAT z KSeF na identyfikatory liczbowe (Naz_GIDLp) z tabeli CDN.Nazwy, których BPM wymaga do poprawnego wyświetlania danych w kolumnie typu Lista (Stawka VAT).
• Dodatkowo, kontrolka Dane Tabelaryczne (Elementy) obserwuje sama siebie (@^SenderControlName@ = ’Elementy’), co aktywuje logikę automatycznego przeliczania wartości w trybie edycji:
• Zapytanie monitoruje zmiany w kolumnach wejściowych, takich jak Cena lub Ilość (oraz Stawka VAT).
• W przypadku edycji tych pól, skrypt automatycznie pobiera stawkę VAT, a następnie przelicza i aktualizuje wartości Netto (Ilość * Cena) oraz Brutto (Netto * (1 + VAT)) w bieżącym wierszu.

• ”Nazwa” (identyfikator kolumny: Nazwa) – typ Tekst
• ”Cena” (identyfikator kolumny: Cena) – typ Liczba stałoprzecinkowa
• ”Ilość” (identyfikator kolumny: Ilosc) – typ Liczba stałoprzecinkowa
• ”Netto” (identyfikator kolumny: Netto) – typ Liczba stałoprzecinkowa
• ”Stawka VAT” (identyfikator kolumny: StawkaVAT) – typ Lista
• ”Brutto” (identyfikator kolumny: Brutto)– typ Liczba stałoprzecinkowa

• Stawki VAT:

 select Naz_gidLp as Id,  
 CASE  
  WHEN Naz_Nazwa='A 23.00' THEN '23%' 
  WHEN Naz_Nazwa='B 8.00' THEN '8%' 
  WHEN Naz_Nazwa='C 0.00' THEN '0%' 
  WHEN Naz_Nazwa='D 0.00' THEN 'ZW' 
  WHEN Naz_Nazwa='E 0.00' THEN 'NP' 
  WHEN Naz_Nazwa='F 7.00' THEN '7%' 
  WHEN Naz_Nazwa='G 5.00' THEN '5%' 
 END  
 from CDN.Nazwy  
 where Naz_GIDTyp = 624  AND trim(substring(Naz_Nazwa,9,2))=''

• Jednostki miary:

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

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

BEGIN

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

WITH ProcessedDocumentItems AS (

/* CTE 1: Ujednolicenie stawek VAT, tabela KSI_ElementStawkaVAT */

SELECT

KSI_ElementNazwa,

KSI_ElementCenaNetto,

KSI_ElementIlosc,

KSI_ElementWartoscNetto,

KSI_ElementStawkaVAT,

CASE

WHEN di.KSI_ElementStawkaVAT LIKE 'Stawka%' THEN LTRIM(RTRIM(SUBSTRING(di.KSI_ElementStawkaVAT, 7, LEN(di.KSI_ElementStawkaVAT) - 6)))

WHEN di.KSI_ElementStawkaVAT = 'zw' THEN 'ZW'

WHEN di.KSI_ElementStawkaVAT = 'np' THEN 'NP'

ELSE di.KSI_ElementStawkaVAT

END AS StandardizedStawkaVAT

FROM

[BAZA_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*/

),

ProcessedNazwyRanked AS (

/* CTE 2: Porządkowanie stawek VAT z tabeli słownikowej (CDN.Nazwy), w celu zapewnienia unikalności */

SELECT

Naz_GIDLp,

Naz_Nazwa1,

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' THEN 'ZW'

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 'NP'

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END AS StandardizedNazwa1_ForJoin,

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' OR LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 0.00

WHEN ISNUMERIC(

CASE

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

) = 1 THEN CAST(

CASE

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

AS DECIMAL(5, 2)) / 100.0

ELSE 0.00

END AS CalculatedVATRate,

/* Numerujemy rekordy dla tego samego klucza łączenia. */

ROW_NUMBER() OVER (PARTITION BY

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' THEN 'ZW'

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 'NP'

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

ORDER BY n.Naz_GIDLp ASC) as RN

FROM

CDN.Nazwy AS n

WHERE Naz_GIDTyp = 624

),

ProcessedNazwy AS (

/* CTE 3: Finalne, unikalne stawki */

SELECT

Naz_GIDLp,

StandardizedNazwa1_ForJoin,

CalculatedVATRate

FROM

ProcessedNazwyRanked

WHERE RN = 1 /* Wybieramy tylko jeden (pierwszy) rekord dla każdej unikalnej stawki */

)

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

SELECT

pi.KSI_ElementNazwa,

pi.KSI_ElementCenaNetto,

pi.KSI_ElementIlosc,

pi.KSI_ElementWartoscNetto,

pn.Naz_GIDLp AS 'stawka VAT', /* ID stawki z drugiej tabeli */

pi.KSI_ElementWartoscNetto * (1 + pn.CalculatedVATRate) AS 'Wartość brutto',

NULL AS 'NULL'

FROM

ProcessedDocumentItems AS pi

JOIN

ProcessedNazwy AS pn

ON

pi.StandardizedStawkaVAT = pn.StandardizedNazwa1_ForJoin;

END

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