Konfiguracja Comarch ERP Optima

Uwaga
Przed rozpoczęciem konfiguracji przykładu, w Comarch DMS (lub w jednej ze spółek w trybie wielospółkowym) musi być skonfigurowana współpraca z Comarch ERP Optima 2024.0.1

 

Przykład generowania dokumentów został skonfigurowany dla parametru „Księgowość kontowa”.

 

Comarch ERP Optima, Konfiguracja rodzaju księgowości




Zawartość pakietu

W ramach pakietu Generator dokumentów do rejestru VAT, pobranego z zakładki „Przykłady”, z sekcji „ERP Optima” na Indywidualnych Stronach Partnerów (zob. Indywidualne Strony Partnerów | ERP Optima (comarch.pl)) znajdują się następujące katalogi:

  • bin – katalog, w którym znajdują się pliki, za pomocą których są generowane dokumenty ERP Optima do rejestru VAT w przypadku instalacji i konfiguracji do pracy na komputerze lokalnym
  • exe – katalog, w którym znajdują się pliki, za pomocą których są generowane dokumenty ERP Optima do rejestru VAT w przypadku instalacji i konfiguracji do pracy poprzez serwer IIS
  • Typ obieguprzykładowy typ obiegu do zaimportowania w Comarch DMS 
  • Zrodlaźródła aplikacji OptimaVatRegisterGenerator.exe – po przekompilowaniu źródeł do katalogu wynikowego należy skopiować pliki z katalogu Binaries

 

Zawartość pakietu „Generator dokumentów do rejestru VAT”




Konfiguracja generatora dokumentów do rejestru VAT Comarch ERP Optima – Instalacja i konfiguracja do pracy na komputerze lokalnym

 

Informacje początkowe

1.Do katalogu, w którym jest zainstalowana stacjonarna wersja Comarch DMS należy skopiować pliki z katalogu bin.

2.Kopiowanie pliku NLog.config jest opcjonalne, jest wymagany, jeżeli zachodzi potrzeba logowania informacji podczas generowania dokumentu.

3.Z katalogu „Typ obiegu” do programu Comarch DMS należy zaimportować typ obiegu: OptimaVatRegisterGeneration.workflow

4.Podczas generowania dokumentu do rejestru VAT Comarch ERP Optima za pomocą niniejszego mechanizmu, Comarch DMS loguje operatora Comarch ERP Optima wskazanego w oknie Ustawienia > Autoryzacja API lub domyślnego operatora wskazanego w oknie Ustawienia > Połączenia z ERP ( przypadku, gdy Comarch DMS pracuje w trybie wielofirmowym).

5.Dopełnieniem konfiguracji jest wskazanie adresu URL aplikacji web Comarch DMS w pliku konfiguracyjnym OptimaVatRegisterGenerator.exe.config, analogicznie do wskazywania adresu URL aplikacji web w pliku konfiguracyjnym aplikacji desktop Comarch DMS.

Plik konfiguracyjny OptimaVatRegisterGenerator.exe.config

 

Konfiguracja

1.W katalogu ze stacjonarną wersją Comarch DMS należy odszukać skopiowany wcześniej plik OptimaVatRegisterGenerator.exe.config.

2.W pliku OptimaVatRegisterGenerator.exe.config należy w kluczu <add key=”ServerUri” value=”http://<host>/<nazwa katalogu>”/> wpisac adres URL aplikacji web Comarch DMS.

Plik konfiguracyjny OptimaVatRegisterGenerator.exe.config z uzupełnionym adresem URL

 

3.Następnie należy wskazać konfiguracyjną bazę danych ERP Optima w zapytaniach inicjujących wartości kontrolek.

