Dokument elektroniczny

Kontrolka typu „Dokument elektroniczny” służy do prezentowania podglądu szczegółów dokumentów z programu Comarch ERP XL. Po zaczytaniu dokumentu system prezentuje numer systemowy dokumentu.

 

Na definicji kontrolki dostępne są następujące 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.
  • Nazwa spółki – wyświetlana, gdy DMS pracuje w trybie wielospółkowym.
  • Typ – parametr służący określeniu typu dokumentu Comarch ERP XL, który będzie możliwy do podpięcia w kontrolce.
  • 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”.
  • 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.

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

  • nie można używać nawiasów kwadratowych
  • nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

Kontrolka może być wykorzystywana do wiązania dokumentów z systemu Comarch ERP XL.

Wiązanie jest możliwe jedynie w aplikacji stacjonarnej. Odbywa się poprzez otwarcie formatki z listą dokumentów zdefiniowanego typu i wskazanie dokumentu. Funkcjonalność działa w oparciu o uprawnienia operatora Comarch ERP XL, w kontekście którego wykonywane jest wiązanie.

 

Wskazówka
Została wprowadzona funkcjonalność umożliwiająca dowiązanie dokumentu Faktura zakupu A-vista w widoku formatki zwykłej lub uproszczonej. Na liście typów dokumentów w kontrolce „Dokument elektroniczny” prezentowane są wartości: „Faktura zakupu a-vista” i „Faktura zakupu a-vista uproszczona”. Uproszczona formatka pojawi się, gdy aplikacja Comarch DMS współpracuje z systemem Comarch ERP XL w wersji 2016.3.3 lub wyższej.

 

Kontrolka Dokument elektroniczny i jej właściwości

 

Prezentowanie wartości pobranych z kontrolki elektronicznej w kontrolkach prostych

Aplikacja Comarch DMS umożliwia powiązanie kontrolek prostych z kontrolkami elektronicznymi. Dzięki tej funkcjonalności możliwe jest zaprezentowanie wartości pobranej z kontrolki elektronicznej (ze wskazanego pola bazy danych) w kontrolce prostej.

W kontrolce elektronicznej należy określić typ dokumentu („Typ”).

W kontrolce prostej należy pozostawić w polu „Inicjowanie” wartość „Brak”, a następnie wypełnić pole „Dokument” poprzez wybór nazwy (identyfikatora) wcześniej zdefiniowanej kontrolki elektronicznej oraz wskazać na liście („Pole”) kolumnę z bazy danych.

 

Wskazówka

Kolumny wyświetlane w ramach kontrolki „Pole” pochodzą z tabeli:

  • cdn.Tranag (jeśli dokument elektroniczny należy do jednego z następujących typów: „Deprecjacja”, „Faktura eksportowa”, „Faktura sprzedaży”, „Faktura sprzedaży a-vista”, „Faktura VAT RR”, „Faktura wewnętrzna”, „Faktura zakupu”, „Faktura zakupu a-vista”, „Faktura zakupu a-vista uproszczona”, „Korekta kosztu”, „Korekta przychodu wewnętrznego”, „Korekta przyjęcia zewnętrznego”, „Koszt dodatkowy zakupu”, „Paragon”, „Przesunięcie międzymagazynowe przyjęcie”, „Przesunięcie międzymagazynowe wydanie”, „Przychód wewnętrzny”, „Przyjęcie towarów kaucjonowanych”, „Przyjęcie zewnętrzne”, „Przyjęcie zewnętrzne importowe”, „Raport sprzedaży”, „Rozchód wewnętrzny”, „Tax Free”, „Wydanie towarów kaucjonowanych”, „Wydanie zewnętrzne”, „Wydanie zewnętrzne eksportowe”),
  • cdn.ImpNag (jeśli dokument elektroniczny należy do typu „Faktura importowa”),
  • cdn.MemNag (jeśli dokument elektroniczny należy do typu „Nota memoriałowa”, „Uproszczona nota memoriałowa”)
  • cdn.ZamNag (jeśli dokument elektroniczny należy do typu „Oferta na zakup”, „Oferta sprzedaży”, „Zamówienie”, „Zapytanie ofertowe na sprzedaż”, „Zapytanie ofertowe na zakup”),
  • cdn.WysPaczki (jeśli dokument elektroniczny należy do typu „Paczka”);
  • cdn.PrmKarty (jeśli dokument elektroniczny należy do typu „Promocja”)
  • cdn.MagNag (jeśli dokument elektroniczny należy do typu „Przesunięcie  wewnątrzmagazynowe”, „Przyjęcie magazynowe”, „Wydanie magazynowe”)
  • cdn.ReklNag (jeśli dokument elektroniczny należy do typu „Reklamacja sprzedaży” lub „Reklamacja zakupu”)
  • cdn.UmwNag (jeśli dokument elektroniczny należy do typu „Umowy”)
  • cdn.CRMWizytyNag (jeśli dokument elektroniczny należy do typu „Wizyta handlowa”)
  • cdn.Wysylki (jeśli dokument elektroniczny należy do typu „Wysyłka”)
  • cdn.SrwZlcNag (jeśli dokument elektroniczny należy do typu „Zlecenie serwisowe”)

 

