Spis treści – Baza Wiedzy aplikacji Comarch Mobile 2025.1

Zasady pracy z aplikacją Comarch Mobile

Uwaga

Niedozwolona jest sytuacja, kiedy na jednym urządzeniu następuje zalogowanie się i synchronizacja (np. w celach testowych) na użytkownika, który równolegle pracuje produkcyjnie na innym urządzeniu.

Wywołanie synchronizacji na pustej bazie mobilnej spowoduje wyczyszczenie odpowiednich pól i mapowań w systemie Comarch ERP, co będzie skutkowało licznymi problemami w pracy operatora działającego produkcyjne (kłopoty z dodaniem nowych kontrahentów, nieprawidłowa realizacja zamówień). W sytuacji, kiedy występuje potrzeba testowego przesynchronizowania się na aktywnego przedstawiciela/operatora należy wykonać backup bazy systemu ERP i odtworzyć ją obok bazy produkcyjnej, a następnie zalogować się i przesynchronizować z bazą testową.

Generowanie bazy na nowo na urządzeniu i przechowywanie backupów

Aby wygenerować bazę na nowo należy:

Usunąć bazę mobilną znajdującą na urządzeniu w pamięci wewnętrznej w katalogu Documents (nazwa bazy: data.db, baza może być podzielona na kilka plików np. data.db, data.db-shm, data.db-wal – należy usunąć je wszystkie). Po usunięciu mobilnej bazy wszystkie dane zostaną utracone.
Wymusić zamknięcie aplikacji mobilnej z poziomu zarządzania aplikacjami. Należy wejść w [Zarządzanie aplikacjami] wybrać [Comarch Mobile], a następnie opcję [Wymuś zatrzymanie].
Wymusić zatrzymanie można też poprzez reinstalację aplikacji. W tym celu należy uruchomić i zainstalować plik [Vendor.Core.apk] znajdujący się w pamięci wewnętrznej urządzenia w katalogu Documents.
Uruchomić aplikację Comarch Mobile Sprzedaż i wykonać pierwszą synchronizację.

Backupy bazy przechowywane są w pamięci wewnętrznej urządzenia w katalogu MoSBackups. Backupy sprzed konwersji oznaczane są sufiksem 'auto'.

Umożliwienie utworzenia bazy danych i przechowywanie załączników na karcie SD

W aplikacji została wprowadzona możliwość tworzenia bazy danych i przechowywania załączników na karcie SD. Jeżeli użytkownik zaznaczy ustawienia dotyczące używania zewnętrznej pamięci, wówczas baza danych i załączniki będą przechowywana na zewnętrznej pamięci telefonu. Aby skorzystać z tej opcji konieczne jest zaznaczenie ustawień w aplikacji. Opisane ustawienia będą dostępne po umieszczeniu karty pamięci w urządzeniu.

Konfiguracja aplikacji Comarch Mobile Sprzedaż, tworzenie bazy mobilnej

Logowanie

Uwaga

Użytkownik poza standardowym widokiem ma także możliwość pracy w widoku poziomym aplikacji. Funkcjonalność ta dedykowana jest w szczególności użytkownikom tabletów.

Po uruchomieniu aplikacji Comarch Mobile Zakupy zostanie wyświetlone okno logowania się do aplikacji. Aby zalogować się do aplikacji należy podać dane zaprezentowane na screenie.

W przypadku, gdy podane przez użytkownika hasło nie będzie odpowiadać temu zapisanemu w stworzonej bazie mobilnej, wówczas przy próbie logowania do aplikacji zostanie wyświetlony komunikat zaprezentowany poniżej.

Po wybraniu opcji [Tak] wpisane hasło zostanie porównane z tym, które jest zapisane na karcie operatora w systemie Comarch ERP Altum. Jeżeli hasła będą identyczne to przedstawiciel handlowy zostanie zalogowany do aplikacji, a jego hasło zostanie automatycznie zmienione w bazie mobilnej na takie, jak w systemie Comarch ERP Altum.

Uruchomienie aplikacji Comarch Mobile

Szczegółowe informacje odnośnie:

wymagań minimalnych dla urządzeń mobilnych
instalacji aplikacji Comarch Mobile Sprzedaż
licencji potrzebnych do korzystania z aplikacji
konfiguracji systemu Comarch ERP na potrzeby aplikacji Comarch Mobile Sprzedaż

znajdują się TUTAJ.

Uwaga

Niezbędnym elementem do prawidłowego działania aplikacji jest skonfigurowanie połączenia z serwerem, na którym jest uruchomiona usługa Comarch Mobile Server.

Aby uruchomić aplikację Comarch Mobile Sprzedaż należy wybrać ikonę [Comarch Mobile Sprzedaż] w menu [Aplikacje]:

Przygotowanie do uruchomienia Comarch Mobile

W przypadku pierwszego uruchomienia aplikacji Comarch Mobile Sprzedaż zostanie wyświetlony kreator, który pomoże Użytkownikowi odpowiednio skonfigurować połączenie z serwerem i wykonać pierwszą synchronizację (szczegółowy opis poszczególnych kroków znajduje się TUTAJ). Przy kolejnych uruchomieniach pojawi się ekran logowania do aplikacji.

Ekran logowania do aplikacji Comarch Mobile

W przypadku, gdy podane przez użytkownika hasło nie będzie odpowiadać temu zapisanemu w stworzonej bazie mobilnej, wówczas przy próbie logowania do aplikacji zostanie wyświetlony komunikat:

Po wybraniu opcji [Tak] wpisane hasło zostanie porównane z tym, które jest zapisane na karcie operatora w systemie Comarch ERP. Jeżeli hasła będą identyczne to przedstawiciel handlowy zostanie zalogowany do aplikacji, a jego hasło zostanie automatycznie zmienione w bazie mobilnej na takie jak w systemie Comarch ERP.

Krok 1 - Serie

Pierwszym krokiem jaki należy wykonać w celu skonfigurowania systemu Comarch ERP Altum do współpracy z aplikacją Comarch Mobile jest stworzenie nowej serii odległej. W tym celu należy wejść na zakładkę [Konfiguracja]. W sekcji [Dokumenty] należy wybrać przycisk [Serie] i przycisk [Dodaj]. Następnie określamy jej [Kod] i [Nazwę] oraz ustawiamy Typ serii na [Odległy].

PRZEJDŹ DO KROKU 2

Krok 2 - Magazyny

Następnym krokiem jest zdefiniowanie nowego magazynu oddziałowego. Aby to uczynić należy kliknąć na zakładkę [Magazyn] nacisnąć ikonę [Magazyny] i kliknąć przycisk [Dodaj]. W oknie dodawania obiektu określamy Symbol magazynu, jego Nazwę oraz ustawiamy Typ jako [Odległy]. Następnie należy kliknąć [Zapisz].

PRZEJDŹ DO KROKU 3

Krok 3 - Numeratory

Współpraca z Comarch Mobile Zakupy wymaga, aby dla dokumentów wykorzystywanych w aplikacji mobilnej, zdefiniować numeratory, które składają się z następujących członów:

Symbol dokumentu
Numer
Rok kalendarzowy (2-cyfrowy lub 4-cyfrowy)
Miesiąc (opcjonalnie)
Seria dokumentu

Uwaga

Dla dokumentów KP należy ustawić 4-cyfrowy format roku kalendarzowego.

Ważne jest, aby zaznaczyć przy członach: „symbol”, „rok”, „miesiąc” oraz „seria” opcję „Ma wpływ”. Aby edytować numerator należy wybrać zakładkę [Konfiguracja], w sekcji [Dokumenty] kliknąć przycisk [Numeratory]. Na liście numeratorów odnajdujemy pozycję dla żądanego dokumentu i edytujemy ją wg powyższych kryteriów. Jeżeli z danym numeratorem był już wystawiany dokument (przez co niemożliwa jest jego edycja) należy dodać nowy.

Następnie należy nowy numerator przypiąć do typu dokumentu. Aby to zrobić należy przejść na zakładkę [Konfiguracja], w sekcji [Dokumenty] wybieramy przycisk [Typy]. Pojawi się nam okno w wyborem typów dokumentów, następnie wybieramy odpowiedni typ dokumentu i przejściu na zakładkę [Schematy numeracji] podpinamy wcześniej zdefiniowany numerator.

Powyższe czynności edycji/tworzenia i przypinania numeratora należy wykonać dla dokumentów: ZZ, OZ. PRZEJDŹ DO KROKU 4

Krok 4 - Grupa operatorów i operator

Następnym krokiem jest dodanie operatora, który będzie przypisany do Przedstawiciela Handlowego. W tym celu klikamy Konfiguracja\Struktura firmy\Operatorzy i naciskamy przycisk [Dodaj]. W oknie dodawania konta użytkownika wpisujemy Nazwę i Hasło nowego Operatora, a także przypisujemy mu odpowiedniego pracownika po czym zapisujemy zmiany.

Następnie z menu Konfiguracja\ Struktura firmy wybieramy opcję [Grupy operatorów] i dodajemy nową grupę. Uzupełniamy Nazwę, a potem w sekcji [konta nieprzydzielone do grupy] odszukujemy stworzonego chwilę wcześniej operatora i klikamy [Dodaj do grupy].

Uwaga

Ważne, aby do centrum mobilnego była przypięta tylko nowostworzona grupa operatów (bez grupy B2_default).

Następnym krokiem jest przypięcie odpowiednich typ cen dla grupy operatorów. W tym celu należy na wybranej grupie przejść na zakładkę [Typy cen] i przypiąć przynajmniej jeden typ ceny przychodowej:

Kolejnym krokiem jest zapisanie grupy, ponowne wejście w jej edycje i przejście na zakładkę [Obiekty], żeby określić jakie typy dokumentów będzie mógł wystawiać Operator w aplikacji Comarch Mobile Zakupy. W tym celu zaznaczamy odpowiedni Typ obiektu (np. Zamówienie zakupu).

Następnie przechodzimy do zakładki [Dokumenty], odszukujemy na liście definicji żądany typ dokumentu (np. ZZ) i klikamy jego edycję.

Następnie przechodzimy na zakładkę [Diagram] i klikamy 2 razy w strzałkę wejścia do bloku [Zainicjowany]. Po prawej stronie pojawi się lista grup operatorów, na której zaznaczamy grupy, które będą mogły wystawiać ten rodzaj dokumentu.

Następnie wchodzimy w zakładkę [Schemat Numeracji] i zaznaczamy wcześniej zmodyfikowany lub utworzony numerator jako domyślny. Po zakończeniu edycji całość zapisujemy. PRZEJDŹ DO KROKU 5

Krok 5 - Uprawnienia

Aby Przedstawiciel mógł również korzystać z funkcji CRM-owych (np. pobieranie zadań z terminarza) grupę operatora mobilnego należy przypiąć do centrum lokalnego (operator powinien móc zalogować się również do Comarch ERP Altum) Dla operatora można określić, czy będzie on widział w aplikacji Comarch Mobile Zakupy ceny zakupu towarów oraz wysokość marży na elemencie/dokumencie. Aby operator miał do nich wgląd, należy w Comarch ERP Altum zaznaczyć dla mobilnej grupy operatorów uprawnienie: [Dostęp do cen zakupu] (zakładka [Inne uprawnienia])

Nadanie uprawnień do widoczności cen zakupu oraz marży

Dodatkowo, istnieje możliwość nadania operatorowi prawa do edycji terminu płatności. W tym celu należy zaznaczyć jako [Aktywny] uprawnienie: [Prawo do edycji terminu płatności].

PRZEJDŹ DO KROKU 6

Krok 6 - Centrum mobilne

Po skonfigurowaniu grupy operatorów wymagane jest utworzenie centrum mobilnego. Aby to zrobić należy w menu głównym wybrać zakładkę [Konfiguracja], nacisnąć przycisk [Struktura Firmy], następnie przycisk [Struktura praw]:

Następnie po wybraniu odpowiedniej firmy lub centrum należy nacisnąć przycisk [Dodaj oddziałowe] i z rozwijanego menu wybrać opcję [Mobile]:

Pojawi nam się okno, w którym należy wpisać nazwę nowego centrum. Typ zostanie ustawiony automatycznie. Możemy również dodać opis centrum oraz stworzyć pieczątkę dla tego centrum.

W zakładce [Operatorzy] dodajemy utworzoną grupę operatorów. Następnie po naciśnięciu przycisku [Dostępność obiektów] użytkownikowi zostanie zaprezentowane poniższe okno:

Na pozycjach [Magazyny], [Rejestry kasowo-bankowe], [Formy płatności], [Rejestry VAT], [Typy cen], [Serie], [Grupy kontrahentów] oraz [Grupy atrybutów] przypinamy odpowiednie obiekty, które zdefiniowaliśmy wcześniej. Aby to zrobić należy wybrać odpowiednią pozycję np.: Serie, po naciśnięciu pokaże się nam okno, w którym przy pomocy przycisku [Dołącz] możemy przypiąć zdefiniowaną wcześniej serię mobilną.

Obiekty konieczne do udostępnienia w centrum mobilnym

Należy pamiętać o zaznaczeniu typów dokumentów na seriach, wchodząc w odpowiednią serie i zaznaczając flagi przy dokumentach.

Udostępnianie serii dla danego typu dokumentu

Po podpięciu wszystkich pól należy zapisać grupę. PRZEJDŹ DO KROKU 7

Krok 7 - Kontrahenci

W aplikacji jest możliwość pobierania wszystkich kontrahentów oraz grup kontrahentów, których opiekunem jest dany przedstawiciel. Funkcjonalność ta daje większą elastyczność podczas wyznaczania zakresu pracy przedstawicieli poprzez określenie tych kontrahentów, którzy mają być obsługiwani przez danego przedstawiciela handlowego.

Aby do aplikacji byli pobierani kontrahenci, którymi opiekuje się dany przedstawiciel, należy na centrum mobilnym zaznaczyć parametr [Pobieranie kontrahentów wg opiekuna].

Ustawienie na centrum mobilnym: pobieranie kontrahentów według opiekuna

W systemie Comarch ERP Altum nie trzeba tworzyć dodatkowych grup, podziałów, wystarczy przypisać opiekuna (pracownika), na grupie czy danym kontrahencie lub na rejonie z poziomu aplikacji webowej Comarch Mobile Zarządzanie. Należy również pamiętać o sprawdzeniu na zakładce Dostępność czy centrum mobilne ma odpowiednie uprawnienia.

PRZEJDŹ DO KROKU 8

Krok 8 - Artykuły

W Comarch ERP Altum (od wersji 2018.1) na karcie artykułu na zakładce dostępność jest możliwość określenia, w których centrach struktury artykuł jest dostępny, które centrum struktury praw posiada uprawnienia właściciela artykułu, oraz które centra mają uprawnienia do modyfikacji danego artykułu.

Również, grupa do której należy artykuł powinna być udostępniona dla centrum Mobilnego z poziomu [Dostępności obiektów].

Dostępność obiektów, udostępnienie grupy towarowej

PRZEJDŹ DO KROKU 9

Wielofirmowość

Spis treści

Dostępność kontrahentów Atrybuty wielofirmowe

W systemie została wprowadzona obsługa wielofirmowości tj. każde centrum podrzędne (w tym centrum Mobile) działa w kontekście którejś z firm. Na każdym centrum na zakładce Firma, znajdują się dane firmy (NIP, nazwa, adres itd.) do której określone centrum jest przypięte. Zmiany wprowadzane z poziomu danej Firmy (np. ograniczenia widoczności), zmiana na obiektach dotyczących tylko danej firmy (oddzielne) dotyczą także jednostek podrzędnych przypisanych do tej firmy. Obsługa wielu firm w jednej bazie danych wymaga zablokowania możliwości współdzielenia wybranych obiektów pomiędzy firmami. Dodano ograniczenie dostępności pomiędzy firmami dotyczy przede wszystkim:

magazynów,
rejestrów kasowo-bankowych,
rejestrów VAT,
okresów obrachunkowych.

Wystawiane dokumenty są dodawane w kontekście jednej firmy. Na dokumencie ustawia się jako Właściciel: centrum, z poziomu którego został wystawiony dokument. Aby zapewnić widoczność dokumentów w np. innej firmie, należy dołączyć tą firmę na definicji dokumentu – na zakładce [Widoczność]. Firma główna pozwala na zarządzanie dostępnością obiektów i uprawnieniami poszczególnych firm podpiętych do Firmy głównej – zawiera zbiór (sumę) wszystkich obiektów ze wszystkich firm. Również działalność operacyjną, handlową można prowadzić na poziomie Firmy głównej. Z tego względu Firma główna (węzeł główny) również zawiera własne obiekty (niewspółdzielone z innymi firmami) – do wykorzystania dla użytkowników, którzy zalogują się i będą pracować bezpośrednio z poziomu Firmy głównej. Magazyny oraz rejestry Firmy głównej mają zaznaczoną opcję [dedykowany dla Firmy głównej].

Uwaga

Aby zapewnić bardziej elastyczne zarządzanie uprawnieniami do obiektów w rozgałęzionej strukturze wielofirmowej został udostępniony w Comarch ERP Altum dedykowany panel do zarządzania dostępnością obiektów w centrach struktury praw.

„Dostępność obiektów” – panel dostępny z poziomu edycji/dodawania dowolnego centrum/Firmy. W panelu [Dostępność obiektów] wprowadzono opcję dla centrów dodawanych niżej, pod firmą [Pobierz z nadrzędnego], umożliwiającą szybsze skonfigurowanie centrum wg ustawień pobieranych z firmy lub centrum ustawionego wyżej.

Uwaga

Dla centrum oddziałowego Mobile (ze względu na specyfikę obiektów oddziałowych), ustawienie „Pobierz z nadrzędnego” dotyczy tylko ustawień:

Rejestry VAT,
Typy cen,
Typy kursów

Pozostałe ustawienia (Magazyny, Rejestry kasowo-bankowe, Formy płatności, Serie, oraz Grupy kontrahentów i Artykułów) muszą zostać określone bezpośrednio dla danego centrum mobilnego.

Dostępność kontrahentów

Oprócz ustawień na centrum mobilnym dotyczącym pobierania kontrahentów według opiekunów lub grup wprowadzona jest możliwość określania widoczności oraz uprawień do modyfikacji danej karty kontrahenta. Aby karta kontrahenta została pobrana do Comarch Mobile Zakupy, na firmie, która jest Właścicielem danej karty musi być dołączone centrum mobilne danego przedstawiciela. Ta karta kontrahenta będzie dostępna do edycji w aplikacji mobilnej, jeśli dla centrum mobilnego została zaznaczona opcja [Modyfikacja].

Ustawienie dostępności danej karty kontrahenta w centrum mobilnym

Uprawnienia na grupie operatorów do modyfikacji i dodawania kart kontrahentów

Dodatkowo – oprócz określenia na karcie kontrahenta centrów, które mają mieć prawo do modyfikacji danej karty kontrahenta – możliwość modyfikacji oraz dodawania nowej karty kontrahenta w aplikacji, została uzależniona od uprawnień do obiektu: Kontrahent na grupie operatorów (przypiętej do centrum mobilnego).

Uprawnienia na grupie operatorów, zakładka: Obiekty

Kontrahent wewnętrzny

W aplikacji istnieje możliwość stworzenia kontrahenta wewnętrznego w celu powiązania centrum typu Firma, a kartą danego kontrahenta jest on pobierany do Comarch Mobile Zakupy analogicznie jak pozostali kontrahenci, wg tych samych zasad (dostępności, widoczności), różni się w stosunku do innych kontrahentów tylko brakiem możliwości edycji.

Atrybuty wielofirmowe

Atrybuty wielofirmowe to złożone informacje dodatkowe, które mogą przyjmować różne wartości w zależności od firmy w kontekście, której działa pracownik. Comarch Mobile również obsługuje ten typ atrybutów – do aplikacji pobierane są wartości zdefiniowane dla firmy, do której należy dane centrum mobilne.

Ustawianie wartości atrybutu w zależności od firmy

Krok 9 - Zatowarowanie magazynu mobilnego

Aby móc dokonywać sprzedaży bezpośredniej konieczne jest skonfigurowanie dokumentów MM- (dla wydań) oraz MM+ (dla przyjęć) wchodząc w [Konfiguracja] / [Struktura firmy] / [Struktura praw] / [Centrum mobilne] / [Dokumenty], a następnie dokumenty MM- i MM+. Podczas konfiguracji dokumentu MM- należy pamiętać aby:

magazyn mobilny był magazynem domyślnym
na definicji dokumentu dodać magazyn lokalny

Konfiguracja magazynów na definicji dokumentu MM-

Podczas konfiguracji dokumentu MM+ należy pamiętać aby:

magazyn lokalny był magazynem domyślnym
na definicji dokumentu dodać magazyn mobilny

Aby towary przesunąć na magazyn mobilny należy z poziomu Comarch ERP Altum wystawić dokument MM- na magazyn mobilny, a następnie wygenerować do niego MM+ i go zatwierdzić. Po wykonaniu synchronizacji na urządzeniu mobilnym wygenerowany dokument przesunięcia pojawi się na liście przyjęć. Niezrealizowane przyjęcie wyświetla się w kolorze zielonym, a towary z tego dokumentu widoczne są w aplikacji na liście towarów do przyjęcia. W przypadku dokonywania zwrotu, w aplikacji dostępne są dwie opcje – możliwe do zmiany z poziomu kafelka [Ustawienia]:

zwrot ręczny – sami wybieramy, które chcemy dodać na dokument MM-
zwrot automatyczny – po wybraniu opcji Zwróć, wszystkie towary z niezerowymi stanami na magazynie mobilnym dodawane są do koszyka automatycznie

Rozszerzalność aplikacji

Istnieje możliwość modyfikacji standardowego wyglądu oraz działania aplikacji poprzez integracje z zewnętrzną aplikacją. Możliwości, jakie daje funkcjonalność to:

rozszerzanie górnego paska aplikacji (ActionBara) w głównym oknie listy kontrahentów o nowe elementy, rozszerzanie ActionBara w oknie dokumentu, pozycji dokumentu, raportu, terminarza, zlecenia serwisowego, czynności serwisowych o nowe elementy,
rozszerzanie dużej kalkulacji pozycji na dokumentach (ukrywanie kontrolek, dodawanie nowych,
modyfikacja istniejących np. poprzez zmianę tekstu lub koloru),
rozszerzanie karty kontrahenta (ukrywanie kontrolek, dodawanie nowych oraz modyfikacja istniejących).

Oprócz zmiana interfejsowych możliwe jest także rozszerzanie procesu synchronizacji o nowe elementy, w celu prze synchronizowania dodatkowych tabel/obiektów z systemu ERP. Więcej informacji i rozszerzalności aplikacji znajduje się TUTAJ.

Ukrywanie i zmiana kolejności elementów w aplikacji

Istnieje możliwość ukrywania oraz zmiany kolejności elementów aplikacji. Poszczególne elementy można ukrywać dokonując zmian w pliku ListPositions, znajdującym się w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\ViewsConfiguration. Poszczególne sekcje w pliku odpowiadają za ukrywanie:

elementów menu głównego aplikacji:

<activity name=”comarch.mobile.vendor.core.activities.MainActivity”>

danych na karcie kontrahenta:

<activity name=”com.comarch.mobile.vendor.core.adapters.ContractorAdapter”>

danych na karcie dodawania nowego kontrahenta:

<activity name=”com.comarch.mobile.vendor.core.fragments.AddContractorFragment”>

danych na dokumencie:

<activity name=”com.comarch.mobile.vendor.documents.adapters.DocumentHeaderAdapter”>

danych na pozycji dokumentu:

<activity name=”com.comarch.mobile.vendor.documents.controls.DocumentPositionHeaderLinearLayout”>

danych na pozycji dokumentu RLS:

<activity name=”com.comarch.mobile.vendor.documents.controls.ComplaintDocumentPositionHeaderLinearLayout”>

Przyklad

Aby ukryć element menu głównego Dzień należy zmienić wpis “VISIBLE” na “INVISIBLE”, np: <position name="DAY" visibility="INVISIBLE" />

Jeżeli natomiast chodzi o zmianę kolejności elementów w aplikacji, to należy zmienić kolejność wierszy w pliku ListPositions. Po wykonaniu synchronizacji elementy w aplikacji powinny wyświetlić się w nowej kolejności. Istnieje także możliwość przypisania konkretnego widoku aplikacji dla konkretnego użytkownika. W tym celu należy w katalogu ViewsConfiguration utworzyć nowy folder o nazwie danego użytkownika i wkleić zmodyfikowany plik ListPositions.xml.

Przyklad

Uproszczenie menu głównego do takiego jakie było w pierwszej wersji aplikacji Comarch Mobile Sprzedaż (widoczne elementy: Kontrahenci i Terminarz)

Ukrywanie elementów w menu głównym (z prawej strony: okno menu głównego przed zmianami, z lewej: okno menu głównego po zmianach)

Fragment pliku ListPosition po zmianach: <activity name="com.comarch.mobile.vendor.core.activities.MainActivity"> <position name="DAY" visibility="INVISIBLE" /> <position name="CALENDAR" visibility="VISIBLE" /> <position name="CONTRACTORS" visibility="VISIBLE" /> <position name="MESSAGES" visibility="INVISIBLE" /> <position name="SERVICE" visibility="INVISIBLE" /> <position name="DOCUMENTS" visibility="INVISIBLE" /> <position name="ITEMS" visibility="INVISIBLE" /> <position name="CASH" visibility="INVISIBLE" /> <position name="REPORTS" visibility="INVISIBLE" /> <position name="SYNC" visibility="VISIBLE" /> <position name="SYNCSTATE" visibility="VISIBLE" />

Dodawanie niestandardowego filtra do listy

Dodawanie filtra

W celu dodania niestandardowego filtra do listy towarów lub kontrahentów należy przygotować odpowiedni plik xml i umieścić go na serwerze synchronizacji.

Wskazówka

Definicje filtrów znajdują się domyślnie w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\CustomFilters.

Usuwanie filtra

Aby usunąć dodany filtr należy zmienić jego ID na ujemne, następnie zmienić datę modyfikacji (np. poprzez ponowne zapisanie pliku z filtrem) i wykonać synchronizację.

Elementy składowe filtra

Każda definicja filtra składa się z klauzuli wstępnej języka xml: <?xml version="1.0" encoding="UTF-8"?>, po której w sekcji customFilter z parametrem objectType o odpowiedniej wartości: contractorsList (filtr pojawi się na liście kontrahentów) lub itemsList (filtr pojawi się na liście towarów) następują wymienione poniżej sekcje:

joinClause (np. JOIN Visits ON Contractors.Id = Visits.ContractorId)
whereClause (np. Visits.PlannedStartDate < @@CUSTOM_FILTER_VALUE@@)
groupByClause (np. Visits.ContractorId)
havingClause
inputType (możliwe wartości: text, date)

Sekcje te (oprócz inputType) są częścią zapytania wykonywanego przez aplikację mobilną w celu wyświetlenia elementów listy towarów bądź listy kontrahentów (np. SELECT * FROM Contractors [joinClause] [whereClause] [groupByClause] [havingClause]). Wartość parametru inputType podawana przez użytkownika aplikacji po wyborze filtra pobierana jest do zapytania SQL za pomocą parametru @@CUSTOM_FILTER_VALUE@@.

Uwaga

Podczas synchronizacji definicji filtrów na urządzenie brana jest pod uwagę data modyfikacji pliku. W celu wymuszenia synchronizacji filtra należy wykonać dowolną modyfikację i zapisać ponownie plik z definicją.

Przykład

Poniższa definicja filtra pozwala na wyświetlanie na liście kontrahentów tylko tych, na których zostały wystawione dokumenty z datą realizacji późniejszą niż wskazana w parametrze filtra.

<?xml version="1.0" encoding="UTF-8"?>

<customFilter objectType="contractorsList">
<joinClause>LEFT JOIN Documents ON Contractors.Id = Documents.MainContractorId</joinClause>
<whereClause>Documents.ExecutionDate &gt; '@@CUSTOM_FILTER_VALUE@@'</whereClause>
<inputType>date</inputType>
</customFilter>

Tak zdefiniowany filtr zapisany w katalogu CustomFilters pod nazwą 2#Data realizacji po.xml, po synchronizacji w aplikacji mobilnej prezentuje się w następujący sposób:

Ustawienie domyślnej waluty na karcie kontrahenta

W aplikacji Comarch Mobile Zakupy istnieje możliwość ustawienia domyślnej waluty, która będzie wyświetlana na karcie kontrahenta. Walutę ustawia się w zakładce [Handlowe], w sekcji [Domyślne warunki handlowe].

Informacja o domyślnej walucie na karcie kontrahenta w systemie Comarch ERP Altum

Operator, który ma uprawnienia do edycji karty kontrahenta może również zmieniać rodzaj waluty na tej karcie. Uprawnienie to nadaje się w systemie Comarch ERP Altum na grupie operatorów, w zakładce [Obiekty- Kontrahent: Modyfikacja].

Załączniki

Do Comarch Mobile Zakupy są pobierane te załączniki, które:

Jako Właściciela załącznika mają ustawioną opcję [Wszyscy] lub [Firmę], do której przypięte jest centrum mobilne,
Mają ustawioną dostępność w Mobile.

Uwaga

Aby zdjęcia mogły się poprawnie wyświetlać na urządzeniu i nie powodowały przepełnienia pamięci, w czasie synchronizacji są automatycznie zmniejszane do rozmiarów x na 1024 pikseli. Niektóre urządzenia umożliwiają jednak bezproblemową obsługę większych zdjęć. Aby zmienić wielkość synchronizowanych zdjęć należy w katalogu [Methods] w folderze serwera Comarch Mobile Zakupy odnaleźć plik [articlesphotos] i wyedytować go w notatniku, podając długość dłuższej krawędzi zdjęcia.

