Właściwości kontrolki typu Dokument ERP XL
Kontrolka typu „Dokument ERP XL” służy do dekretacji kosztów poprzez funkcjonalność opisu analitycznego. Funkcjonalność pozwala wygenerować dokument Comarch ERP XL na podstawie danych (kontrahent, elementy dokumentu, dekretacja kosztów na opisie analitycznym) wprowadzonych w kontrolce „Dokument ERP XL”.
Zakładka Ogólne
Na właściwościach tej kontrolki można zainicjować pola:
- 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”,
- Nazwa spółki – wyświetlana, gdy Comarch DMS pracuje w trybie wielospółkowym,
- Wybierz centrum – wybrana wartość określa centrum struktury praw, w którym zostanie utworzony dokument,
- Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki
Zakładka Dokument ERP XL
Zakładka Dokument ERP XL zawiera kontrolki:
- Typ – kontrolka umożliwia wybranie typu dokumentu, dla którego będzie tworzony opis analityczny.
- Tryb pracy – kontrolka prezentuje tryb pracy opisu analitycznego: „Dla elementu” i „Dla nagłówka”
W sekcji „Ustawienia” dostępne są dwa parametry:
- Generowanie dokumentu bez OA – po zaznaczeniu tej opcji system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego
- Po odwiązaniu pozostaw w dokumentach związanych – jeśli ta opcja jest zaznaczona, wówczas w momencie odwiązywania dokumentu informacja o związaniu dokumentów nie jest usuwana
W ramach sekcji „Pola API” dostępne są pola w strukturze API, które po przypisaniu kontrolek i wypełnieniu wartościami na dokumencie umożliwią wygenerowanie dokumentu w systemie Comarch ERP XL.
Zakładka Wartości mapowane
W zależności od ustawienia kontrolki „Tryb pracy” (na zakładce „Dokument ERP XL”) na zakładce „Wartości mapowane” dostępne są jedna (tryb „Dla nagłówka”) lub dwie (tryb „Dla elementu”) sekcje:
Sekcja „Nagłówek”
W tej sekcji znajdują się kontrolki:
- Kontrahent
- Płatnik
- Wartość netto
- Waluta
- Rachunek bankowy
- Opis
oraz pole „Załączniki” z linkiem „Dodaj”, który umożliwia wybór kontrolki typu załącznik, dostępnej w danym typie obiegu, z której zostanie dodany załącznik.
Kontrolki można zmapować z kontrolkami na karcie obiegu (dostępne dla wybranych dokumentów).
Kontrolki „Kontrahent” i „Płatnik” przyjmują wartości:
- wartość Brak
- wartość <nazwa kontrolki typu „Kontrahent” lub „Płatnik”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnianej na karcie obiegu do pola Kontrahent na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.
Kontrolka „Wartość netto” przyjmuje wartości:
- Brak
- <nazwa kontrolki typu „Liczba rzeczywista” / „Liczba całkowita” / „Liczba stałoprzecinkowa”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Razem netto na kontrolce „Dokument ERP XL”.
Przeniesiona wartość traktowana jest przez aplikację jako wartość netto całego dokumentu = łączna wartość opisu analitycznego.
Do mapowania wartości zaleca się używanie kontrolek typu „Liczba stałoprzecinkowa”. Dla dokumentów typu A-vista wartość mapowana z Karty obiegu przenosi się do kolumny Cena lub Wartość netto.
Kontrolka „Waluta” przyjmuje wartości:
- Brak
- <nazwa kontrolki/ek typu „Tekst” lub „Lista”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Waluta na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.
Kontrolka „Rachunek bankowy” (dostępna od wersji 2022.0 dla faktury zakupu w trybie nagłówkowym i elementowym, (A) faktury zakupu uproszczonej i (A) faktury zakupu) przyjmuje wartości:
- Brak
- <nazwa kontrolki typu „Tekst” lub „Lista”>
Kiedy w ramach konfiguracji kontrolki ERP XL zostanie wskazana kontrolka, z której pochodzić będzie informacja o numerze rachunku bankowego do formatki ERP XL, wówczas nastąpi automatyczne wpisanie numeru rachunku do kontrolki „Rachunek bankowy” na formatce Dokument ERP XL.
Kontrolka „Opis” przyjmuje wartości:
- Brak
- <nazwa kontrolki typu „Tekst”>
Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Nazwa na kontrolce Dokument ERP XL. Gdy zostanie wybrana wartość ‘Brak’, wtedy mapowanie nie zostanie wykonane.
Kontrolka „Załącznik” przyjmuje wartość:
- Brak
- <nazwa kontrolki/ek z karty obiegu typu „Załącznik”>
Funkcjonalność pozwala na dołączenie załączników podpiętych do dokumentu w Comarch DMS do wygenerowanego na podstawie kontrolki „Dokument ERP XL” dokumentu w systemie Comarch ERP XL.
W Comarch DMS zdefiniowano obieg dokumentów:
Na karcie obiegu umieszczono trzy kontrolki typu załącznik: Specyfikacja, Skan dokumentu oraz Instrukcja obsługi.
We właściwościach kontrolki typu Dokument ERP XL wskazano wszystkie trzy kontrolki:
Zarejestrowano dokument w Comarch DMS, w kontrolkach typu załącznik podpięto kilka dokumentów:
W kontrolce typu Dokument ERP XL wygenerowano dokument FZ w systemie Comarch ERP XL, na dokumencie FZ na zakładce Załączniki w Comarch ERP XL prezentowane są wszystkie pliki podpięte w kontrolkach, które wskazano we właściwościach kontrolki typu Dokument ERP XL na zakładce Wartości mapowane.
- na kontrolkach typu Załącznik, które wybrano do mapowania w kontrolce typu Dokument ERP XL, na zakładce Archiwa ustawiono odpowiednią spółkę
oraz
- na kontrolce typu Dokument ERP XL na zakładce Ogólne ustawiono spółkę analogicznie jak na wybranych kontrolkach typu Załącznik
w przeciwnym wypadku mapowanie załączników nie będzie możliwe.
W systemie Comarch ERP XL załączniki prezentowane są na zakładce Załączniki.
Sekcja Elementy (dostępna w trybie pracy „Dla elementu” – chyba, że wybrano typ „Spinacz nagłówkowy faktury zakupu” lub „Nota memoriałowa”)
W tej sekcji znajdują się kontrolki:
- Lista elementów – w ramach tej kontrolki można wybrać kontrolkę typu Dane tabelaryczne, z której wartości będą przenoszone na zakładkę „Dokument” na kontrolce typu Dokument ERP XL
- Towar – w ramach tej kontrolki można wybrać kolumnę typu Towar z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Towar” i „Nazwa towaru” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
- Ilość – w ramach tej kontrolki można wybrać kolumnę typu liczba stałoprzecinkowa z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Ilość” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
- Jednostka miary – w ramach tej kontrolki można wybrać kolumnę typu lista z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Jm.” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
- Cena – w ramach tej kontrolki można wybrać kolumnę typu liczba stałoprzecinkowa z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „CenaN” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
- Stawka VAT– w ramach tej kontrolki można wybrać kolumnę typu lista z tabeli wybranej w kontrolce „Lista elementów” – z tej kolumny zostanie przeniesiona wartość na pole „Stawka VAT” na zakładce „Dokument” na kontrolce typu Dokument ERP XL
Szczegółowe informacje przedstawiono poniżej w podrozdziale Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej.
Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej
Istnieje możliwość przenoszenia wartości wprowadzonych do kontrolek tabelarycznych na formatkę „Dokumenty ERP XL”.
Aktualnie wszystkie mechanizmy mapujące mogą działać „online” (przenoszą dane do otwartej formatki „Dokumenty ERP XL”).
Dzięki temu tylko oznaczone elementy zostaną przeniesione do formatki „Dokumenty ERP XL”. Mechanizm można wykorzystać np. w częściowej realizacji zamówienia.
Aby włączyć tryb wskazywania wierszy, należy dodać w kontrolce typu dane tabelaryczne, z której będą mapowane wartości, kolumnę typu Wartość logiczna (np. „Czy zatwierdzono”) i wybrać opcję „Tak” w polu Wybór wierszy. Wówczas na kontrolkę typu Dokument ERP XL zostaną zmapowane wartości tylko z tych wierszy, dla których zaznaczono checkbox w kolumnie typu Wartość logiczna.
Mechanizm przenoszenia wartości z kontrolki „Dane tabelaryczne” do formatki „Dokumenty ERP XL” działa na wszystkich platformach Comarch DMS.
Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL
Przykład przenoszenia wartości z wybranych kontrolek oraz z kontrolki typu dane tabelaryczne
Operator:
- utworzył kontrolki Kontrahent , Waluta, Opis i Załącznik
- utworzył kontrolkę typu dane tabelaryczne o nazwie Elementy z następującymi kolumnami:
- utworzył kontrolkę typu Dokument ERP XL o nazwie Faktura zakupu, w zakładce Tryb pracy wybrał opcję Dla elementu
- na zakładce Wartości mapowane wskazał skąd będą pobierane informacje wyświetlane w kontrolce – w sekcji Nagłówek wybrał w odpowiednich polach kontrolki Kontrahent, Waluta, Opis i Załącznik, zaś w sekcji Elementy wskazał poszczególne kolumny kontrolki tabelarycznej, na podstawie których zostaną uzupełnione wartości:
- następnie operator zapisał typ obiegu, utworzył nowy dokument i uzupełnił kontrolki Kontrahent, Waluta, Elementy i Opis, a także dodał załącznik do kontrolki Załącznik.
- Wartości z kontrolek Kontrahent, Waluta i Elementy zostały zmapowane na odpowiednie pola na zakładce Dokument, zaś wartość z kontrolki Opis – na pole Opis na zakładce Opis analityczny, natomiast załącznik z kontrolki Załącznik zostanie dołączony do wygenerowanego dokumentu i będzie widoczny w Comarch ERP XL na karcie danego dokumentu w zakładce Załączniki.
W wersji 2018.1 udostępniono możliwość określania czy na danym etapie obiegu dane będą mapowane do kontrolki ‘Dokument ERP XL’.
Na zakładce Kontrolki na etapie definiowanego procesu prezentowana jest właściwość nazwa_kontrolki (mapowanie). Zaznaczenie parametru ‘Widoczna’ powoduje, że w etapie dane będą mapowane do kontrolki, odznaczenie parametru wyłącza mapowanie na tym etapie.
Generowanie dokumentu (S)FZ – Spinacza nagłówkowego faktury zakupu
W przypadku spinacza nagłówkowego faktury zakupu w kontrolce typu Dokument ERP XL dostępne są zakładki:
Zakładka Ogólne
Na właściwościach tej kontrolki można zainicjować pola:
- 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”,
- Nazwa spółki – wyświetlana, gdy DMS pracuje w trybie wielospółkowym,
- Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki
Zakładka Dokument ERP XL
Zakładka Dokument ERP XL zawiera kontrolki:
- Typ – kontrolka umożliwia wybranie typu generowanego dokumentu
- Tryb pracy – kontrolka prezentuje tryb pracy opisu analitycznego; w przypadku spinacza nagłówkowego faktury zakupu, tryb pracy zawsze będzie ustawiony ‘Dla elementu’, bez możliwości zmiany wartości
W przypadku spinaczy nagłówkowych faktur zakupu generowanie dokumentów odbywa się w oknie systemu Comarch ERP XL wywołanym z poziomu kontrolki Dokument ERP XL.
Po wybraniu ikony w kontrolce typu Dokument ERP XL wyświetlona zostaje lista dokumentów zakupowych Comarch ERP XL, na której możliwe jest dodanie dokumentu PZ i następnie:
- spięcie go do spinacza nagłówkowego (S)FZ
lub
- spięcie istniejącego dokumentu PZ do spinacza nagłówkowego faktury zakupu (S)FZ
lub
- wybranie istniejącej pary spiętych dokumentów PZ i (S)FZ.
Po utworzeniu i zapisaniu spinacza i wybraniu na liście dokumentów Comarch ERP XL, dokumenty PZ i (S)FZ do którego został spięty, zostają dowiązane do kontrolki Dokument ERP XL.
Dane dokumentu spinacza nagłówkowego faktury zakupu (S)FZ zostają przeniesione na formatkę kontrolki Dokument ERPXL.
Dla dokumentu spinacza (S)FZ na formatce Dokument ERP XL w aplikacji Comarch DMS wyświetlane są trzy zakładki:
- Przyjęcie zewnętrzne – zakładka, na którą przenoszone są dane z dokumentu PZ będącego elementem spinacza (S)FZ, dodanego w kontrolce Dokument ERP XL, dane z dokumentu wyświetlane są w trybie do odczytu, oznacza to, że nie ma możliwości wprowadzenia zmian na dokumencie PZ.
- Spinacz faktury – zakładka, na którą przenoszone są dane z dowiązanego dokumentu (S)FZ, dane z dokumentu wyświetlane są w trybie do odczytu, oznacza to, że nie ma możliwości wprowadzenia zmian na dokumencie (S)FZ.
- Opis analityczny – zakładka, na której operator ma możliwość wprowadzenia opisu analitycznego dokumentu oraz aktualizacji opisu w systemie Comarch ERP XL.
Uzupełnienie opisu analitycznego dotyczy wyłącznie dokumentu spinacza. W kolumnie Pozycja opisu analitycznego w zależności od odliczenia VAT, dostępne będą elementy:
- Opis dla nagłówka dokumentu spinacza: „dokument_<rodzaj zakupu>”
- Opis dla nagłówka dokumentu PZ: „1/<numer PZ>/dokument_<rodzaj zakupu>”
- Opis dla VAT’u z nagłówka dokumentu spinacz: „dokument_VAT_koszt”
- Opis dla elementu dokumentu PZ: „1/<numer PZ>/<kod towaru>”
Prezentowane wymiary opisu analitycznego, są wymiarami dostępnymi dla centrum w systemie Comarch ERP XL, w którym wygenerowano dokument spinacza nagłówkowego faktury zakupu.
W przypadku wyświetlania w kontrolce dokument ERP XL dokumentów PZ i spinacza (S)FZ, do którego został spięty, nie ma możliwości odwiązania dokumentów pojedynczo. Gdy użytkownik chciałby zmienić spięte dokumenty na inne, konieczne jest usunięcie dokumentów za pomocą ikony 
znajdującej się na formatce Dokument ERP XL wyświetlonej z kontrolki typu Dokument ERP XL. Zanim dokumenty zostaną usunięte z formatki Dokument ERP XL, zostanie wyświetlony komunikat:
Generowanie dokumentu z poziomu formatki „Dokument ERP XL” bez opisu analitycznego
W kontrolce „Dokument ERP XL” istnieje opcja generowania dokumentów z opisem analitycznym.
Po zaznaczeniu na właściwościach kontrolki opcji „Generowanie dokumentu bez OA”, system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego.
Jeżeli opis zostanie wprowadzony, dokument zostanie wygenerowany z opisem analitycznym.
Przy odznaczonej opcji „Generowanie dokumentu bez OA” system wymaga aby opis analityczny był wprowadzony.
Przy odwiązywaniu dokumentu z formatki „Dokument ERP XL” pozostaw w dokumentach powiązanych
Z poziomu formatki „Dokument ERP XL” istnieje możliwość odwiązania dokumentu ERP XL za pomocą przycisku 
.
Funkcjonalność ta jest powiązana z kontrolką typu „Dokumenty związane” oraz formatką ERP XL „Historia związanych”.
W momencie odwiązywania dokumentu usuwane są informacje o powiązaniu obu dokumentów.
Po zaznaczeniu na właściwościach kontrolki „Dokument ERP XL” opcji „Po odwiązaniu pozostaw w dokumentach związanych”, informacja o związaniu dokumentów nie jest usuwana.
W sytuacji, gdy w kontrolce Dokument ERP XL za pomocą przycisku nastąpi próba odpięcia dokumentu wygenerowanego w systemie Comarch ERP XL, wyświetlany jest komunikat jak poniżej:
Wybranie odpowiedzi „Tak”, spowoduje odwiązanie dokumentu, wybranie odpowiedzi „Nie” lub kliknięcie poza komunikatem spowoduje zamknięcie komunikatu i powrót do edycji dokumentu.
Edycja wartości w kontrolce Dokument ERP XL
W Comarch DMS umożliwiono edycję wartości w kolumnach:
- CenaN,
- CenaB,
- Wartość netto
- Wartość brutto
na dokumencie ERP XL.
Zmiana wartości w jednej z tych kolumn powoduje przeliczenie wartości w pozostałych kolumnach.
Funkcjonalność dostępna jest dla typów dokumentów:
- (A)Faktura zakupu
- Faktura zakupu (w trybie elementowym)
- (A)Korekta faktury zakupu
- (A)Faktury sprzedaży
- (A)Faktura zakupu uproszczona
- Zamówienie zakupu (w trybie elementowym)
Parametr ‘Cena z dokładnością do groszy’
Na dokumencie ERP XL udostępniono parametr ‘Cena z dokładnością do groszy’.
Zaznaczenie parametru powoduje zaokrąglanie wprowadzonej ceny netto i brutto do dwóch miejsc po przecinku.
Odznaczenie parametru pozwala użytkownikowi na wprowadzenie ceny netto i ceny brutto z dokładnością do czterech miejsc po przecinku.
W przypadku, gdy:
- w Comarch ERP XL w konfiguracji (System/Konfiguracja/Sprzedaż/Rabaty i promocje) odznaczono parametr ‘Rabaty liczone od ceny’
i
- w Comarch DMS odznaczono parametr ‘Cena z dokładnością do groszy’
dla dokumentów:
- (A)Faktura zakupu,
- Faktura zakupu (w trybie elementowym),
- (A)Korekta faktury zakupu,
- (A)Faktury sprzedaży
cena będąca podstawą naliczania VAT będzie zaokrąglana analogicznie jak w Systemie Comarch ERP XL.
Zaznaczenie w Comarch ERP XL parametru ‘Rabaty liczone od ceny’ umożliwi wprowadzanie wartości z dokładnością do czterech miejsc po przecinku.
Prezentacja numeru rachunku bankowego kontrahenta w kontrolce Dokument ERP XL
Funkcjonalność jest znowu dostępna od wersji Comarch DMS 2020.2.2. we współpracy z Comarch ERP XL w wersjach nowszych niż 2019.0.
W kontrolce typu Dokument ERP XL prezentowany jest numer rachunku bankowego i adresu płatnika. Dane płatnika pobierane są na podstawie informacji zawartych na karcie kontrahenta wskazanego w polu Kontrahent.
Pole zawierające Rachunek bankowy/ Adres płatnika zostało udostępnione dla dokumentów: FZ, (A)FZ i dla uproszczonej (A)FZ. W polu prezentowane są informacje w następującej kolejności:
1. numer rachunku bankowego płatnika przypisany do adresu płatnika
2. nazwa płatnika
3. adres płatnika
Domyślna wartość prezentowana w polu Rachunek bankowy/ Adres płatnika pobierana jest z aktualnego adresu ustawionego na karcie płatnika w systemie Comarch ERP XL.
Gdy na karcie płatnika zdefiniowano więcej niż jeden adres, na rozwijanej liście wyświetlane są dane ze wszystkich zdefiniowanych adresów.
W przypadku, gdy na karcie kontrahenta ustawiono płatnika będącego urzędem, pracownikiem lub bankiem pole Rachunek bankowy/ Adres płatnika jest nieaktywne i nie prezentuje danych.
W przypadku, gdy do kontrolki typu Dokument ERP XL dowiązano istniejący dokument z systemu Comarch ERP XL, pole Rachunek bankowy/ Adres płatnika jest nieaktywne i nie prezentuje danych.