W tym celu należy kolejno:

  • uruchomić stacjonarną wersję Comarch DMS,
  • przejść do konfiguracji zaimportowanego typu obiegu.
  • W kontrolkach:
        •      Waluta
        •      Elementy, zakładka Listy -> lista: Stawka
        •      Elementy, zakładka inicjowanie wartości -> kontrolki powiązane: 3 wystąpienia

      w zapytaniach SQL  odszukać nazwę bazy „CDN_KNF_Konfiguracja” i zamienić ją na właściwą nazwę konfiguracyjnej bazy danych.

    • W wielospółkowym trybie pracy Comarch DMS dodatkowo zweryfikować spółkę, która jest wskazana w kontrolkach:

Kontrahent

Kategoria

Opis kategorii

Rejestr

Typ rejestru

Forma płatności

Waluta

Definicje list w kontrolce Elementy

Generuj dokument

Rejestr Vat zakupu

4.Aby możliwe było generowanie dokumentów do Rejestru VAT Optima z załącznikami, wymagane jest zapisywanie załączników w bazie Comarch DMS.

Za ustawienie bazy, w której zapisywane są załączniki odpowiada klucz <add key=”DestinationAttachmentsWorkflow” value=”DO” /> w pliku web.config (wartość DO oznacza zapisywanie załączników w bazie Comarch DMS).

 

Klucze licencji

Podczas generowania dokumentu do rejestru VAT Comarch ERP Optima za pomocą niniejszego mechanizmu, pobierana jest licencja Comarch ERP Optima.

Dokumenty są generowane w oparciu o licencje operatora wskazanego w oknie Ustawienia > Autoryzacja API lub domyślnego operatora wskazanego w oknie Ustawienia > Połączenia z ERP (w przypadku, gdy Comarch DMS pracuje w trybie wielofirmowym).

Istnieje również możliwość wskazania licencji, która będzie pobierana podczas generowania dokumentów do rejestru VAT w Comarch ERP Optima.

Aby wskazać licencję należy ustawić value =”1” dla wybranej licencji w pliku konfiguracyjnym OptimaVatRegisterGenerator.exe.config:

<add key=”KP” value=”0″/>

<add key=”KH” value=”0″/>

<add key=”KHP” value=”0″/>

<add key=”ST” value=”0″/>

<add key=”FA” value=”0″/>

<add key=”MAG” value=”0″/>

<add key=”PK” value=”0″/>

<add key=”PKXL” value=”0″/>

<add key=”CRM” value=”0″/>

<add key=”ANL” value=”0″/>

<add key=”DET” value=”0″/>

<add key=”BIU” value=”0″/>

<add key=”SRW” value=”0″/>

<add key=”ODB” value=”0″/>

<add key=”KB” value=”0″/>

<add key=”KBP” value=”0″/>

<add key=”HAP” value=”0″/>

<add key=”CRMP” value=”0″/>

Jeżeli w pliku OptimaVatRegisterGenerator.exe.config wszystkie wartości kluczy w sekcji Moduły Optima będą miały ustawioną wartość 0, wówczas generowanie dokumentów będzie odbywać się na dotychczasowych zasadach.

 

Plik konfiguracyjny OptimaVatRegisterGenerator.exe.config, sekcja Moduły Optima – klucze licencji

 

Kontrolka Własna akcja

Z poziomu kontrolki „Własna akcja” (Generuj dokument), należy ustawić definicję uruchomienia dodatku.

Uwaga
Definicja uruchomienia powinna się znaleźć w edytorze SQL wywołanym dla opcji Plik wykonywalny.

Definicja uruchomienia pliku OptimaVatRegisterGenerator.exe:

OptimaVatRegisterGenerator.exe @^UserLoginToken@ @^DocumentId@ @^Culture@ @^DocumentCompanyId@ @Walidator@

 

Kontrolka Walidator

W załączonym typie obiegu znajduje się kontrolka Walidator, w jej definicji wprowadzono warunek, odpowiadający za możliwość jednokrotnego generowania dokumentu.

Warunek blokuje możliwość wygenerowania kolejnego dokumentu również w przypadku, gdy wcześniej wygenerowany dokument w Comarch ERP Optima został odpięty od dokumentu w Comarch DMS.