W aplikacji Comarch Mobile została jest możliwość dodawania załączników z poziomu aplikacji. Opcja ta dotyczy następujących obiektów:

Karty kontrahenta,
Karty towaru,
Nagłówka następujących dokumentów: ZZ, OZ
Pozycji następujących dokumentów: ZZ, OZ

W celu usprawnienia synchronizacji zostały dodane ustawienia umożliwiające ręczne sterowanie takimi parametrami synchronizacji załączników jak automatyczna zmiana rozmiaru zdjęć czy ich kompresja. W pliku articlesphotos.configuration znajdującym się w folderze (…)\Comarch Mobile\Serwer synchronizacji\Methods\articlesphotos dostępne są następujące parametry:

Size – maksymalny rozmiar boku zdjęcia (w pikselach) w przypadku włączonej opcji automatycznej zmiany rozmiaru załącznika
DoResize – czy ma być wykonana automatyczna zmiana wielkości załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba załączników w wysokiej rozdzielczości, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
DoCompression – czy ma być wykonana automatyczna kompresja załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba nieskompresowanych załączników, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
MultiThreading – wielowątkowe tworzenie pliku wymiany z załącznikami. Wartość domyślna – False. Włączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Użycie trybu może skutkować wzrostem obciążenia CPU, szczególnie w momencie wykonywania pierwszej synchronizacji załączników jednocześnie przez kilku operatorów.

Uwaga

Przed zmianą parametrów synchronizacji na środowisku produkcyjnym zaleca się zbadanie ich wpływu na środowisku testowym, w celu dobrania optymalnych wartości dla danej bazy danych

Ukrywanie kwoty przyznanego i wykorzystanego limitu kredytowego kontrahenta

W aplikacji Comarch Mobile Zakupy istnieje możliwość ukrywania niektórych informacji dotyczących limitu kredytowego, takich jak:

Wartość bieżącego limitu kredytowego,
Wykorzystana kwota limitu kredytowego,
Dozwolona ilość po przekroczeniu terminu,
Kwota następnego limitu kredytowego,
Dozwolona wielkość po przekroczeniu terminu dla następnego limitu kredytowego.

Umożliwiono również pobieranie limitów kredytowych w walutach obcych. Jeżeli limit kredytowy dla danego kontrahenta został zdefiniowany w systemie w innej walucie i na karcie Kontrahenta waluta obca ustawiona jest jako domyślna wówczas limit kredytowy na karcie Kontrahenta w aplikacji wyświetla się w walucie obcej.

Ustawienie limitu kredytowego na kontrahencie

Ustawienie domyślnej waluty na karcie kontrahenta

W plikach konfiguracyjnych znajdujących się w katalogu Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [IsContractorsCreditLimitsValueVisible], odpowiedzialny za ukrywanie/odkrywanie informacji o przyznanej oraz wykorzystanej kwocie limitu. Dzięki tej funkcjonalności przedstawiciel handlowy będzie miał dostęp tylko do kwoty limitu pozostającej do wykorzystania przez kontrahenta oraz kwot dozwolonych po terminie i przeterminowanych. Domyślna wartość tego parametru jest wartość „1”. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Obsługa programów lojalnościowych

Spis treści

Struktura definicji programu lojalnościowego Elementy w definicji program lojalnościowego Synchronizacja punktów lojalnościowych kontrahentów Rozliczanie punktów w systemie Comarch ERP Altum

W aplikacji Comarch Mobile Zakupy jest możliwość obsługi programów lojalnościowych. Umożliwiono pobieranie z systemu ERP punktów lojalnościowych zgromadzonych na kontach określonych kontrahentów za zakup poszczególnych towarów. Zebrane punkty mogą zostać wykorzystane w aplikacji mobilnej do nadania rabatów. Aby umożliwić rozliczanie punktów lojalnościowych z poziomu aplikacji Comarch Mobile Zakupy, należy:

stworzyć definicję programu lojalnościowego zgodnego ze swoimi założeniami oraz wymaganiami opisanymi w dalszej części dokumentu,
obsłużyć synchronizację punktów lojalnościowych kontrahentów,
włączyć obsługę programu lojalnościowego w pliku configuration.*.statement, poprzez zmianę wartości klucza [IsLoyaltyEnabled] na 1.

Struktura definicji programu lojalnościowego

Przygotowane definicje programów lojalnościowych należy umieścić w pliku z rozszerzeniem XML w katalogu [LoyaltyProgramsDefinitions] katalogu głównego serwera synchronizacji Mobile. Nazwa pliku musi składać się z <IdProgramuLojalnosciowego>#<NazwaProgramuLojalnosciowego>.xml

Przyklad

12#NaszaLojalnosc.xml

Synchronizacja definicji do urządzeń mobilnych odbywa się po każdej modyfikacji w plikach definicji. Aby usunąć już zsynchronizowaną definicję z urządzeń mobilnych należy zmienić id programu na wartość ujemną. Taka definicja zostanie usunięta przy następnej synchronizacji.

Przyklad

-12#NaszaLojalnosc.xml

<?xml version=”1.0″ encoding=”UTF-8″?> <LoyaltyProgram>

…

</CheckContractorStatusQuery>

…

</CheckArticleStatusQuery>

…

</InitialMessageQuery>

…

</AfterRemovePositionLoyaltyProgramQuery>

…

</AfterAddPositionLoyaltyProgramQuery>

…

</AfterRemoveDocumentLoyaltyProgramQuery>

…

</AfterAddDocumentLoyaltyProgramQuery>

</LoyaltyProgram>

Elementy w definicji program lojalnościowego

Name – Nazwa program lojalnościowego
SettleDocumentsValue – flaga bitowa określająca, na jakich dokumentach bierze udział program lojalnościowy. Poszczególne typy dokumentów będą miały przyporządkowane wartości:

1 – OS

2 – ZS

4 – FS

8 – PA

16 – WZ

32 – WM

Wskazówka

Wartość pola 5 oznaczać będzie, że rozliczenie punktów dostępne będzie na dokumentach OS i FS (1+4).

CheckContractorStatusQuery – Zapytanie sprawdzające czy dany kontrahent bierze udział w programie lojalnościowym oraz zwraca liczbę punktów dostępnych dla kontrahenta. Zwrócenie wiersza oznacza, że kontrahent bierze udział w programie lojalnościowym.
- Parametry wejściowe:
  - @DocumentType – typ dokumentu. Wartość zgodna z wartościami z punktu drugiego.
  - @ContractorId – identyfikator kontrahenta
  - @LoyaltyProgramId – identyfikator programu lojalnościowego
  - @EditedDocumentId – identyfikator dokumentu, który jest teraz aktualnie reedytowany (został tylko zapisany wcześniej, został cofnięty do bufora)
- Kolumny wyjściowe:
  - Liczba punktów dostępnych do zużycia przez kontrahenta
CheckArticleStatusQuery – Zapytanie sprawdzające czy dany towar jest dostępny w danym programie lojalnościowym oraz zwraca liczbę punktów do rozliczenia na pozycji.
- Parametry wejściowe
  - @ArticleId – identyfikator towaru na który wystawiana jest pozycja
  - @StartGrossPrice – początkowa cena brutto
  - @StartNetPrice – początkowa cena netto
  - @Quantity – ilość w jednostce bazowej
  - @AvailablePoints – liczba dostępnych punktów kontrahenta
  - @EditedDocumentId – identyfikator edytowanego dokumentu
  - @VatRate – stawka VAT (np. dla 23% – parametr ten będzie miał wartość 23)
  - @VatDirection – kierunek VAT (0 – Netto, 1 – Brutto)
- Kolumny wyjściowe
  - MaxPointsToSettleValue – maksymalna liczba punktów możliwa do rozliczenia na pozycji
  - EndGrossPrice – końcowa cena brutto na pozycji po rozliczeniu punktów MaxPointsToSettleValue
InitialMessageQuery – Zapytanie tworzące komunikat powitalny.
- Parametry wejściowe
  - @DocumentType – typ dokumentu. Wartość zgodna z wartościami z punktu drugiego.
  - @ContractorId – identyfikator kontrahenta
  - @LoyaltyProgramId – identyfikator programu lojalnościowego
  - @EditedDocumentId – identyfikator dokumentu, który jest teraz aktualnie reedytowany (został tylko zapisany wcześniej, został cofnięty do bufora)
- Kolumny wyjściowe
  - InitialMessageText – komunikat powitalny. Może zawierać proste tagi html’owe w celu sformatowania tekstu. (np. Dodanie nowej linii <br />, Zmiana koloru fragmentu tekstu <font color=”#FF0000″></font>, itd.)
AfterRemovePositionLoyaltyProgramQuery – Zapytanie wykonywane po usunięciu rozliczenia programu lojalnościowego na pozycji. Służy do wycofania zmian wykonanych w AfterAddPositionLoyaltyProgramQuery.
- Parametry wejściowe
  - @LoyaltyProgramId – identyfikator programu lojalnościowego
  - @ProgramName – nazwa programu lojalnościowego
  - @AttributeObjectType – typ atrybutów dla pozycji
  - @ObjectId – identyfikator dokumentu
  - @ObjectIsLocal – identyfikator dokumentu
  - @ObjectSubId – identyfikator pozycji
  - @ObjectSubIsLocal – identyfikator pozycji
- Obsługiwane jest wiele zapytań w ramach tej samej definicji. Separator skryptów „;GO;”
AfterAddPositionLoyaltyProgramQuery – Zapytanie wykonywane po zapisie dokumentu – dla każdej pozycji, która zostaje rozliczona za pomocą programu lojalnościowego.
- Parametry wejściowe
  - @LoyaltyProgramId
  - @ProgramName
  - @SettledPoints
  - @AttributeObjectType
  - @ObjectId
  - @ObjectIsLocal
  - @ObjectSubId
  - @ObjectSubIsLocal
  - @StartGrossPrice – cena początkowa brutto
  - @StartNetPrice – cena początkowa netto
  - @StartGrossValue – wartość brutto
  - @StartNetValue – wartość netto
- Obsługiwane jest wiele zapytań w ramach tej samej definicji. Separator skryptów „;GO;”
AfterRemoveDocumentLoyaltyProgramQuery – Zapytanie wykonywane po usunięciu rozliczenia programu lojalnościowego z dokumentu. Służy do wycofywania zmian wykonanych w
- Parametry wejściowe
  - @LoyaltyProgramId
  - @ProgramName
  - @SettledPoints
  - @AttributeObjectType
  - @ObjectId
  - @ObjectIsLocal
  - @ObjectSubId
  - @ObjectSubIsLocal
- Obsługiwane jest wiele zapytań w ramach tej samej definicji. Separator skryptów „;GO;”
AfterAddDocumentLoyaltyProgramQuery – Zapytanie wykonywane po zapisie dokumentu z rozliczeniem programu lojalnościowego.
- Parametry wejściowe
  - LoyaltyProgramId
  - ProgramName
  - SettledPoints
  - AttributeObjectType
  - ObjectId
  - ObjectIsLocal
  - ObjectSubId
  - ObjectSubIsLocal
- Obsługiwane jest wiele zapytań w ramach tej samej definicji. Separator skryptów „;GO;”

Synchronizacja punktów lojalnościowych kontrahentów

Aby umożliwić synchronizację punktów lojalnościowych kontrahentów należy zaimplementować metody synchronizacji obiektu [contractorsloyaltypoints]:

*.statement – zapytanie pobierające aktualne stany punktów kontrahentów. Zwracane kolumny:
- OperationType – typ operacji (dodawanie, usuwanie, edycja),
- OperationTS – timestamp synchronizacji,
- LoyaltyProgramId – identyfikator programu lojalnościowego,
- ContractorId – identyfikator kontrahenta,
- Points – liczba dostępnych punktów do rozliczenia przez kontrahenta,
- LockedPoints – liczba punktów dostępnych lecz zablokowanych do rozliczenia. Obecnie parametr ten nie jest jeszcze obsługiwany, dlatego zawsze kolumna ta powinna zwracać wartość 0.
contractorsloyaltypoints*.xml – definicja metody synchronizacji, triggery aktualizujące timestampy wierszy

Rozliczanie punktów w systemie Comarch ERP Altum

Rozliczanie punktów należy obsłużyć po stronie systemu Comarch ERP Altum za pomocą triggera wdrożeniowego aktywowanego np. potwierdzeniem dokumentu. Dokładny sposób rozliczenia jest zależny od mechanizmów zaimplementowanych w programie lojalnościowym po stronie systemu Comarch ERP Altum. Program lojalnościowy może zostać oparty poprzez atrybuty zdefiniowane w systemie Comarch ERP Altum. W takiej obsłudze będą brani pod uwagę Kontrahenci, którzy posiadają zdefiniowany atrybut ze wskazaniem programu lojalnościowego (np. Nasza Lojalność), a przedstawiciel będzie mógł nadać rabat tylko na pozycjach towarów oznaczonych też odpowiednim atrybutem.

Dodanie atrybuty na karcie towaru i karcie kontrahenta

Obecne implementacje do przesyłania informacji o liczbie rozliczonych punktów, korzystają z atrybutów (klasa atrybutu tylko do odczytu) ustawianych na pozycjach dokumentów (za pomocą AfterAddPositionLoyaltyProgramQuery) z wartością rozliczonych na pozycji punktów. Podczas synchronizacji do systemu ERP dokumentów, w momencie ich potwierdzenia, w triggerze sprawdzone powinno zostać istnienie atrybutu rozliczającego punkty na pozycjach. Wartość rozliczonych punktów powinna zostać odjęta z puli punktowej kontrahenta. Dodatkowo rozliczenie takie powinno spowodować podbicie odpowiednich timestampów w [contractorsloyaltypoints] w celu wymuszenia synchronizacji aktualnego stanu punktów kontrahenta.

Blokada realizacji działań handlowych dla nowo utworzonego kontrahenta

Aplikacja Comarch Mobile umożliwia blokowanie realizacji działań handlowych dla nowo utworzonego kontrahenta do czasu jego synchronizacji do systemu ERP. Kontrahent dodany w aplikacji Comarch Mobile jest oznaczony ikonką

. Zablokowana zostanie możliwość wystawiania dokumentów handlowych, dokumentów ZSR oraz tworzenia działań CRM we wszystkich miejscach w aplikacji. Aby mieć możliwość wystawiania poszczególnych działań handlowych dla nowo utworzonego kontrahenta konieczne jest wykonanie synchronizacji z systemem ERP.

Uwaga

Za konfigurację tej funkcjonalności odpowiada parametr CanBlockActionsForNewContractorBeforeSynchronization. Wartość parametru należy zmienić w pliku contractors.xl.statement w lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration. Więcej informacji na temat konfiguracji znajduje się TUTAJ.

Po włączeniu parametru CanBlockActionsForNewContractorBeforeSynchronization i utworzeniu nowego kontrahenta w aplikacji Comarch Mobile:

po kliknięciu w sekcję Działania, Serwis oraz Handlowe na karcie kontrahenta zostanie wyświetlony komunikat: "Brak możliwości wykonywania działań handlowych. Dokonaj synchronizacji nowego kontrahenta."

Widok okna informującego o konieczności synchronizacji

po kliknięciu na liście kontrahentów w menu kontekstowym nowego kontrahenta nie jest widoczna opcja "Dodaj dokument"

podczas wystawiania dokumentów w kaflu Dokumenty, Serwis i Kasa lub działania CRM w kaflu Terminarz i Dzień w momencie wyboru kontrahenta, który nie został jeszcze zsynchronizowany z systemem ERP, pojawi się komunikat: "Należy dokonać synchronizacji nowego kontrahenta."

w przypadku kafla Dokumenty, Dzień, Serwis i Terminarz ukryta jest ikonka odpowiedzialna za dodanie nowego kontrahenta

Pobieranie dokumentów historycznych

Aby określony dokument mógł być widoczny w innej firmie, w innym centrum, na definicji dokumentu na zakładce [Widoczność] należy dołączyć odpowiednie centra ze struktury firmy. Przy włączonej obsłudze transakcji historycznych, dokumenty wystawione w innych firmach będą pobierane do Comarch Mobile, o ile centrum mobile zostało dołączone na definicji dokumentu. Aby umożliwić w aplikacji mobilnej pobieranie dokumentów historycznych FS, PAR, WZ, RLS wystawionych w innych centrach niż centrum mobilne, należy na definicji dokumentu na zakładce [Widoczność] wskazać centrum mobilne. Należy wykonać to w kontekście tego centrum, z którego dokumenty chcemy widzieć w aplikacji. Informacje dot. tego, jak włączyć pobieranie dokumentów historycznych w aplikacji znajdują się TUTAJ.

Ustawianie widoczności w centrum mobilnym, dokumentów wystawionych w centrum IT Company PL

Także dokumenty wystawiane bezpośrednio w Comarch Mobile i synchronizowane do systemu mogą być widoczne w innych firmach, jeżeli na centrum mobilnym odpowiednio ustawiono udostępnianie innym firmom swoich dokumentów.

Podczas przypisywania magazynu odległego musi on być pusty, aby przy synchronizacji stany magazynu się zgadzały w aplikacji i ERP.

Uwaga

Na definicji dokumentu ZZ magazynem domyślnym powinien być magazyn lokalny (firmy). W przeciwnym razie nie będzie możliwości wystawienia dokumentu ZZ z poziomu aplikacji mobilnej.

Wystawianie dokumentów ZZ, OZ na kilka magazynów

Aby umożliwić Przedstawicielowi Handlowemu wystawianie dokumentów ZZ (Zamówienie Zakupu) oraz OZ (Oferta Zakupu) na kilka magazynów należy w Comarch ERP Altum zaznaczyć check [Preferuj magazyn domyślny]. Zaznaczenie checku spowoduje możliwość zmiany magazynu podczas wystawiania dokumentu zarówno na nagłówku jak i na samym elemencie.

Konfiguracja systemu Comarch ERP Altum w celu możliwości edycji magazynu podczas wystawiania dokumentów

Odznaczenie wszystkich checków będzie skutkowało tym, że w aplikacji mobilnej nie będzie podpowiadał się na nagłówku dokumentu magazyn domyślny zdefiniowany w systemie Comarch ERP Altum. Po zaznaczenie checku [Operacje na jednym magazynie] będzie skutkować tym, że zmiana magazynu będzie dostępna do momentu aż do koszyka zostanie dodany towar. Dokumenty ZZ, OZ można wystawiać wyłącznie na magazyn lokalny, aplikacja nie kontroluje stanów magazynowych. Więcej informacji o funkcjonalności można znaleźć w dokumencie TUTAJ.

Zmiana kontrahenta podczas wystawiania dokumentu

Dostępna jest funkcja zmiany kontrahenta podczas wystawiania dokumentu. Za tę funkcjonalność odpowiada parametr [CanChangeContractorOnDocument], znajdujący się w pliku konfiguracyjnym w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods. W zależności od wartości tego parametru, przedstawiciel handlowy będzie miał możliwość zmiany kontrahenta w trakcie wystawiania dokumentu, korzystając z ikony ołówka przy kontrahencie na nagłówku dokumentu. Po kliknięciu w ikonę ołówka, wyświetlona zostanie lista kontrahentów.

Wystawianie dokumentów zamówienia zakupu i oferty zakupu w innej walucie

W aplikacji Comarch Mobile Zakupy umożliwiono wystawianie zamówień i ofert sprzedaży w walucie obcej. Podczas wystawiania dokumentów OZ i ZZ na nagłówku dokumentu ustawiana jest waluta domyślna z karty kontrahenta. Aby zmienić walutę domyślną na karcie kontrahenta należy na zakładce [Główne] przejść do katalogu kontrahenci, zakładka [Handlowe] - [Domyślne warunki handlowe]. Dodatkowo operator ma możliwość zmiany waluty oraz jej kursy w zależności od nadanych mu uprawnień. W zależności od wartości parametru [CanChangeCurrency] operator ma możliwość lub blokadę zmiany:

Samej waluty
Samego kursu waluty
Zarówno waluty i kursu waluty

Parametr [CanChangeCurrency] może przyjmować trzy wartości:

1 – zmiana waluty na nagłówku dokumentu możliwa, zmiana kursu waluty niemożliwa – wartość domyślna,
2 – zmiana waluty na nagłówku dokumentu możliwa, zmiana kursu waluty możliwa,
0 – zmiana waluty na nagłówku dokumentu niemożliwa, zmiana kursu waluty na nagłówku dokumentu niemożliwa, wystawienie dokumentu możliwe tylko w walucie zdefiniowanej na karcie kontrahenta.

Wartość parametru należy edytować w pliku configuration.altumx.statement znajdujący się w folderze C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods.

Uwaga

Edycję waluty lub kursu waluty można wykonać jedynie wtedy, gdy w koszyku nie ma jeszcze dodanych towarów.

Obsługa eksportowych stawek VAT

W aplikacji Comarch Mobile umożliwiono dodatkowo oprócz transakcji krajowych z krajowymi stawkami VAT również obsługę eksportowych stawek VAT podczas wystawiania dokumentów ZZ i OZ. Dane dotyczące eksportowych stawek VAT pobierane są z systemu Comarch ERP Altum.

Dużym udogodnieniem jest także to, że typ transakcji na nagłówku dokumentu ustawiany jest zgodnie z typem kontrahenta, dla którego transakcja jest realizowana. Dla kontrahenta Krajowego domyślnie ustawi się zatem transakcja krajowa, dla kontrahenta Unijnego transakcja Wewnątrzwspólnotowa, a dla kontrahenta Pozaunijnego transakcja Inna zagraniczna. Typ Kontrahenta ustawiany w Comarch ERP Altum na karcie kontrahenta w zakładce [Ogólne].

Obsługa odwrotnego obciążenia

W aplikacji Comarch Mobile Zakupy wprowadzona została obsługa odwrotnego obciążenia, czyli procedury odwrotnego naliczania VAT przez nabywcę a nie odbiorcę. Do poprawnego działania odwrotnego obciążenia VAT w aplikacji Comarch Mobile Zakupy wymagane jest ustawienie w Comarch ERP Altum następujących elementów:

Parametru: [Obsługa odwrotnego obciążenia] (System /Konfiguracja/ zakładka: [Handel])

Konfiguracja odwrotnego obciążenia w Comarch ERP Altum

Stawka VAT wskazana w polu [Stawka VAT dla odwrotnego obciążenia] – menu [Konfiguracja], sekcja [Ogólne/ Stawki VAT]

Konfiguracja stawki VAT dla odwrotnego obciążenia

Wartość słownika [Klasyfikacja odwrotnego obciążenia] – menu [Konfiguracja], sekcja: [Ogólne/Słowniki uniwersalne/Ogólne]

Konfiguracja wartości klasyfikacji odwrotnego obciążenia

Parametr [Odwrotne obciążenie] – karta kontrahenta, zakładka [Ogólne]

Parametr Odwrotne obciążenie – do zaznaczenia na karcie kontrahenta

Przypisanie wartości klasyfikacji odwrotnego obciążenia – karta artykułu, zakładka [Ogólne]

Karta artykułu – parametr i wartość klasyfikacji odwrotnego obciążenia

Obsługa odwrotnego obciążenia w aplikacji jest opisana TUTAJ.

Obsługa edycji sposobu dostawy

W aplikacji Comarch Mobile Zakupy jest możliwość przypisania sposoby dostawy dla kontrahenta. W pierwszej kolejności należy dodać rodzaj dostawy w sposobie dostawy, na liście słowników, zgodnie z rysunkiem poniżej.

Dodanie sposobu dostawy na liście słowników

Następnie należy wejść w szczegóły grupy kontrahentów, jeżeli chcemy przypisać jednakowy sposób dostawy dla wszystkich kontrahentów z danej grupy lub wejść w szczegóły kontrahenta, gdy chcemy przypisać sposób dostawy dla konkretnego kontrahenta. Następnie w zakładce [Handlowe] należy wybrać odpowiednią dostawę.

Edycja płatnika na nagłówku dokumentu

Możliwość zmiany płatnika na nagłówku dokumentu została wprowadzona dla dokumentów:

Zamówienie Zakupu (ZZ)
Oferta Zakupu (OZ)

Standardowo w aplikacji wyświetlane są informacje o płatniku ustawione dokumencie w zakładce [Płatności] w systemie Comarch ERP Altum.

Zmiana Płatnika na nagłówku dokumentu Comarch Mobile raz wyświetlanie informacji o płatniku na dokumencie zsynchronizowanym do systemu Comarch ERP Altum

Jeżeli w parametrze [ChangingContractorOnDocumentPermission] została dodana wartość 2, wówczas podczas wystawiania dokumentu, na nagłówku w polu [Kontrahent] pojawia się ikona ołówka oznaczająca możliwość edycji wartości dla Kontrahenta głównego. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Edycja kontrahenta docelowego i głównego na nagłówku dokumentu

Możliwość zmiany kontrahenta docelowego i głównego na nagłówku dokumentu została wprowadzona dla dokumentów:

Zamówienie Zakupu (ZZ)
Oferta Zakupu (OZ)

Za możliwość zmiany kontrahenta głównego i docelowego odpowiada parametr [ChangingContractorOnDocumentPermission] (domyślna lokalizacja: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration). Więcej informacji nt. tego parametru znajduje się TUTAJ.ekcji [Docelowy] wyświetlany jest Kontrahent Główny[/alert]

Agregacja VAT na definicji dokumentów oraz stan realizacji zamówień

Aplikacja Comarch Mobile Zakupy obsługuje agregacje VAT od sumy wartości, dlatego w typie dokumentów, w strukturze praw na centrum mobilnym należy zaznaczyć w sposobie naliczania VAT (zakładka [Ogólne]) [Agregacje VAT od sumy wartości].

Pobieranie informacji o stanie realizacji zamówień z Comarch ERP Altum

Po odpowiedniej konfiguracji istnieje możliwość pobierania informacji o stanie realizacji zamówień z systemu Comarch ERP Altum do Comarch Mobile Zakupy. Przesyłane są informacje: o stanie zamówienia z Comarch ERP Altum, procencie realizacji dokumentu i zmianach jakie zostały naniesione na dokument zamówienia. Konfiguracji należy dokonać na odpowiednim centrum mobilnym: Struktura firmy/Struktura praw/odpowiednie centrum mobilne/ Zakładka [Dokumenty]/ZZ/Zakładka [Ogólne]/Sekcja [Parametry]. W wybranej sekcji należy zaznaczyć opcję [Synchronizuj] informacje o stanie realizacji zamówień.

Parametr synchronizacji informacji o stanie realizacji zamówień

Dodatkowo w aplikacji Comarch Mobile Zakupy powinna zostać włączona opcja pobierania dokumentów z systemu.

Możliwość zatwierdzania dokumentu bez podpisu

W aplikacji istnieje możliwość pominięcia podpisu podczas wystawienia dokumentu. Funkcjonalność ta wymaga zmodyfikowanie pliku documentsnumerators.altum, (Serwer synchronizacji/Methods/documentsnumerators) . Należy dodać warunek dotyczący konkretnego dokumentu na którym chcemy pominąć krok "Podpis”. Poniżej przedstawiono przykład jak skonfigurować funkcjonalność pominięcia kroku z podpisem na dokumencie Zamówienie (ZZ). Przy wystawianiu pozostałych dokumentów podpis będzie wymagany.

WHEN NamespaceEntry = 'Comarch.B2.Sales.Documents.SalesOrderManager' THEN 0 /*ZZ*/ ELSE 1 END AS IsSignatureRequired

Możliwość zatwierdzania dokumentu bez podpisu

Załączniki

Do Comarch Mobile Zakupy są pobierane te załączniki, które:

Jako Właściciela załącznika mają ustawioną opcję [Wszyscy] lub [Firmę], do której przypięte jest centrum mobilne,
Mają ustawioną dostępność w Mobile.

Uwaga

Aby zdjęcia mogły się poprawnie wyświetlać na urządzeniu i nie powodowały przepełnienia pamięci, w czasie synchronizacji są automatycznie zmniejszane do rozmiarów x na 1024 pikseli. Niektóre urządzenia umożliwiają jednak bezproblemową obsługę większych zdjęć. Aby zmienić wielkość synchronizowanych zdjęć należy w katalogu [Methods] w folderze serwera Comarch Mobile Zakupy odnaleźć plik [articlesphotos] i wyedytować go w notatniku, podając długość dłuższej krawędzi zdjęcia.

W aplikacji Comarch Mobile została jest możliwość dodawania załączników z poziomu aplikacji. Opcja ta dotyczy następujących obiektów:

Karty kontrahenta,
Karty towaru,
Nagłówka następujących dokumentów: ZZ, OZ
Pozycji następujących dokumentów: ZZ, OZ

W celu usprawnienia synchronizacji zostały dodane ustawienia umożliwiające ręczne sterowanie takimi parametrami synchronizacji załączników jak automatyczna zmiana rozmiaru zdjęć czy ich kompresja. W pliku articlesphotos.configuration znajdującym się w folderze (…)\Comarch Mobile\Serwer synchronizacji\Methods\articlesphotos dostępne są następujące parametry:

Size – maksymalny rozmiar boku zdjęcia (w pikselach) w przypadku włączonej opcji automatycznej zmiany rozmiaru załącznika
DoResize – czy ma być wykonana automatyczna zmiana wielkości załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba załączników w wysokiej rozdzielczości, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
DoCompression – czy ma być wykonana automatyczna kompresja załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba nieskompresowanych załączników, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
MultiThreading – wielowątkowe tworzenie pliku wymiany z załącznikami. Wartość domyślna – False. Włączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Użycie trybu może skutkować wzrostem obciążenia CPU, szczególnie w momencie wykonywania pierwszej synchronizacji załączników jednocześnie przez kilku operatorów.

Uwaga

Przed zmianą parametrów synchronizacji na środowisku produkcyjnym zaleca się zbadanie ich wpływu na środowisku testowym, w celu dobrania optymalnych wartości dla danej bazy danych

Wyświetlanie ceny i ilości zarówno w jednostce podstawowej jak i domyślnej jednostce pomocniczej podczas wystawiania dokumentów

W aplikacji istnieje możliwość podejrzenia ilości i ceny w jednostce pomocniczej podczas wystawiania dokumentów już z poziomu listy towarów, bez konieczności podnoszenia kalkulacji dla tej pozycji. Funkcjonalność ta jest dostępna podczas wystawiania dokumentów:

Oferta zakupu (OZ)
Zamówienie zakupu (ZZ)

Za tę funkcjonalność odpowiada parametr [IsBaseUnitVisible], który może przyjmować dwie wartości: 1 – wartość domyślna; oznacza widoczność dodatkowej ceny (w jednostce podstawowej) tylko po dodaniu towarów do Koszyka – jeżeli użytkownik zmieni na pozycji z jednostki domyślnej np. szt. na karton. 0 – ilość wyświetlana jest tylko w jednostce domyślnej – na liście pozycji wyświetlana jest ilość na magazynie oraz ilość dodaną na dokument tylko w tej jednej – domyślnej lub wybranej podczas dodawania do Koszyka jednostce. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Załączniki

Do Comarch Mobile Zakupy są pobierane te załączniki, które:

Jako Właściciela załącznika mają ustawioną opcję [Wszyscy] lub [Firmę], do której przypięte jest centrum mobilne,
Mają ustawioną dostępność w Mobile.

Uwaga

Aby zdjęcia mogły się poprawnie wyświetlać na urządzeniu i nie powodowały przepełnienia pamięci, w czasie synchronizacji są automatycznie zmniejszane do rozmiarów x na 1024 pikseli. Niektóre urządzenia umożliwiają jednak bezproblemową obsługę większych zdjęć. Aby zmienić wielkość synchronizowanych zdjęć należy w katalogu [Methods] w folderze serwera Comarch Mobile Zakupy odnaleźć plik [articlesphotos] i wyedytować go w notatniku, podając długość dłuższej krawędzi zdjęcia.

W aplikacji Comarch Mobile została jest możliwość dodawania załączników z poziomu aplikacji. Opcja ta dotyczy następujących obiektów:

Karty kontrahenta,
Karty towaru,
Nagłówka następujących dokumentów: ZZ, OZ
Pozycji następujących dokumentów: ZZ, OZ

W celu usprawnienia synchronizacji zostały dodane ustawienia umożliwiające ręczne sterowanie takimi parametrami synchronizacji załączników jak automatyczna zmiana rozmiaru zdjęć czy ich kompresja. W pliku articlesphotos.configuration znajdującym się w folderze (…)\Comarch Mobile\Serwer synchronizacji\Methods\articlesphotos dostępne są następujące parametry:

Size – maksymalny rozmiar boku zdjęcia (w pikselach) w przypadku włączonej opcji automatycznej zmiany rozmiaru załącznika
DoResize – czy ma być wykonana automatyczna zmiana wielkości załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba załączników w wysokiej rozdzielczości, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
DoCompression – czy ma być wykonana automatyczna kompresja załączników. Wartość domyślna – True. Wyłączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Jeżeli jednak na bazie systemu ERP znajduje się duża liczba nieskompresowanych załączników, zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania w synchronizacji.
MultiThreading – wielowątkowe tworzenie pliku wymiany z załącznikami. Wartość domyślna – False. Włączenie opcji w znacznym stopniu przyśpiesza tworzenie pliku wymiany. Użycie trybu może skutkować wzrostem obciążenia CPU, szczególnie w momencie wykonywania pierwszej synchronizacji załączników jednocześnie przez kilku operatorów.

Uwaga

Przed zmianą parametrów synchronizacji na środowisku produkcyjnym zaleca się zbadanie ich wpływu na środowisku testowym, w celu dobrania optymalnych wartości dla danej bazy danych

Precyzja cen w aplikacji mobilnej

W aplikacji Comarch Mobile Zakupy istnieje możliwość wyboru precyzji ceny na typie ceny oraz na definicji dokumentu, tak aby można było wykorzystywać ceny towarów określane z czterema, trzema lub jednym miejscu po przecinku oraz sprzedawać je w dużych ilościach, np. (100szt. x 1,3333zł = 133,33zł, a 100szt. x 1,33zł= 133,00zł). Aby w aplikacji Comarch Mobile Zakupy we współpracy z Comarch ERP Altum istniała możliwość prezentacji towaru na karcie towaru z precyzją do jednej, dwóch, trzech lub do czterech miejsc po przecinku. W systemie Comarch ERP Altum należy zaznaczyć precyzję na typie ceny [Sprzedaż/Cenniki/Typy cen].

Przypisanie precyzji cen wyświetlanych w aplikacji Comarch Mobile Zakupy na kartotece towaru

Zaznaczenie liczby w polu [Pozycja] spowoduje z cen z dokładnością jednej, dwóch, trzech lub czterech miejsc po przecinku (zgodnie z tym jaka cyfra została wpisana).

Prezentacja ceny na karcie towary z precyzją a) do jednego miejsca po przecinku, b) do dwóch miejsc po przecinku, c) do trzech miejsc po przecinku, d) do czterech miejsc po przecinku

