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ą (dawny 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 dodatkowo zweryfikować spółkę, która jest wskazana w kontrolkach:

  • Sekcja Dane ogólne:
      • Kontrahent
      • Waluta
      • Forma płatności
  • Sekcja Rejestr i kategoria:
      • Kategoria
      • Opis kategorii
      • Rejestr
      • Typ rejestru
  • Sekcja Pozycje
      • Definicje list w kontrolce Elementy
  • Sekcja Dokument w ERP Optima
      • Generuj dokument
      • Rejestr Vat zakupu
  • Sekcja Opis analityczny
    • Definicje list w kontrolce Opis analityczny
    • Dodaj opis analityczny
    • Obowiązkowe kolumny

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 wyświetlana jest wartość 0.

 

Konfiguracja generowania dokumentów – OptimaVatRegisterDimension.exe

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

Definicja uruchomienia pliku OptimaVatRegisterDimension.exe:

OptimaVatRegisterDimension.exe @^UserLoginToken@ @^DocumentId@ @^Culture@ @^DocumentCompanyId@ @Int2@

 

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

 

Konfiguracja kontrolek w obszarze (sekcji) „Opis analityczny”

Na właściwościach kontrolki „Opis analityczny” (kontrolka tabelaryczna), należy dodać kolumny typu lista odpowiadające zdefiniowanym wymiarom opisu analitycznego dla dokumentu typ „rejestr zakupu”.

 

Uwaga

Kolejność kolumn w kontrolce „Opis analityczny” musi być następująca:

  • Pozycja – kolumna istnieje na zaimportowanym przykładzie
  • Kolumny wymiarów – (max. 7) w kolejności określonej na formatce „Opis analityczny” w ERP Optima
  • Procent – kolumna istnieje na zaimportowanym przykładzie
  • Wartość – kolumna istnieje na zaimportowanym przykładzie

 

Podczas konfiguracji kolumn z wymiarami analitycznymi w polach „Nazwa kolumny” należy wprowadzić dokładnie takie same nazwy wymiarów, jakie zostały zdefiniowane w Optimie.

Przykład posiada 7 inicjatorów list o nazwach od „Wymiar 1” do „Wymiar 7”. W każdej kolejnej kolumnie wymiaru należy ustawić kolejne inicjatory list.

 

Przyklad

Przykładowo, jeżeli na formatce „Opis analityczny” powiązanej z dokumentem typu „rejestr zakupu” zostały zdefiniowane poniższe wymiary

 

Przykład tabeli opisu analitycznego w Comarch ERP Optima

 

konfiguracja kontrolki tabelarycznej „Opis analityczny” powinna wyglądać następująco:

 

Przykład konfiguracja typu obiegu do generowania opisu analitycznego

 

Ponadto w definicji kontrolek:

  • Weryfikator wartości opisu analitycznego (dwa wystąpienia)
  • Walidator2 (trzy wystąpienia)

należy we wzorze na wartość SQL OD zamienić identyfikator kontrolki @CustomAction2_EXE@ na @CustomAction2_IISEXE@

 

Wzór na wartość w kontrolce typu tekst – Weryfikator wartości opisu analitycznego

 

Wzór na wartość w kontrolce typu liczba całkowita – Walidator2

 

Uruchomienie przykładu

Aby wygenerować dokument do rejestru VAT z opisem analitycznym należy:

1. otworzyć dokument DMS ze skonfigurowanym przykładem

2. uzupełnić kontrolki w obszarze (sekcji) „Rejestr zakupu”;

3. zapisać dokument;

4. wygenerować dokument poprzez kliknięcie w przycisk „Generuj dokument”;

5. uzupełnić kontrolki w obszarze (sekcji) „Opis analityczny”;

6. zapisać dokument;

7. wygenerować opis analityczny poprzez kliknięcie w przycisk „Dodaj opis analityczny”.

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 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 z 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’.

Po wygenerowaniu opisu analitycznego poprzez kliknięcie w przycisk „Dodaj opis analityczny”, w kontrolce ‘Weryfikator opisu analitycznego’ zostanie wyświetlona informacja, że opis analityczny został dodany do dokumentu o numerze określonym w kontrolce Dokument.

 

Sekcja Opis analityczny po wygenerowaniu opisu analitycznego do dokumentu w rejestrze VAT Comarch ERP Optima