Jeśli zajdzie potrzeba wygenerowania wielu dokumentów, należy zmienić warunek w kontrolce.

W przypadku gdy:

  • dokument generowany jest poprawnie, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość większą od zera (ID wygenerowanego dokumentu)
  • wystąpi błąd, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość mniejszą od zera.

Domyślnie w kontrolce jest wartość 0.

 

Kontrolki Termin płatności i Zastosuj termin płatności

Włączenie obsługi terminu płatności, gdy przykład był wykorzystywany w poprzednich wersjach

W przypadku, gdy w Comarch DMS wykorzystywany jest przykład do generowania dokumentów w rejestrze VAT ERP Optima, do obsługi przekazania terminu płatności wymagane jest wprowadzenie zmian jak poniżej:

1. Na definicji typu obiegu należy dodać kontrolki:

Zastosuj termin płatności – kontrolka typu Lista, inicjowanie wartości poprzez Słownik, wartości słownika: ‘Tak’, ‘Nie’.

Kontrolka przekazuje informację o tym czy termin płatności wskazany w kontrolce ‘Termin płatności’ zostanie przekazany do dokumentu w rejestrze VAT Comarch ERP Optima z karty obiegu, czy będzie ustalany zgodnie z konfiguracją Comarch ERP Optima.

W kontrolce należy wskazać odpowiedzi:

  • Tak – wówczas termin płatności na dokumencie w Comarch ERP Optima będzie pochodził z kontrolki Termin płatności
  • Nie – termin płatności będzie ustalany zgodnie z konfiguracją Comarch ERP Optima.

 

Konfiguracja kontrolki typu Lista

 

Termin płatności – kontrolka typu data i godzina.

Jeżeli w kontrolce ‘Zastosuj termin płatności’ ustawiono wartość ‘Tak’, termin płatności zostanie przeniesiony na dokument w rejestrze VAT Comarch ERP Optima,

Jeżeli w kontrolce ‘Zastosuj termin płatności’ ustawiono wartość ‘Nie’, termin płatności na dokumencie w rejestrze VAT będzie wynikał z konfiguracji Comarch ERP Optima.

 

Konfiguracja kontrolki typu Data i godzina

 

2.Po dodaniu kontrolek, należy w pliku konfiguracyjnym przykładu do generowania dokumentów odkomentować klucze odpowiedzialne za przekazanie wartości powyższych kontrolek:

          • <add key=”UsePaymentDateControl” value=”List1″ /> – dotyczy kontrolki typu Lista,
          • <add key=”PaymentDateControl” value=”DateTime4″ /> – dotyczy kontrolki Data i godzina

W wartościach kluczy należy wpisać identyfikatory kontrolek dodanych na typie obiegu.

OptimaVatRegisterGenerator.exe.config z odkomentowanymi kluczami dla kontrolek Lista i Data i godzina odpowiadających za przekazanie terminu płatności

 

Włączenie obsługi terminu płatności w przypadku nowej konfiguracji przykładu

Aby włączyć obsługę terminu płatności, należy w pliku konfiguracyjnym OptimaVatRegisterGenerator.exe.config odkomentować klucze odpowiedzialne za przekazanie wartości powyższych kontrolek:

<add key=”UsePaymentDateControl” value=” Zastosuj_termin_platnosci ” /> – dotyczy kontrolki typu Lista,

<add key=”PaymentDateControl” value=” Termin_platnosci” ” /> – dotyczy kontrolki Data i godzina

W wartościach kluczy należy wpisać identyfikatory kontrolek dodanych na typie obiegu.

W załączonym typie obiegu udostępniono kontrolki:

Zastosuj termin płatności – kontrolka typu lista w formie słownika z możliwością wskazania wartości domyślnej. Kontrolka przekazuje informację o tym czy termin płatności wskazany w kontrolce ‘Termin płatności’ zostanie przekazany do dokumentu w rejestrze VAT Comarch ERP Optima z karty obiegu, czy będzie ustalany zgodnie z konfiguracją Comarch ERP Optima. W kontrolce można wskazać odpowiedzi:

  • Tak – wówczas termin płatności na dokumencie w Comarch ERP Optima będzie pochodził z kontrolki Termin płatności
  • Nietermin płatności będzie ustalany zgodnie z konfiguracją Comarch ERP Optima.

Termin płatności – kontrolka typu data i godzina, jeżeli w kontrolce ‘Zastosuj termin płatności’:

  • ustawiono wartość ‘Tak’, termin płatności zostanie przeniesiony na dokument w rejestrze VAT Comarch ERP Optima;
  • ustawiono wartość ‘Nie’, termin płatności na dokumencie w rejestrze VAT będzie wynikał z konfiguracji Comarch ERP Optima.

 

Kontrolka Numer rachunku bankowego

W przypadku, gdy w Comarch DMS wykorzystywany jest przykład do generowania dokumentów w rejestrze VAT ERP Optima, do obsługi przekazania numeru rachunku bankowego wymagane jest:

1. dodanie kontrolki na typie dokumentu

Na definicji typu obiegu należy dodać kontrolkę typu tekst, nadać jej nazwę np. Numer rachunku bankowego i identyfikator np. Numer_rachunku_bankowego.

 

2. dodanie w pliku konfiguracyjnym klucza obsługującego przekazanie numeru rachunku bankowego na generowany dokument w Comarch ERP Optima.

Następnie należy w pliku konfiguracyjnym przykładu do generowania dokumentów dodać klucz odpowiedzialny za przekazanie numeru rachunku bankowego:

<add key=”AccountNumberControl” value=”Numer_rachunku_bankowego”/>

W wartości klucza należy wpisać identyfikator kontrolki typu tekst dodanej na typie obiegu.

Klucz ten domyślnie jest zakomentowany – aby korzystać z danej funkcjonalności należy go odkomentować.

 

OptimaVatRegisterGenerator.exe.config z odkomentowanym kluczem odpowiadającym za przekazanie numeru rachunku bankowego

 

Kontrolka Tryb generowania

W przypadku, gdy w Comarch DMS wykorzystywany jest przykład do generowania dokumentów w rejestrze VAT Comarch ERP Optima do obsługi przekazania trybu generowania Netto/Brutto wymagane jest wprowadzenie zmian jak poniżej:

Na definicji typu obiegu należy dodać kontrolkę:

Tryb generowaniakontrolka typu Lista, inicjowanie wartości poprzez Słownik, wartości słownika: ‘Netto’, ‘Brutto’.

 

Konfiguracja kontrolki typu Lista

 

Kontrolka przekazuje informacje o tym, czy dokument ma zostać wygenerowany w rejestrze VAT Comarch ERP Optima od Netto, czy od Brutto.

W kontrolce należy wskazać odpowiednią wartość:

          • Netto – wówczas podczas generowania dokumentu do Comarch ERP Optima zostanie przekazana kwota netto i VAT i na tej podstawie wyliczy się kwota brutto
          • Brutto – wówczas podczas generowania dokumentu do Comarch ERP Optima zostanie przekazana kwota brutto i VAT i na tej podstawie wyliczy się kwota netto

Po dodaniu kontrolki, należy w pliku konfiguracyjnym przykładu do generowania dokumentów dodać klucz odpowiedzialny za przekazanie wartości powyższej kontrolki:

<add key=”GenerationModeControl” value=”Tryb_Generowania” />

W wartości klucza należy wpisać identyfikator kontrolki dodanej na typie obiegu (w przykładzie jest to kontrolka o identyfikatorze Tryb_Generowania)

 

OptimaVatRegisterGenerator.exe.config z kluczem dla kontrolki Lista odpowiadającej za przekazanie trybu generowania

 