Dodatkowo istnieje możliwość ustawienia precyzji ceny na definicji dokumentu na centrum operatora [Konfiguracja/ Struktura firmy/Struktura praw/Centrum operatora]. Następnie w zakładce [Dokumenty] należy wybrać odpowiedni dokument do konfiguracji.

Przypisanie precyzji cen wyświetlanych w aplikacji Comarch Mobile Zakupy podczas wystawiania dokumentów

Zaznaczenie opcji 1, 2, 3 lub 4 spowoduje wyświetlanie cen z dokładnością do takiej liczby miejsc po przecinku.

Prezentacja ceny podczas wystawiania dokumentu z precyzją a) do jednego miejsca po przecinku, b) do dwóch miejsc po przecinku, c) do trzech miejsc po przecinku, d) do czterech miejsc po przecinku

Cena z wybraną precyzją widoczna jest na liście towaru podczas wystawiania dokumentu, na małej kalkulacji oraz w zakładce Koszyk.

Konfiguracja kompletu

W aplikacji Comarch Mobile Zakupy jest dostępny komplet czyli zestaw dwóch lub więcej artykułów sprzedawanych klientowi jako jeden produkt. Na karcie danego artykułu o typie [Komplet], w zakładce [Ogólne] dostępny jest parametr [Pobieraj składniki na dokument].

Odznaczenie parametru spowoduje, że podczas wystawiania dokumentu artykuł będący kompletem dodawany jest jako jedna pozycja. Istnieje wówczas także możliwość określenia marży minimalnej oraz wskazania, że komplet podlega odwrotnemu obciążeniu.
Jeżeli parametr zostanie zaznaczony, to na dokumencie będą pokazywały się poszczególne składniki kompletu, a nie jedna pozycja w postaci całego kompletu.
Przy zaznaczonym parametrze [Pobieraj składniki na dokument] pojawi się dodatkowe okno dotyczące kolejnego parametru [Modyfikacja pojedynczego elementu na dokumentach]. Jeżeli dla dokumentów rozchodowych wartość tego parametru ustawiona będzie na [Blokuj] wówczas podczas wystawiania dokumentów w aplikacji mobilnej możliwe będzie dodawanie tylko pełnych kompletów. Edycja ilości dla pojedynczego elementu (składnika kompletu) nie będzie możliwa. Dotyczy to wszystkich dokumentów możliwych do wystawiania w aplikacji mobilnej przy współpracy z Comarch ERP Altum.

Parametr [Pobieraj składniki na dokument] na karcie kompletu w zakładce [Ogólne]

Zaznaczenie parametru [Pobieraj składniki na dokument]

Wyświetlanie/ukrywanie informacji o stanach magazynowych

W Comarch Mobile Zakupy istnieje możliwość wyboru wyświetlenia\ukrycia informacji o stanach magazynowych. W folderze [Methods], w pliku konfiguracyjnym [configuration.optima.xml] znajduje się parametr odpowiedzialny za tę funkcjonalność: [IsHeadquarterStocksVisible]. Domyślna wartość parametru to „1”, pozwalająca na podgląd informacji o stanach magazynowych na urządzeniu mobilnym. Więcej informacji nt. tego parametru znajduje się TUTAJ. Oprócz magazynów przypisanych do centrum mobilnego w Comarch ERP Altum, do aplikacji mobilnej można także synchronizować magazyny innej firmy (wraz z zasobami towarów dostępnych w Mobile). Aby takie magazyny były widoczne w Comarch Mobile Zakupy należy na karcie magazynu w zakładce widoczność stanów udostępnić centrum mobilne.

Konfiguracja magazynu w Comarch ERP Altum – udostępnienie widoczności stanów centrum mobilnemu.

Wyświetlanie stanów magazynowych z podziałem na partie (wielocechowość)

Istnieje możliwość sprawdzania w aplikacji mobilnej stanów towarów z podziałem na poszczególne partie (w zależności od cechy). Cechy te można również wskazać podczas generowania dokumentu w Comarch Mobile Zakupy. Określenie czy dana cecha ma mieć wpływ na partię jest z poziomu karty towaru w systemie ERP Altum (zakładka [Parametry]):

Określenie wpływu cechy na partie towaru

W systemie Comarch ERP Altum informacje o cechach dostępne są również z poziomu zakładki [Zasoby i partie], również na karcie towaru:

Informacje o zasobach towaru z podziałem na partie

Edycja raportów

W aplikacji umożliwiono usuwanie, dodawanie oraz edycję raportów z poziomu serwera synchronizacji. Definicje raportów znajdują się w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji/Reports. Aby dodać nowy raport należy utworzyć jego definicję, a następnie zapisać go w formacie xml.

Uwaga

W przypadku zapisu definicji raportu w Notatniku należy wybrać kodowanie UTF-8.

Aby usunąć istniejący raport należy zmienić jego ID na ujemne, następnie zmienić datę modyfikacji (np. wystarczy zapisać ponownie plik z raportem) i wykonać synchronizację.

Uwaga

Podczas synchronizacji definicji raportów na urządzenie brana jest pod uwagę data modyfikacji pliku. W celu wymuszenia synchronizacji raportu należy wykonać dowolną modyfikację.

Istnieje możliwość zmiany języka raportu.

Przyklad

W przypadku, gdy w wersji polskojęzycznej chcemy mieć raport w języku niemieckim, to należy zmodyfikować ostatni człon nazwy z deu na pol, następnie należy zmienić datę modyfikacji.

Przykład modyfikacji raportu

W celu opisania przykładowej modyfikacji raportu wykorzystany zostanie Raport dobowy przedstawiciela. Do tegoż raportu zostanie dodany argument za pomocą którego możliwe będzie wybranie dnia, z którego dany raport zostanie zaprezentowany. W tym celu należy wyedytować definicję raportu o nazwie 53#DailyReport#pol.xml znajdującą się w domyślnej lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Reports\ i katalogu odpowiednim dla systemu ERP. W pliku tym należy przed sekcją elements dodać sekcję zawierającą argumenty raportu oraz argument o typie daty (typeId = 0) według następującego przykładu:

Przyklad

Kolejnym krokiem dla lepszej czytelności raportu będzie usunięcie godziny z nagłówka raportu znajdującego się na zielonej belce. Dla pierwszego elementu raportu (id = 1) należy wyedytować sekcję sql w pozostawiając następujące polecenie:

<![CDATA[select '<b<![CDATA[>Raport dobowy<br/><b/> ', date(@data@/1000, 'unixepoch', 'localtime')]]>

Następnie w całym pliku należy wyszukać wszystkie fragmenty kodu odnoszące się do aktualnej daty i zamienić je na odnoszące się do wcześniej zdefiniowanego argumentu. Wobec tego należy fragmenty:

date('now','localtime')

Zamienić na następujące:

date(@data@/1000, 'unixepoch', 'localtime')

Po wykonaniu tych kroków zmodyfikowany raport będzie wymagał wyboru daty:

I będzie prezentował dane o stanach magazynów mobilnych oraz wystawionych dokumentach, zapisach kasowych i obrotu kaucjami z wybranego dnia.

Elementy składowe

Definicja raportu składa się z danych sekcji xml. Główną sekcją raportu jest sekcja report. W niej zaś zawarte są następujące:

reportHeader
reportType
onListVisibillity
arguments
elements

W celu opisania elementów składowych raportów jako przykład wykorzystany zostanie standardowy raport dostępny w aplikacji Comarch Mobile - Podsumowanie dnia, którego definicja znajduje się w pliku 2#SummaryOfTheDay#pol.xml.

Nagłówek

Nagłówek raportu opisany jest sekcją reportHeader, w niej zaś znajdują się poniższe:

Nazwa	name
Opis	Nazwa raportu.
Parametry	wartość tekstowa

Nazwa	description
Opis	Opis raportu.
Parametry	wartość tekstowa

Przyklad

<reportHeader> <name>Podsumowanie dnia</name> <description>Podsumowanie wykonanych w dniu operacji. Sprzedaż wg grup. Udział grup w sprzedaży dnia.</description> </reportHeader>

Typ raportu

Sekcja oznaczająca typ raportu: reportType. Musi zawierać następującą sekcję:

Nazwa	value
Opis	Wartość typu raportu. Np. jeżeli użytkownik nie posiada praw do dokumentów zakupowych, to nie wykona raportu o typie 1 oraz 0.
Parametry	0 - wszystkie typy 1 - raport sprzedażowy 2 - raport zakupowy 3 - raport serwisowy

Przyklad

Widoczność raportu

Sekcja onListVisibillity określa miejsca w aplikacji mobilnej poza kaflem Raporty, z których dostępny jest raport. Musi zawierać następującą sekcję:

Nazwa	value
Opis	Wartość występowania raportu. Możliwe wartości łączone np. 129 = 128+1 - raport widoczny zarówno na liście kontrahentów jak i karcie kontrahenta.
Parametry	0 - tylko lista raportów 1 - lista kontrahentów 2 - lista towarów 4 - element wizyty "Inny" 8 - listy pozycji dokumentów 16 - duża kalkulacja podczas dodawania pozycji na dokument 32 - pasek po rozpoczęciu wizyty handlowej 64 - karta towaru 128 - karta kontrahenta suma wybranych wartości

Przyklad

Dostępność raportu z poziomu dodawania pozycji na dokumencie

Argumenty

Raport może wykorzystywać podane przez użytkownika aplikacji po kliknięciu w ikonę ołówka argumenty (parametry). Argumenty znajdują się w sekcji arguments definicji raportu, zaś poszczególne argumenty opatrzone są sekcją argument według następującego przykładu:

Przyklad

Wskazówka

Aby wstawiane polecenia SQL działały poprawnie należy umieścić je w znaczniku <![CDATA[ polecenieSQL ]> w celu wyłączenia spod analizy deserializatora XML.

Argument może zawierać następujące sekcje:

Nazwa	id
Opis	Identyfikator argumentu.
Parametry	wartość liczbowa

Nazwa	typeId
Opis	Typ argumentu.
Parametry	0 - wybór daty 1 - pole tekstowe 2 - lista z parametrami zdefiniowanymi w sekcji posibleSQL 3 - pole liczbowe 4 - wybór kontrahenta 5 - wybór towaru 6 - wybór typu check

Wskazówka

Jeżeli typ argumentu został wybrany jako 0 (wybór daty), to element defaultSQL należy ustawić jako: <![CDATA[select date('now','localtime')]]> zaś posibleSQL zostawić puste wstawiając: <![CDATA[]]>

Przyklad

Przykład argumentu wybranego jako typ 6 (typ check) w raporcie Prezentacja partii towaru (45#ItemLots#pol.xml) dostępnym przy współpracy z systemem ERP Altum: <argument> <id>3</id> <typeId>6</typeId> <name>mag</name> <visibleName>Magazyn</visibleName> <defaultSQL><![CDATA[ SELECT '(' || group_concat(id, ',') || ')' AS Conc, 'Wszystkie' AS Value FROM Warehouses WHERE IsActive = 1 AND Id > 0 GROUP BY Value ]]> </defaultSQL> <posibleSQL><![CDATA[ SELECT id || ' [' || code || '] ' , name FROM Warehouses WHERE IsActive = 1 AND Id > 0 ]]> </posibleSQL> </argument>

Nazwa	name
Opis	Nazwa argumentu używana w poleceniach SQL.
Parametry	wartość tekstowa

Nazwa	visibleName
Opis	Nazwa argumentu widoczna w aplikacji.
Parametry	wartość tekstowa

Nazwa	defaultSQL
Opis	Wartość parametru ustawiana domyślnie. Jeżeli wartość pozostanie pusta (ustawiona na <![CDATA[]]>) to wartość parametru w aplikacji ustawi się na 'Wybierz wartość' i konieczny będzie wybór tego parametru przed otwarciem raportu.
Parametry	polecenie SQL

Nazwa	posibleSQL
Opis	Wartości parametru możliwe do wyboru.
Parametry	polecenie SQL

Nazwa	isErpSQL
Opis	Znacznik decydujący czy polecenie SQL ma być wykonywane na bazie systemu ERP. Używany w raportach online.
Parametry	brak sekcji - polecenie wykonywane na bazie mobilnej 0 - polecenie wykonywane na bazie mobilnej 1 - polecenie wykonywane na bazie systemu ERP

Nazwa	validationRule
Opis	Znacznik definiujący sposób walidacji argumentu (tylko dla typu data).
Parametry	Trzy cyfry oddzielone kropkami np. 2.0.1: Pierwsza cyfra: 0 - brak walidacji 1 - sprawdzenie, czy data jest przyszła 2 - sprawdzenie, która data jest późniejsza Druga cyfra - określa pary argumentów (np. argument dataOd 2.1.1 a dataDo 2.1.2) Trzecia cyfra - określa która data ma być wcześniejszą (wartość 1), a która późniejszą (wartość 2)

Przyklad

<argument> <id>2</id> <typeId>2</typeId> <name>grupowanie</name> <visibleName>Sposób grupowania</visibleName> <defaultSQL><![CDATA[select 0,'Brak']]></defaultSQL> <posibleSQL><![CDATA[select 0,'Brak' union all select 1,'Kategoria' union all select 2,'Marka' union all select 3,'Producent' union all select 4,'Grupa']]></posibleSQL> </argument>

Zdefiniowany w powyższym przykładzie argument widoczny jest w aplikacji w następujący sposób:

Elementy

Elementy raportu składają się na jego wygląd w aplikacji mobilnej. Poszczególne elementy raportu znajdują się w sekcji elements definicji raportu, zaś każda z poniżej opisanych sekcji może znajdować się w sekcji element, która jest definicją jednego elementu.

Przyklad

Nazwa	id
Opis	Identyfikator elementu.
Parametry	wartość liczbowa

Nazwa	typeId
Opis	Typ elementu.
Parametry	0 – nagłówek raportu, który w aplikacji widoczny jest w raporcie na zielonej belce. 1 – tabela1 2 – tabela2 3 – wykres słupkowy 4 – wykres kołowy 5 – wykres liniowy 6 – wartość tekstowa

Nazwa	sql
Opis	Polecenie SQL wykonywane na bazie SQL, które tworzy tabelę wynikową. Podanie argumentu odbywa się poprzez umieszczenie jego nazwy w znakach @ np. @grupowanie@.
Parametry	polecenie SQL/polecenie wywołujące procedurę

Nazwa	header
Opis	Nagłówek elementu.
Parametry	wartość tekstowa/polecenie SQL

Nazwa	headerType
Opis	Typ nagłówka raportu.
Parametry	0 - tekst 1 - polecenie SQL

Nazwa	isSummary
Opis	Znacznik czy element zawiera podsumowanie zwartości tabeli. W przypadku jego użycia w sekcji sql należy umieścić polecenia sumujące wybrane kolumny tabeli.
Parametry	brak sekcji - brak podsumowania 0 - brak podsumowania 1 - podsumowanie polecenie SQL zwracające jedną z powyższych wartości

Nazwa	isSummaryType
Opis	Typ znacznika podsumowania.
Parametry	brak sekcji - wartość liczbowa 0 - wartość liczbowa 1 - polecenie SQL

Nazwa	isErpSQL
Opis	Znacznik czy polecenie ma być wykonane na bazie systemu ERP. Używany w raportach online.
Parametry	brak sekcji - polecenie wykonywane na bazie mobilnej 0 - polecenie wykonywane na bazie mobilnej 1 - polecenie wykonywane na bazie systemu ERP

Nazwa	reportTypeVisibility
Opis	Widoczność elementu w zależności od rodzaju raportu.
Parametry	0 - wszystkie typy 1 - raport sprzedażowy 2 - raport zakupowy 3 - raport serwisowy

Nazwa	showNumberOfRows
Opis	Wyświetla liczbę zwróconych rekordów w tabeli jako ostatni wiersz tabeli. Używane tylko gdy sekcja isSummary przyjmuje wartość 1.
Parametry	brak sekcji - nie wyświetlaj 0 - nie wyświetlaj 1 - wyświetl

Nazwa	isExecute
Opis	Znacznik czy wykonać dany element.
Parametry	0 - brak wykonania 1 - wykonanie polecenie SQL zwracające jedną z powyższych wartości

Nazwa	isExecuteType
Opis	Typ znacznika wykonania elementu.
Parametry	brak sekcji - wartość liczbowa 0 - wartość liczbowa 1 - polecenie SQL

Przyklad

<element>
<id>8</id>
<typeId>3</typeId>
<sql>
<![CDATA[

select
coalesce(categories.name, 'Brak kategorii') as Kategoria,
sum(DocumentsPositions.GrossValueInSystemCurrency) as NetValue
from documents
join documentspositions
on documentspositions.documentid = documents.id
AND DocumentsPositions.DocumentIsLocal = Documents.DocumentIsLocal
and DocumentsPositions.IsItemsSetVirtualPosition = 0
and DocumentsPositions.RelatedItemsSetOrdinal is null
join items on items.id = documentspositions.itemid
left join categories on items.categoryid = categories.id
where Documents.DocumentIsLocal = 1 AND documents.NumeratorId IN (16,17) AND datetime(DocumentDate/1000, 'unixepoch','localtime') >datetime(date(@data@/1000, 'unixepoch', 'localtime'),'start of day') and  datetime(DocumentDate/1000, 'unixepoch','localtime') <datetime(date(@data@/1000, 'unixepoch','localtime'),'start of day','+1 day', '-1 seconds')  and 1 = @grupowanie@ group by categories.name

union all

select
coalesce(brands.name, 'brak marki') as Marka,
sum(DocumentsPositions.GrossValueInSystemCurrency) as NetValue
from documents
join documentspositions
 on documentspositions.documentid = documents.id
 AND DocumentsPositions.DocumentIsLocal = Documents.DocumentIsLocal
 and DocumentsPositions.IsItemsSetVirtualPosition = 0
 and DocumentsPositions.RelatedItemsSetOrdinal is null
join items on items.id = documentspositions.itemid
left join brands on items.brandid = brands.id
where Documents.DocumentIsLocal = 1 AND documents.NumeratorId IN (16,17) AND datetime(DocumentDate/1000, 'unixepoch','localtime') >datetime(date(@data@/1000, 'unixepoch', 'localtime'),'start of day') and  datetime(DocumentDate/1000, 'unixepoch','localtime') <datetime(date(@data@/1000, 'unixepoch','localtime'),'start of day','+1 day', '-1 seconds')  and 2 = @grupowanie@ group by brands.name

union all

select
coalesce(Producers.name, 'brak producenta') as Grouping,
sum(DocumentsPositions.GrossValueInSystemCurrency) as NetValue
from documents
join documentspositions
 on documentspositions.documentid = documents.id
AND DocumentsPositions.DocumentIsLocal = Documents.DocumentIsLocal
and DocumentsPositions.IsItemsSetVirtualPosition = 0
and DocumentsPositions.RelatedItemsSetOrdinal is null
join items on items.id = documentspositions.itemid
left join Producers on items.producerid = Producers.id
where Documents.DocumentIsLocal = 1 AND documents.NumeratorId IN (16,17) AND datetime(DocumentDate/1000, 'unixepoch','localtime') >datetime(date(@data@/1000, 'unixepoch', 'localtime'),'start of day') and  datetime(DocumentDate/1000, 'unixepoch') <datetime(date(@data@/1000, 'unixepoch','localtime'),'start of day','+1 day', '-1 seconds') and 3 = @grupowanie@ group by Producers.name

union all

select
coalesce(ig.name  , 'brak grupy towaru') as Grupa ,
sum(DocumentsPositions.GrossValueInSystemCurrency) as GrossValue
from documents
join documentspositions
on documentspositions.documentid = documents.id
AND DocumentsPositions.DocumentIsLocal = Documents.DocumentIsLocal
and DocumentsPositions.IsItemsSetVirtualPosition = 0
and DocumentsPositions.RelatedItemsSetOrdinal is null
join items on items.id = documentspositions.itemid
join itemsgroupslinks igl on items.id = igl.itemid
join itemsgroups ig on groupid = ig.id
where Documents.DocumentIsLocal = 1 AND documents.NumeratorId IN (16,17) AND (select count(*) from itemsgroups join itemsgroupslinks on itemsgroupslinks.itemid = igl.itemid and itemsgroups.id = itemsgroupslinks.groupid where parentid = ig.id) = 0 and datetime(DocumentDate/1000, 'unixepoch','localtime') >datetime(date(@data@/1000, 'unixepoch', 'localtime'),'start of day') and  datetime(DocumentDate/1000, 'unixepoch','localtime') <datetime(date(@data@/1000, 'unixepoch','localtime'),'start of day','+1 day', '-1 seconds') and @grupowanie@=4 group by ig.name]]>
</sql>
<header>Wykres zakupu wg grupowania</header>
<isSummary>0</isSummary>
<reportTypeVisibility>2</reportTypeVisibility>
</element>

Widok standardowego raportu Podsumowanie dnia

Dodanie argumentu

W celu opisania przykładowej modyfikacji raportu wykorzystany zostanie Raport dobowy przedstawiciela. Do raportu zostanie dodany argument za pomocą którego możliwe będzie wybranie dnia, z którego dany raport zostanie zaprezentowany. W tym celu należy wyedytować definicję raportu o nazwie 53#DailyReport#pol.xml znajdującą się w domyślnej lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Reports\ i katalogu odpowiednim dla systemu ERP. W pliku tym należy przed sekcją elements dodać sekcję zawierającą argumenty raportu oraz argument o typie daty (typeId = 0) według następującego przykładu:

Przyklad

Kolejnym krokiem dla lepszej czytelności raportu będzie usunięcie godziny z nagłówka raportu znajdującego się na zielonej belce. Dla pierwszego elementu raportu (id = 1) należy wyedytować sekcję sql w pozostawiając następujące polecenie:

<![CDATA[select '<b<![CDATA[>Raport dobowy<br/><b/> ', date(@data@/1000, 'unixepoch', 'localtime')]]>

Następnie w całym pliku należy wyszukać wszystkie fragmenty kodu odnoszące się do aktualnej daty i zamienić je na odnoszące się do wcześniej zdefiniowanego argumentu. Wobec tego należy fragmenty:

date('now','localtime')

Zamienić na następujące:

date(@data@/1000, 'unixepoch', 'localtime')

Po wykonaniu tych kroków zmodyfikowany raport będzie wymagał wyboru daty:

I będzie prezentował dane o stanach magazynów mobilnych oraz wystawionych dokumentach, zapisach kasowych i obrotu kaucjami z wybranego dnia.

Dodanie nowej kolumny w tabeli

W celu opisania modyfikacji wykorzystany zostanie raport Sprzedaż SKU. Modyfikacja dotyczyć będzie dodania nowej kolumny z kodem EAN w tabeli Towary.

W tym celu należy wyedytować definicję raportu o nazwie 1#SalesSKU#pol.xml znajdującą się w domyślnej lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Reports\.

Wskazówka

Poprawność modyfikowanych zapytań SQL można zweryfikować wykonując je na bazie mobilnej (plik data.db na urządzeniu mobilnym) np. za pomocą narzędzia SQLite Studio.

W pliku należy wyedytować zapytanie SQL dla elementu o id = 3 dodając do niego pole zwracające kod EAN dla danego towaru w poleceniu select wraz z funkcją IFNULL, która w przypadku braku kodu EAN dla towaru zwróci pustą wartość w wierszu tabeli. Następnie należy do zapytania dołączyć tabelę ItemsBarcodes używając polecenia LEFT JOIN oraz odpowiednich aliasów. Dodane linijki zostały oznaczone kolorem żółtym.

<id>3</id>
<typeId>1</typeId>
<sql>
<![CDATA[
	Select
		Items.Name as '[l]Nazwa', 
		IFNULL(bar.Barcode, '') AS EAN,
		(sum(DocumentsPositions.Quantity/DocumentsPositions.Denominator*DocumentsPositions.Nominator))  as '[d4]Ilość', 
		DocumentsPositions.UnitName as JM, 
		cast(ROUND(sum(DocumentsPositions.NetValueInSystemCurrency), 2) as Varchar) || ' ' || c.Symbol as 'Netto', 
		cast(ROUND(sum(DocumentsPositions.GrossValueInSystemCurrency), 2) as varchar) || ' ' || c.Symbol as 'Brutto', 
		sum(DocumentsPositions.Quantity) as '[d4]Ilość(podst.)',
		DocumentsPositions.BaseUnitName as 'JM(podst.)'  
	from Documents d
	join DocumentsPositions
	  on d.Id = DocumentsPositions.DocumentId
	 AND d.DocumentIsLocal = DocumentsPositions.DocumentIsLocal
	 and DocumentsPositions.IsItemsSetVirtualPosition = 0
	 and DocumentsPositions.RelatedItemsSetOrdinal is null
	join Items on Items.Id = DocumentsPositions.ItemId 
	left JOIN ItemsBarcodes bar ON bar.ItemId = DocumentsPositions.ItemId
	join Currencies c ON c.e = 1 AND c.IsSystem = 1
	where d.DocumentIsLocal = 1 AND NumeratorId IN (1,2,3,4,5) AND datetime(d.DocumentDate/1000, 'unixepoch','localtime') >datetime(date(@dataOd@/1000, 'unixepoch','localtime'),'start of day') 
	and  datetime(d.DocumentDate/1000, 'unixepoch','localtime') <datetime(date(@dataDo@/1000, 'unixepoch','localtime'),'start of day','+1 day', '-1 seconds')  
	group by DocumentsPositions.ItemId,unitname order by items.name
	]]>
</sql>

Zmodyfikowany w ten sposób raport będzie prezentował się następująco:

Raport Sprzedaż SKU z dodatkową kolumną EAN

Usunięcie kolumny z tabeli

W celu opisania modyfikacji wykorzystany zostanie raport Ranking kontrahentów kupujących towar, w którym to usunięte zostaną dwie kolumny z tabeli: Marża (kwotowo) i Marża (procentowo).

Standardowy raport: Ranking kontrahentów kupujących towar

W tym celu należy wyedytować definicję raportu o nazwie 38#CustomersPurchasingItems#pol.xml znajdującą się w domyślnej lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Reports\.

Wskazówka

Poprawność modyfikowanych zapytań SQL można zweryfikować wykonując je na bazie mobilnej (plik data.db na urządzeniu mobilnym) np. za pomocą narzędzia SQLite Studio.

Z pliku należy usunąć część zapytania SQL dla elementu o id = 2, która odpowiada za zwrócenie wartości danych kolumn Marża (kwotowo) i Marża (procentowo). Będzie to poniższy fragment, który dla tego elementu występuje dwa razy:

CASE
  WHEN SUBSTR(ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2), LENGTH(ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2))-1,1) = "."
  THEN ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2) || "0" || "<br/>" || (Select Value From Configuration Where Key == 'Currency')
  ELSE ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2) || "<br/>" || (Select Value From Configuration Where Key == 'Currency')