Na karcie dokumentu po dodaniu dokumentu z Comarch ERP XL w ramach wybranej kontrolki typu dokument elektroniczny określone w ten sposób wartości zostaną zaprezentowane w kontrolkach prostych.

 

Kontrolka typu „Dokument elektroniczny” z nazwą-identyfikatorem „fz”

 

Wybór kontrolki typu Dokument elektroniczny o nazwie (identyfikatorze) „fz” w polu „Dokument” i
kolumny z bazy danych w polu „Pole”

 

Lista kolumn wyświetlana w polu „Pole” w kontrolce prostej po wyborze w polu „Dokument” kontrolki typu dokument elektroniczny

 

Kontrolki proste z wartościami pochodzącymi z dokumentu dodanego w kontrolce typu dokument elektroniczny („Faktura zakupu”)

 

Możliwość podpięcia korekt dokumentów PZ i PZI

W polach karty obiegu typu Dokument elektroniczny, gdy określono typ dokumentu PZ lub PZI została wprowadzona możliwość podpięcia korekt tych dokumentów. W przypadku, gdy na karcie obiegu należy podpiąć dokument PZ / PZI z bazy Comarch ERP XL, ale dokument posiada korektę, możliwe jest podpięcie dokumentu PZK / PKI.

 

Wybór korekty przyjęcia zewnętrznego

 

Korekta przyjęcia zewnętrznego dodana do kontrolki typu dokument elektroniczny

 

Inicjowanie wartości

Pole Inicjowanie może przyjąć wartość: Brak, SQL OD, SQL ERP (od wersji 2023.1.0) lub C# Script.

  • Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.
  • W przypadku wartości „SQL OD” lub „SQL ERP” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”.

 

Parametr „Inicjuj przy każdym otwarciu dokumentu”

  • Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.

 

Inicjowanie kontrolki za pomocą kodu w języku C#

 

  • Zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.

Uwaga

Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość  SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzi zapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.

W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak” albo wprowadzić brakujące zapytanie.

W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu „Inicjowanie”  tej kontrolki.

Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Dokument 1” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Dokument 2” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytań

Odpinanie anulowanego dokumentu ERP XL z kontrolek elektronicznych

Istnieje funkcjonalność odpinania dokumentów, które zostały anulowane w systemie Comarch ERP XL i znajdowały się na dokumentach w Comarch DMS w kontrolkach: Dokument elektroniczny, Dokument ERP XL i Dane tabelaryczne w kolumnie ‘Dokument elektroniczny’. W sytuacji, gdy spięty dokument osiągnął stan ‘Anulowany’, na dokumencie w Comarch DMS zostaje usunięte powiązanie i numer dokumentu z Comarch ERP XL nie jest prezentowany.