W przypadku konfiguracji generowania dokumentu do rejestru VAT Comarch ERP Optima po raz pierwszy, nie ma potrzeby modyfikacji pliku OptimaVatRegisterGenerator.exe.config oraz definicji typu obiegu, ponieważ te zmiany są już uwzględnione. Należy dokonać pozostałej konfiguracji zgodnie z opisem w tym artykule.

Uruchomienie przykładu

Po otwarciu nowego dokumentu DMS należy wprowadzić lub zmienić wartości na karcie obiegu. Wartości w kontrolkach, których opis jest pogrubiony są obowiązkowe.

Następnie należy zapisać dokument lub przekazać do kolejnego etapu.

Kolejnym krokiem jest kliknięcie w przycisk „Generuj dokument”, wygenerowany dokument automatycznie zostanie podpięty do pola „Rejestr VAT zakupu”.

 

Obieg dokumentów, generowanie dokumentu do rejestru VAT w Comarch ERP Optima.

 

W przypadku gdy dokument generowany jest z załącznikami, dołączone pliki dostępne są na dokumencie OBD powiązanym z wygenerowanym dokumentem w rejestrze VAT.

W oknie dokumentu Comarch ERP Optima wyświetlonym w Comarch DMS nie ma możliwości podglądu dokumentu OBD, tym samym nie ma możliwości usunięcia załączników dodanych na dokument OBD.

Aby zweryfikować listę załączonych plików, należy otworzyć dokument w systemie Comarch ERP Optima.

 

Dokument w rejestrze VAT zakupu w Comarch ERP Optima oraz powiązany dokument OBD załącznikiem przekazanym z Comarch DMS. Dokumenty wyświetlone w systemie Comarch ERP Optima

 

Oprócz dołączania załączników, na dokument OBD w Comarch ERP Optima:

1. w polu Numer obcy umieszczana jest informacja o numerze dokumentu Comarch DMS z którego wygenerowano dokumenty w Comarch ERP Optima;

2. w tytule dokumentu umieszczana jest informacja ‘Dokument Comarch DMS’.




Konfiguracja generowania dokumentów do rejestru VAT z poziomu Comarch DMS poprzez serwer IIS

 

Informacje początkowe

Do katalogu bin\exe w katalogu, w którym zainstalowano aplikację serwerową (dawna web) należy skopiować całą zawartość katalogu exe.

W ustawieniach zaawansowanych puli aplikacji należy powiązać pulę z kontem Windows, na którym zainstalowano Comarch ERP Optima.

 

Ustawienia zaawansowane puli aplikacji

 

Ustawienie tożsamości puli aplikacji

 

Tożsamość puli aplikacji – ustawianie poświadczeń dla niestandardowego konta

 

W definicji kontrolek:

  • Rejestr VAT zakupu
  • Komunikat
  • Walidator

należy we wzorze na wartość SQL OD zamienić identyfikator kontrolki @Generuj_dokument_EXE@ na @Generuj_dokument_IISEXE@

 

Wzór na wartość w kontrolce typu ‘Dokument elektroniczny’ – Rejestr Vat zakupu

 

Następnie należy wskazać konfiguracyjną bazę danych ERP Optima w zapytaniach inicjujących wartości kontrolek. W tym celu należy:

1. uruchomić stacjonarną wersję Comarch DMS;

2. przejść do konfiguracji zaimportowanego typu obiegu.

3. w kontrolkach:

  • Waluta
  • Elementy, Lista Stawka
  • Elementy, zakładka inicjowanie wartości -> kontrolki powiązane: 3 wystąpienia

w zapytaniach SQL odszukać nazwę bazy „CDN_KNF_Konfiguracja” i zamienić ją na właściwą nazwę konfiguracyjnej bazy danych.