END AS '[c]Marża<br/>(kwotowo)',
					      					
CASE
  WHEN (Select Value From Configuration Where Key == 'MarginCountType') == 1            
  THEN IFNULL(ROUND(ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2)/SUM(dp.EndNetPriceInSystemCurrency * dp.Quantity)*100, 2), 0.00) || " %"               
  ELSE IFNULL(ROUND(ROUND(SUM(Case when d.IsVatFromNetValue == 1 THEN dp.MarginValueInSystemCurrency ELSE dp.MarginValueInSystemCurrency*100/(100+dp.VatRateValue) END), 2)/SUM(dp.BaseNetPriceInSystemCurrency * dp.Quantity)*100, 2), 0.00) || " %"               
END AS '[c]Marża<br/>(procentowo)'

Dodatkowo należy usunąć możliwość wyboru sortowania danych po usuniętych kolumnach. W tym celu dla argumentu o id = 4 z sekcji posibleSQL należy usunąć następujące wartości:

UNION ALL
SELECT 3, 'Marża(kwotowo)'
UNION ALL
SELECT 4, 'Marża(procentowo)'

Po wykonaniu powyższych kroków raport powinien wyglądać następująco:

Raport: Ranking kontrahentów kupujących towar po modyfikacji

Definicje wydruków

W aplikacji zostały przygotowane przykładowe wydruki, które można dowolnie modyfikować i dostosowywać do wymagań Klienta.

Wskazówka

Definicje wydruków dokumentów znajdują się domyślnie w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Printouts.

Wskazówka

Definicje wydruków raportów znajdują się domyślnie w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Printouts i podkatalogu odpowiednim dla systemu ERP, np. xl11.

Każdy wydruk składa się z trzech części:

Data – zapytania wyciągające dane wykorzystywane na wydruku,
Layout – układ wydruku,
Style – styl wydruku (czcionki, kolory itp.).

Uwaga

Podczas synchronizacji definicji wydruków na urządzenie brana jest pod uwagę data modyfikacji pliku. W celu wymuszenia synchronizacji wydruku należy wykonać dowolną modyfikację.

Dodanie nowej definicji wydruku dokumentu

Aby dodać nowy wydruk należy utworzyć jego definicję tworząc pliki Data, Layout i Style, następnie zapisać je w formacie xml. Istnieje możliwość dodania kilku definicji dla jednego dokumentu. Przykładowo dla dokumentu Zamówienie Sprzedaży istnieje standardowa definicja składająca się z plików:

1#SalesOrder#data#Wydruk_domyślny.xml
1#SalesOrder#layout#Wydruk_domyślny.xml
1#SalesOrder#style#Wydruk_domyślny.xml

Należy dodać nową zmodyfikowaną definicję zmieniając w nazwie plików liczbę 1 na taką, która wśród definicji nie istnieje oraz frazę Wydruk_domyślny na wybraną przez siebie nazwę definicji, np:

45#SalesOrder#data#Mój_wydruk.xml
45#SalesOrder#layout#Mój_wydruk.xml
45#SalesOrder#style#Mój_wydruk.xml

Po tych czynnościach podczas wydruku dokumentu mamy możliwość wyboru definicji wydruku:

Uwaga

W przypadku zapisu definicji wydruku w Notatniku należy wybrać kodowanie UTF-8.

Dodanie nowej definicji wydruku raportu

W celu dodania definicji wydruku raportu w katalogu Printouts i podkatalogu odpowiednim dla systemu ERP należy utworzyć pliki Data, Layout i Style zawierając w nazwie Id raportu z katalogu Reports serwera synchronizacji. Przykładowo, aby utworzyć definicję wydruku dla raportu Sprzedaż w okresach należy raport ten odszukać w katalogu Reports, nosi on nazwę 3#SalesInPeriods#pol.xml. Kolejno w katalogu Printouts i odpowienim podkatalogu utworzyć jego definicję tworząc pliki data, layout i style zawierając w nazwie jego Id:

46#Report#data#3#Moj_wydruk.xml
46#Report#layout#3#Moj_wydruk.xml
46#Report#style#3#Moj_wydruk.xml

Po tych czynnościach w aplikacji pojawi się możliwość wydruku raportu Sprzedaż w okresach.

Usunięcie definicji wydruku

Aby usunąć istniejący wydruk, należy zmienić ID wszystkich jego elementów na ujemne, następnie zmienić datę modyfikacji i wykonać synchronizację.

Licznik wydruków

Funkcjonalność licznika wydruków PDF umożliwia ewidencjonowanie wydrukowanych dokumentów danego typu. Dzięki niej będzie można sprawdzić na bazie mobilnej, które dokumenty zostały wydrukowane i ewentualnie według potrzeby będzie można zablokować możliwość edycji już wydrukowanych dokumentów. Dla potrzeb funkcjonalności na bazie mobilnej została dodana tabela RealizedPrintout, w której można odszukać dokładną datę i godzinę wydruku, rodzaj obiektu, liczbę kopii itp. Informację o liczbie wydruków będzie można wykorzystać w raportach, np. ilość wydrukowanych dokumentów ZS danego dnia.

Dodatkowe informacje na wydrukach

Na wszystkich wydrukach dostępnych z poziomu aplikacji wprowadzone są dodatkowe informacje, które dotyczą:

numeru wydruku,
identyfikatora określającego, że wydruk został stworzony w aplikacji mobilnej,
liczby kopii wydruku,
identyfikatora operatora.

Dodatkowe dane pozwalają na dokładniejszą weryfikację wydruków wykonanych z poziomu aplikacji przez przedstawicieli.

Źródło danych

Wydruk do pdf

Źródło danych dla wydruku musi zostać umieszczone w pliku o nazwie Data.xml. Głównym elementem w pliku jest sekcja data wewnątrz której musi się znaleźć dokładnie jeden element setf. Wewnątrz elementu setf musi się znaleźć jeden lub więcej elementów set. Każdy element set reprezentuje jeden zbiór danych (wynik jednego zapytania SQL). Musi on zawierać dwa elementy podrzędne: name – który określa nazwę zbioru oraz query, które definiuje zapytanie SQL wykonywane na mobilnej bazie danych aplikacji Comarch Mobile.

Uwaga

Prezentowane zapytania SQL mogą różnić się w zależności od wersji aplikacji Comarch Mobile.