4. w wielospółkowym trybie pracy Comarch DMS należy dodatkowo zweryfikować spółkę, która jest wskazana w kontrolkach:

  • Kontrahent
  • Kategoria
  • Opis kategorii
  • Rejestr
  • Typ rejestru
  • Forma płatności
  • Waluta
  • Definicje list w kontrolce Elementy
  • Generuj dokument
  • Rejestr Vat zakupu

 

Aby możliwe było generowanie dokumentów do Rejestru VAT Optima z załącznikami, wymagane jest zapisywanie załączników w bazie Comarch DMS.

Za ustawienie bazy, w której zapisywane są załączniki odpowiada klucz <add key=”DestinationAttachmentsWorkflow”value=”DO” /> w pliku Web.config (wartość DO oznacza zapisywanie załączników w bazie Comarch DMS).

 

Konfiguracja generowania dokumentów – OptimaVatRegisterGenerator.exe

Z poziomu kontrolki „Własna akcja” (Generuj dokument), należy ustawić definicję uruchomienia dodatku, definicja uruchomienia powinna się znaleźć w edytorze SQL wywołanym dla opcji IIS.

Definicja uruchomienia pliku OptimaVatRegisterGenerator.exe:

OptimaVatRegisterGenerator.exe @^UserLoginToken@ @^DocumentId@ @^Culture@ @^DocumentCompanyId@ @Walidator@

 

Definicja obiegu dokumentów, kontrolka typu Własna akcja, Zapytanie SQL dla pliku wykonywalnego na serwerze IIS.

 

Kontrolka Walidator

W załączonym typie obiegu znajduje się kontrolka Walidator, w jej definicji wprowadzono warunek, odpowiadający za możliwość jednokrotnego generowania dokumentu.

Warunek blokuje możliwość wygenerowania kolejnego dokumentu również w przypadku, gdy wcześniej wygenerowany dokument w Comarch ERP Optima został odpięty od dokumentu w Comarch DMS.

W przypadku, gdy zajdzie potrzeba wygenerowania wielu dokumentów, należy zmienić warunek w kontrolce.

W przypadku, gdy:

  • dokument generowany jest poprawnie, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość większą od zera (ID wygenerowanego dokumentu),
  • wystąpi błąd, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość mniejszą od zera.

Domyślnie w kontrolce jest wartość 0.

 

Uruchomienie przykładu

Po otwarciu nowego dokumentu DMS należy wprowadzić lub zmienić wartości na karcie obiegu. Wartości w kontrolkach, których opis jest pogrubiony obowiązkowe.

Następnie należy zapisać dokument lub przekazać do kolejnego etapu.

Kolejnym krokiem jest kliknięcie w przycisk „Generuj dokument”, wygenerowany dokument automatycznie zostanie podpięty do pola „Rejestr VAT zakupu”.

 

Obieg dokumentów, generowanie dokumentu do rejestru VAT w Comarch ERP Optima.

 

W przypadku gdy dokument generowany jest z załącznikami, dołączone pliki dostępne są na dokumencie OBD powiązanym z wygenerowanym dokumentem w rejestrze VAT.

W oknie dokumentu Comarch ERP Optima uruchomionym w Comarch DMS nie ma możliwości podglądu dokumentu OBD, tym samym nie ma możliwości usunięcia załączników dodanych na dokument OBD.

Aby zweryfikować listę załączonych plików, należy otworzyć dokument w systemie Comarch ERP Optima.

 

Dokument w rejestrze VAT zakupu w Comarch ERP Optima oraz powiązany dokument OBD załącznikiem przekazanym z Comarch DMS. Dokumenty wyświetlone w systemie Comarch ERP Optima

 

Oprócz dołączania załączników, na dokument OBD w Comarch ERP Optima  umieszczane są:

1. w polu Numer obcy: informacja o numerze dokumentu Comarch DMS z którego wygenerowano dokumenty w Comarch ERP Optima

2. w tytule dokumentu: informacja ‘Dokument Comarch DMS’.