Przykład standardowego pliku data.xml występującego w definicji wydruku dokumentu Zamówienie Sprzedaży (1#SalesOrder#data#Wydruk_domyślny.xml):

Przyklad

<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE data PUBLIC "//UNKNOWN/" "unknown.dtd"> <data> <setf> <set> <name>Header</name> <query> ... </query> </set> <set> <name>DocumentsPositions</name> <query> ... </query> </set> <set> <name>VatAggregation</name> <query> ... </query> </set> <set> <name>Logo</name> <query>SELECT Data FROM PrintoutsImages WHERE Name='logo.png'</query> </set> <set> <name>FooterAppVersionNumber</name> <query> SELECT MajorVersion AS MajorVersion, MinorVersion AS MinorVersion, BuildVersion AS BuildVersion FROM Packages </query> </set> <set> <name>FooterOperatorCode</name> <query> SELECT Name AS OperatorCode FROM Users </query> </set> <set> <name>FooterCopyNumber</name> <query> SELECT CASE WHEN COUNT(Number) = 0 THEN 1 ELSE COUNT(Number) + 1 END AS Numbers FROM Documents INNER JOIN RealizedPrintouts rp ON(Documents.Number = rp.DocumentNumber) WHERE Documents.Id=@Id@ </query> </set> </setf> </data>

Wydruk termiczny

Jedyną różnicą w definicji pliku data.xml dla wydruków termicznych względem definicji wydruku do pdf jest brak elementu setf. Przykład takiego wydruku (11#SalesOrder#data#Thermal#Vline112#Wydruk_domyślny.xml) wygląda nastepująco:

Przyklad

<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE data PUBLIC "//UNKNOWN/" "unknown.dtd"> <data> <set> <name>Header</name> <query> ... </query> </set> <set> <name>DocumentsPositions</name> <query> ... </query> </set> <set> <name>VatAggregation</name> <query> ... </query> </set> <set> <name>FooterAppVersionNumber</name> <query> SELECT MajorVersion AS MajorVersion, MinorVersion AS MinorVersion, BuildVersion AS BuildVersion FROM Packages </query> </set> <set> <name>FooterOperatorCode</name> <query> SELECT Name AS OperatorCode FROM Users </query> </set> <set> <name>FooterCopyNumber</name> <query> SELECT CASE WHEN COUNT(Number) = 0 THEN 1 ELSE COUNT(Number) + 1 END AS Numbers FROM Documents INNER JOIN RealizedPrintouts rp ON(Documents.Number = rp.DocumentNumber) WHERE Documents.Id=@Id@ </query> </set> </data>

Układ wydruku

Zawartość oraz układ wydruku definiowany jest w pliku Layout.xml. Głównym elementem w pliku jest document. Musi zawierać on element body, który zawiera główną część wydruku. Zawartość elementów body czy też footer może zostać skomponowana z innych elementów opisanych poniżej. Elementy te mogą być zagnieżdżane. Parametr class odwołuje się do klasy stylu zdefiniowanej w pliku Styles.xml dla danego elementu stylującego. Wszystkie dostępne elementy, które mogą zostać zastosowane podczas tworzenia układu wydruku zostały opisane poniżej. Opis każdego elementu zawiera następujące sekcje:

Parametry – opisuje wszystkie dostępne atrybuty jakie można dodać do elementu i co oznaczają.
Elementy stylujące – zawiera listę selektorów, które dopasowują dany element w pliku Styles.xml
Elementy podrzędne – opcjonalna sekcja opisująca elementy, które mogą wystąpić tylko wewnątrz danego elementu. Dla każdego elementu podrzędnego zachowany jest układ opisu taki sam jak dla głównego elementu.
Przykład – zawiera fragment kodu z przykładowym wykorzystanie opisywanego elementu.

Wszystkie dostępne elementy, które mogą zostać zastosowane podczas tworzenia układu wydruku zostały opisane poniżej.

Elementy - wydruk do pdf

Nazwa	Document
Opis	Otwarcie/zamknięcie dokumentu
Parametry	Brak
Elementy stylujące	Brak

Nazwa	Body
Opis	Główna część wydruku
Parametry	Brak
Elementy stylujące	Body

Nazwa	Footer
Opis	Stopka wydruku
Parametry	Brak
Elementy stylujące	Footer

Nazwa	pageNumber
Opis	Numeracja stron
Parametry	Brak
Elementy stylujące	Brak

Przyklad

<footer> Comarch Mobile, v <data set="FooterAppVersionNumber" var="MajorVersion" />.<data set="FooterAppVersionNumber" var="MinorVersion" />.<data set="FooterAppVersionNumber" var="BuildVersion" />, Operator: <data set="FooterOperatorCode" var="OperatorCode" />, nr kopii: <data set="FooterCopyNumber" var="Numbers" /> <br /> Strona <pageNumber/> </footer>

Nazwa	Horizontal
Opis	Podział na sekcje ułożone poziomo
Parametry	Brak
Elementy stylujące	Horizontal
Elementy podrzędne	Section

Nazwa	Horizontal: Section
Opis	Sekcja
Parametry	weight – waga szerokości kolumny. Wartość domyślna 1.
Elementy stylujące	Section

Przyklad

<horizontal> <section class="header"> <p class="header">Nabywca</p> </section> <section weight="0.05"/> <section class="header"> <p class="header">Odbiorca</p> </section> </horizontal>

Nazwa	Image
Opis	Obraz z bazy lub z dysku
Parametry	path – ścieżka do pliku względnie do katalogu głównego definicji wydruku. Jeżeli ustawiamy parametr path pozostałe parametry będą ignorowane. set – Nazwa źródła danych var – Nazwa kolumny w źródle danych index – Indeks wiersza w źródle danych
Elementy stylujące	Image

Przyklad

Nazwa	P
Opis	Paragraf
Parametry	Brak
Elementy stylujące	P

Przyklad

<p class="centered">Uprawniony do odbioru dokumentu</p>

Nazwa	Data
Opis	Element zwracający dane ze źródła danych w postaci tekstowej
Parametry	set – nazwa zestawu danych var – nazwa kolumny index – indeks wiersza ze źródła danych (wartość domyślna 0) format – todo
Elementy stylujące	Brak

Przyklad

Nazwa	Hr
Opis	Linia pozioma
Parametry	Brak
Elementy stylujące	Hr

Przyklad

<section> <hr/> <p class="centered">Uprawniony do wystawienia dokumentu</p> </section>

Nazwa	Br
Opis	Złamanie linii w tekście
Parametry	Brak
Elementy stylujące	Brak

Przyklad

Nazwa	Spacer
Opis	Separator
Parametry	Brak
Elementy stylujące	Brak

Przyklad

... </horizontal> <spacer/><spacer/> <if> ...

Nazwa	If
Opis	Element testowy pozwalający na układ wydruku zależny od dowolnych warunków
Parametry	Brak
Elementy stylujące	Brak
Elementy podrzędne	Test True False

Nazwa	If: Test
Opis	Element zawierający warunek decydujący o tym czy do wydruku zostaną dodane elementy z sekcji true czy false . Warunek może mieć postać: eq - równy, lt - mniej niż, gt - więcej niż.
Parametry	Brak
Elementy stylujące	Brak

Nazwa	If: True
Opis	Element zawierający elementy, które zostaną w przypadku kiedy warunek z sekcji test zostanie spełniony.
Parametry	Brak
Elementy stylujące	Brak

Nazwa	If: False
Opis	Element zawierający elementy, które zostaną w przypadku kiedy warunek z sekcji test nie zostanie spełniony.
Parametry	Brak
Elementy stylujące	Brak

Przyklad

<if> <test><data set="Header" var="ReverseCharge" /> eq 1</test> <true> <p class="right">*) - odwrotne obciążenie</p> </true> <false> <p class="right">Odwrotne obciążenie nie występuje</p> </false> </if>

Nazwa	Table
Opis	Tabela dynamiczna o ustalonej liczbie kolumn.
Zawartość	Jeden lub więcej elementów column
Parametry	split - określa czy tabela może zostać podzielona na kilka stron. Parametr może przyjmować wartość true lub false. set - nazwa zestawu danych.
Elementy stylujące	Table
Elementy podrzędne	Column TableData

Nazwa	Table: Column
Opis	Element definiujący kolumnę tabeli.
Zawartość	Dowolne elementy tekstowe
Parametry	description - nagłówek kolumny. weight - waga szerokości kolumny. Wartość domyślna 1
Elementy stylujące	DataCell HeadCell

Nazwa	Table: TableData
Opis	Element zwracający wartość tekstową ze zbioru danych bazującą na zbiorze danych tabeli, kolumnie podanej w parametrze var oraz aktualnym wierszu tabeli.
Zawartość	Element nie może zawierać żadnych elementów.
Parametry	var - nazwa kolumny ze zbioru danych. format - format danych
Elementy stylujące	Brak

Przyklad

Elementy - wydruk termiczny

Nazwa	Document
Opis	Otwarcie/zamknięcie dokumentu
Parametry	Brak

Nazwa	Command
Opis
Parametry	comment format code

Przyklad

Nazwa	Data
Opis	Element zwracający dane ze źródła danych w postaci tekstowej
Parametry	query - nazwa zbioru danych z pliku data columnName - nazwa kolumny offset - miejsce (licząc od lewej strony), od której ma być drukowany element length - szerokość elementu align - pozycja elementu, możliwe wartości: left, right, center maxlines - maksymalna ilość linii, którą może zająć element

Nazwa	Text
Opis	Element testowy
Parametry	offset - miejsce (licząc od lewej strony), od której ma być drukowany element length - szerokość elementu align - pozycja elementu, możliwe wartości: left, right, center

Nazwa	Line
Opis	Znacznik linii
Parametry	Brak

Przyklad

<line> <text offset="30" length="35" align="left">Data dostawy/wykonania usługi: </text> <data query="Header" columnName="ExecutionDate" offset="65" length="15" align="left" /> </line>

Nazwa	Table
Opis	Tabela dynamiczna o ustalonej liczbie kolumn.
Parametry	query - nazwa zbioru danych z pliku data length - szerokość elementu
Elementy podrzędne	Header Row

Nazwa	Table: Header
Opis	Nagłówek tabeli (nazwy kolumn).
Parametry	Brak
Elementy podrzędne	Column

Nazwa	Table: Header: Column
Opis	Element definiujący kolumnę tabeli.
Parametry	offset - miejsce (licząc od lewej strony), od której ma być drukowany element length - szerokość elementu align - pozycja elementu, możliwe wartości: left, right, center

Nazwa	Table: Row
Opis	Element definiujący wiersz tabeli.
Parametry	offset - miejsce (licząc od lewej strony), od której ma być drukowany element length - szerokość elementu align - pozycja elementu, możliwe wartości: left, right, center
Elementy podrzędne	Row_item

Nazwa	Table: Row: Row_item
Opis	Element definiujący zawartość wiersza tabeli.
Parametry	offset - miejsce (licząc od lewej strony), od której ma być drukowany element length - szerokość elementu align - pozycja elementu, możliwe wartości: left, right, center

Przyklad

<table query="DocumentsPositions" length="80"> <header> <column offset="0">L.p.</column> <column offset="7">[Kod]Nazwa</column> <column offset="22">Ilość</column> <column offset="32">J.M.</column> <column offset="39"><data query="Header" columnName="PriceType"/></column> <column offset="53">Rabat</column> <column offset="61">Wartość</column> <column offset="77">VAT</column> </header> <row> <line> <row_item name="Ordinal" offset="0" length="7" align="center" /> <row_item name="ItemName" offset="7" length="70" align="left" maxlines="2"/> </line> <line> <row_item name="Quantity" offset="17" length="10" align="right" /> <row_item name="UnitName" offset="28" length="9" align="left" /> <row_item name="Price" format="currency" decimal-places="PriceDecimalPlaces" offset="37" length="10" align="right" /> <row_item name="Discount" format="currency" offset="52" length="7" align="right" /> <row_item name="Value" format="currency" offset="60" length="10" align="right" /> <row_item name="VatRateValue" offset="70" length="10" align="right" /> </line> </row> </table>

Wygląd wydruku

Wydruk do pdf

Poniższy dokument składa się z opisu trzech części składających się na wygląd wydruku:

Atrybuty zawężające
Selektory
Reguły

Dostosowanie wygląd wydruku możliwe jest poprzez pliki #style#.xml, np. standardowym plikiem definiującym wygląd Faktury Sprzedaży jest plik 7#SalesInvoice#style#Wydruk_domyślny.xml. Głównym elementem tego pliku jest style, który zawiera elementy określające wygląd poszczególnych elementów wydruku zdefiniowanych w pliku layout. Jednym z elementów podrzędnych elementu style jest element fonts, który określa wszystkie czcionki, które zostaną wykorzystane w wydruku. Może on zawierać, jeden lub więcej elementów font, który definiuje krój, wielkość, wygląd oraz styl fontu.

Przyklad

Atrybuty elementu font to:

name - określa nazwę fontu, przez którą możemy się do niego odwołać
face - nazwa kroju fontu
size - rozmiar w punktach
color - kolor
style - style fontu. Może zawierać jedną (lub więcej wartości oddzielonych znakiem spacji) z wartości bold, italic, underline.

Wewnątrz elementu fonts powinien znaleźć się także jeden element font z pominiętym atrybutem name. Font ten będzie stosowany jako font domyślny dla wydruku.

Przyklad

Oprócz elementu fonts w pliku Styles.xml mogą znajdować się elementy w schemacie:

<selektor>
<reguła/>
<reguła/>
[...]
</selektor>

Gdzie selektor decyduje o tym, czy podległe mu reguły zostaną zastosowane dla danego elementu. Większość selektorów ma taką samą nazwę jak element, który stylują. Np. w celu ostylowania paragrafu (element p w pliku Layout.xml ) należy zastosować selektor p.

Przyklad

Powyższy przykład wszystkim paragrafom wydruku ustawi margines górny na 5 punktów. Selektor może wybrać do ostylowania tylko wybrane elementy danego typu. W tym celu do elementu w pliku Layout.xml oraz selektora w pliku Styles.xml należy dodać atrybut class. Selektor wybierze wtedy tylko te elementy, które mają identyczną wartość atrybutu class.

Przyklad

Powyższy przykład ustawi font wszystkich paragrafów na normal ale te, których atrybut class to title zostanie ustawiony font title. Dokładny opis innych atrybutów selektorów oraz spis reguł stylujących znajduje się w sekcji Wygląd. Lista selektorów oraz reguł, które można zastosować dla danego elementu znajduje się w opisie poszczególnych elementów w sekcji Układ. Reguły z pliku style stosowane są od góry do dołu tzn. jeżeli dwa selektory dopasują ten sam element i zawierają one takie same reguły z innymi wartościami to zostanie zastosowana wartość występująca później.

Atrybuty zawężające

Opis każdego selektora zawiera listę elementów, które styluje oraz listę reguł, jakie można w nim umieścić. Opis każdej reguły zawiera listę atrybutów jakie można w niej zastosować. Każdy selektor może zostać zawężony poprzez atrybut class. Dodatkowo selektory elementów związane z tabelami mogą zostać zawężone poprzez atrybut index, który może zawierać liczbę całkowitą lub wyrażenie postaci An+B, gdzie A oraz B to liczby całkowite. Selektor taki dopasuje element, jeżeli zgadza się on z indeksem wiersza tabeli (wiersze tabeli numerowane są od 0 z góry na dół). Przykłady:

index="0" - dopasuje pierwszy wiersz w tabeli
index="first" - dopasuje pierwszy wiersz w tabeli
index="last" - dopasuje ostatni wiersz w tabeli
index="5" - dopasuje szósty wiersz w tabeli
index="2n" - dopasuje parzyste wiersze tabeli tzn. z indeksem równym 0,2,4... czyli wiersze pierwszy, trzeci, piąty...
index="3n+1" - dopasuje wiersze z indeksem 1, 4, 7...
index="3n+2" - dopasuje wiersze z indeksem 2, 5, 8...

Selektory

Nazwa	Body
Opis	Selektor dla głównego elementu wydruku
Elementy stylowane	Body
Parametry zawężające	class
Reguły	page margin

Przyklad

Nazwa	Footer
Opis	Selektor dla stopki dokumentu
Elementy stylowane	Footer
Parametry zawężające	class
Reguły	margin text

Przyklad

Nazwa	DataCell
Opis	Selektor dla komórki w tabeli dynamicznej
Elementy stylowane	Column
Parametry zawężające	class index
Reguły	border background text

Przyklad

Nazwa	HeadCell
Opis	Selektor dla komórki nagłówka w tabeli dynamicznej
Elementy stylowane	Column
Parametry zawężające	class
Reguły	border background text

Przyklad

Nazwa	Hr
Opis	Selektor dla linii poziomej
Elementy stylowane	Hr
Parametry zawężające	class
Reguły	line

Przyklad

Nazwa	Image
Opis	Selektor dla obrazka
Elementy stylowane	Image
Parametry zawężające	class
Reguły	fit

Przyklad

Nazwa	P
Opis	Selektor dla paragrafu
Elementy stylowane	P
Parametry zawężające	class
Reguły	margin text border background

Przyklad

Nazwa	Section
Opis	Selektor dla sekcji
Elementy stylowane	Section
Parametry zawężające	class
Reguły	border background text

Przyklad

Nazwa	Table
Opis	Selektor dla tabeli dynamicznej
Elementy stylowane	Table
Parametry zawężające	class
Reguły	width border background text

Przyklad

Reguły

Nazwa	Background
Opis	Reguła określająca tło elementu
Atrybuty	color - kolor tła elementu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB

Nazwa	Border
Opis	Reguła określająca obramowanie elementu
Atrybuty	left - szerokość lewego obramowania. right - szerokość prawego obramowania. top - szerokość górnego obramowania. bottom - szerokość dolnego obramowania. color - kolor obramowania elementu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB borderStyle - styl obramowania. Może przyjmować jedną z wartości: o dashdot o dashdotdot o dashlargegap o dashsmallgap o dot o none o single
Uwagi	Szerokość obramowania może być podana w różnych jednostkach m.in.: cm, in, mm, pt. Domyślną jednostką są punkty.

Nazwa	borderLeft, borderRight, borderTop, borderBottom
Opis	Reguły określające poszczególne części obramowania elementu
Atrybuty	width - szerokość obramowania color - kolor obramowania borderStyle - styl obramowania

Nazwa	Fit
Opis	Reguła określająca rozmiar elementu
Atrybuty	width - szerokość elementu height - wysokość elementu
Uwagi	Szerokość i wysokość może być podana w różnych jednostkach m.in.: cm, in, mm, pt. Stylowany element zachowa swoje proporcje przyjmując mniejszy z podanych wymiarów.

Nazwa	Margin
Opis	Reguła określająca marginesy elementu
Atrybuty	left - lewy margines right - prawy margines top - górny margines bottom - dolny margines
Uwagi	Szerokość marginesu może być podana w różnych jednostkach m.in.: cm, in, mm, pt.

Nazwa	Text
Opis	Reguła określająca styl tekstu
Atrybuty	align - wyrównanie tekstu. Przyjmuje jedną z wartości: o right - wyrównanie do prawej o left - wyrównanie do lewej o justify - wyjustowanie tekstu o center - wyśrodkowanie tekstu indent - wcięcie pierwszej linii tekstu. leftIndent - wcięcie tekstu z lewej. rightIndent - wcięcie tekstu z prawej. font - nazwa fontu zdefiniowana wcześniej w sekcji fonts . color - kolor tekstu. Może on być w formacie #RRGGBB lub 0xRRGGBB lub 0xAARRGGBB

Nazwa	Width
Opis	Reguła określająca szerokość elementu
Atrybuty	percentage - procentowa szerokość elementu bazująca na szerokości elementu-rodzica

Przykłady wydruków fiskalnych

W aplikacji Comarch Mobile Sprzedaż nie ma możliwości modyfikacji wydruków z drukarki fiskalnej. Poniżej prezentowane są przykładowe wydruki paragonu oraz faktury na drukarce fiskalnej. W przypadku faktury drukowana jest również kopia dokumentu.

Przykład wydruku faktury na drukarce fiskalnej

Przykład wydruku paragonu na drukarce fiskalnej

Przykłady wydruków termicznych

W aplikacji Comarch Mobile możliwy jest wydruk dokumentów na drukarce termicznej. Wygląd wydruków można dowolnie modyfikować zgodnie z instrukcją dostępną TUTAJ. Poniżej znajduje się przykład standardowego wydruku termicznego dokumentu Zamówienia Sprzedaży.

Przykład wydruku Zamówienia Sprzedaży na drukarce fiskalnej

Dodawanie kolumny

Do omówienia tej modyfikacji, wykorzystany zostanie przykład dodania kolumny zawierającej informację o rabacie. W celu dodania nowej kolumny należy wyedytować plik #data#. Należy odszukać zapytanie wydobywające dane związane z pozycjami dokumentu. Aby wykorzystać te dane w definicji dokumentu konieczne jest stworzenie aliasu tej kolumny np. Discount. Po dokonaniu zmian zapisujemy dokument.

Dodanie aliasu kolumny odpowiedzialnej za wyświetlanie rabatu

Aby dane te pokazywały się na dokumencie, konieczne jest odpowiednie zmodyfikowanie pliku #layout#, w którym w odpowiedniej sekcji należy dodać kolumnę o nazwie „Rabat”. W description należy wpisać nazwę kolumny, class - określenie klasy, w tym przypadku jest to numer, var - odniesienie do aliasu kolumny określonej w pliku data tj. Discount. Aby poza wartością rabatu wyświetlany był również symbol procentów, należy dodać na końcu linii znak „%”. Ponieważ rabat powinien być wyświetlany zarówno na dokumencie tworzonym od wartości brutto jak i netto, należy skopiować definicje kolumny do poniższej sekcji. Na koniec zapisujemy zmiany.

Zmiana kolorystyki

W celu zmiany kolorystyki wydruku należy wyedytować plik #style#, zmieniając kod koloru dla poszczególnych elementów definicji wydruku w sekcji <fonts>. Kolory podawane są w zapisie heksadecymalnym.

Wskazówka

Zalecanym programem do tej modyfikacji jest Notepad++. Definicje kolorów w zapisie heksadecymalnym dostępne są w Internecie.

Dodawanie/usuwanie/zmiana logo

Aby logo było dodane na wydruku, należy wybraną grafikę zapisać pod nazwą logo.png w folderze wydruków Printouts. Zmiana logo na inne możliwa jest poprzez zmianę nazwy poprzedniej grafiki oraz dodanie nowej, jako plik o nazwie logo.png o nowszej dacie modyfikacji od poprzedniego, tak jak zostało to zaprezentowane na poniższym rysunku:

W celu usunięcia logo z wydruku dokumentu, należy usunąć zapytania zwracające logo tj.

W pliku Data: <set> <name>Logo</name> <query>SELECT Data FROM PrintoutsImages WHERE Name='logo.png'</query> </set>
W pliku Layout: <image set="Logo" var="Data" />

Dodanie nowych danych na wydruk

Jeżeli istnieje potrzeba pokazania na wydruku niestandardowych danych można to zrealizować w następujący sposób:

przesynchronizować potrzebne dane do tabeli Configuration bazy mobilnej
umieścić nowe dane na wydruku

Poniżej przedstawiony jest przykład dodania na wydruk dokumentu danych pracownika, który wystawił dokument: Zamówienie Sprzedaży przy współpracy z Comarch ERP XL 2018.2.1. W sposób opisany poniżej można synchronizować dowolne dane z systemu ERP i prezentować je na wydruku.

Uwaga

Zapytania SQL wykorzystywane w tym przykładzie mogą różnić się w zależności od systemu ERP oraz jego wersji.

W pierwszej kolejności należy w odpowiednim dla wersji systemu ERP pliku konfiguracyjnym znajdującym się w katalogu Methods serwera synchronizacji (ścieżka domyślna: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration) dodać następujące zapytanie:

UNION ALL
select
1,
0,
'ImieNazwisko',
cast ((Prc_Imie1 +' '+ Prc_Nazwisko) as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId
UNION ALL
select
1,
0,
'telefon',
cast (Prc_Telefon3 as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId
UNION ALL
select
1,
0,
'email',
cast (Prc_EMail as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId

Powyższe zapytania pobierają z bazy systemu ERP dane dotyczące pracownika: imię i nazwisko, telefon, e-mail. Dodanie zapytań do pliku spowoduje, że konkretne dane zostaną przesynchronizowane do tabeli Configuration na bazie mobilnej. Kolejnym krokiem jest modyfikacja pliku wydruku 1#SalesOrder#data#Wydruk_domyślny.xml znajdującego się w katalogu Printouts serwera synchronizacji. Należy dodać zapytania pobierające zsynchronizowane wcześniej dane do tabeli Configuration. Nowo dodane fragmenty zostały oznaczone kolorem żółtym:

...
<set>
<name>Logo</name>
<query>SELECT Data FROM PrintoutsImages WHERE Name='logo.png'</query>
</set>
<set>
<name>Wystawil</name>
<query>SELECT Value FROM Configuration WHERE key like 'ImieNazwisko'</query>
</set>
<set>
<name>Wystawiltel</name>
<query>SELECT Value FROM Configuration WHERE key like 'telefon'</query>
</set>
<set>
<name>Wystawilemail</name>
<query>SELECT Value FROM Configuration WHERE key like 'email'</query>
</set>
...

Ostatnim krokiem jest modyfikacja pliku wydruku 1#SalesOrder#layout#Wydruk_domyślny.xml, która polega na dodaniu wpisów odpowiedzialnych za wyświetlanie danych, które zostały zwrócone w zapytaniach w pliku 1#Order#data#Wydruk_domyślny.xml:

…
<horizontal split="no">
<section weight="2.4"/>
<section weight="0.8">
<image class="signature" set="Header" var="Signature" />
</section>
</horizontal>
<horizontal split="no">
<section weight="1.5">
<p class="left"><data set="Wystawil" var="Value" /></p>
<p class="left">Telefon: <data set="Wystawiltel" var="Value" /></p>
<p class="left">E-mail: <data set="Wystawilemail" var="Value" /> </p>
<hr/>
<p class="centered">Uprawniony do wystawienia dokumentu</p>
</section>
…

Po wykonaniu powyższych modyfikacji należy wykonać synchronizację z urządzenia mobilnego. Po modyfikacji wydruk powinien wglądać następująco:

Zamówienie Sprzedaży z danymi osoby wystawiającej

Usunięcie tabeli i przesunięcie tekstu

Opis modyfikacji będzie dotyczył standardowej definicji wydruku termicznego dokumentu Faktura sprzedaży. Opisane zostanie usunięcie tabeli zawierającej informacje o VAT oraz przesunięcie informacji o zapłacie na prawą stronę wydruku.

Standardowy wydruk termiczny dokumentu Faktura Sprzedaży

Należy zmodyfikować plik: 17#SalesInvoice#layout#Thermal#Vline112#Wydruk_domyślny.xml. W pliku tym należy usunąć lub zakomentować linijki dotyczące tabeli zawierającej informacje o VAT jak poniżej:

<table query="VatAggregation" length="64">
<header>
<column offset="0">Stawka VAT</column>
<column offset="18">Wartość netto</column>
<column offset="34">Wartość VAT</column>
<column offset="48">Wartość brutto</column>
</header>
<row>
<line>
<row_item name="VatRateName" offset="0" length="18" align="left" />
<row_item name="NetValue" format="currency" offset="18" length="13" align="right" />
<row_item name="VatValue" format="currency" offset="31" length="14" align="right" />
<row_item name="GrossValue" format="currency" offset="45" length="17" align="right" />
</line>
</row>
</table>

oraz dla części zawierającej informacje o zapłacie zmodyfikować wartości offset z 0 na 40 (cały wydruk ma szerokość 80) poszczególnych danych jak w przykładzie poniżej zaznaczono kolorem czerwonym:

...
<line>
<text offset="40" length="21" align="left">Razem do zapłaty:</text>
<data query="Summary" columnName="Value" format="currency" offset="22" length="10" align="right" />
</line>
<line>
<text offset="40" length="21" align="left">Zapłacono:</text>
<data query="Summary" columnName="Paid" format="currency" offset="22" length="10" align="right" />
</line>

<command comment="set_bold_font" format="hex" code="1B47"/> 
<line>
<text offset="40" length="21" align="left">Pozostaje do zapłaty:</text>
<data query="Summary" columnName="ToPay" format="currency" offset="22" length="10" align="right" />
<data query="Header" columnName="Currency" offset="33" length="5" align="left" />
</line>
...

Po wprowadzeniu tej modyfikacji wydruk termiczny Faktury sprzedaży powinien wyglądać następująco:

Wydruk dokumentu Faktura Sprzedaży po modyfikacji

Dodanie nowych danych na wydruk

Jeżeli istnieje potrzeba pokazania na wydruku niestandardowych danych można to zrealizować w następujący sposób:

przesynchronizować potrzebne dane do tabeli Configuration bazy mobilnej
umieścić nowe dane na wydruku

Poniżej przedstawiony jest przykład dodania na wydruk dokumentu danych pracownika, który wystawił dokument: Faktura Sprzedaży przy współpracy z Comarch ERP XL 2018.2.1. W sposób opisany poniżej można synchronizować dowolne dane z systemu ERP i prezentować je na wydruku.

Uwaga

Zapytania SQL wykorzystywane w tym przykładzie mogą różnić się w zależności od systemu ERP oraz jego wersji.

W pierwszej kolejności należy w odpowiednim dla wersji systemu ERP pliku konfiguracyjnym znajdującym się w katalogu Methods serwera synchronizacji (ścieżka domyślna: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration) dodać następujące zapytanie:

UNION ALL
select
1,
0,
'ImieNazwisko',
cast ((Prc_Imie1 +' '+ Prc_Nazwisko) as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId
UNION ALL
select
1,
0,
'telefon',
cast (Prc_Telefon3 as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId
UNION ALL
select
1,
0,
'email',
cast (Prc_EMail as varchar)
from cdn.opekarty opekar
join cdn.PRCKarty pckar on opekar.Ope_PrcNumer=pckar.Prc_GIDNumer
where Ope_GIDTyp =128 and Ope_GIDNumer=@UserId

Powyższe zapytania pobierają z bazy systemu ERP dane dotyczące pracownika: imię i nazwisko, telefon, e-mail. Dodanie zapytań do pliku spowoduje, że konkretne dane zostaną przesynchronizowane do tabeli Configuration na bazie mobilnej. Kolejnym krokiem jest modyfikacja pliku wydruku 11#SalesOrder#data#Thermal#Vline112#Wydruk_domyślny.xml znajdującego się w katalogu Printouts serwera synchronizacji. Należy dodać zapytania pobierające zsynchronizowane wcześniej dane do tabeli Configuration. Nowo dodane fragmenty zostały oznaczone kolorem żółtym:

...
<set>
<name>Logo</name>
<query>SELECT Data FROM PrintoutsImages WHERE Name='logo.png'</query>
</set>
<set>
<name>Wystawil</name>
<query>SELECT Value FROM Configuration WHERE key like 'ImieNazwisko'</query>
</set>
<set>
<name>Wystawiltel</name>
<query>SELECT Value FROM Configuration WHERE key like 'telefon'</query>
</set>
<set>
<name>Wystawilemail</name>
<query>SELECT Value FROM Configuration WHERE key like 'email'</query>
</set>
...

Ostatnim krokiem jest modyfikacja pliku wydruku 11#SalesOrder#layout#Thermal#Vline112#Wydruk_domyślny.xml, która polega na dodaniu wpisów odpowiedzialnych za wyświetlanie danych, które zostały zwrócone w zapytaniach w pliku 11#SalesOrder#data#Thermal#Vline112#Wydruk_domyślny.xml w miejsce nad linię z informacją o osobach uprawnionych i dacie odbioru:

…
<line>
<data query="Wystawil" columnName="Value" format="currency" offset="0" length="30" align="center" />
</line>
<line>
<data query="Wystawiltel" columnName="Value" format="currency" offset="0" length="30" align="center" />
</line>
<line>
<data query="Wystawilemail" columnName="Value" format="currency" offset="0" length="30" align="center" />
</line>

<line>
<text offset="0" length="30" align="center">Uprawniony do wystawienia dok.</text>
<text offset="31" length="18" align="center">Data odbioru</text>
<text offset="50" length="30" align="center">Uprawniony do odbioru dok.</text>
</line>
…

Po wykonaniu powyższych modyfikacji należy wykonać synchronizację z urządzenia mobilnego. Po modyfikacji wydruk termiczny powinien wglądać następująco:

Wydruk dokumentu Faktura Sprzedaży z dodatkowymi danymi

Raporty

Istnieje możliwość przeglądania raportów z poziomu aplikacji. Raporty są dostępne z poziomu menu głównego po wybraniu kafla Raporty, a także po odpowiedniej konfiguracji z poziomu:

Karty Kontrahenta
Listy Kontrahentów
Karty towaru
Dużej kalkulacji podczas dodawania pozycji na dokument
Listy pozycji dokumentu

Domyślnie w aplikacji znajdują się następujące raporty systemowe:

Raport dobowy przedstawiciela – prezentuje listę wystawionych w danym dniu dokumentów sprzedażowych oraz zapisów kasowych a także aktualny stan towarów na magazynie mobilnym przedstawiciela.
Kontrahenci bez transakcji – prezentuje listę kontrahentów, którzy w określonym przedziale czasu nie dokonali żadnej transakcji

Wywołanie raportu odbywa się poprzez wybór przycisku [Pokaż] dostępnego w menu rozwijanym lub wybrania pozycji z nazwą raportu.

– Wywołanie danego raportu W Comarch Mobile Zakupy udostępniono możliwość wyświetlania raportów z różnych poziomów aplikacji, nie tylko z poziomu kafelka raporty. Raporty będą mogły zostać wyświetlone z poziomu:

Karty Kontrahenta
Listy Kontrahentów
Karty towaru
Dużej kalkulacji podczas dodawania pozycji na dokument
Listy pozycji dokumentu

Po odpowiedniej konfiguracji w definicji raportów, wybrane raporty będą widoczne w wyżej wymienionych lokalizacjach w aplikacji, więcej informacji dotyczących konfiguracji znajduje TUTAJ.

Wyświetlenie raportów z poziomu listy pozycji dokumentu i dużej kalkulacji pozycji

Przy wyświetlaniu raportu z listy kontrahentów, z karty danego kontrahenta, czy z poziomu listy pozycji dokumentu. Kontrahent podpowiada się już w parametrach raportu. Podobnie jest w przypadku towarów (wyświetlanie raportu z listy towarów, karty towaru). Przy wyświetlaniu raportu z listy kontrahentów, z karty danego kontrahenta, z poziomu listy pozycji dokumentu czy realizacji wizyty Kontrahent podpowiada się już w parametrach raportu. Podobnie jest w przypadku towarów (wyświetlanie raportu z listy towarów, karty towaru). Dodatkowo istnieje możliwość drukowania raportów z poziomu aplikacji. W tym celu należy stworzyć odpowiednią definicję wydruku danego raportu i umieścić ją w katalogu C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Printouts. Wówczas będzie możliwość drukowania raportu, analogicznie jak dokument:

na drukarce mobilnej sparowanej z urządzeniem (opcja: Drukuj),
lub wywołać wydruk pdf (opcja: Wyślij do drukarki),
pojawi się także możliwość przesłania wiadomości e-mail z wygenerowanym raportem w formacie pdf.

W aplikacji Comarch Mobile istnieje możliwość dowolnego ustawiania kolejności raportów na liście, np. prezentować na początku listy te raporty, które są najczęściej używane przez przedstawiciela handlowego. W tym celu na definicji raportu, który znajduje się w lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Reports należy określić wartość priorytetu:

Im wartość priorytetu jest wyższa, tym raport będzie znajdował się wyżej na liście.

Możliwość zmiany kolejności raportów na liście

Raport: Kontrahenci bez transakcji

Raport: Kontrahenci bez transakcji prezentuje listę kontrahentów, którzy w danym okresie nie dokonali żadnej transakcji.

W celu zmiany parametrów wywołania raportu należy wybrać przycisk:

.

Raport dobowy przedstawiciela

Raport dobowy przedstawiciela pozwala wyświetlić informacje na temat wystawionych w danym dniu:

dokumentów sprzedażowych: FS, PA, WZ,
zapisów kasowych: KP/KW,
aktualnego stanu towarów na magazynie mobilnym przedstawiciela

W standardzie aplikacji istnieje możliwość wydrukowania raportu na drukarce mobilnej lub stacjonarnej, a także wysłania go jako za pomocą wiadomości e-mail. Przykładowy raport przedstawia poniższy rysunek:

Dokumenty

Zarejestrowanie dokumentu zakupu w aplikacji Comarch Mobile Zakupy jest możliwe również z kafelka dokumenty po wybraniu ikony plusa. Po jego wybraniu zostanie rozwinięta lista dostępnych dokumentów: zamówienia zakupu (ZZ), oferty zakupu (OZ). Jeśli w aplikacji dostępny jest kontrahent [Jednorazowy] wówczas po wyborze typu dokumentu pokaże się okno dokumentu z wybranym kontrahentem: Jednorazowym. Jeżeli w aplikacji nie ma kontrahenta [Jednorazowego] wówczas po wyborze typu dokumentu pokaże się okno z wyborem kontrahenta.

Jeżeli w aplikacji wystawiane są zarówno dokumenty zakupu jak i sprzedaży, podział na Sprzedaż i Zakup prezentowany jest także na kaflu z Dokumentami. Sekcja podzielona jest wówczas na dwie zakładki: Sprzedaż oraz Zakup, a do rejestrowania dokumentów obydwu typów służą dwa oddzielne przyciski na Action Barze.

Jeżeli w aplikacji wystawiany jest tylko jeden rodzaj dokumentów (tylko sprzedaży lub tylko zakupu) listę dokumentów należy prezentować jak dotychczas – bez rozbijania na zakładki. Podczas wystawiania dokumentów przychodowych z okna: [Dokumenty] automatycznie powinien w zależności od parametru [SelectContractorWhenAddingDocument] na Numeratorze dodawać się dokument na kontrahenta Jednorazowego, jeżeli występuje w bazie, lub powstawać lista kontrahentów.

Menu kontekstowe dokumentu

Standardowym gestem otwierającym menu kontekstowe rekordu jest dłuższe przytrzymanie palca na danej pozycji. Dodatkowo w miejscach, gdzie takie menu kontekstowe jest dostępne znajduje się przycisk:

, który również umożliwia jego otwarcie. Opcje w menu kontekstowe mogą się różnić w zależności od statusu dokumentu:

Dokument niezatwierdzony – dostępne opcje:
- [Edytuj] - edycja dokumentu, otwarcie okna umożliwiającego naniesienie dodatkowych zmian i zatwierdzenie,
- [Podgląd] - podgląd dokumentu.
- [Usuń] - usunięcie dokumentu będącego w buforze.

Dokument zatwierdzony – dostępne opcje:
- [Edytuj] - edycja dokumentu, otwarcie okna umożliwiającego cofnięcie zatwierdzenia dokumentu i przejście do jego edycji, opcja dostępna, jeżeli dokument nie został wysłany do systemu ERP
- [Podgląd] - podgląd dokumentu,
- [Wyślij] - wysłanie dokumentu na e-mail/do drukarki.

Pobrane dokumenty z systemu na liście dokumentów w kaflu Dokumenty oraz na liście dokumentów z poziomu karty kontrahenta oznaczone są dodatkową ikoną

.

Filtrowanie dokumentów

Z poziomu listy dokumentów istnieje możliwość filtrowania.

Filtrowanie listy dokumentów z poziomu kafelka [Dokumenty]

W aplikacji udostępniono filtrowanie listy dokumentów po kilku atrybutach jednocześnie. Po wybraniu opcji [Informacje dodatkowe] pokazuje się lista atrybutów :

Wybór klasy atrybutu w filtrze na liście kontrahentów

Po wybraniu określonych typów dokumentów będą one dostępne w dolnej części okna w kafelku [Dokumenty] W celu poprawy niezawodności aplikacji Comarch Mobile Zakupy umożliwiono odzyskiwanie dokumentów w przypadku nieoczekiwanego zamknięcia aplikacji. Wówczas po powrocie na menu główne pojawi się komunikat, jak na zdjęciu poniżej. Po wybraniu opcji [TAK], dokument zostanie odzyskany.

Rejestracja dokumentu

Z poziomu aplikacji Comarch Mobile istnieje możliwość zarejestrowania dokumentów:

Zamówienia zakupu (ZZ),
Oferty zakupu (OZ),

Dokumenty można dodawać z poziomu:

Szczegółów karty kontrahenta:

Okna: Dokumenty

Listy kontrahentów

Po wybraniu przycisku dodania dokumentu należy określić typ rejestrowanego dokumentu. Jeżeli Przedstawiciel handlowy ma możliwość rejestracji tylko jednego typu dokumentu, okno wyboru typu nie zostanie wyświetlony. Nastąpi natomiast bezpośrednie przekierowanie do okna rejestracji dokumentu. Rejestracja dokumentu składa się z następujących etapów:

Wybór określonych elementów z poziomu Listy towarów
Wprowadzenie podpisu
Zatwierdzenie

Blokada wystawiania dokumentów dla określonych kontrahentów

Aplikacja Comarch Mobile umożliwia skonfigurowanie, jakie typy dokumentów mają być dostępne dla poszczególnych kontrahentów. Jeden kontrahent może mieć udostępniony dany typ dokumentu, podczas gdy dla innego kontrahenta typ ten może zostać ukryty. Istnieje także możliwość ukrycia wszystkich typów dokumentów dla kontrahenta. Wówczas po wybraniu opcji: Dodaj dokument, w aplikacji zostanie wyświetlony odpowiedni komunikat, jak na poniższym rysunku.

Uwaga

Za konfigurację tej funkcjonalności odpowiada parametr BlockAddingDocument. Więcej informacji na temat konfiguracji znajduje się TUTAJ.

Komunikat wyświetlany, jeżeli wszystkie typy dokumentów zostaną zablokowane dla kontrahenta

Lista towarów

Spis treści

Filtrowanie listy towarów

Po wyborze przycisku dodania nowego dokumentu zostanie wyświetlone okno: Towary.

Stany towarów, które nie są dostępne na magazynie prezentowane są na liście w kolorze czerwonym. W widoku poziomym lista towarów w trakcie wystawiania dokumentu jest podzielona na trzy części:

Lista towarów ze wszystkimi zakładkami dokumentu
Szczegóły towaru
Szczegóły elementu (duża kalkulacja)

Wystawianie dokumentu, zakładka [Towary] – widok poziomy

Poruszając się po liście użytkownik ma możliwość wyświetlenia w bieżącym oknie danych wybranego towaru oraz szczegółów elementu wystawianego dokumentu. W górnym pasku okna:

z lewej strony widoczny jest kod i nazwa towaru lub numer i wartość zamówienia
z prawej strony przycisk zapisania elementu
ikonka dodania informacji dodatkowej.

Filtrowanie

Istnieje możliwość zawężenia listy towarów poprzez wykorzystanie filtrów dostępnych w dolnej części okna. Po wybraniu przycisku

użytkownik może dokonać wyboru kryteriów, według których będzie odbywało się filtrowanie listy towarów.

W aplikacji udostępniono filtrowanie listy kontrahentów po kilku atrybutach jednocześnie. Po wybraniu opcji [Informacje dodatkowe] pokazuje się lista atrybutów:

W przypadku wyboru kryterium: [Po towarach] zostanie wyświetlone okno, w którym będzie możliwość wyboru, czy filtrowanie będzie odbywało w oparciu o nazwę lub kod towaru, czy o kod EAN przypisany do jego karty. W zależności od ustawień listy towarów wyszukiwanie rozpocznie się po wpisaniu wskazanej ilości znaków w polu wyszukiwania. Opis ustawień listy towarów znajduje się TUTAJ.

Filtr na liście towarów, wybór kryterium: Po towarach

Po wybraniu kryterium filtra [Promocje] zostanie wyświetlone okno, w którym użytkownik ma możliwość wyfiltrowania listy promocji po nazwie.

Filtr na liście towarów, wybór kryterium: Promocja

Przy każdej promocji dostępna jest ikona

, która umożliwia przejście do sekcji ze szczegółowymi informacjami o promocji. Widok promocji jest taki sam, jak po wejściu w promocję na karcie Kontrahenta w sekcji „Istnieją obowiązujące promocje”. Więcej informacji o promocjach znajduje się TUTAJ.

Uwaga

Filtr [Promocje] jest dostępny w przypadku, gdy nie została zablokowana widoczność promocji.

Koszyk

Wyświetlenie zawartości Koszyka jest możliwe po przejściu na kolejną zakładkę. Z poziomu menu kontekstowego elementy dodane do Koszyka można:

Zmodyfikować,
Skopiować,
Usunąć.

Ponadto z tego poziomu można także wyświetlić szczegóły karty dodanego towaru oraz sprawdzić stan towaru.

Po wybraniu towaru dodanego do koszyka więcej niż jeden raz, zostanie wyświetlone okno z informacją na temat dodanej ilości oraz wartości netto i brutto za elementy (wartość = ilość x cena).

Okno: [Towary], towar dodany kilka razy do koszyka

Na liście filtrów dostępnych z poziomu zakładki: Koszyk na dokumencie zostały również dodane dwa filtry: Producent oraz Marka. Po wybraniu filtra zostaje wyświetlona lista Producentów/Marek powiązanych z towarami dodanymi do koszyka. Na liście prezentowana jest także wartość dokumentu w kontekście konkretnej Marki/Producenta. Jeżeli na filtrze zostanie wybrana określona wartość, lista towarów w Koszyku zostanie odfiltrowana – zawężona do wybranej Marki/Producenta.

Filtr: Marka oraz Producent na zakładce Koszyk dokumentu

Istnieje możliwość przełączenia się na widok katalogowy towarów dodanych do koszyka. Dotychczas opcja wyświetlania zdjęć towarów możliwa była jedynie z poziomu widoku listy towarów – gdzie prezentowane są wszystkie towary, zarówno te na które Klient się zdecydował jak i te nie dodane na dokument. Nowa opcja daje możliwość szybkiego podglądu miniatur zdjęć towarów za pomocą opcji

dostępnej na nagłówku wystawianego dokumentu. W razie potrzeby widok zdjęć towarów dodanych do koszyka można równie szybko wyłączyć poprzez wybranie opcji:

. W aplikacji Comarch Mobile umożliwiono wyświetlanie na liście towarów oraz liście pozycji dodanych do koszyka informacji o ilości i cenie w jednostce podstawowej jak i domyślnej jednostce pomocniczej. Podejrzenie ilości i ceny w jednostce podstawowej możliwe jest już z poziomu listy towarów, bez konieczności podnoszenia kalkulacji dla pozycji. Funkcjonalność ta dotyczy towarów, które zostały dodane na dokument w jednostce pomocniczej. Więcej informacji odnośnie konfiguracji tej funkcjonalności znajduje się TUTAJ. Taka możliwość istnieje podczas wystawiania dokumentów:

Oferta zakupu
Zamówienie zakupu

Po wyborze towarów i dokonaniu ewentualnych zmian na nagłówku dokumentu, dokument można:

Zapisać – dokument zostanie zapisany do bufora, nie zostanie wysłany do systemu Comarch ERP XL podczas synchronizacji,
Zatwierdzić – po zatwierdzeniu dokument będzie wysłany do systemu podczas synchronizacji,
Wyjść bez zapisu,
Anulować – jeśli dokument był edytowany, po wybraniu tej opcji zmiany nie zostaną zapisane

Dodanie towaru do koszyka

Spis treści

Uproszczone dodawanie pozycji do koszyka Tryb uproszczony z klawiaturą Pełna kalkulacja elementu

Towar może zostać dodany do Koszyka z poziomu:

listy towarów tworząc dany dokument istnieje możliwość dodania towaru do Koszyka:

Wpisując ręcznie kod EAN wagowy/cenowy i zatwierdzenie Enterem
Skanując kod m. in. za pomocą aplikacji Binary Eye

W oknie dodawania towaru do Koszyka istnieje możliwość określenia zamawianej ilości oraz udzielenia rabatu dla wybranej pozycji pod warunkiem, że widoczność promocji nie jest wyłączona.

Seryjne dodawanie towarów do koszyka

Istnieje możliwość seryjnego dodawania towarów do koszyka. W tym celu należy z paska górnego wybrać przycisk

, a następnie przycisk

.

Opcja seryjnego dodawania towarów do koszyka

Po naciśnięciu przycisku pojawi się okno, w którym należy wpisać ilość towarów dodawanych seryjnie.

Opcja będzie dotyczyła wszystkich towarów aktualnie znajdujących się na liście towarów. Listę można zawęzić do określonych towarów poprzez zastosowanie filtra.

Uwaga

W trakcie otwierania listy towarów do pamięci urządzenia pobierane jest maksymalnie 100 towarów. Jeżeli odfiltrowana lista towarów będzie miała więcej niż 100 elementów, to przy seryjnym dodawaniu towarów zostanie dodane 100 pozycji. Aby w takiej sytuacji dodać więcej niż 100 pozycji do koszyka należy przewinąć listę towarów do ostatniego towaru spełniającego dane kryterium filtrowania.

Uproszczone dodawanie pozycji do koszyka

Przy współpracy z systemem Comarch ERP Altum istnieje możliwość uproszczonego wprowadzania pozycji do koszyka na dokumencie. Aby zmienić widok listy towarów należy wejść w ustawienia aplikacji i w sekcji „Parametry dokumentów” zaznaczyć uproszczony widok listy – więcej informacji nt. temat znajduje się TUTAJ. Po zaznaczeniu uproszczonego widoku listy towarów przypadku listy towarów pojawiają się kwadratowe przyciski, które umożliwiają szybkie dodawanie towaru do koszyka oraz spełniają funkcję informacyjną:

– pozycja nie jest dodana do koszyka

– pozycja jest prawidłowo dodana do koszyka..

– ostrzeżenie – dodanie pozycji nie jest zablokowane, natomiast zaistniało zdarzenie, o którym Operator powinien być powiadomiony, by miał możliwość skorygowania

– blokada – wprowadzona ilość jest niepoprawna i nie można zapisać pozycji (np. nieprawidłowy przelicznik). Nie można przejść do innej pozycji do czasu poprawienia ilości na elemencie. W widoku katalogowego na pozycjach pojawia się cena i ilość wybranego towaru, a w przypadku błędu wyświetla się odpowiedni komunikat.

Widok listy towarów w trybie uproszczonym

Tryb uproszczony z klawiaturą

W ustawieniach aplikacji należy zmienić widok listy towarów na uproszczony z klawiaturą. Klawiatura pojawia się przy rozpoczęciu edycji danej pozycji. Umożliwia to wpisywanie wartości dwucyfrowych oraz ułamkowych. W celu wprowadzenia wartości ułamkowej należy kliknąć i przytrzymać przycisk 9_. Dłuższe przytrzymanie przycisku 0_xpowoduje usunięcie pozycji z zamówienia.

Widok listy towarów w trybie uproszczonym z klawiaturą

Poruszając się po liście użytkownik ma możliwość wyświetlenia w bieżącym oknie danych wybranego towaru oraz szczegółów elementu wystawianego dokumentu. W górnym pasku okna:

z lewej strony widoczny jest kod i nazwa towaru lub numer i wartość zamówienia
z prawej strony przycisk zapisania elementu,
ikonka dodania informacji dodatkowej

Pełna kalkulacja elementu

Pełna Kalkulacja elementu zawiera następujące informacje:

Kod oraz nazwa towaru
Cena bazowa
Marża minimalna
Stawka podatku VAT sprzedaży
Marża uzyskana prezentowana w procentach – pole możliwe do edycji
Wartość uzyskanej marży
Ilość zamawianego towaru – pole możliwe do edycji
Stan towaru na magazynie
Cena początkowa (pole ukryte przy wyłączonej widoczności promocji)
Rabat – pole możliwe do edycji (pole ukryte przy wyłączonej widoczności promocji)
Cena końcowa – pole możliwe do edycji
Wartość elementu netto oraz brutto – pole możliwe do edycji
Waga elementu
Magazyny
Opis elementu – pole możliwe do edycji
Informacja dodatkowa (widoczne, gdy został dodany atrybut)- Tylko z poziomu pełnej kalkulacji można dodać atrybut na pozycji dokumentu.
Załączniki
Dokumenty – lista dokumentów historycznych

Z poziomu skróconej jak i pełnej kalkulacji elementu istnieje możliwość skopiowania ilości oraz ceny użytej w poprzednich transakcjach dla wybranego kontrahenta. Przy czym cenę z transakcji historycznej można kopiować tylko dla poszczególnych, pojedynczych pozycji – nie automatycznie dla wszystkich pozycji na dokumencie. Informacje są prezentowane, jeżeli w ustawieniach aplikacji został zaznaczony parametr: [Pokazuj elementy historyczne]. Przeniesienie wartości do aktualnie wystawianego dokumentu odbywa się poprzez wybranie ilości lub ceny w prezentowanym oknie w sekcji dotyczącej historyczności.

Uwaga

Zarówno na małej, jak i na dużej kalkulacji: cena początkowa (za szt.), marża, cena końcowa, pobierana z cennika w innej walucie niż systemowa jest przeliczana na walutę systemowa.

W sekcji: Cechy towaru, można określić cechę towaru:

Okno dużej kalkulacji podczas generowania dokumentu

Wybrana cecha jest prezentowana również z poziomu Koszyka pod nazwą towaru. Jeśli podczas generowania dokumentu zostanie wprowadzona ilość większa niż dostępne zasoby dla danej partii towaru, pojawi się komunikat jak na rysunku poniżej:

Informacja o niewystarczających zasobach dla danej partii

W aplikacji Comarch Mobile istnieje także funkcjonalność prezentacji pokrycia realizacji zamówienia względem poszczególnych magazynów. Informacja o tym, czy wskazane przez użytkownika ilości wybranych towarów znajdują się na danym magazynie są prezentowane w postaci procentowej, odpowiednim kolorem – w zależności od dostępności towarów. Użytkownik może sprawdzić:

dostępność konkretnego towaru na poszczególnych magazynach – z poziomu dużej kalkulacji pozycji

Prezentacja pokrycia realizacji danego towaru na poszczególnych magazynach

możliwość zrealizowania całego zamówienia na poszczególnych magazynach – z poziomu nagłówka dokumentu.

Prezentacja pokrycia realizacji całego zamówienia na poszczególnych magazynach

Dzięki wyświetlaniu tej informacji użytkownik może zmienić magazyn, jeżeli realizacja zamówienia na wybranym magazynie okaże się niemożliwa ze względu na niewystarczającą ilość zasobów na tym magazynie.

Cofanie dokumentów do bufora

Spis treści

Usuwanie dokumentów

Cofanie dokumentu do bufora odbywa się poprzez wybranie przycisku

, który jest dostępny z poziomu okna: Dokumenty w menu rozwijanym dla danego dokumentu:

Okno: Dokumenty, lista przycisków rozwijanych

Dodatkowo podczas podglądu dokumentu zatwierdzonego, który nie został jeszcze zsynchronizowany do systemu Comarch ERP Altum istnieje możliwość cofnięcia dokumentu do bufora poprzez wybranie przycisku

.

Po wybraniu opcji: [Tak], dokument zostanie cofnięty do bufora.

Komunikat towarzyszący cofaniu dokumentu do bufora

Usuwanie dokumentów

Usunięcie dokumentu będącego w buforze odbywa się poprzez wybranie przycisku

. Opcja jest dostępna z poziomu okna: Dokumenty w menu rozwijanym dla danego dokumentu:

Po wybraniu opcji Komunikat towarzyszący usuwaniu dokumentu, dokument zostanie usunięty.

Wydruk dokumentu

Wygląd wydruków dla poszczególnych typów dokumentów i/lub operatorów można modyfikować – np. dodając własne logo firmy na wydruku. Więcej informacji oraz przykłady takich modyfikacji można znaleźć TUTAJ.

Zatwierdzanie dokumentu – zakładka Podpis

Po wybraniu przycisku Podpisz należy wprowadzić podpis (przez pracownika kontrahenta, z którym prowadzona jest transakcja lub samego przedstawiciela handlowego).

Istnieje możliwość zatwierdzania dokumentów bez podpisu. Poprzez ustawienie odpowiedniego parametru istnieje możliwość skonfigurowania, dla jakich typów dokumentów podpis ma być wymagany, a dla których może on być pomijany. Dla takich dokumentów (dla których wymagalność podpisu została wyłączona) okno rejestracji dokumentu składa się z 3 zakładek – zakładka z Podpisem nie jest prezentowana. Użytkownik może w szybki sposób zatwierdzić taki dokument, poprzez wybranie opcji: Zatwierdź wyświetlanej na nagłówku dokumentu lub w standardowy sposób poprzez wybór z wszystkich dostępnych opcji. Po wybraniu opcji: [Zatwierdź i wyślij] pojawi się okno zaprezentowane poniżej:

Opcja: Powrót

Wybranie przycisku: [Powrót] dostępnego na urządzeniu podczas rejestracji dokumentu spowoduje wyświetlenie okna zaprezentowanego na rysunku poniżej:

Jeżeli podczas rejestrowania dokumentu przynajmniej jeden towar został dodany do Koszyka, wówczas podczas próby wyjścia bez zapisu z dokumentu zostanie dodatkowo wyświetlony komunikat informujący o istnieniu pozycji w koszyku. Na tym poziomie użytkownik będzie musiał określić czy na pewno chce wyjść bez zapisu dokumentu.

Nagłówek dokumentu

Z poziomu okna [Nagłówek dokumentu] widoczne są pola zaprezentowane poniżej. Pola oznaczone symbolem

są możliwe do edycji po naciśnięciu przycisku.

Uwaga

Pola: [Cena początkowa] i [Rabat] są ukryte przy wyłączonej widoczności promocji. W przypadku dezaktywacji formy płatności w systemie Comarch ERP Altum podczas rejestrowania nowego dokumentu nieaktywna forma płatności nie będzie dostępna.

W aplikacji istnieje możliwość zablokowania zmiany na nagłówku dokumentu:

Formy płatności
Terminu płatności
Daty realizacji

W widoku poziomym, aby użytkownik mógł modyfikować elementy nagłówka dokumentu, które mają wpływ na wartość dokumentu, np. Magazyn, wszystkie elementy dokumentu muszą być zapisane (zamknięte).

Możliwość dodania i edycji nowego adresu dla Kontrahenta docelowego

W aplikacji umożliwiono określenie danych kontrahenta bezpośrednio podczas rejestracji dokumentu. Z poziomu nagłówka dokumentu opcji edycji adresu docelowego została dodana możliwość dodania nowego adresu kontrahenta, po uzupełnieniu i zatwierdzeniu danych adres zostaje automatycznie dodany na wystawianym dokumencie.

Możliwość dodania dodatkowego adresu dla kontrahenta docelowego podczas rejestracji dokumentu

Prezentacja wagi całego dokumentu oraz poszczególnych towarów

Po zaznaczeniu parametru w Ustawieniach aplikacji [Pokazuj wagę towarów] (opis tego parametru znajduje się TUTAJ), przedstawiciel podczas wystawiania dokumentu może kontrolować wagę całego zamówienia.

Zaznaczenie w ustawieniach konfiguracji parametru widoczności wagi towarów na dokumencie

Wyświetlenie jednostek zdefiniowanych dla towaru i ustawienie jednostki domyślnej

Wyświetlanie na dokumencie wagi wszystkich towarów dodanych do koszyka

Zdefiniowana waga (brutto) na kartach towarów w systemie Comarch ERP Altum jest pobierana i prezentowana w aplikacji. Oprócz kart produktów, ciężar jest także wyliczany i prezentowany podczas wystawiania dokumentu:

na pozycji (na dużej kalkulacji),
na dokumencie (na wszystkich zakładkach na pasku górnym)– suma wag poszczególnych elementów.

Obsługa odwrotnego obciążenia

W aplikacji Comarch Mobile Zakupy istnieje możliwość rejestracji transakcji z obsługą odwrotnego obciążenia. W przypadku odwrotnego obciążenia odpowiedzialność za rozliczenie podatku od zawartej transakcji może zostać przeniesiona ze sprzedawcy na nabywcę. Obsługa odwrotnego obciążenia w aplikacji Comarch Mobile Zakupy jest dostępna po odpowiedniej konfiguracji w systemie ERP:

włączeniu odpowiedniego parametru w konfiguracji systemu ERP,
ustawieniu na karcie kontrahenta, że podatnikiem jest nabywca,
zdefiniowaniu stawek VAT dla odwrotnego obciążenia,
oznaczeniu odpowiednich towarów objętych odwrotnym obciążeniem.

Informacje dotyczące skonfigurowania oraz możliwości ustawienia odpowiedniej stawki odwrotnego obciążenia zostały opisane TUTAJ. Po odpowiednim skonfigurowaniu stawki odwrotnego obciążenia dla danego kontrahenta i określonego towaru, podczas wystawiania dokumentów niefiskalnych z kontrahentem i towarem objętym odwrotnym obciążeniem wartości elementu są wyliczane w oparciu o zdefiniowaną stawkę VAT odwrotnego obciążenia.

Okno: Pozycja dokumentu z odwrotnym obciążeniem

Zgodnie z przepisami, na wystawianym dokumencie na rzecz podmiotu prowadzącego działalność gospodarczą nie wykazuje się należnego podatku VAT. Zamiast informacji o wysokości oraz wartości stawek VAT z pozycji prezentowana jest adnotacja o odwrotnym obciążeniu na wydruku dokumentu.

Obsługa numeru obcego

Na zakładce nagłówek, pod numerem dokumentu znajduje się pole [Numer obcy]. Po uzupełnieniu pola i zapisaniu, wprowadzony numer obcy jest prezentowany na nagłówku dokumentu.

Przedstawiciel uzupełniając numer obcy na dokumentach będzie mógł później wyszukać dokument po tym numerze – także Klient, podając przedstawicielowi numer dokumentu u siebie w systemie, wskaże operatorowi, które transakcje chciałby powtórzyć.

Edycja płatnika na nagłówku dokumentu

W aplikacji Comarch Mobile Zakupy istnieje możliwość edycji płatnika na nagłówku dokumentów wystawionych w aplikacji:

Zamówienie Zakupu (ZZ)
Oferta Zakupu (OZ)

Po dokonaniu zmiany płatnika na dokumencie, jego zatwierdzeniu i zsynchronizowaniu do systemu ERP, informacja o płatniku jest widoczna na dokumencie, w zakładce [Kwoty/Płatności].

Edycja kontrahenta docelowego

W aplikacji Comarch Mobile Zakupy istnieje możliwość edycji kontrahenta docelowego na nagłówku dokumentów wystawionych w aplikacji:

Zamówienie Zakupu (ZZ),
Oferta Zakupu (OZ).

Informacje na temat konfiguracji można znaleźć TUTAJ.

Edycja kontrahenta głównego na nagłówku dokumentu

Jeżeli na dokumencie (bez promocji pakietowej) zostały już dodane towary do koszyka, wówczas przy próbie zmiany kontrahenta docelowego na nagłówku, pojawia się komunikat:

Komunikat wyświetlany w aplikacji przy próbie zmiany kontrahenta docelowego na nagłówku dokumentu, do którego zostały już dodane towary do koszyka

Po dokonaniu zmiany kontrahenta docelowego na dokumencie, jego zatwierdzeniu i zsynchronizowaniu do systemu Comarch ERP Altum, informacja o kontrahencie docelowym widoczna jest na dokumencie, w zakładce [Ogólne] -> [Kontrahent docelowy] oraz na zakładce [Kontrahent] ->[Docelowy].

Edycja kontrahenta głównego na nagłówku dokumentu

Od wersji 2022.2.1 aplikacji Comarch Mobile została wprowadzona funkcjonalność, dzięki której użytkownik będzie mógł zdecydować, czy podczas zmiany kontrahenta na nagłówku dokumentu, ma również nastąpić zmiana innych elementów tj. płatnik, kontrahent docelowy, typ transakcji, forma płatności, sposób dostawy.

Widok okna wyboru z możliwością dokonania zmian po wybraniu innego kontrahenta

Użytkownik decyduje, które elementy dokumentu mają ulec zmianie. Po wskazaniu odpowiednich opcji i wybraniu Zapisz, pojawi się poniższy komunikat:

Komunikat wyświetlany w aplikacji przy próbie zmiany kontrahenta głównego na nagłówku dokumentu

- Nie – pozostawienie aktualnych ustawień na dokumencie – brak zmiany.
- Tak – aktualizacja wskazanych danych na dokumencie

Uwaga

Wybrane elementy zostają zapamiętane dla danego kontrahenta do momentu ich ponownej zmiany

Więcej informacji o konfiguracji dotyczącej zmiany kontrahenta na nagłówku dokumentu można znaleźć TUTAJ.

Zmiana daty realizacji

W przypadku, gdy na elementach dokumentu jest ustawiony czas dostawy, podczas edycji na nagłówku dokumentu, czasu realizacji wystawianego dokumentu, użytkownik będzie mógł zadecydować:

czy data realizacji z nagłówku ma się zapisać na każdym elemencie dokumentu,
czy data dostawy poszczególnych towarów ma pozostać ze zdefiniowanego cennika.

Ustawienie czasu dostawy na elemencie zgodnie z czasem realizacji na nagłówku dokumentu

Zmiana cennika na nagłówku dokumentu

Istnieje możliwość przeliczenia pozycji dodanych do koszyka po zmianie cennika początkowego na nagłówku dokumentu. Jeżeli dokument posiada już pozycje w koszyku a użytkownik spróbuje zmienić cenę początkową, zostanie wyświetlony odpowiedni komunikat, po potwierdzeniu którego pozycje w koszyku zostaną przeliczone zgodnie z ustawionym cennikiem.

Zmiana ceny początkowej na nagłówku dokumentu

Po tym jak użytkownik wybierze inny cennik na liście możliwych do wyboru cenników, zostanie poinformowany, że zmiana ta może spowodować zmianę warunków handlowych.

Komunikat wyświetlany po zmianie cennika na nagłówku dokumentu

Po potwierdzeniu komunikatu pozycje zostaną przeliczone zgodnie z wybranym cennikiem.

Dodawanie atrybutów oraz załączników na nagłówek dokumentu

Aby użytkownik posiadał możliwość przypisania danego atrybutu na pozycję dokumentu konieczne jest jego właściwe zdefiniowanie oraz przypięcie do odpowiedniego obiektu w systemie Comarch ERP Altum. Natomiast, aby użytkownik mógł przypisać daną klasę atrybutu na nagłówek dokumentu konieczne jest jej właściwe zdefiniowanie oraz przypięcie do odpowiedniego obiektu w systemie ERP. W aplikacji obsługiwane są następujące typy atrybutów:

Data
Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta.

Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie Comarch ERP Altum, w aplikacji Comarch Mobile Zakupy jest oznaczony znakiem

.

Uwaga

Tylko z poziomu pełnej kalkulacji można dodać atrybut na pozycji dokumentu (towar).

Na nagłówek dokumentu można dodać z poziomu każdego okna dostępnego podczas jego tworzenia informację dodatkową (atrybut). Aby dodać atrybut należy nacisnąć przycisk i wybrać opcję Dodaj informację dodatkową. Następnie należy wybrać klasę atrybutu i wpisać bądź wybrać wartość. Aby użytkownik posiadał możliwość przypisania danej klasy atrybutu na nagłówek dokumentu konieczne jest jej właściwe zdefiniowanie oraz przypięcie do odpowiedniego obiektu w systemie Comarch ERP Altum. W tym celu należy w systemie Comarch ERP Altum na klasie atrybutu zakładka [Ogólne] zaznaczyć możliwość [Podglądu i Edycji] w aplikacji Comarch Mobile Sprzedaż oraz przypiąć ją do odpowiedniego obiektu. Aby dodać atrybut na nagłówek dokumentu należy:

rozwinąć opcje dodatkowe dokumentu i wybrać opcję: Dodaj informację dodatkową. Następnie należy wybrać klasy atrybutów i wpisać/wybrać wartość,
lub wybrać ikonę „+” w sekcji: Informacje dodatkowe na nagłówku dokumentu.

Aby dodać załącznik na nagłówku dokumentu należy:

rozwinąć opcje dodatkowe dokumentu i wybrać opcję: Dodaj załącznik,
lub wybrać ikonę „+” w sekcji: Załączniki na nagłówku dokumentu.

Dodawanie atrybutów i załączników na nagłówku dokumentu

Więcej informacji o załącznikach w aplikacji znajduje się TUTAJ.

Zamówienie zakupu (ZZ)

Po wybraniu ZZ na liście dokumentów, w aplikacji wyświetli się lista towarów. Do koszyka możemy dodać towary, które są dostępne na magazynie mobilnym oraz takie, które mają stany zerowe.

Dodawanie towarów do koszyka dokumentu ZZ

Uwaga

Dokumenty ZZ generowane w aplikacji Comarch Mobile Zakupy nie mają przypisanego rejestru, który w Comarch ERP Altummożna sprawdzić w zakładce [Płatności].

Podczas składania zamówienia, na oknie dużej kalkulacji pojawia się dodatkowo informacja o terminie dostawy: dacie realizacji zamówienia i liczbie dni pozostałych do upływu tej daty. Pola te nie są możliwe do edycji, pełnią jedynie rolę informacyjną. Informacja o dacie realizacji wyświetlana jest także w przypadku dokumentów pobranych z systemu Comarch ERP Altum.

Realizacja ZZ

Realizacja dokumentów ZZ została opisana TUTAJ.

Realizacja zamówień (ZZ)

Spis treści

Realizacja zamówień – zakładka: Koszyk Realizacja zamówień – zakładka: Nagłówek Realizacja zamówień – mała kalkulacja Realizacja zamówień – Pełna kalkulacja elementu Realizacja zamówień – atrybuty

Aby informacje o realizacji zamówień były pobierane z systemu Comarch ERP Altum do aplikacji Comarch Mobile Zakupy należy zaznaczyć parametr "Synchronizuj informacje o stanie realizacji zamówień." Parametr znajduje się na dokumencie ZZ dla centrum typu Mobile, na zakładce Ogólne, w grupie Parametry. Do aplikacji pobierane są informacje na temat ZZ, które w systemie Comarch ERP XL mają stan:

Potwierdzone
W realizacji
Zrealizowane
Zamknięte
Zamknięte w realizacji
Anulowane

Uwaga

Do aplikacji nie są pobierane informacje na temat dokumentów będących w buforze.

Na liście dokumentów wystawionych dla danego kontrahenta prezentowane są informacje na temat danego dokumentu zaprezentowane na poniższym zrzucie ekranu. Status i stopień realizacji ZZ jest pobierany dla dokumentów wystawionych w mobile i dla dokumentów wystawionych w centrali.

Dostępne statusy dokumentów ZZ w systemie Comarch ERP XL zostały oznaczone w aplikacji poniższymi ikonami:

– dokonano zmian na elementach bądź Nagłówku ZZ.

– dokument zatwierdzony w aplikacji, bądź ZZ który ma status: Zrealizowane w systemie ERP.

– ZZ otrzymało w systemie ERP Stan: Zamknięte, Anulowane, Zamknięte w realizacji.

Realizacja zamówień – zakładka: Koszyk

Zmiany dokonane w systemie Comarch ERP XL na Zamówieniu Zakupu wystawionym w aplikacji widoczne są na zakładce [Koszyk]. Na zakładce [Koszyk] dostępne są informacje dotyczące danej pozycji Zamówienia Sprzedaży zaprezentowane na rysunku poniżej:

Na pozycjach ZZ możliwe jest dokonanie poniższych zmian w systemie Comarch ERP XL:

Zmiana: ilości, JM, ceny początkowej, ceny końcowej, rabatu, wartości, marży uzyskanej, informacji dodatkowej itp.

Realizacja zamówień, zakładka: [Koszyk], korygowanie pozycji

Dodanie nowej pozycji do dokumentu

Realizacja zamówień, zakładka: [Koszyk], dodanie nowej pozycji do dokumentu

Usunięcie pozycji z dokumentu

Realizacja zamówień, zakładka: [Koszyk], usunięcie pozycji z dokumentu

Przy pozycji usuniętej nie są dostępne informacje na temat: ilości, ceny końcowej netto/ brutto, wartości końcowej netto/ brutto, procentu realizacji.

Realizacja zamówień – zakładka: Nagłówek

Na zakładce: Nagłówek prezentowane są zmiany dokonane w systemie Comarch ERP XL na Zamówieniu Zakupu wystawionym w aplikacji.

Koszyk – sekcja z informacją na temat realizacji elementu dokumentu ZZ

W sekcji Realizacja prezentowany jest procent realizacji danego ZZ. Po naciśnięciu na przycisk zostanie otwarta sekcja z informacjami widocznymi na rysunku poniżej:

Rozwinięcie sekcji z informacją na temat nr dokumentu realizującego dane ZZ

Realizacja zamówień – mała kalkulacja

Na małej kalkulacji danej pozycji widoczne są tylko aktualne dane.

Realizacja zamówień, zakładka: [Nagłówek], zmiany na ZZ dokonane w systemie ERP

Realizacja zamówień – Pełna kalkulacja elementu

Jeżeli na danej pozycji ZZ zaszły jakiekolwiek zmiany w systemie Comarch ERP XL to Okno: Szczegóły pozycji składa się z dwóch zakładek:

Szczegóły pozycji – na zakładce wszelkie zmiany dokonane w systemie Comarch ERP XL prezentowane są w kolorze niebieskim.

Dodatkowo w oknie: Szczegóły pozycji w sekcji Realizacja prezentowane są informacje na temat ilości oraz procentowej realizacji pozycji.

Zmiany – na zakładce prezentowane są tylko i wyłącznie te elementy, które uległy zmianie w systemie Comarch ERP XL. Białym kolorem zaprezentowane są elementy dodane w aplikacji, natomiast niebieskim, elementy zmienione w systemie Comarch ERP XL.

Realizacja zamówień – atrybuty

Po wystawieniu dokumentu zamówienia sprzedaży w aplikacji i zsynchronizowaniu do systemu ERP jeżeli zostanie zmieniona wartość atrybutu lub dodana nowa klasa atrybutu informacja o dokonanej zmianie będzie synchronizowana z powrotem do aplikacji. Zmiany w atrybutach na dokumencie Zamówienia Zakupu obejmują:

Edycję istniejących klas atrybutów na nagłówku dokumentu ZZ
Dodanie nowych klas atrybutów na nagłówku dokumentu ZZ
Usunięcie w systemie ERP klasy atrybutu dodanej w Comarch Mobile na nagłówku dokumentu ZZ
Edycję istniejącej klasy atrybutu na pozycji ZZ
Dodanie nowej klasy atrybutu na pozycji dokumentu ZZ
Usunięcie w systemie ERP klasy atrybutu dodanej w Comarch Mobile na pozycji dokumentu ZZ

Jeżeli Zamówienie zarejestrowane w aplikacji zostało zsynchronizowane do ERP i z poziomu centrali został zmodyfikowany lub dodany nowy atrybut wówczas wartość atrybutu prezentowana będzie w kolorze zielonym. Funkcjonalność pozwala na weryfikację, jakie zmiany zostały wprowadzone w atrybutach znajdujących się na dokumencie podczas realizacji zamówienia sprzedaży.

Oferta Zakupu (OZ)

OZ jest dokumentem odzwierciedlający początkowe stadium procesu sprzedaży, często stosowany w przypadku całkiem nowych lub niezdecydowanych na konkretną ofertę Klientów. Oferta Zakupu może zawierać konkretne elementy – pozycje towarowe lub tylko ogólny opis poszukiwanego towaru/asortymentu (gdy np. Klient ma szczególne wymagania lub przedstawiciel nie ma dostępu do wszystkich towarów, cenników itd.).

Dodawanie towarów do koszyka w Ofercie Zakupu

Automatyczne wysyłanie mailem dokumentów po ich zatwierdzeniu

W aplikacji Comarch Mobile jest możliwość wysyłania dokumentu po zatwierdzeniu, na adres email przypisany do karty kontrahenta a także do wszystkich odbiorców zdefiniowanych w Ustawieniach aplikacji. W parametrach aplikacji została dodana opcja: Automatyczne wysyłanie maila – po zaznaczeniu opcji zostaje wyświetlona dodatkowa konfiguracja, w której użytkownik może określić:

Do kogo ma być wysyłany dokument po zatwierdzeniu:
- Kontrahent – wiadomość z załączonym dokumentem zostanie wysłana na adres email przypisany do adresu głównego kontrahenta, lub na adres email przypisany do adresu wysyłkowego (jeżeli kontrahent nie posiada adresu email na adresie głównym).
- Odbiorca – możliwość określenia dowolnego adresu/adresów, na które dokumenty powinny być wysyłane po zatwierdzeniu.
Dla jakich typów dokumentów opcja wysyłania po zatwierdzeniu powinna zostać włączona,
Dla jakich serii dokumentów opcja wysyłania powinna zostać włączona.

Jeżeli dokument spełnia wymagania określone w ustawieniach aplikacji (odpowiedni typ i seria) po zatwierdzeniu dokumentu i wskazaniu aplikacji, która ma zostać użyta do wysłania maila, zostanie podniesiona formatka nowej wiadomości z uzupełnionymi adresami email Odbiorców i/lub Kontrahenta. Dodatkowo, jeżeli opcja Automatycznego wysyłania maila jest włączona, po wybraniu opcji Wyślij w menu kontekstowym na liście dokumentów, oprócz dotychczas prezentowanych opcji dostępna będzie także opcja: Wyślij do zdefiniowanych odbiorców, która wywoła analogiczny efekt jak w przypadku Zatwierdzenia dokumentu.

Parametr aplikacji: Automatyczne wysyłanie maila

Automatyczne uzupełnianie adresów email, zgodnie z ustawieniami aplikacji

Wyszukiwanie historycznych transakcji na podstawie indeksu towarowego

Funkcjonalność ta pozwala na wyszukiwanie historycznych transakcji podczas wystawiania dokumentu za pomocą wskazanego towaru z listy. Podczas wystawiania dokumentu handlowego, przedstawiciel handlowy będzie miał możliwość podejrzenia ilości danego towaru na historycznym dokumencie oraz numeru tego dokumentu w sytuacji, gdy kontrahent będzie chciał zamówić/kupić towar, który w przeszłości został już u nas zakupiony. Podczas wystawiania dokumentu w aplikacji, z poziomu listy towarów, należy rozwinąć menu kontekstowe dla wybranego przez nas towaru. W menu tym znajduje się opcja Historyczne transakcje, jak na rysunku poniżej:

Opcja [Historyczne transakcje] dostępna z poziomu menu kontekstowego na liście towarów

Po wyborze opcji historycznych transakcji zostanie wyświetlone okno historycznych transakcji, na których pojawił się wybrany przez nas towar:

Lista dokumentów historycznych, na których wybrana została wskazana pozycja

Po rozwinięciu menu przy danym dokumencie pojawi się lista działań, jak poniżej:

Możliwe opcje po rozwinięciu menu dokumentu

W zależności od wyboru danej opcji użytkownik będzie miał możliwość:

Podgląd - podejrzenia dokumentu tj. informacji o towarach, nagłówku oraz warunków handlowych
Kopiuj pozycję - skopiowania wybranej pozycji, czego skutkiem będzie dodanie pozycji na listę towarów na tworzonym dokumencie. Po tej czynności w aplikacji pojawi się informacja: Pozycja została dodana do koszyka.
Kopiuj dokument - skopiowania wszystkich pozycji z historycznego dokumentu. Po wybraniu tej opcji zostanie wyświetlone okno jak poniżej:

Wybór dokumentu, na który operator chce skopiować pozycje towarowe

Historyczność transakcji

Z poziomu skróconej jak i pełnej kalkulacji elementu istnieje możliwość skopiowania ilości oraz ceny użytej w poprzednich transakcjach dla wybranego kontrahenta. Informacje są prezentowane, jeżeli w ustawieniach aplikacji został zaznaczony parametr: pokazuj elementy historyczne.

Ustawienia aplikacji: parametry historyczności

Przeniesienie wartości do aktualnie wystawianego dokumentu odbywa się poprzez wybranie ilości lub ceny w prezentowanym oknie dotyczącym historyczności.

Naciśnięcie przycisku [Zapisz] spowoduje przypisanie wybranej ilości lub ceny, natomiast wybranie [Anuluj] spowoduje wyświetlenie poprzedniej ceny i ilości, w której towar występował na dokumencie. W oknie dużej kalkulacji w sekcji dokumenty wyświetlone zostaną dokumenty historyczne, w których wykorzystano dany towar. Istnieje możliwość skopiowania ceny i ilości towaru z dokumentu historycznego, podejrzenie dokumentu historycznego i wysłanie.

Kopiowanie dokumentów

Istnieje możliwość kopiowania wielu elementów z historycznie wystawionego dokumentu. Aby takie kopiowanie wykonać należy w trakcie wystawiania skorzystać z jednego z filtrów:

kontrahenta – umożliwiający wybór historycznie wystawionego dokumentu dla kontrahenta wybranego w wystawianym dokumencie,
Wszystkie dok. – umożliwiający wybór historycznie wystawionego dokumentu dla dowolnego kontrahenta, którym opiekuje się Sprzedawca.

Filtry: Dok. kontrahenta i Wszystkie dok.

Po wybraniu historycznego dokumentu w filtrze, lista towarów zostaje zawężona do towarów, które występowały na wybranym dokumencie i są dostępne do sprzedaży przez Pracownika danemu Kontrahentowi. Kolorem fioletowym prezentowane są historyczne wartości elementów.

Dodawanie seryjne

Następnie należy wybrać opcję: Dodaj seryjnie

, wybór opcji powoduje podniesienie okna, które przedstawiono poniżej.

Dodawanie seryjne, opcja: Zastosuj ilości z historycznego dokumentu

Wskazówka

Dzięki temu Sprzedawca może m.in. w szybki sposób zrealizować prośbę Klienta: „Proszę to, co ostatnio i do tego…”.

Możliwość ukrywania cen oraz wartości towarów w kafelku Towary i na konkretnych dokumentach

Parametr [PricesOnItemsInvisible] umożliwia ukrycie cen i rabatów w kafelku Towary. Parametr ten został opisany TUTAJ. Przełączenie parametru na wartość 1 powoduje:

Ukrycie cen na karcie towaru

Ukryta informacja o cennikach na karcie towaru

Ukrycie cen na liście oferowanych towarów

Ukryta informacja o cenach na liście towarów

W celu ukrycia cen na poszczególnych dokumentach należy w funkcji SyncFramework.GetNumerators (nazwa_bazy -> Programmability -> Functions -> Table-valued Functions -> SyncFramework.GetNumerators) odnaleźć poniższy fragment: 0 as IsPricesInvisible, i zmienić warunek dla którego dokumentu chcemy ukryć ceny (poniżej przykład dla dokumentu ZS).

case
when NamespaceEntry = 'Comarch.B2.Sales.Documents.SalesOrderManager' then 1
else 0
end as IsPricesInvisible,

Edycja funkcji spowoduje:

Ukrycie cen i rabatów na kalkulacji dla danego dokumentu
Ukrycie cen i rabatów w Koszyku dla danego typu dokumentu
Ukrycie informacji o rabacie, marży na Nagłówku dla danego typu dokumentu
Ukrycie wartości na transakcjach historycznych dla danego typu dokumentu
Ukrycie wartości na liście dokumentów dla dokumentów niepotwierdzonych dotyczących danego typu dokumentu
Ukrycie wartości dla dokumentów niepotwierdzonych z poziomu wizyty elementu Rejestracja dokumentu dla danego typu dokumentu
Kafel Raporty: ujęcie wartości tylko z potwierdzonych dokumentów (dla konkretnego typu dokumentu)

Wyłączenie widoczności cen i rabatów na dokumencie prezentuje poniższy rysunek, gdzie prezentowana jest lista oferowanych towarów na ZS z ukrytymi informacjami:

Ukryta informacja o cenach na dokumencie ZS

Ukryte informacje o cenach i rabatach są również na małej i dużej kalkulacji elementu, jak na poniższym rysunku:

Ukryte informacje o cenach na małej i dużej kalkulacji towaru

W aplikacji wprowadzono nowy parametr ForceHidingPrices (jest on opisany TUTAJ). Zmiana tego parametru na 1 spowoduje dodatkowo:

Ukrycie wartości na liście dokumentów dla dokumentów potwierdzonych dotyczących danego typu dokumentu
Ukrycie wartości dla dokumentów potwierdzonych z poziomu wizyty elementu Rejestracja dokumentu dla danego typu dokumentu

Uwaga

Wartość parametru należy zmienić w pliku documentsnumerators.altum.statement (Comarch Mobile\Serwer synchronizacji\Methods\documentsnumerators)

Wyświetlanie atrybutów na listach

W aplikacji Comarch Mobile możliwe jest wyświetlanie atrybutów na listach w aplikacji. Funkcjonalność ta dotyczy:

Listy kontrahentów,
Listy towarów,
Listy pozycji dodanych do koszyka,

Jeżeli do obiektu została przypisana informacja dodatkowa, oraz atrybut został odpowiednio skonfigurowany, wówczas będzie mógł on być wyświetlany na listach w aplikacji, jak na poniższych przykładach.

Wyświetlanie atrybutów na liście towarów i na liście kontrahentów

Wyświetlanie atrybutów na liście towarów dodanych do koszyka

Uwaga

Za konfigurację tej funkcjonalności odpowiada parametr IsVisibleOnList. Więcej informacji na temat konfiguracji znajduje się TUTAJ.

Prezentacja kwoty limitu kredytowego do wykorzystania

W aplikacji Comarch Mobile podczas wystawiania dokumentu możliwe jest wyświetlanie kwoty limitu kredytowego pozostającej do wykorzystania przez kontrahenta, dla którego aktualnie wystawiany jest dokument. Włączenie tej funkcjonalności możliwe jest poprzez włączenie parametru Pokazuj limit kredytowy dostępnego w ustawieniach aplikacji. Więcej informacji znajduje się TUTAJ.

Kwota limitu kredytowego pozostającego do wykorzystania widoczna podczas wystawiania dokumentu

Prezentacja kwoty płatności przeterminowanych

W aplikacji Comarch Mobile podczas wystawiania dokumentu możliwe jest wyświetlanie kwoty płatności przeterminowanych kontrahenta, dla którego aktualnie wystawiany jest dokument. Włączenie tej funkcjonalności możliwe jest poprzez włączenie parametru Pokazuj płatności przeterminowane dostępnego w ustawieniach aplikacji. Więcej informacji znajduje się TUTAJ.

Kwota płatności przeterminowanych widoczna podczas wystawiania dokumentu

Dostępne widoki

Spis treści

Widok miesięczny Widok tygodniowy Widok dzienny Lista działań zaplanowanych Lista działań przeterminowanych Lista działań zakończonych Opis na liście działań

Terminarz posiada sześć widoków:

Widok miesięczny
Widok tygodniowy
Widok dzienny
Lista działań zaplanowanych
Lista działań przeterminowanych
Lista działań zakończonych

W każdym widoku prezentowane są odpowiednio odfiltrowane działania.

Uwaga

Zakładka cykliczne niezaplanowane nie jest obsługiwana z systemem Comarch ERP Altum.

Widok miesięczny

W widoku miesięcznym prezentowane są działania z wybranego miesiąca. Istnieje możliwość podglądu działania jak i również zaplanowania nowego. W celu dokonania zmiany daty w widoku miesięcznym należy:

Kliknąć w dostępne opcje strzałek
Kliknąć w konkretną datę
Wykonać gest przesunięcia w górę lub w dół

Jeżeli w obrębie dnia zostały zaplanowane działania, to w danym dniu prezentowane są dwie liczby: z prawej strony łączna liczba wszystkich zaplanowanych działań natomiast z lewej strony w kolorze czerwonym prezentowana jest liczba zdarzeń przeterminowanych, o ile takie istnieją. Na dolnym pasku Terminarza po lewej stronie prezentowana jest nazwa zaznaczonego dnia tygodnia oraz data natomiast po prawej stronie prezentowana jest w kolorze czerwonym liczba działań przeterminowanych przez łączną liczbę działań zdefiniowanych w danym dniu. Kliknięcie na wybrany numer tygodnia powoduje automatyczne przejście do widoku tygodniowego dla wybranego tygodnia.

Widok tygodniowy

Prezentuje listę działań do zrealizowania oraz zrealizowanych w wybranym tygodniu. W zależności od typu działania i stanu realizacji, są one prezentowane różnymi kolorami:

Spotkania i wizyty niezrealizowane – zielony,
Zadania niezrealizowane- żółty,
działania prywatne – niebieski,
działania zrealizowane – szary.

Na dolnym pasku Terminarza po lewej stronie prezentowana jest nazwa zaznaczonego dnia tygodnia oraz data natomiast po prawej stronie prezentowana jest w kolorze czerwonym liczba działań przeterminowanych przez łączną liczbę działań zdefiniowanych w danym czasie.

Widok dzienny

Widok dzienny prezentuje działania zaplanowane oraz zrealizowane w wybranym dniu. W celu dokonania zmiany daty w widoku dziennym należy:

Kliknąć w dostępne opcje strzałek,
Kliknąć w konkretną datę.

W widoku dziennym prezentowany jest rozkład godzinowy zaplanowanych działań.

Lista działań zaplanowanych

Prezentuje wszystkie działania zaplanowane od dnia bieżącego do kolejnych tygodni w przyszłości.

Lista działań przeterminowanych

Prezentuje działania przeterminowane od dnia bieżącego do kolejnych tygodni w przeszłości.

Lista działań zakończonych

Prezentuje listę działań wykonanych oraz odrzuconych. Lista działań zakończonych została zaprezentowana na rysunku poniżej.

Opis na liście działań

W aplikacji została dodana na liście działań, możliwość wyświetlenia opisu dla poszczególnych rodzajów działań. Dodatkowo istnieje możliwość skonfigurowania ile linii opisu jest prezentowane bezpośrednio na liście działań. Wprowadzona funkcjonalność ułatwia przeglądnie działań w terminarzu. W przypadku działań zrealizowanych prezentowane są informacje zawarte w polu Opis znajdującym się na:

Nagłówku wizyty

oraz informacje zawarte w polu Uwagi do realizacji znajdującym się na:

Spotkaniu,
Kontakcie,
Zadaniu,
Prywatnie.

Jeżeli Uwagi do realizacji nie zostaną uzupełnione podczas realizacji działania wówczas prezentowane są informacje zawarte w polu Opis. W przypadku działań niezrealizowanych prezentowane są informacje zawarte w polu Opis znajdującym się na:

Nagłówku wizyty,
Kontakcie,
Spotkaniu,
Zadaniu,
Prywatne.

Terminarz: dostępne opcje

Po wybraniu przycisku:

, z poziomu okna Terminarza dostępne są opcje:

Po wybraniu przycisku [Idź do] do zostanie wyświetlone okno wyboru daty.

Po wybraniu konkretnej daty zostanie wyświetlony widok dla tego dnia. Po zaznaczeniu w Ustawieniach parametru [Pokazuj kody kontrahentów], na liście wizyt, w Terminarzu, prezentowany jest kod kontrahenta, z którym została zaplanowana wizyta.

Widok dzienny z prezentacją kodu kontrahenta w Terminarzu

Po wybraniu opcji [Ustawienia] zostanie wyświetlone okno zaprezentowane poniżej.

Możliwość filtrowania działań

Użytkownik aplikacji mobilnej może wyfiltrować działania z poziomu :

Terminarza – z poziomu Zakładek: Zaplanowane, Przeterminowane i Zakończone użytkownik może skorzystać z opcji filtra i odnaleźć interesujące go działania korzystając z opcji filtra:
- od – zwrócone zostaną wszystkie działania, których data wystawienia jest późniejsza niż wskazana
- do – zwrócone zostaną wszystkie działania, których data wystawienia jest wcześniejsza niż wskazana,
- Wzorzec – zwrócone zostaną wizyty handlowe, na których zastosowano wybrany,
- Typ – zwrócone zostaną wizyty handlowe o typie, który został wskazany w ustawieniach filtra
- Rodzaj działania – użytkownik może odszukać działania danego rodzaju (np. tylko spotkania) lub działania kilku różnych rodzajów (wielowybór),
- Kontrahent – po wybraniu konkretnego kontrahenta zostaną zwrócone działania dotyczące tylko tego konkretnego Klienta.
- Dodatkowo za pomocą filtru tekstowego możliwe jest wyszukanie działań np. po mieście czy ulicy.

Możliwość filtrowania działań z poziomu terminarza oraz karty kontrahenta

Podobnie jak dla filtrów w innych miejscach aplikacji użytkownik może skorzystać z opcji dodatkowych, dostępnych po dłuższym przytrzymaniu na przycisk z danym filtrem. Jedną z możliwości jest przypięcie filtra do szybkiego wybierania, które usprawni proces wyszukiwania interesujących działań.

Opcja: Wyznacz trasę

Dzięki funkcji nawigacji, operator wprost z poziomu interfejsu aplikacji, przy zdefiniowanym adresie, może wyznaczyć odpowiednią trasę i tym samym zoptymalizować swoją drogę do wyznaczonego celu.

Opcja: Wyznacz trasę - umożliwiająca wyznaczenia trasy do danego punktu, adresu została dodana na:

Menu kontekstowym na liście kontrahentów,
Karcie kontrahenta,
Adresach kontrahenta,
Menu kontekstowym na terminarzu,
Karcie spotkania, kontaktu,
Nagłówku zatwierdzonego dokumentu.

Przy wyznaczaniu trasy warto skorzystać z opcji pokazania aktualnego natężenia ruchu, w celu uniknięcia korków czy robót drogowych.

Wybór adresu kontrahenta do wyznaczania trasy

Po kliknięciu w ikonę [Wyznacz trasę] i wyborze adresu docelowego wywoływana jest aplikacja Google Mapy ze wskazówkami dojazdu do punktu (wybranego adresu).

Opcja: Wyznacz trasę

Dzięki funkcji nawigacji, operator wprost z poziomu interfejsu aplikacji, przy zdefiniowanym adresie, może wyznaczyć odpowiednią trasę i tym samym zoptymalizować swoją drogę do wyznaczonego celu.

Opcja: Wyznacz trasę - umożliwiająca wyznaczenia trasy do danego punktu, adresu została dodana na:

Menu kontekstowym na liście kontrahentów,
Karcie kontrahenta,
Adresach kontrahenta,
Menu kontekstowym na terminarzu,
Karcie spotkania, kontaktu,
Nagłówku zatwierdzonego dokumentu.

Przy wyznaczaniu trasy warto skorzystać z opcji pokazania aktualnego natężenia ruchu, w celu uniknięcia korków czy robót drogowych.

Po kliknięciu w ikonę [Wyznacz trasę] i wyborze adresu docelowego wywoływana jest aplikacja Google Mapy ze wskazówkami dojazdu do punktu (wybranego adresu).

Podgląd działań historycznych

Możliwość podglądu historycznych działań istnieje z poziomu terminarza oraz karty kontrahenta. Po określeniu parametru w ustawieniach aplikacji i wykonaniu synchronizacji pobrane zostaną działania wszystkich typów, które zostały w przeszłości zrealizowane lub odrzucone przez operatora zalogowanego w aplikacji. Historyczne działania można podejrzeć z poziomu terminarza lub z poziomu karty kontrahenta. Wszystkie działania pobrane z systemu ERP opatrzone są ikoną:

.

Podgląd historycznych działań możliwy z poziomu Terminarza oraz Karty kontrahenta

Przypomnienia (powiadomienia) dla działań CRM

W aplikacji Comarch Mobile użytkownik ma możliwość włączenia przypomnienia (powiadomienie PUSH) do zaplanowanych działań CRM wraz z określeniem z jakim wyprzedzeniem taki alert ma pojawić się na urządzeniu mobilnym. W Ustawieniach aplikacji w sekcji Parametry działań znajduje się parametr [Przypomnienia dla działań CRM].

Po wybraniu parametru pojawi się okno z opcjami:

Brak - powiadomienia PUSH dla działań CRM są wyłączone
30 min. przed działaniem - powiadomienia PUSH dla działań CRM pojawią się 30 minut przed ich rozpoczęciem
1 godz. przed działaniem - powiadomienia PUSH dla działań CRM pojawią się 1 godzinę przed ich rozpoczęciem
2 godz. przed działaniem - powiadomienia PUSH dla działań CRM pojawią się 2 godziny przed ich rozpoczęciem
3 godz. przed działaniem - powiadomienia PUSH dla działań CRM pojawią się 3 godziny przed ich rozpoczęciem
Niestandardowe - wybór tej opcji powoduje pojawienie się okna konfiguracji godziny

Po włączeniu parametru [Przypomnienia dla działań CRM] na urządzeniu mobilnym użytkownik otrzyma powiadomienie PUSH w skonfigurowanym przedziale czasowym przed planowanym działaniem. Wybór opcji OK zamyka komunikat. Wybór opcji Przejdź lub naciśnięcie obszaru powiadomienia otwiera aplikację i przenosi użytkownika do widoku szczegółów danego działania CRM.

Planowanie wizyty handlowej z poziomu Terminarza

Spis treści

Wzorzec wizyty Kontrahenci Koszyk Dzień

Wizyty mogą być planowane jeżeli będzie dostępny co najmniej jeden wzorzec wizyty. Okno planowania wizyty składa się z czterech zakładek:

Wzorzec wizyty
Kontrahenci
Koszyk
Dzień

Wzorzec wizyty

Wzorzec wizyty – okno otwarte jako pierwsze podczas planowania wizyty, zaprezentowane na poniższym zrzucie ekranu.

Z poziomu zakładki [Wzorzec wizyty] można dokonać wyboru typu, czasu trwania oraz dnia, na który ma zostać zaplanowana wizyta. Dodatkowo można również zdefiniować ewentualne powtórzenia wizyty (działania cykliczne). Możliwe do wyboru powtórzenia zostały zaprezentowane na poniższym zrzucie ekranu.

Wzorzec wizyty: dialog wyboru typu powtarzania cyklicznego na WH

Kontrahenci

Kontrahenci – okno, w którym należy wybrać kontrahenta, dla którego zostanie zaplanowana dana wizyta. Okno zostało zaprezentowane na poniższym zrzucie ekranu.

Po naciśnięciu na przycisk zostanie wyświetlone menu zaprezentowane na poniższym zrzucie ekranu.

Wizyta handlowa: zakładka [Kontrahenci], zaplanuj dla wszystkich

Jeżeli okaże się ze kontrahent, na którego ma być zaplanowana wizyta nie figuruje na liście kontrahentów (nie został jeszcze dodany do bazy danych), to możliwe jest jego dodanie z poziomu okna planowania wizyty handlowej. W tym celu należy z paska postępu wybrać przycisk:

, a następnie opcję Dodaj kontrahenta. Pojawi się okno dodawania nowego kontrahenta, w którym należy wprowadzić informacje o kontrahencie. Po zatwierdzeniu wprowadzonych danych kontrahent zostanie dodany do listy kontrahentów i możliwe będzie dodanie go do koszyka planowanej wizyty.

Koszyk

Koszyk – okno, w którym prezentowana jest lista wizyt, która zostanie stworzona po naciśnięciu przycisku:

.

Dzień

Dzień – okno można zobaczyć zaplanowane działania w ujęciu dziennym.

Planowanie wizyty handlowej z poziomu Karty kontrahenta

Okno planowania wizyty składa się z trzech zakładek:

Wzorzec wizyty
Koszyk
Dzień

Poniżej zostały omówione poszczególne zakładki: Wzorzec wizyty – okno otwarte jako pierwsze podczas planowania wizyty, zaprezentowane na poniższym zrzucie ekranu.

W polach [Data] i [Godzina] podpowiada się pierwszy wolny termin począwszy od daty bieżącej, w którym może zostać zrealizowana wizyta. Po ustaleniu nowego terminu wizyty należy wybrać opcję Zapisz. Wizyta zostanie przeniesiona na nowy termin. Koszyk – okno, w którym prezentowana jest lista wizyt, która zostanie stworzona po naciśnięciu przycisku:

.

Planowanie wizyty bez wskazania godziny

Istnieje możliwość dodania nowej wizyty na okres całego dnia, bez wskazania godziny. Taka opcja jest dostępna z poziomu aplikacji poprzez zaznaczenie opcji [Cały dzień].

Planowanie wizyty bez podania wzorca

Istnieje możliwość dodania nowej wizyty bez określania wzorca. Podczas planowania takiej wizyty należy pole: Wzorzec pozostawić puste. Funkcjonalność ta jest możliwa, jeśli na grupie operatorów w Comarch ERP Altum na zakładce Inne Uprawnienia jest Aktywny parametr Możliwość planowania wizyt bez podania wzorca.

Kopiowanie wizyt

W aplikacji istnieje możliwość kopiowania wizyt - w menu kontekstowym wizyty widoczna będzie opcja [Kopiuj].

Opcja: [Kopiuj] (menu kontekstowe wizyty zaplanowanej)

Kopiowanie pojedynczej wizyty

W przypadku pojedynczej wizyty, po wybraniu opcji [Kopiuj] z menu kontekstowego wizyty, pojawi się okno umożliwiające skopiowanie wizyty na podany termin.

Opcja kopiowania dostępna w menu kontekstowym wizyty

W polach [Data] i [Godzina] podpowiada się pierwszy wolny termin począwszy od daty bieżącej, w którym może zostać zrealizowana kopiowana wizyta wzorcowa. Po ustaleniu nowego terminu dla kopiowanej wizyty należy wybrać opcję [Zapisz]. Wizyta zostanie skopiowana na podany termin.

Kopiowanie cyklu wizyt

W przypadku, gdy kopiowana wizyta jest częścią cyklu, po wybraniu opcji Kopiuj z menu kontekstowego wizyty, pojawi się okno kopiowania całego cyklu:

Przyklad

Ustawienie okresu powtarzania na [Brak] umożliwi skopiowanie pojedynczej wizyty na podstawie cyklu.

Po ustaleniu nowych parametrów cyklu należy wybrać opcję [Zapisz]. Cykl wizyt zostanie skopiowany z uwzględnieniem podanych parametrów (terminu rozpoczęcia, powtarzania, terminu końca cyklu).

Kopiowanie tygodniowego planu wizyt

W aplikacji istnieje możliwość kopiowania tygodniowego planu wizyt. Więcej informacji o konfiguracji parametru można znaleźć TUTAJ.

Opcja kopiowania tygodniowego planu wizyt

Po wyborze opcji [Kopiuj wizyty] pojawi się okno wyboru tygodnia, z którego będziemy chcieli skopiować wizyty oraz tygodnia, na który będziemy chcieli przenieść plan wizyt. W zależności od zaznaczenia opcji [Tylko w obrębie miesiąca], dany tydzień skopiuje się na cały tydzień tj. od poniedziałku do niedzieli, niezależnie od zakończenia poprzedniego miesiąca i rozpoczęcia kolejnego. Jeśli natomiast opcja ta zostanie odznaczona, plan wizyt zostanie skopiowany tylko w obrębie danego miesiąca tj. jeśli następny miesiąc rozpoczyna się w czwartek, wtedy plan wizyt zostanie skopiowany do środy włącznie.

Okno kopiowania planu wizyt z zaznaczonym parametrem [Tylko w obrębie miesiąca]

Kopiowanie dziennego planu wizyt

W aplikacji istnieje możliwość kopiowania dziennego planu wizyt. Więcej informacji o konfiguracji parametru można znaleźć TUTAJ.

Po wyborze opcji [Kopiuj wizyty] pojawi się okno z możliwością kopiowania tygodniowego planu wizyt. Po wybraniu opcji tygodniowy zostanie włączona opcja kopiowania dziennego planu wizyt. Użytkownik ma możliwość przełączenia dat przy użyciu przycisków

oraz

lub po kliknięciu w nazwę dnia tygodnia.

Przesunięcie wizyty

Przesunięcie pojedynczej wizyty

W celu przesunięcia pojedynczej wizyty na inny termin należy z jej menu kontekstowego wybrać opcję [Przesuń].

Po naciśnięciu na przycisk [Przesuń] pojawi się okno umożliwiające wybranie nowego terminu wizyty zaprezentowane na poniższym zrzucie ekranu.

W polach [Data] i [Godzina] podpowiada się pierwszy wolny termin począwszy od daty bieżącej, w którym może zostać zrealizowana wizyta. Po ustaleniu nowego terminu wizyty należy wybrać opcję [Zapisz]. Wizyta zostanie przeniesiona na nowy termin.

Przesunięcie cyklu wizyty

W przypadku, gdy wizyta należy do cyklu, po wybraniu opcji [Przesuń] z menu kontekstowego wizyty, pojawi się okno wyboru zaprezentowane na poniższym zrzucie ekranu.

Okno wyboru opcji przesuwania wizyty należącej do cyklu

Uwaga

Przesunięcie, usunięcie lub odrzucenie wizyty będącej częścią cyklu spowoduje podzielenie tego cyklu na 2 części: pierwsza część cyklu do tego wydarzenia i druga część cyklu od tego wydarzenia. Wówczas jeśli użytkownik będzie chciał przesunąć cały cykl wizyt to przesunięty zostanie pierwszy lub drugi cykl w zależności, która wizyta została wybrana.

Przyklad

Zostały zaplanowane wizyty co tydzień w każdy poniedziałek: 02.05, 09.05, 16.05, 23.05 oraz 30.05. Wizyta 16.05 została odrzucona (prawnik wziął wtedy np. Urlop). Jeśli chcemy przesunąć cykl o np. 1 dzień (w każdy wtorek) i klikniemy na wizytę 02.05, wówczas przesunięte zostaną tylko wizyty 02.05 oraz 09.05 (pierwszy cykl wizyt), natomiast 23.05 oraz 30.05 zostaną bez zmian.

Wybranie opcji [Cały cykl] spowoduje wywołanie okna umożliwiającego przeplanowanie całego cyklu wizyt.

Okno przesuwania cyklu wizyt różni się od okna przesuwania pojedynczej wizyty następującymi informacjami:

w polu Zaplanowano na pokazywana jest data pierwszego ze zdarzeń cyklu,
prezentowana jest informacja o okresie powtarzania zdarzenia,
prezentowana data końca cyklu.

W polach [Data] i [Godzina] podpowiada się pierwszy wolny termin począwszy od daty bieżącej, w którym może zostać zrealizowane pierwsze ze zdarzeń cyklu. Jest to jednocześnie termin rozpoczęcia cyklu. Po ustaleniu nowego terminu należy wybrać opcję [Zapisz]. Cykl wizyt zostanie przeplanowany zgodnie z podanym nowym terminem jego rozpoczęcia.

Wskazówka

Terminy zdarzeń i data zakończenia przesuwanego cyklu ustalone zostaną na podstawie różnicy pomiędzy starym a nowym terminem rozpoczęcia cyklu.

Wstrzymanie realizacji wizyty handlowej

Funkcjonalność wstrzymania realizacji wizyty umożliwia przejście w aplikacji do innych działań, w tym realizacji innych wizyt bez konieczności zakończenia, bądź odrzucenia dotychczas realizowanej wizyty. Realizację zawieszonej wizyty będzie można wznowić w późniejszym terminie. Taka funkcjonalność ma szerokie zastosowanie w sytuacji, gdy przedstawiciel handlowy w ramach jednego wyjazdu do klienta realizuje kilka spotkań. Tak więc rozpoczynając pierwsze spotkanie, rozpoczyna w aplikacji wizytę, którą po zakończeniu spotkania zawiesza. Kolejne spotkanie realizowane jest później (na przykład telefonicznie) pod koniec dnia. Aplikacja umożliwia zawieszenie takiej wizyty i rozpoczęcie kolejnych wizyt zaplanowanych na dany dzień. Umożliwienie zawieszenia wizyty możliwe jest poprzez zaznaczenie w pasku górnym wizyty będącej w trakcie realizacji opcji [Wstrzymaj realizację] (przycisk pauzy).

Wybór opcji „Wstrzymaj realizację” na wizycie handlowej

W widoku poziomym również możliwe jest wstrzymanie realizacji wizyty poprzez wybór opcji [Wstrzymaj realizację]. Dodatkowo w podanym oknie jest możliwość zastosowania opcji:

Odrzuć
Zakończ
Wyjdź bez zapisu
Anuluj

Wybór opcji „Wstrzymaj realizację” – widok poziomy

Naciśnięcie opcji [Wstrzymaj realizację] powoduje następujące skutki:

wyjście z okna wizyty, z zapisaniem do bazy mobilnej wszelkich dokonanych dla niej zmian
zatrzymanie licznika realizacji (uwaga: w bazie zapamiętywany jest dotychczasowy czas trwania)
oznaczenie wizyty w aplikacji i w bazie mobilnej jako wstrzymaną (zawieszoną)

Wizyta wstrzymana jest zaprezentowana w aplikacji jako wizyta niezrealizowana i oznaczona kolorem pomarańczowo-żółtym. Prezentacja wizyty zawieszonej jest widoczna w następujących lokalizacjach:

w Terminarzu, na zakładkach:

– Miesiąc, Tydzień, Dzień, [Zaplanowane]

w Podsumowaniu dnia, na zakładce: [Dzień]

Prezentacja zawieszonej wizyty handlowej

Wznowienie wizyty handlowej możliwe jest poprzez wybranie opcji [Realizuj], która jest dostępna na poziomie:

okna podniesionej do edycji wizyty (górny pasek)
menu kontekstowego dostępnego dla wizyty na pozycji terminarza

Opcja [Realizuj] uruchamia realizację wizyty na standardowych zasadach aplikacji, z tą różnicą że należy kontynuować dotychczas naliczony czas trwania realizacji (licznik staruje nie od zera, lecz od ostatnio zapisanej wartości).

Jeżeli następuje Podsumowanie dnia, w którym dana wizyta została zawieszona i niezrealizowana występuje komunikat następującej treści: „Istnieją rozpoczęte działania, które zostały wstrzymane. Czy na pewno chcesz zakończyć dzień?” Wybór opcji [Tak] pozwala na zakończenie dnia pomimo zawieszonej realizacji wizyty, natomiast wybór opcji [Nie], nie spowoduje zamknięcia dnia.

Informacja o zawieszonej wizycie podczas Podsumowania dnia

Realizacja wizyty handlowej bez podania wzorca

Realizacja wizyty bez podania wzorca jest bardzo podobna jak wizyta ze wzorcem. Jedyną różnicą między nimi jest to, że po kliknięciu w ikonę realizacji podnosi się okno w wyborem wzorca, jak na zrzucie poniżej.

Wybór wzorca wizyty podczas realizowanej wizyty

Dzięki temu przedstawiciel handlowy może dobrać odpowiedni wzorzec z wymaganymi elementami do rodzaju wizyty u Klienta.

Realizacja wizyty handlowej

Aby zrealizować zaplanowaną wizytę należy wybrać jedną z dostępnych opcji w menu dostępnym po naciśnięciu na przycisk z prawej strony. Realizacja wizyty polega na wybraniu przycisku [Realizuj] lub [Odrzuć] dostępnych z poziomu Szczegółów działania lub z dostępnego dla wizyty menu rozwijalnego. Podczas próby wyjścia z danego elementu WH bez zapisania dokonanych zmian pojawi się okno z wyborem opcji: [Zapisz], [Wyjdź bez zapisu], [Anuluj], [Odrzuć] oraz [Wstrzymaj realizację].

W oknie zaplanowanej wizyty handlowej na zakładce [Opis] istnieje możliwość edycji opisu. Edycja ta jest dostępna również po zakończeniu realizacji wizyty, ale przed jej zsynchronizowaniem do centrali.

Realizacja elementów wizyty

Po rozpoczęciu realizacji wizyty handlowej istnieje możliwość zrealizowania poszczególnych zadań do wykonania zdefiniowanych w ramach wizyty.

Wizyta handlowa - stan początkowy (0% realizacji)

Realizacja poszczególnych działań odbywa się przez wejście w dane działanie przez dłuższe przytrzymanie palcem lub przez kliknięcie ikony strzałki. Dane zadanie można wykonać klikając Realizuj lub zrezygnować z wykonania klikając Odrzuć:

Realizacja lub odrzucenie elementu wizyty

W przypadku, gdy chcemy zakończyć realizację danej WH istnieje możliwość skorzystania z następujących opcji:

Naciśnięcie na przycisk spowoduje wyświetlenie okna zaprezentowanego na poniższym zrzucie ekranu.

Wizyta służbowa, okno wyświetlane po naciśnięciu przycisku [Odrzuć]

Naciśnięcie na przycisk spowoduje wyświetlenie okna zaprezentowanego na poniższym zrzucie ekranu.

Wizyta służbowa, okno wyświetlane po naciśnięciu przycisku Zapisz i Powrót na urządzeniu

Naciśnięcie przycisku [Powrót] na urządzeniu spowoduje wyświetlenie okna identycznego jak po naciśnięciu na przycisk .

W przypadku próby zakończenia wizyty, która posiada elementy wymagane, które nie zostały zrealizowane konieczne jest podanie powodu odrzucenia wymaganych elementów.

Pasek postępu realizacji wizyty handlowej obrazuje udział zrealizowanych bądź odrzuconych elementów w stosunku do wszystkich elementów wizyty. Widoczny jest on w oknie wizyty bezpośrednio nad sekcją z zakładkami. Pojawia się po rozpoczęciu jej realizacji i obecny jest przez cały czas jej trwania. Funkcjonalność ta pozwala Przedstawicielowi na łatwe śledzenie postępu realizacji zadań do wykonania.

Pasek postępu zapełnia się w miarę realizacji bądź odrzucania elementów wizyty. W miarę realizacji elementów przesuwa się on w prawo, a jego kolor zależy od procentu zapełnienia:

brak zapełnienia – żadne z zadań nie zostało jeszcze wykonane:

zapełnienie od 1% do 33% – kolor czerwony:

zapełnienie od 34% do 66% – kolor żółty:

zapełnienie od 67% do 100% – kolor zielony:

pasek całkowicie zapełniony – wszystkie zadania wykonane:

Wyliczanie procentu realizacji odbywa się w następujący sposób:

każdy z elementów wizyty otrzymuje taką samą wagę, co przekłada się to na procent zapełniania paska postępu po zrealizowaniu/odrzuceniu elementu,
dodatkowo:
- procent realizacji elementu Ankiety zależy od liczby pytań, na które udzielono już odpowiedzi,
- procent realizacji elementu Merchandising zależy od liczby sfotografowanych realizacji,
- procent realizacji elementu Raport obecności towarów i Raport towarów konkurencji zależy od ilości raportów wchodzących w skład elementu.

Pasek postępu widoczny jest również w oknie zrealizowanej wizyty (zatwierdzonej bądź odrzuconej). Pokazuje on wówczas procent zrealizowanych/odrzuconych elementów wizyty na etapie, w którym wizyta została zakończona. Elementy wizyty, do których został przypięty załącznik oznaczone są na liście ikoną spinacza (tak jak to pokazano na poniższym zrzucie).

Aby podejrzeć załączniki przypięte do poszczególnych zadań należy na liście elementów wizyty rozwinąć menu kontekstowe i wybrać opcję [Załączniki].

Otwieranie listy załączników z poziomu elementu wizyty

W przypadku elementów typu:

Ankieta
Inny
Raport obecności
Raport konkurencji

Lista załączników została dodatkowo udostępniona w formie kolejnej zakładki, dzięki czemu Użytkownik ma dostęp do załączników także w trakcie realizacji poszczególnych etapów wizyty. Dla ułatwienia różne rodzaje załączników zostały od siebie odróżnione odpowiednimi ikonami. Lista załączników zaprezentowana jest na zrzucie poniżej.

Możliwość pobrania z systemu Comarch ERP Altum załączników, przypisanych do nagłówka lub elementów wizyty handlowej, w najnowszej aplikacji została rozszerzona o wzorce wizyt. Dzięki temu, dział handlowy może usprawnić swoją pracę poprzez przypisanie na wzorcach wizyt odpowiednich załączników, które po pobraniu wzorca, będą automatycznie dodawane do zaplanowanej wizyty w aplikacji mobilnej. Przy pomocy tej funkcji, można udostępnić przedstawicielowi handlowemu dodatkowe informacje i dokumenty, które są potrzebne podczas spotkania z Klientem, np. skany umów, dokumentacje techniczne, wzory pism, notatki czy gazetki promocyjne. Załączniki przypięte do nagłówka wzorca wizyty handlowej widoczne są na zakładce Szczegóły, w sekcji [Informacje dodatkowe].

Element WH: Przejazd

Obsługa takiego rodzaju elementu wizyty polega na zarejestrowaniu informacji skąd przedstawiciel handlowy wyjechał, dokąd dojechał oraz jaką odległość wykonał i w jakim czasie z zarejestrowaniem samochodu, którym się poruszał oraz jego stanu licznika.

Element WH: Należności

W przypadku, gdy elementem wizyty jest przyjęcie należności po wybraniu przycisku [Realizuj] zostanie otwarte okno: [Płatności] z nierozliczonymi dokumentami dla kontrahenta wskazanego w wizycie (jeżeli takie dokumenty istnieją, w przeciwnym wypadku otwarte okno jest puste). Okno umożliwia wykonanie wpłaty dla określonego w wizycie kontrahenta.

Kliknięcie w daną płatność spowoduje otwarcie okna, w którym możliwa jest zmiana kwoty rozliczenia. Okno zostało zaprezentowane na poniższym zrzucie ekranu.

Element WH: Zamówienia

Obsługa takiego elementu wizyty polega na wystawieniu dokumentu handlowego na kontrahenta.

Element WH: Inny

Obsługa takiego typu wizyty polega na wprowadzeniu informacji odnośnie realizacji dodatkowego zadania.

Realizacja elementu Inny polega na wpisaniu tekstu. Po kliknięciu w ikonę

możliwe jest także podyktowanie realizacji, a system przeniesie go na tekst pisany.

Element WH: Merchandising

Obsługa takiego typu wizyty polega na wykonaniu zdjęcia na podstawie udostępnionego załączonego wzorca.

Po wykonaniu zdjęcia, wzorzec w oparciu, o który zrealizowane zostało zdjęcie zostanie oznaczony ikoną zaprezentowaną na poniższym zrzucie ekranu.

Wizyta służbowa: Merchandising, realizacja

Przy współpracy z systemem Comarch ERP Altum istnieje możliwość dodawania zdjęć bez zadanych wzorców. Po wejściu w realizację merchandisingu prezentowany jest kafel [Dodatkowe] dla którego można dodawać kolejne zdjęcia.

Realizacja merchandisingu bez zadanych wzorców

Istnieje także możliwość dodawania wielu zdjęć do każdego z wzorców. Aby dodać kolejne zdjęcie należy przesunąć palcem w lewo zdjęcie z realizacją.

Przy współpracy z systemem Comarch ERP Altum istnieje możliwość dodawania opisów do wykonywanych zdjęć. Aby go dodać należy kliknąć w ikonę z ołówkiem znajdującą się w polu opis.

Element WH: Raport towarów konkurencji

Obsługa takiego elementu wizyty polega na sprawdzeniu obecności towarów konkurencji u Klienta. W przypadku, gdy w ramach elementu wizyty o typie: Raport towarów konkurencji zdefiniowane jest więcej niż jeden raport wówczas podczas realizacji elementu wizyty zostanie wyświetlone okno z listą dostępnych w ramach danego elementu raportów.

Wybór wzorca wizyty, dla którego w systemie ERP podpięto raport konkurencji

Wizyta służbowa: Raport towarów konkurencji

Definicje raportów należy utworzyć w systemie Comarch Mobile Zarządzanie. Po wejściu w dany raport zostanie wyświetlone okno z listą towarów, które obejmuje dany raport. Na raporcie konkurencji została udostępniona możliwość oznaczenia dostawcy danego artykułu. Po otwarciu raportu konkurencji, użytkownik może określić [Proponowanego dostawcę], poprzez wybór z listy lub dodanie nowego kontrahenta. Podczas realizacji elementów raportu konkurencji ustawiony proponowany dostawca będzie się podpowiadał na danym towarze.

Raport towarów konkurencji: lista towarów

Określenie dostawcy na raporcie konkurencji

Po wybraniu danego towaru pojawi się okno zaprezentowane na poniższym zrzucie ekranu.

W ten sposób przedstawiciele w szybszy sposób mogą zbierać informacje odnośnie konkurencji w celu przygotowywania i zaproponowania Klientowi atrakcyjniejszej oferty.

Usuwanie wizyt handlowych

Usunięcie niezrealizowanych wizyt zarejestrowanych na urządzeniu jest możliwe poprzez wybór opcji [Usuń], dostępnej z poziomu menu kontekstowego. Po naciśnięciu przycisku [Usuń] zostanie wyświetlone okno:

Element WH: Ankiety

Obsługa takiego typu wizyty polega na wykonaniu ankiety, która została zdefiniowana w systemie Comarch ERP Altum. W przypadku, gdy w ramach elementu wizyty o typie: Ankiety zdefiniowane jest więcej niż jedna ankieta wówczas podczas realizacji elementu wizyty zostanie wyświetlone okno z listą dostępnych w ramach danego elementu ankiet.

Po wyborze konkretnej ankiety zostanie wyświetlona lista pytań zdefiniowanych w ramach wybranej ankiety, zaprezentowana na poniższym zrzucie ekranu.

W aplikacji Comarch Mobile umożliwiono definiowanie ankiet zarówno z pytaniami jednokrotnego jak i wielokrotnego wyboru. Podczas realizacji elementu wizyty: Ankiety standardowo po wybraniu zadania do wykonania (Ankiety) i po wybraniu danej ankiety powinna zostać wyświetlona lista pytań. Na rysunku poniżej zaprezentowano model zaznaczenia wielu odpowiedzi i ich prezentacje na liście pytań. W przypadku wyboru odpowiedzi Inna, pojawi się okno w której istnieje możliwość wpisania własnej odpowiedzi.

Zaznaczenie wielu odpowiedzi i prezentacja na liście pytań (w tym odpowiedzi typu Inna)

W najnowszej wersji aplikacji Comarch Mobile została dodana opcja skanowania odpowiedzi do ankiety. Warunkiem działania tej funkcji jest zainstalowana aplikacja Binary Eye na urządzeniu mobilnym. Po wywołaniu przycisku skanowania w oknie odpowiedzi możliwe będzie zeskanowanie wartości – odpowiedzi ankiety.

Możliwość zeskanowania odpowiedzi do ankiety

Aplikacja Comarch Mobile Sprzedaż umożliwia także wprowadzenie danych osób Klienta, z którymi została przeprowadzona ankieta. Podczas realizacji tego elementu wizyty, operator może:

określić kilku respondentów spośród zdefiniowanych osób kontaktowych Klienta,
dodać nową osobę ankietowaną – np. nowego pracownika Klienta.

Możliwość wyboru osoby kontaktowej z karty kontrahenta, z którą była przeprowadzana ankieta

Informacja o ankietowanej osobie na karcie wizyty

Podczas realizacji elementu wizyty: Ankieta użytkownik może w szybki sposób wyszukać interesującą osobą na wyświetlonej liście osób kontaktowych kontrahenta. Opcja ta jest szczególnie przydatna, kiedy lista jest długa i wymaga przewijania. Użytkownik może odszukać interesującą go osobę wyszukując po imieniu lub nazwisku. Wpisaną frazę można w szybki sposób skasować poprzez wybranie ikony krzyżyka.

Element WH: Raport obecności towarów

SPIS TREŚCI

Konfiguracja elementu Merchandising z Raportem obecności towarów Obsługa funkcjonalności w aplikacji Generowanie zamówienia na podstawie raportu obecności towarów Obsługa funkcjonalności w aplikacji

Obsługa takiego elementu wizyty polega na sprawdzeniu obecności towarów firmy Przedstawiciela Handlowego u Klienta. W przypadku, gdy w ramach elementu wizyty o typie: Raport obecności towarów zdefiniowane jest więcej niż jeden raport, wówczas podczas realizacji elementu wizyty zostanie wyświetlone okno z listą dostępnych w ramach danego elementu raportów.

Wizyta służbowa: Lista raportów obecności towarów

Po wejściu w dany raport są dostępne dwie zakładki: [Realizacja] - okno prezentujące aktualny raport z listą towarów, które obejmuje dany raport. Definicje raportów należy utworzyć w systemie Comarch Mobile Zarządzanie, oraz [Raport historyczności] - okno prezentuje poprzednie raporty powiązane z danym kontrahentem. Poszczególne zakładki zaprezentowano na poniższym rysunku:

Okno realizacji raportu – bez możliwości generowania zamówień na podstawie raportu oraz Okno raportu historycznego

Okno realizacji raportu – z możliwością generowania zamówień na podstawie raportu oraz Okno raportu historycznego

W pierwszej zakładce [Realizacja], po wybraniu danego towaru, pojawi się okno z poszczególnymi danymi do uzupełnienia, zaprezentowane poniżej.

Wizyta służbowa: Raport obecności towarów

Po uzupełnieniu danych dotyczących towaru zostanie wyświetlone okno tak, jak na poniższym rysunku.

Wizyta służbowa: Raport obecności towarów, uzupełnione dane

Zakładka [Raport historyczny] zawiera informacje o dacie realizacji raportu oraz ilości zrealizowanych towarów względem ilości wszystkich towarów. W tej zakładce, gdy istnieją raporty historyczne, wówczas są dostępne na action barze dwa dodatkowe przyciski

i

. Po wybraniu opcji

pojawi się lista raportów historycznych z możliwością wyboru raportu do wyświetlenia. Prezentowane są tylko raporty, które dotyczą wizyt wystawionych na kontrahenta, którego dotyczy aktualnie realizowana wizyta i zrealizowanych przez operatora mobilnego zalogowanego do aplikacji.

Po wybraniu opcji

pojawi się okno z możliwość skopiowania danych z poprzednich raportów na raport bieżący. Po wybraniu opcji kopiowania dostępne są następujące parametry: Pomiń towary już zaznaczone – po zaznaczeniu, jeżeli realizacja dla towaru jest uzupełniona na raporcie bieżącym i jednocześnie znajduje się na raporcie historycznym, wówczas dane dla takiego towaru nie są nadpisywane, Wartości parametrów z historycznego raportu - po zaznaczeniu kopiowane są wartości parametrów (cena, ilość, itp.) z historycznego raportu o ile pokrywają się one z bieżącą definicją raportu, Ilość do zamówień z historycznego raportu - parametr pojawi się tylko, jeśli na bieżącej definicji raportu została skonfigurowana możliwość generowania zamówień na podstawie raport (funkcjonalność opisana TUTAJ).

Uwaga

Jeżeli któryś z parametrów został oznaczony jako wymagany, a na raporcie historycznym taki nie był, zatwierdzenie realizacji takiego raportu nie będzie możliwe do momentu uzupełniania wymaganych parametrów na wszystkich zaznaczonych pozycjach (będą prezentowane w kolorze czerwonym).

Konfiguracja elementu Merchandising z Raportem obecności towarów

Dodatkowo w aplikacji istnieje możliwość powiązania elementu wizyty: Raport obecności towarów z elementem: Merchandising. W efekcie podczas realizacji wizyty Raport obecności towarów jest możliwość wykonania zdjęć losowym towarom znajdującym się na raporcie. W Comarch Mobile Zarządzanie podczas dodawania elementu wzorca Merchandising parametr Zdjęcia na podstawie może przyjmować ustawienia: dodanych wzorców lub raportu obecności. Podczas konfiguracji Zdjęcia na podstawie raportu obecności wymagane jest dodatkowo uzupełnienie parametrów: Dla ilu towarów z raportów wykonać zdjęcia Raporty obecności

Konfiguracja elementu wzorca: Merchandising – zdjęcia na podstawie raportu obecności

Lista dostępnych raportów obecności możliwych do powiązania z elementem Merchandising

Dodany raport powiązany z elementem Merchandising

Obsługa funkcjonalności w aplikacji

Po wykonaniu opisanej konfiguracji w aplikacji Comarch Mobile Sprzedaż przed rozpoczęciem realizacji elementu Merchandising jest sprawdzane, czy podpięty raport obecności towarów został zrealizowany.

Uwaga

Jeżeli na raporcie obecności towarów zostało zarejestrowanych mniej towarów niż wskazuje na to wartość parametru "Dla ilu towarów z raportów wykonać zdjęcia", wówczas wyświetlana ilość zdjęć do zrealizowania będzie odpowiadać wartości towarów zrealizowanych na takim raporcie.

Zdjęcia dla poszczególnych towarów są prezentowane w takiej formie jak prezentowane są wzorce zdefiniowane na elemencie Merchandising.

Wykonywanie zdjęć towarów zarejestrowanych na raporcie obecności towarów

Każde kolejno dodane zdjęcie wyświetlane jest w postaci zakładek. Możliwe jest dodanie wielu zdjęć do jednego towaru.

Uwaga

Dla każdego z wylosowanych towarów należy wykonać co najmniej jedno zdjęcie. Inaczej pojawi się komunikat "Zatwierdzenie elementu niemożliwe. Dla każdego z towarów musi zostać wykonane co najmniej jedno zdjęcie."

Zatwierdzanie elementu Merchandising jeśli nie dla wszystkich towarów zostały wykonane zdjęcia.

Generowanie zamówienia na podstawie raportu obecności towarów

W aplikacji Comarch Mobile Zarządzanie podczas konfigurowania Raportu obecności towarów w sekcji [Ogólne] został dodany nowy parametr Możliwość wygenerowania zamówienia na podstawie raportu, który domyślnie ustawiony jest na Tak. Jeżeli wartość parametru przyjmuje wartość Tak, wówczas podczas realizacji elementu wizyty typu: Rejestrowanie dokumentu (ZS) istnieje możliwość automatycznego dodania towarów na zamówienie zgodnie z ilościami towarów wskazanymi podczas realizacji raportu obecności.

Konfiguracja elementu: Raport obecności towarów

Obsługa funkcjonalności w aplikacji

Jeżeli w aplikacji Comarch Mobile Sprzedaż na wizycie został zrealizowany co najmniej jeden raport, na definicji którego parametr: Możliwość wygenerowania zamówienia na podstawie raportu został określony na: Tak, wówczas po rozpoczęciu realizacji elementu Rejestrowanie dokumentu z typem: ZS wyświetlone zostanie okno z nagłówkiem „Dodaj towary z raportów obecności” z dodatkowymi parametrami. Rysunek poniżej:

Okno dodawania towarów na dokument ZS na podstawie raportu obecności – (1) przypadek jeśli zrealizowany tylko jeden raport, (2) przypadek jeśli zrealizowanych kilka raportów

Jednocześnie opcja [Dodaj towary z raportów obecności] jest dostępna w menu kontekstowym na dokumencie ZS.

Opcja: Dodaj towary z raportu dostępna w opcjach dodatkowych dokumentu ZS.

Planowanie spotkania

Uwaga

Przy dodawaniu spotkania w systemie Comarch ERP Altum, które ma zostać zsynchronizowane na urządzenie mobilne, należy zaznaczyć opcję „Dodaj do terminarzy pracowników”.

Spotkanie jest typem działania planowanego przeważnie z wyprzedzeniem. Za jego pomocą można zarejestrować spotkanie u Klienta. W przypadku tworzenia spotkań dostępne są dodatkowe opcje takie jak: wysyłanie działania do systemu po zaplanowaniu, czy też planowanie kolejnego po zrealizowaniu.

Opcja „Dodaj do terminarzy pracowników”, konieczna do zaznaczenia jeśli planujemy spotkanie z poziomu Comarch ERP Altum

Okno planowania spotkania składa się z czterech zakładek:

Określ wzorzec spotkania,
Wybierz kontrahentów,
Koszyk,
Dzień.

Po wybraniu opcji planowania spotkania, nastąpi przejście na zakładkę: Określ wzorzec spotkania – okno zostało zaprezentowane poniżej.

Przy współpracy z systemem Comarch ERP Altum rodzaje spotkań definiuje się w systemie ERP, jako: Słowniki uniwersalne\CRM\Rodzaj kontaktu. Oznaczenie wybranych godzin w kolorze czerwonym oznacza, że w danym terminie istnieje zaplanowane już inne wydarzenie. Spotkanie może być ponadto powiązane z wątkiem na urządzeniu mobilnym, należy pamiętać jednakże wątek ten nie będzie wysyłany do systemu ERP. Spotkanie można powiązać z istniejącym, niezakończonym wątkiem przypisanym do danego Kontrahenta lub można stworzyć nowy wątek, z którym spotkanie zostanie powiązane. Powiązanie to jest fakultatywne.

Realizacja spotkania

Realizacja spotkania polega na wybraniu przycisku [Realizuj] lub [Odrzuć] dostępnych z menu rozwijalnego. Menu rozwijalne i wszystkie dostępne opcje dla Spotkania zostało zaprezentowane na rysunku poniżej.

Menu rozwijalne, działanie typu: [Spotkanie]

Po naciśnięciu na przycisk

zostanie wyświetlone okno realizacji spotkania zaprezentowane na rysunku poniżej.

Realizacja spotkania – powiązanego z wątkiem

Jeżeli wątek zostaje zamknięty i są z nim powiązane niezrealizowane zdarzenia cykliczne, to zostaną one usunięte. Jeżeli wątek zostaje zamknięty i są z nim powiązane zdarzenia niecykliczne niezrealizowane, to zamknięcie wątku spowoduje ich zakończenie z czasem realizacji 0 i dacie zrealizowania takiej jak data działania, podczas której zamknięto wątek. W uwagach do realizacji automatycznie doda się opis, który świadczy o zakończeniu działań z powodu zamknięcia wątku. Na karcie wątku znajdują się działania powiązane z danym wątkiem. Z tego poziomu istnieje możliwość np. realizacji lub wyświetlenia szczegółów danego działania.

Menu kontekstowe z dostępnymi opcjami zostało zaprezentowane na rysunku poniżej.

Usuwanie spotkań

Usunięcie niezrealizowanych spotkań zarejestrowanych na urządzeniu jest możliwe poprzez wybór opcji [Usuń], dostępnej z poziomu menu kontekstowego. Po naciśnięciu przycisku [Usuń] zostanie wyświetlone okno:

Realizacja kwestionariusza

Gdy podczas planowania spotkania lub kontaktu został wybrany kwestionariusz, jest on dostępny podczas realizacji tego typu elementu CRM w sekcji: zadania do wykonania. Nazwa kwestionariusza zawierającego pytania wymagające odpowiedzi kolorem czerwonym. Oprócz nazwy i opisu kwestionariusza prezentowana jest także ilość udzielonych odpowiedzi oraz wszystkich pytań znajdujących się na ankiecie.

Opcje dostępne podczas realizacji spotkania z kwestionariuszem

Kwestionariusz można zrealizować, dodać opis realizacji lub odrzucić. Jeśli na wybranym kwestionariuszu znajduje się przynajmniej jedno pytanie oznaczone w systemie Comarch ERP Altum jako wymagające odpowiedzi, to cały kwestionariusz jest uznany jako obligatoryjny. Podczas realizacji kontaktu nie będzie możliwe zatwierdzenie całego kontaktu, dopóki nie zostaną udzielone odpowiedzi na wymagane pytania.

Komunikat podczas zatwierdzenia kontaktu z kwestionariuszem bez udzielonych odpowiedzi na wymagane pytania

Natomiast podczas odrzucania kwestionariusza na spotkaniu konieczne jest podanie powodu.

W aplikacji Comarch Mobile istnieje opcja skanowania odpowiedzi do ankiety. Warunkiem działania tej funkcji jest zainstalowana aplikacja Binary Eye na urządzeniu mobilnym. Po wywołaniu przycisku skanowania w oknie odpowiedzi możliwe jest zeskanowanie wartości – odpowiedzi ankiety.

Planowanie działania prywatnego

Działania prywatne można planować tylko na urządzeniu i nie jest ono przesyłane do systemu ERP. Okno planowania działania prywatnego składa się z dwóch zakładek:

Planowanie działania,
Dzień.

Okno planowania działania prywatnego zostało pokazane i opisane poniżej.

Działanie prywatne: zakładka [Planowanie działania]

Oznaczenie wybranych godzin w kolorze czerwonym oznacza, że w danym terminie istnieje zaplanowane już inne działanie. Na zakładce Dzień można zobaczyć zaplanowane zdarzenie w ujęciu dziennym.

Realizacja działania prywatnego odbywa się poprzez oznaczenie jako zrealizowane.

Realizacja działania prywatnego

Realizacja działania prywatnego polega na wybraniu przycisku [Realizuj] lub [Odrzuć] dostępnych z poziomu Szczegółów działania lub z dostępnego dla działania menu. Dodatkowo wydarzenie prywatne można usunąć lub edytować.

Zakupy

Zasady pracy z aplikacją Comarch Mobile

Generowanie bazy na nowo na urządzeniu i przechowywanie backupów

Umożliwienie utworzenia bazy danych i przechowywanie załączników na karcie SD

Logowanie

Uruchomienie aplikacji Comarch Mobile

Konfiguracja

Krok 1 - Serie

Krok 2 - Magazyny

Krok 3 - Numeratory

Krok 4 - Grupa operatorów i operator

Krok 5 - Uprawnienia

Krok 6 - Centrum mobilne

Krok 7 - Kontrahenci

Krok 8 - Artykuły

Wielofirmowość

Dostępność kontrahentów

Atrybuty wielofirmowe

Krok 9 - Zatowarowanie magazynu mobilnego

Konfiguracja funkcjonalności

Rozszerzalność aplikacji

Ukrywanie i zmiana kolejności elementów w aplikacji

Dodawanie niestandardowego filtra do listy

Dodawanie filtra

Usuwanie filtra

Elementy składowe filtra

Przykład

Kontrahenci

Ustawienie domyślnej waluty na karcie kontrahenta

Załączniki

Ukrywanie kwoty przyznanego i wykorzystanego limitu kredytowego kontrahenta

Obsługa programów lojalnościowych

Struktura definicji programu lojalnościowego

Elementy w definicji program lojalnościowego

Synchronizacja punktów lojalnościowych kontrahentów

Rozliczanie punktów w systemie Comarch ERP Altum

Blokada realizacji działań handlowych dla nowo utworzonego kontrahenta

Dokumenty

Pobieranie dokumentów historycznych

Wystawianie dokumentów ZZ, OZ na kilka magazynów

Zmiana kontrahenta podczas wystawiania dokumentu

Wystawianie dokumentów zamówienia zakupu i oferty zakupu w innej walucie

Obsługa eksportowych stawek VAT

Obsługa odwrotnego obciążenia

Obsługa edycji sposobu dostawy

Edycja płatnika na nagłówku dokumentu

Edycja kontrahenta docelowego i głównego na nagłówku dokumentu

Agregacja VAT na definicji dokumentów oraz stan realizacji zamówień

Pobieranie informacji o stanie realizacji zamówień z Comarch ERP Altum

Możliwość zatwierdzania dokumentu bez podpisu

Załączniki

Wyświetlanie ceny i ilości zarówno w jednostce podstawowej jak i domyślnej jednostce pomocniczej podczas wystawiania dokumentów

Towary

Załączniki

Precyzja cen w aplikacji mobilnej

Konfiguracja kompletu

Wyświetlanie/ukrywanie informacji o stanach magazynowych

Wyświetlanie stanów magazynowych z podziałem na partie (wielocechowość)

Raporty

Edycja raportów

Przykład modyfikacji raportu

Elementy składowe

Nagłówek

Typ raportu

Widoczność raportu

Argumenty

Elementy

Przykłady modyfikacji raportów

Dodanie argumentu

Dodanie nowej kolumny w tabeli

Usunięcie kolumny z tabeli

Wydruki

Definicje wydruków

Dodanie nowej definicji wydruku dokumentu

Dodanie nowej definicji wydruku raportu

Usunięcie definicji wydruku

Licznik wydruków

Dodatkowe informacje na wydrukach

Źródło danych

Wydruk do pdf