Spis treści – Baza Wiedzy aplikacji Comarch Mobile 2025.1

Parametry

Kontrahenci

Zmiany parametrów należy dokonać w pliku configuration.xl.statement. Domyślna lokalizacja pliku to C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration.

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima

ArchiveUsedAddressAfterChanging	1 – jeżeli nowododany adres kontrahenta został użyty to adres ten zostanie zarchiwizowany w przypadku jego zmiany przed synchronizacją do systemu ERP 0 – jeżeli nowododany adres kontrahenta został użyty to adres ten nie zostanie zarchiwizowany w przypadku jego zmiany (zostanie podmieniony na dokumencie) przed wysłaniem do systemu ERP
CanAddContractorWithChecking	0 – po wybraniu opcji dodawania nowego kontrahenta, nie nastąpi weryfikacja kontrahenta w bazie systemu ERP (standardowe działanie aplikacji), 1 – po wybraniu opcji dodawania nowego kontrahenta, nastąpi weryfikacja kontrahenta w bazie systemu ERP, jeżeli kontrahent o wskazanym numerze NIP zostanie odnaleziony, dodanie kontrahenta w aplikacji o takim samym numerze NIP nie zostanie zablokowane, 2 – po wybraniu opcji dodawania nowego kontrahenta, nastąpi weryfikacja kontrahenta w bazie systemu ERP, jeżeli kontrahent o wskazanym numerze NIP zostanie odnaleziony, dodanie kontrahenta w aplikacji o takim samym numerze NIP zostanie zablokowane.
CanAddContractor	0 – powoduje zablokowanie możliwości dodania kontrahenta w aplikacji
ContextSynchronization	0 – możliwość wywołania synchronizacji stanów dla pojedynczego towaru wyłączona 1 – możliwość wywołania synchronizacji stanów dla pojedynczego towaru włączona
EmailFlag (w pliku contractorstypes)	1 – pole jest wymagane 2 – pole będzie dostępne do edycji 4 – zmiana pola wpłynie na zmianę adresu
PhoneFlag (w pliku contractorstypes)	1– pole jest wymagane 2– pole będzie dostępne do edycji 4 – zmiana pola wpłynie na zmianę adresu
URLFlag (w pliku contractorstypes)	1 – pole jest wymagane 2 – pole będzie dostępne do edycji 4 – zmiana pola wpłynie na zmianę adresu
IsContractorsCreditLimitsValueVisible	0 - opcja ukrywania kwoty przyznanego i wykorzystanego limitu; ustawienie tej wartości parametru spowoduje ukrycie w aplikacji Comarch Mobile Sprzedaż informacji o kwotach limitów – pozostanie informacja o kwocie pozostającej do wykorzystania oraz przeterminowanej 1 - opcja pełnej prezentacji informacji o przyznanym limicie; dotychczasowe działanie aplikacji w zakresie wyświetlania kwot limitów kontrahenta
IsEditingSettlementsEnabled	0 – zmiana kwoty na raporcie KW – rozliczenie jest możliwa 1 – powoduje zablokowanie zmiany kwoty na raporcie KW – rozliczenie
IsHeadquarterStocksVisible	0 – opcja podglądu informacji o stanach magazynowych z magazynów lokalnych w aplikacji Comarch Mobile Sprzedaż wyłączona, ukryte są wszelkie informacje dotyczące stanów magazynowych lokalnych firmy 1 – opcja podglądu informacji o stanach magazynowych z magazynów lokalnych (z centrali) w aplikacji Comarch Mobile Sprzedaż włączona; dotychczasowe działanie aplikacji w zakresie wyświetlania informacji o stanach magazynowych z centrali.
IsNewContractorVatPayer	0– kontrahent synchronizowany do XL jako niepłatnik VAT 1 – kontrahent synchronizowany do XL jako płatnik VAT
IsSystemContractorsEditingEnabled	0 – powoduje zablokowanie możliwości edycji kontrahentów
LengthTIN	13 – możliwość wprowadzenia maksymalnie 13 znaków w polu NIP dla kontrahenta (domyślnie) 20 – możliwość wprowadzenia maksymalnie 20 znaków w polu NIP dla kontrahenta

Dokumenty

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima

BlockAddingDocument Parametr dostępny w pliku contractors.xl20182.statement	W zależności od tego jaką wartość przyjmie parametr dla określonego kontrahenta, zablokowane zostanie wystawianie w aplikacji następujących typów dokumentów: 1 – zablokowane wystawianie FS 2 – zablokowane wystawianie PAR 4 – zablokowane wystawianie WZ 8 – zablokowane wystawianie ZS 16 – zablokowane wystawianie OS 32 – zablokowane wystawianie RLS 64 – zablokowane wystawianie ZOS Możliwe jest także sumowanie wartości parametru, np. jeżeli wartość parametru zostanie ustawiona na 48 wówczas dla kontrahenta zablokowane zostanie wystawianie dokumentów: OS oraz RLS.
CanAddDocument OnlyOnVisit	1 – wystawianie dokumentów handlowych (WZ, PA, FS) jest niemożliwe 0 – wartość domyślna; wystawianie dokumentów handlowych (PA, FS) możliwe we wszystkich możliwych dostępnych poziomach w aplikacji
CanAddOrderOnlyOnVisit	1 – wystawianie dokumentów OS i ZS jest niemożliwe 0 – wartość domyślna; wystawianie dokumentów OS i ZS możliwe we wszystkich możliwych dostępnych poziomach w aplikacji
CanChangeStartPrice	1 – wartość domyślna; pozwala na edycję ceny początkowej (Jeśli wyłączona została możliwość edycji ceny, to pomimo wartości 1, operator nie będzie mógł zmienić ceny początkowej) 0 – brak praw do edycji ceny początkowej 2 – możliwość zmiany ceny początkowej tylko na nagłówku dokumentu
CanEditComplaintProcessingStatus	0 – powoduje zablokowanie możliwości edycji statusu realizacji 1 – powoduje możliwość edycji statusu realizacji
CanSetNonCalendarIssueDate	0 – wartość domyślna; na nagłówku dokumentu ZS dostępny jest zakres dat tylko z kalendarza dostaw typu "Wysyłka". 1 - do wyboru są dostępne wszystkie terminy realizacji zamówienia.
ChangingContractorOnDocumentPermission (w pliku documentsnumerators)	1 – możliwość zmiany edycji płatnika na nagłówku dokumentu wystawianego w Mobile Sprzedaż 0 – brak możliwości zmiany edycji płatnika na nagłówku dokumentu wystawianego w Mobile Sprzedaż
IsBaseUnitVisible	1 – (wartość domyślna) na liście towarów wyświetlona cena w jednostce pomocniczej oraz jednostce podstawowej, 0 – ilość wyświetlona tylko w jednostce domyślnej
IsCauseOfComplaintRequiredField	Przyczyna reklamacji na dokumencie Reklamacji jest: 1 – wymagane, 0 – niewymagane
IsDocumentsFromSystemVisible	0 – powoduje zablokowanie widoczność dokumentów z systemu
IsEditingSettlementsEnabled	1 – umożliwia zmianę kwoty rozliczonej kasy przez przedstawiciela handlowego 0 – wprowadza blokadę zmiany kwoty rozliczanej przez przedstawiciela handlowego
IsOnlyLowerPaymentFormsVisible	1 – opcja zmiany formy płatności na dokumentach w dół włączona; 0 – opcja zmiany formy płatności na dokumentach w dół wyłączona;
IsOrdersResourcesReservationVerified	0 – opcja weryfikacji zasobów dla zamówień zostanie wyłączona 1 – opcja weryfikacji zasobów dla zamówień zostanie włączona- dla potwierdzonych zamówień z aplikacji nastąpi w systemie ERP zakładanie rezerwacji dla pozycji zamówień
IsRealizationOfComplaintVisible	0 – widoczność realizacji reklamacji w aplikacji Comarch Mobile Sprzedaż wyłączona, 1 – (wartość domyślna) widoczność realizacji reklamacji włączona
IsTotalRealizationEnabled	1 – ZS będzie miało w systemie Comarch ERP XL zaznaczone pole „Realizuj w całości” i nie będzie możliwości częściowej realizacji, 0 – nie będzie możliwości całościowej realizacji ZS
MaxNumberOfDescriptionsLinesInCart	Maksymalna ilość linii opisu wyświetlanych na towarze dodanym do koszyka: 0 – opis pozycji nie będzie wyświetlany na liście towarów dodanych do koszyka, wartość całkowita większa od 0 – ilość linii opisu pozycji wyświetlanych na liście towarów dodanych do koszyka
MaxNumberOfDescriptionsLinesInDocumentList	Maksymalna ilość linii opisu dokumentu wyświetlanych na liście dokumentów: 0 – opis nagłówka dokumentu nie będzie wyświetlany na liście dokumentów, wartość całkowita większa od 0 – ilość linii opisu nagłówka dokumentu wyświetlanych na liście dokumentów
MaxNumberOfDescriptionsLinesOnDevicesList	Maksymalna ilość linii opisu urządzenia wyświetlanych na liście urządzeń: 0 – opis urządzenia nie będzie wyświetlany na liście dokumentów, wartość całkowita większa od 0 – ilość linii opisu urządzenia wyświetlanych na liście urządzeń
SalesInCollectivePackage	0– jeżeli na karcie towaru jest wybrana jednostka zbiorcza dopełnia ilości wg np. karton 1– blokuje sprzedaż w niepełnych jednostkach
SurplusOnBailReturns	1 – wartość domyślna, przy dokonywaniu zwrotu kaucji na korekcie WKK będzie możliwe wskazanie większej ilości towaru kaucjonowanego niż wynika to z korygowanych dokumentów WKA. Możliwe będzie również dodanie pozycji, która nie wynika z dokumentu WKA 0 – przy dokonywaniu zwrotu kaucji na korekcie WKK nie będzie możliwe wskazanie większej ilości towaru kaucjonowanego niż wynika to z korygowanych dokumentów WKA.
CanChangeVatRates	0 – (wartość domyślna) możliwość zmiany stawki VAT wyłączona, 1 – możliwość zmiany stawki VAT włączona
CanBlockActionsForNewContractorBeforeSynchronization	0 – wartość domyślna; dotychczasowe działanie aplikacji w zakresie wystawiania działań handlowych 1 – wystawianie działań handlowych przed synchronizacją nowo utworzonego kontrahenta jest zablokowane we wszystkich dostępnych poziomach w aplikacji
SynchronizationAfterIssuingADocument	0 – synchronizacja podczas zatwierdzania dokumentu wyłączona (wartość domyślna) 1 – możliwość wywołania synchronizacji podczas zatwierdzania dokumentu włączona
SynchronizationBeforeIssuingADocument	0 – synchronizacja przed wystawieniem dokumentu wyłączona (wartość domyślna) 1 – synchronizacja przed wystawieniem dokumentu włączona
SendToKSeF	0 – możliwość wysyłania faktur sprzedaży do KSeF wyłączona (wartość domyślna) 1 – możliwość wysyłania faktur sprzedaży do KSeF włączona

Nagłówek dokumentu

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima
IsReferenceNumberVisible	0 – powoduje zablokowanie obsługi numeru obcego
CanChangePaymentForm	0 – powoduje zablokowanie możliwości edycji formy płatności na nagłówkach dokumentów
CanChangePaymentDate	0 – powoduje zablokowanie możliwości edycji terminu płatności na nagłówkach dokumentów
CanChangeIssueDate	0 – powoduje zablokowanie możliwości edycji daty realizacji na nagłówkach dokumentów
CanChangeCreationDate	0 – powoduje zablokowanie możliwości edycji daty wystawienia na nagłówkach dokumentów
ControlMinMarginWithConstPricePromotion	W zależności od wpisanych parametrów dla promocji typu stała cena powoduje: 1 – kontrolę marży minimalnej, 2 – ostrzeżenie, iż marża minimalna nie została osiągnięta, 3 – brak kontroli marży minimalnej
CanChangeCurrency	1 – zmiana waluty możliwa, zmiana kursu waluty niemożliwa – wartość domyślna, 2 – zmiana waluty możliwa, zmiana kursu waluty możliwa, 0 – zmiana waluty niemożliwa, zmiana kursu waluty niemożliwa, wystawienie dokumentu możliwe tylko w walucie zdefiniowanej na karcie kontrahenta.

Działania

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima
BlockDocumentEditAfterApproval BlockCashRecordEditAfterApproval	0 – zezwala na edycję dokumentów oraz zapisów kasowych po zatwierdzeniu 1 – powoduje zablokowanie możliwości edycji dokumentów oraz zapisów kasowych po zatwierdzeniu
BlockOrderEditAfterApproval	0 – zezwala na edycję dokumentów (możliwość odtwierdzenia dokumentu) ZOS/OS/ZS 1 – powoduje zablokowanie możliwości edycji (odtwierdzania) dokumentów ZOS/OS/ZS
CanConfirmVisitWithUnconfirmedDocument	Opcja odpowiedzialna za konfigurację tego czy można zatwierdzić wizytę, w ramach której został wystawiony dokument zapisany do bufora. W zależności od wartości parametru: 0 – jeżeli w ramach wizyty został wystawiony dokument o statusie „w buforze” wówczas zatwierdzenie wizyty nie będzie możliwe, 1 – jeżeli w ramach wizyty został wystawiony dokument o statusie „w buforze” wówczas zatwierdzenie wizyty będzie możliwe.
CanCopyVisits	0 – powoduje zablokowanie kopiowania WH, 1 – będzie możliwość skopiowania niezrealizowanej WH, 2 – będzie istniała możliwość skopiowania każdej WH
CanCopyVisitsWithoutActivePattern	0 – powoduje zablokowanie kopiowania WH jeżeli wzorzec jest niedostępny
CanCopyWeeklyVisitPlan	0 – brak możliwości kopiowania tygodniowego planu wizyt 1 – możliwość kopiowania tygodniowego planu wizyt
CanCopyDailyVisitPlan	0 – brak możliwości kopiowania dziennego planu wizyt 1 – możliwość kopiowania dziennego planu wizyt
CanDeletePlannedAction	0 – brak możliwości usuwania zaplanowanych działań CRM na urządzeniu mobilnym; 1 – możliwość usuwania zaplanowanych działań CRM na urządzeniu mobilnym; wartość domyślna
CanDeleteObjectRelatedToConfirmedVisit	Opcja odpowiedzialna za konfigurację tego czy można usunąć obiekt powiązany z zatwierdzoną wizytą. W zależności od wartości parametru: 0 – jeżeli wizyta została zatwierdzona, usunięcie powiązanego z nią obiektu (dokumentu, zapisu kasowego) będzie niemożliwe, 1 – jeżeli wizyta została zatwierdzona, usunięcie powiązanego z nią obiektu (dokumentu, zapisu kasowego) będzie możliwe. Również usunięcie dokumentu w buforze z poziomu realizowanej/wstrzymanej wizyty będzie możliwe.
CanEditSynchronizedActions	0 – powoduje zablokowanie możliwości przesunięcia działań zsynchronizowanych (wartość domyślna) 1 – umożliwia przesuwanie działań zsynchronizowanych
CanPauseVisitRealization	0 – brak możliwości wstrzymywania realizacji wizyty 1 – włączona możliwość wstrzymywania realizacji wizyty
CanPlanVisitsWithoutPattern	0 – brak możliwości planowania wizyty bez określonego wzorca 1 – udostępniona możliwość planowania wizyty bez określonego wzorca
CanSendAfterPlanning	0 – parametr „Wyślij po zaplanowaniu” jest odznaczony bez możliwości jego edycji w aplikacji mobilnej 1 – parametr „Wyślij po zaplanowaniu” jest zaznaczony bez możliwości jego edycji w aplikacji mobilnej 10 – parametr „Wyślij po zaplanowaniu” jest odznaczony z możliwością jego edycji w aplikacji mobilnej 11 – parametr „Wyślij po zaplanowaniu” jest zaznaczony z możliwością jego edycji w aplikacji mobilnej
CanSendMerchandisingRealization	0 – brak możliwości zrealizowanego elementu typu Merchandising za pomocą opcji e-mail 1 – powoduje możliwość korzystania z funkcjonalności wysyłania zrealizowanego elementu typu Merchandising podczas realizacji wizyty, za pomocą opcji e-mail
CanSendReportsByEmail	0 – brak możliwości wysłania raportu html, ukrycie opcji „Odbiorca wysyłanych raportów” 1 – powoduje możliwość wysyłania raportu, dodanie w ustawieniach aplikacji opcji „Odbiorca wysyłanych raportów”
Encrypted	0 – baza nie powinna być szyfrowana (zaznaczona domyślnie) 1 – baza powinna być szyfrowana
IsContactKindForMeetingRequired	Parametr techniczny różnicujący systemy ERP. Zmiany nie są zalecane.
IsContactsEnabled	0 – powoduje zablokowanie widoczności kontaktów
IsContractorsAttributeVisibleOnVisit	0 – opcja kopiowania atrybutu kontrahenta na element typu „Inny” wizyty wyłączona 1 – opcja kopiowania atrybutu kontrahenta na element wizyty typu „Inny” włączona, włączenie opcji spowoduje wyświetlanie na elemencie wizyty informacji dodatkowej z kartoteki kontrahenta, u którego realizowana jest wizyta
IsHeadquarterStocksVisible	0 – powoduje wyłączenie możliwości podglądu stanów magazynowych 1 – powoduje włączenie możliwości podglądu stanów magazynowych
IsMeetingsEnabled	0 – powoduje zablokowanie dodawania kontaktów
IsPrivateEventsEnabled	0 – powoduje zablokowanie dodawania wydarzeń prywatnych
IsSettlementsSynchronizationOnVisitEnabled	0 – opcja automatycznej synchronizacji rozliczeń wyłączona, wysyłanie rozliczeń i raportów kasowych dopiero po opuszczeniu okna wizyty i ręcznego uruchomienia synchronizacji 1 – opcja automatycznej synchronizacji rozliczenia z poziomu realizacji elementu wizyty: Należności, włączenie opcji spowoduje, że po zakończeniu zadania, nastąpi automatyczne zamknięcie raportu kasowego i jego synchronizacja do systemu ERP
IsTasksEnabled	0 – powoduje zablokowanie dodawania zadań
IsVisitsEnabled	0 – powoduje zablokowanie dodawania WH
RejectPlannedVisitAfterCopy	0 – powoduje zablokowanie odrzucenia planowanej WH po skopiowaniu 1 – powoduje odrzucenie planowanej WH po skopiowaniu
RequireVisitConfirmation	0 – WH tworzone w aplikacji są potwierdzone, 1 – WH tworzone w aplikacji wymagają potwierdzenia w systemie ERP
CanAddMultipleVisitMerchandisingRealizations	0 – umożliwia wykonanie jednego zdjęcia powoduje w ramach elementu Merchandising, 1 – wartość domyślna, umożliwia realizację kilku zdjęć w ramach elementu Merchandising
MaxNumberOfDescriptionsLinesInActionList	Maksymalna ilość linii opisu działań wyświetlanych na liście działań w Terminarzu: 0 – opis działania nie będzie wyświetlany na liście działań, wartość całkowita większa od 0 – ilość linii opisu działania wyświetlanych na liście działań
SynchronizationAfterEndingAVisit	0 – synchronizacja podczas zakończenia wizyty handlowej wyłączona (wartość domyślna) 1 – synchronizacja podczas zakończenia wizyty handlowej włączona

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima
IsDiscountsVisible	0 – powoduje zablokowanie widoczności wszystkich promocji naliczonych bądź zdefiniowanych w systemie ERP 1 – powoduje widoczność wszystkich promocji naliczonych bądź zdefiniowanych w systemie ERP
CanPreviewDiscountCards	0 – ukrywanie widoczności promocji z poziomu karty towaru/kontrahenta
CanChangeElementToGratis	0 – powoduje zablokowanie obsługi elastycznego generowania promocji pakietowych 1 – powoduje możliwość skorzystania z obsługi elastycznego generowania promocji pakietowych
MaxDiscountControlType	Parametr decydujący o kontroli rabatu maksymalnego: 0 – mniej restrykcyjna 1 – bardziej restrykcyjna kontrola dla użytkownika
StartPriceIncludesDiscounts	0 – cena początkowa nie zostanie pomniejszona o promocję 1 – cena początkowa zostanie automatycznie pomniejszona o promocję
CanUseMaxDisountForItems	0 – oznacza brak obsługi maksymalnego rabatu dla towarów 1 – wartość domyślna, oznacza włączoną obsługę maksymalnego rabatu dla towarów
OnlyKNUWhenCountingStartPrice	0 – wyłączona opcja uwzględniająca tylko promocję KNU 1 – włączona opcja uwzględniania tylko promocji KNU - parametr ten działa na cenę początkową oraz rabat na liście
AddRequiredItemsForPackagePromotionToCart	0 – opcja wyłączona 1 – Po akceptacji promocji pakietowej pojawi się komunikat „Towary wymagane w ramach zaznaczonej promocji zostaną dodane do koszyka” z przyciskiem OK, a następnie zostanie wyświetlone okno dodawania ilości dla wszystkich wymaganych towarów 2 – Po akceptacji promocji pakietowej pojawi się komunikat „Towary wymagane w ramach zaznaczonej promocji zostaną dodane do koszyka”, a następnie zostanie wyświetlone okno z „Kartą dodawania towarów wymaganych”

Nazwa parametru	Opis	Comarch ERP XL	Comarch ERP Altum	Comarch ERP Optima
AccessToConsentsToProcessingPersonalData	0 – zgody nie będą wyświetlane na karcie kontrahenta, ani też w sekcji Adresy/Kontakty jeżeli zgoda powiązana z adresem/kontaktem 1 – zgody będą wyświetlane na karcie kontrahenta, ani też w sekcji Adresy/Kontakty jeżeli zgoda powiązana z adresem/kontaktem 2 – możliwość dodawania nowych zgód 3 – możliwość wycofania zgody, na które wcześniej została wyrażona zgoda oraz możliwość dodawania nowych zgód
AttachmentSize WarningTreshold	Rozmiar załącznika, przy którym ma pojawiać się ostrzeżenie o dużym rozmiarze dodanego załącznika. Domyślny rozmiar: 15MB.
AttachmentsSendAlgorithm	Ustawienie dotyczące tego, czy dodany załącznik ma być przesyłany do centrali w postaci jednego pliku czy podzielony na paczki o określonej wielkości. Możliwe ustawienia parametru: 0 – załącznik zostanie przesłany w postaci jednego plik, 1 – załącznik podczas wysyłania zostanie podzielony na paczki o określonej wielkości.
AttachmentsSendParcelMaxSize	Rozmiar paczki podczas wysyłania załącznika. Domyślny rozmiar: 100KB.
CanDeleteSynchronizedAttachment	Ustawienie dotyczące możliwości usuwania załączników zsynchronizowanych z systemu ERP lub dodanych w aplikacji, ale już wysłanych do systemu ERP. W zależności od wartości parametru: 0 – edycja załącznika zsynchronizowanego z systemu ERP lub dodanego w aplikacji ze statusem zsynchronizowano lub wysłano niemożliwa 1 – edycja załącznika zsynchronizowanego z systemu ERP lub dodanego w aplikacji ze statusem zsynchronizowano lub wysłano możliwa
CanEditSynchronizedAttachment	Ustawienie dotyczące możliwości edycji załączników zsynchronizowanych z systemu ERP lub dodanych w aplikacji, ale już zsynchronizowanych do systemu ERP. W zależności od wartości parametru: 0 – edycja załącznika zsynchronizowanego z systemu ERP lub dodanego w aplikacji ze statusem zsynchronizowano niemożliwa 1 – edycja załącznika zsynchronizowanego z systemu ERP lub dodanego w aplikacji ze statusem zsynchronizowano możliwa
CanSendAttachment	Parametr dotyczący opcji: „Przesyłaj do centrali” przy dodawaniu załącznika, możliwe wartości parametru: 0 – parametr „Przesyłaj do centrali” jest odznaczony bez możliwości jego edycji w aplikacji mobilnej 1 – parametr „Przesyłaj do centrali” jest zaznaczony bez możliwości jego edycji w aplikacji mobilnej 10 – parametr „Przesyłaj do centrali” jest odznaczony z możliwością jego edycji w aplikacji mobilnej 11 – parametr „Przesyłaj do centrali” jest zaznaczony z możliwością jego edycji w aplikacji mobilnej
ImageAttachmentSizeLimit	Ustawienie związane z rozmiarem załącznika o typie Zdjęcie. Możliwe ustawienia parametru: 0 - bez limitu 0_X - ograniczone do X megabajtów, gdzie X jest dodatnią liczbą naturalną mniejszą niż 100000 1 - 1MB (wartość domyślna) 2 - 500KB 3 - 3MB
AudioAttachmentSizeLimit	Ustawienie związane z rozmiarem załącznika o typie Nagranie. Możliwe ustawienia parametru: 0 - bez limitu 0_X - ograniczone do X megabajtów, gdzie X jest dodatnią liczbą naturalną mniejszą niż 100000 1 - 1MB (wartość domyślna) 2 - 3MB 3 - 5MB
FileAttachmentSizeLimit	Ustawienie związane z rozmiarem załącznika o typie Plik. Możliwe ustawienia parametru: 0 - bez limitu 0_X - ograniczone do X megabajtów, gdzie X jest dodatnią liczbą naturalną mniejszą niż 100000 1 - 5MB (wartość domyślna) 2 - 3MB 3 - 10MB
SaveAttachmentsOnAdditionalDatabase	0 – wartość domyślna, zdjęcia zapisywane zgodnie z dotychczasowym mechanizmem w pamięci urządzenia lub w pamięci zewnętrznej w katalogu MoSAttachments 1 – zdjęcia zostaną zamieszczone w osobnej bazie danych MoSAttachments.db
AutomaticVeryficationVatStatusOnDocument	1 – weryfikacja (podczas zapisu/ zatwierdzenia FS/FSL) kontrahenta czy jest aktywnym płatnikiem VAT 0 – brak weryfikacji czy kontrahent jest aktywnym płatnikiem VAT
BlockDocumentEditAfterPrint	0 – domyślna wartość; możliwość usunięcia/edycji dokumentu lub zapisu kasowego pomimo jego wydrukowania 1 – brak możliwości usunięcia/edycji dokumentu lub zapisu kasowego pomimo jego wydrukowania
BlockSelectOptionOnCashRecordFromHand	Blokada wystawiania KP/KW na Kontrahent/Inny/Ode mnie/Do mnie na kafelku Kasa/Dzień 0 – Przy wyborze typu podmiotu na KP/KW, dostępne są opcje: Kontrahent/Inny/Ode mnie (KP)/Dla mnie (KW) 1 – Dostępne opcje: Inny/Ode mnie (KP)/Dla mnie (KW) 2 – Dostępne opcje: Kontrahent/Ode mnie (KP)/Dla mnie (KW) 3 – Dostępne opcje: Ode mnie (KP)/Dla mnie (KW) 4 – Dostępne opcje: Kontrahent/Inny 5 – Dostępne opcje: Inny 6 – Dostępne opcje: Kontrahent 7 – Całkowita blokada wystawiania KP/KW z ręki
CanAddTwoSignaturesOnServiceOrder	0 – wartość domyślna, brak podpisu osoby uprawnionej do wystawienia dokumentu po zakończeniu zlecenia 1 – wymagany podpis osoby uprawnionej do wystawienia dokumentu po zakończeniu zlecenia
CanAddValuesToOpenList	1 – Możliwość dodania nowej wartości do listy cech 2 – Brak możliwości dodania nowej wartości (lista zdefiniowana w systemie)
CanChangeAdditionalCustomerStatus	1 – obsługa statusu kontrahenta Płatnik VAT 2 – obsługa statusu kontrahenta Rolnik ryczałtowy 3 – obsługa statusu kontrahenta Płatnik VAT i Rolnik ryczałtowy
CanChange AttribuesOnSynchronizedDocuments	1 – możliwość zmiany wartości atrybutu na nagłówku zsynchronizowanego/wysłanego dokumentu 0 – blokada zmiany wartości atrybutu na nagłówku zsynchronizowanego/wysłanego dokumentu
CanChangeItemsView	0 – brak możliwości zmiany domyślnego widoku towarów, domyślnie ustawiony widok Katalogowy 1 – brak możliwości zmiany domyślnego widoku towarów, domyślnie ustawiony widok Listy 10 – możliwa zmiana domyślnego widoku towarów, domyślnie ustawiony widok Katalogowy 11 – możliwa zmiana domyślnego widoku towarów, domyślnie ustawiony widok Listy (wartość domyślna parametru)
CanChangeVatStatusOnContractor	1 – możliwość ręcznej zmiany parametru „Płatnik VAT” na karcie kontrahenta 0 – blokada ręcznej zmiany parametru „Płatnik VAT” na karcie kontrahenta
CanConfirmServiceOrders	0 – brak możliwości zatwierdzania zleceń serwisowych 1 – możliwość zatwierdzania zleceń serwisowych
CarGuard	1 – określenia stanu licznika samochodu w Podsumowaniu Dnia wymagane tylko na starcie dnia 2 – określenia stanu licznika samochodu w Podsumowaniu Dnia wymagane tylko na zakończenie dnia 3 – określenia stanu licznika samochodu w Podsumowaniu Dnia wymagane na starcie i na zakończeniu dnia
IsActualBalanceRequired	1 – nie zezwala na zamknięcie/otwarcie dnia bez podania stanu rzeczywistego kasy 0 – zezwala na zamknięcie/otwarcie dnia bez podania stanu rzeczywistego kasy
IsAdditionalCostsEnabled	0 – Obsługa kosztów dodatkowych jest wyłączona, wartość domyślna 1 – Obsługa kosztów dodatkowych jest włączona
IsFeaturesOnComplaintEnabled	0 – brak możliwości określenia cechy na kalkulacji pozycji dokumentu RLS (Altum) 1 – możliwe określenie cechy towaru na kalkulacji pozycji dokumentu RLS (XL)
IsGeneratingSettlementWhenClosingTheCashReportEnabled	1 – automatyczne generowanie KW/KP na różnicę przy zamknięciu raportu kasowego 0 – brak automatycznego generowania KW/KP na różnicę przy zamknięciu raportu kasowego (wartość domyślna)
IsItemsFeaturesEnabled	0 – Brak obsługi cech 1 – Obsługa cech w aplikacji
IsOdometerReadingRequiredField	Ustawienie dotyczące tego, czy podczas rozpoczęcia dnia, zmiany samochodu oraz zakończenia dnia ma zostać wymuszone podanie bieżącego stanu licznika. W zależności od wartości parametru: 0 – podanie bieżącego stanu licznika w sytuacji: rozpoczęcia dnia, zmiany samochodu, zakończenia dnia nie zostanie wymuszone, 1 – podanie bieżącego stanu licznika w sytuacji: rozpoczęcia dnia, zmiany samochodu, zakończenia dnia zostanie wymuszone (przejazd zostanie dodany tylko w momencie zakończenia dnia)
IsServiceActivityTimeAutomaticallyCounted	0 – brak automatycznego zliczania czasu podczas realizacji zlecenia serwisowego, 1 – wartość domyślna; włączenie automatycznego zliczania czasu podczas realizacji zlecenia serwisowego
IsStartDayRequired	0 – domyślna wartość; nie wymagane rozpoczęcie dnia 1 – włączone sprawdzanie i wymagalność rozpoczęcia dnia
IsVisibleOnList	Parametr dotyczy widoczności atrybutów na liście towarów/kontrahentów/dokumentów i ustawiany jest na klasie danego atrybutu (procedura AttributesClasses). W zależności od wartości: 1 – atrybut będzie widoczny na liście towarów, 0 – atrybut nie będzie widoczny na liście towarów
PrintoutCounterOption	1 – do licznika wydruków brane są tylko dokumenty, które zostały wydrukowane przez opcję „Wyślij do drukarki” lub „Drukuj”; wartość domyślna 2 – do licznika wydruków brane są tylko dokumenty, które zostały wydrukowane przez opcję „Wyślij jako e-mail” 3 – do licznika wydruków brana są tylko dokumenty zarówno wydrukowane przez opcję „Wyślij do drukarki” lub „Drukuj” oraz opcję „Wyślij jako e-mail”
ShowColumnsOnReports	0 – wyświetla się okno z wszystkimi parametrami raportu w kolejności: kolumny domyślne, kolumny dodatkowe (kolejność wyświetlania kolumn dodatkowych zależy od kolejności atrybutów na karcie raportu w Comarch ERP XL) 1 – wyświetla się okno z wymaganymi parametrami domyślnymi oraz wszystkimi parametrami dodatkowymi 2 – wyświetla się okno tylko z wymaganymi parametrami (domyślnymi i dodatkowymi)
UseShortenedElement	1 – Wyświetla się mała kalkulacja, brak możliwości zmiany ustawień w aplikacji 0 – Wyświetla się od razu duża kalkulacja, brak możliwości zmiany ustawień w aplikacji 11 – Wyświetla się mała kalkulacja, użytkownik ma możliwość zmiany ustawień w aplikacji 10 – Wyświetla się od razu duża kalkulacja, użytkownik ma możliwość zmiany ustawień w aplikacji
PricesOnItemsInvisible	0 – standardowe działanie aplikacji, 1 – ukrycie cen na karcie towaru oraz na liście oferowanych towarów
ForceHidingPrices	0 – standardowe działanie aplikacji, 1 – ukrycie wartości na liście dokumentów dla dokumentów potwierdzonych dotyczących danego typu dokumentu oraz ukrycie wartości dla dokumentów potwierdzonych z poziomu wizyty elementu Rejestracja dokumentu dla danego typu dokumentu
ShouldClosedServiceOrderBeModifiedInHeadquarters	0 – dokumenty ZSR synchronizowane jako zamknięte, nie podlegają dalszej realizacji w Centrali 1 – dokumenty ZSR synchronizowane jako zatwierdzone, możliwa jest edycja zleceń i czynności na tych zleceniach w Centrali, w aplikacji zlecenie jest zamknięte i nie podlega jakimkolwiek działaniom (konieczne jest zaznaczenie paramertu Operacje na zatwierdzonych: ZSR)
ShouldServiceAcitivityBeModifiedIn Headquarters	0 – brak możliwości modyfikacji czynności i elementów związanych z czynnościami w Centrali 1 – możliwości modyfikacji czynności i elementów związanych z czynnościami w Centrali na zleceniach w stanie "Do realizacji" oraz "Zatwierdzone" (w zależności od ustawienia parametru ShouldClosedServiceOrderBeModifiedInHeadquarters)
SyncServiceOrdersTypeParam	0 – Standardowa synchronizacja wszystkich zleceń 1 – Synchronizacja zleceń, na których został dodany serwisant (zlecenia bez serwisanta nie zostaną pobrane) 2 – Synchronizacja zleceń, na których został dodany zalogowany w aplikacji serwisant 3 – Synchronizacja zleceń, na których został dodany serwisant posiadający oddział mobilny (zalogowany w aplikacji lub inny mobilny) lub nie został dodany żaden serwisant
IsOrderFromReportEnabled	0 – generowanie zamówień na podstawie raportu obecności wyłączone 1 – wartość domyślna; generowanie zamówień na podstawie raportu obecności włączone
CanEditServiceActivityTime	0 – brak możliwości zmiany czasu realizacji czynności 1 – możliwości zmiany czasu realizacji czynności
StockLevelsLessReservation	0 – stany magazynowe w aplikacji nie będą pomniejszone o rezerwacje (wartość domyślna) 1 – stany magazynowe w aplikacji będą pomniejszone o rezerwacje
SynchronizationNotifications (X,Y)	0 – powiadomienia o synchronizacji wyłączone (wartość domyślna) X – liczba całkowita podawana w minutach określająca interwał czasu, po jakim pojawi się powiadomienie o synchronizacji Y – liczba całkowita podawana w minutach określająca interwał czasu po jakim wyświetli się przypomnienie o odłożonej synchronizacji (w sytuacji, gdy użytkownik wybierze przycisk [Odłóż] w dowolnym miejscu aplikacji)
SynchronizationAfterIssuingAServiceOrder	0 – synchronizacja podczas wyjścia ze zlecenia serwisowego wyłączona (wartość domyślna) 1 – synchronizacja podczas wyjścia ze zlecenia serwisowego włączona. Podczas wyjścia ze zlecenia serwisowego dostępna będzie opcja [Przekaż do realizacji i synchronizuj] 2 – synchronizacja podczas wyjścia ze zlecenia serwisowego włączona. Podczas wyjścia ze zlecenia serwisowego dostępna będzie opcja [Zatwierdź i synchronizuj] 4 – synchronizacja podczas wyjścia ze zlecenia serwisowego włączona. Podczas wyjścia ze zlecenia serwisowego dostępna będzie opcja [Zakończ i synchronizuj] Możliwe jest także sumowanie wartości parametru, np. jeżeli wartość parametru zostanie ustawiona na 5 wówczas podczas wyjścia ze zlecenia serwisowego dostępne będą opcje [Przekaż do realizacji i synchronizuj] oraz [Zakończ i synchronizuj]
SynchronizationAfterLoggingIntoApplication	0 – synchronizacja w momencie logowania wyłączona (wartość domyślna) 1 – synchronizacja w momencie logowania włączona. Pełna synchronizacja rozpocznie się automatycznie po zalogowaniu użytkownika do aplikacji.

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 synchronizacjiViewsConfiguration. 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”>

danych na nagłówku dokumentu ZSR:

<activity name=”com.comarch.mobile.vendor.service.adapters.ServiceOrderHeaderAdapter”>

Przykład

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.

Przykład

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

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" />

Uwaga

Od wersji 2017.1 Comarch Mobile został zmieniony domyślny układ kafli menu głównego aplikacji – zgodnie z przykładem zaprezentowanym powyżej.

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).

Przykład

Za pomocą przycisku umożliwiono przełączanie się pomiędzy domyślną stawką VAT dla towaru, a alternatywną stawką VAT ustawioną na kontrahencie.

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

Ukrywanie cen oraz wartości towarów w kafelku Towary i na konkretnych dokumentach

W aplikacji została wprowadzona możliwość ukrywania cen i rabatów w kafelku Towary, za który odpowiada parametr [PricesOnItemsInvisible] (jest on opisany TUTAJ). Jeżeli opcja ta zostanie włączona, wówczas w aplikacji zostaną ukryte następujące informacje:

Na karcie towaru ukryta informacja na temat cen towaru, jak na poniższym rysunku:

Ukryta informacja o cennikach na karcie towaru

Na liście oferowanych towarów ukryta informacja o cenach poszczególnych towarów, jak na poniższym rysunku:
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 i w nawiasie umieścić mob.Dok_GIDTyp dokumentu, na którym mają zostać ukryte ceny.

Przykład

CASE

WHEN mob.Dok_GIDTyp IN (9344,8832,9472) THEN (SELECT CONVERT(NVARCHAR(100),RTRIM(CASE WHEN Ope_WidziCenyZakupu = 1 THEN 0 ELSE 1 END))

FROM CDN.FrmStruktura

JOIN CDN.FrmLinki ON FrL_GrOTyp=FrS_GIDTyp AND FrL_GrONumer=FrS_Id AND FrL_GIDTyp=128

JOIN CDN.OpeKarty ON FrL_GIDNumer = Ope_GIDNUmer

WHERE FRS_ID = @UserCenterId)

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

Dopóki dokument nie zostanie zatwierdzony informacja o jego wartości nie będzie widoczna. Do momentu zatwierdzenia ukryta zostanie także informacja o cenach i wartościach w widoku towarów dodanych do koszyka, jak na poniższym rysunku:

Ukryta informacja o wartościach i cenach na niezatwierdzonym dokumencie

Informacja wyświetlana na kaflu Raporty, dotycząca wartości wystawionych w aplikacji dokumentów, także nie będzie uwzględniała niezatwierdzonych dokumentów. Po wywołaniu filtra: Dokumenty kontrahenta lub Wszystkie dokumenty, na wyświetlonej liście dokumentów historycznych informacja na temat wartości tych dokumentów zostanie ukryta. W aplikacji Comarch Mobile 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.xl.statement (Comarch Mobile\Serwer synchronizacji\Methods\documentsnumerators)

Dodawanie niestandardowego filtra do listy

Dodawanie filtra

W celu dodania niestandardowego filtra do listy towarów, kontrahentów lub na liście czynności i zleceń serwisowych, 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), itemsList (filtr pojawi się na liście towarów), serviceOrdersDocumentsList(filtr pojawi się na liście zleceń serwisowych) lub serviceOrdersActionsList (filtr pojawi się na liście czynności serwisowych) 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, boolean)

Sekcje te (oprócz inputType) są częścią zapytania wykonywanego przez aplikację mobilną w celu wyświetlenia elementów listy towarów, listy kontrahentów, listy zleceń serwisowych bądź listy czynności serwisowych (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:

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.

Przykład

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.

Konfiguracja raportów prowizji

Do odpowiedniego wyliczenia raportu prowizji konieczne jest założenie następującego atrybutu na karcie towaru, gdzie:

Klasa Atrybutów: „Prowizja”
Typ: Liczba

Po zdefiniowaniu na kartach produktu w systemie Comarch ERP XL odpowiedniego atrybutu, w aplikacji można porównywać sprzedaż pod względem wartości prowizji.

Ustawienie atrybutu na karcie towaru (Prowizja) w systemie Comarch ERP XL

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
orderOnList
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

Przykład

<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 2.
Parametry	0 - wszystkie typy 1 - raport sprzedażowy 2 - raport zakupowy 3 - raport serwisowy

Przykład

Kolejność raportów

Sekcja oznaczająca priorytet raportu: orderOnList. Musi zawierać następującą sekcję:

Nazwa	value
Opis	Priorytet wyświetlania raportu na liście raportów w kaflu Stan.
Parametry	brak sekcji - raport wyświetlany pod elementami zawierającymi tą sekcję wartość liczbowa

Przykład

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

Przykład

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:

Przykład

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[]]>

Przykład

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)

Przykład

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

Przykład

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

Przykład

<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:

Przykład

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):

Przykład

<?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:

Przykład

<?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

Przykład

<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

Przykład

<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

Przykład

Nazwa	P
Opis	Paragraf
Parametry	Brak
Elementy stylujące	P

Przykład

<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

Przykład

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

Przykład

<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

Przykład

Nazwa	Spacer
Opis	Separator
Parametry	Brak
Elementy stylujące	Brak

Przykład

... </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

Przykład

<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

Przykład

Elementy - wydruk termiczny

Nazwa	Document
Opis	Otwarcie/zamknięcie dokumentu
Parametry	Brak

Nazwa	Command
Opis
Parametry	comment format code

Przykład

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

Przykład

<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

Przykład

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

Przykład

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.

Przykład

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.

Przykład

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.

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Przykład

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

Automatyczna zapłata

Parametr określa, czy będzie dokonywana automatyczna zapłata oraz dla jakich typów dokumentów handlowych ma być ona dokonywana. Aby ustawienie to było dostępne na urządzeniu, należy z poziomu aplikacji, w [Ustawieniach] odszukać parametr [Automatyczna zapłata] i zmienić domyślną opcję [Nie]. Po kliknięciu tego parametru pojawi się okno z możliwością wyboru, dla jakiego dokumentu automatyczna zapłata ma zostać ustawiona.

Po zaznaczeniu parametru dla danego typu dokumentu oraz po zatwierdzeniu dokumentu automatycznie podniesie się okno z wygenerowanym dokumentem KP.

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

W aplikacji Comarch Mobile 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, 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 (Domyślna lokalizacja pliku to C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration), 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

Przykład

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.

Przykład

-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 XL

Rozliczanie punktów należy obsłużyć po stronie systemu Comarch ERP XL 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 XL. Program lojalnościowy może zostać oparty poprzez atrybuty zdefiniowane w systemie Comarch ERP XL. 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.

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.

Wyświetlanie limitu kredytowego do wykorzystania przez kontrahenta

Istnieje możliwość ukrywania 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. W plikach konfiguracyjnych znajdujących się w katalogu (domyślnie): C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [IsContractorsCreditLimitsValueVisible], odpowiedzialny za ukrywanie/odkrywanie powyższych informacji. Domyślna wartość tego parametru to „1”. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Przypisanie grupy towarów oraz magazynów do kontrahenta

W systemie Comarch ERP XL istnieje możliwość przypisania grupy towarów oraz magazynów, z których pobierane będą towary dla danego kontrahenta. Dostępne towary oraz magazyny dla danego kontrahenta należy wskazać na Karcie kontrahenta, zakładka [Aplikacje].

Wskazówka

Można:

wybrać grupę towarów, która będzie dostępna w aplikacji dla danego Kontrahenta,
wybrać magazyny, które będą dostępne dla danego Kontrahenta,
określić magazyn domyślny.

Przypisanie grupy towarów oraz magazynów do kontrahenta

W przypadku wyboru Magazynów istnieje możliwość określenia, który magazyn będzie domyślny i dostępny w aplikacji Comarch Mobile.

Przypisanie magazynów do kontrahenta, określenie magazynu domyślnego i dostępnego w aplikacji

Wyświetlanie waluty na karcie kontrahenta

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

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

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 XL w konfiguracji oddziału mobilnego w zakładce kontrahenci [Edycja kontrahenta].

Określenie rodzajów kontrahentów na wzorcu wizyty

Istnieje możliwość planowania wizyt z uwzględnieniem rodzaju kontrahenta. Funkcjonalność ta jest zależna od określenia rodzajów kontrahentów na wzorcu wizyty w systemie Comarch ERP XL:

Określenie rodzajów kontrahenta na wzorcu wizyty

Zaznaczenie powyższego parametru spowoduje, że operator będzie mógł zaplanować wizytę z danym wzorcem tylko dla znajdujących się na liście rodzajów kontrahentów. Jeśli opcja ta zostanie odznaczona, będzie istniała możliwość dodania lub usunięcia danego rodzaju kontrahentów z listy.

Kolorowanie kontrahentów

Istnieje możliwość kolorowania kontrahentów. Aby dany rodzaj kontrahentów został pokolorowany w aplikacji należy w systemie Comarch ERP XL, w module: Administrator wybrać z menu pozycję: Listy\Słowniki kategorii\CRM\Rodzaje kontrahentów i przypisać odpowiedni kolor do danego rodzaju kontrahenta.

Przypisywanie koloru do rodzaju kontrahenta w systemie Comarch ERP XL

Po wykonaniu synchronizacji kontrahenci dostępni w aplikacji zostaną oznaczeni na liście odpowiednim kolorem. Przed nazwą i akronimem każdego pokolorowanego kontrahenta będzie wpisany rodzaj kontrahenta.

Konfiguracja limitu kredytowego kontrahenta

W aplikacji obsłużona została kontrola limitu kredytowego. Do wyliczenia salda porównywanego z limitem uwzględniane są zobowiązania wobec kontrahenta oraz nierozliczone wpłaty. W przypadku, gdy saldo należności od kontrahenta przekroczy ustalony limit, wówczas przy próbie zarejestrowania transakcji sprzedaży (potwierdzenia dokumentu sprzedaży) aplikacja zareaguje stosownie do uprawnień użytkownika, a ściślej do ustawień w definicji dokumentu: uniemożliwi zarejestrowanie transakcji lub wyświetli ostrzeżenie (w systemie Comarch ERP XL, okno: [Definicja dokumentu], zakładka: [Ogólne]). Uwzględniane są przy tym ustawienia w definicji dokumentu dla centrum struktury praw, do którego należy zalogowany do aplikacji operator. Szczegółowe informacje dotyczące ustawień na definicji dokumentu znajdują się TUTAJ. W systemie Comarch ERP XL istnieje możliwość ustalenia limitu kredytowego:

Nieograniczonego (w tym przypadku informacja na temat listy limitów kredytowych nie jest pobierana do aplikacji Comarch Mobile)
Ograniczonego kwotowo z konkretną datą zakończenia
Ograniczonego kwotowo, bezterminowego (bez określonej daty zakończenia)

(Należy pamiętać aby strefa czasowa na urządzeniu mobilnym była zgodna ze strefa czasową na serwerze.) Dla danego kontrahenta można zdefiniować obecnie kilka limitów kredytowych. Każdy limit jest rejestrowany dla określonego okresu, w którym ma obowiązywać, a poszczególne okresy dodanych limitów nie mogą się pokrywać.

Karta kontrahenta w systemie Comarch ERP XL, zakładka: [Limity kredytowe]

Do aplikacji Comarch Mobile pobierane są informacje na temat obecnych i przyszłych limitów kredytowych wraz z dozwoloną kwotą przeterminowania. W przypadku, gdy limit kredytowy w systemie Comarch ERP XL został wyrażony w walucie obcej, wówczas przy pobieraniu go do aplikacji Comarch Mobile zostanie on przeliczony na walutę systemową wg wybranego kryterium:

Daty Od – kursu z dnia rozpoczynającego okres limitu kredytowego;
Daty bieżącej – bieżący kurs;
Dnia poprzedniego – kurs z dnia poprzedniego;
Ustalony – zdefiniowany na limicie.

Ze względu na możliwą do zdefiniowania strukturę wielooddziałową kontrahentów w systemie Comarch ERP XL, wprowadzona została kontrola centralnego limitu kredytowego, który ustalany jest na centrali i dotyczy wszystkich kontrahentów, którzy są jej oddziałami. Jeśli dla centrali ustawiony zostanie limit kredytowy, to dany oddział nie będzie mógł go przekroczyć. W przypadku struktury oddziałowej kontrola limitu kredytowego przebiega dwuetapowo:

sprawdzany jest limit kredytowy danego kontrahenta i jeśli dany kontrahent jest oddziałem następuje przejście do drugiego etapu
jeśli limit kredytowy oddziału nie został przekroczony lub został przekroczony, ale w definicji dokumentu zaznaczona jest opcja dotycząca zatwierdzania: Zezwalaj lub Ostrzegaj, następuje sprawdzenie limitu kredytowego centrali.

Jeśli dany kontrahent jest centralą, zawsze sprawdzany jest tylko jego limit. Dodatkowo, jeśli kontrolowany jest limit centrali, sprawdzane jest wykorzystanie limitu centrali oraz wszystkich kontrahentów, którzy są jej oddziałami. Aktualny limit kredytowy dla danego kontrahenta prezentowany jest na karcie kontrahenta, w sekcji [Handlowe]. Możliwe jest również prezentowanie limitu kredytowego w walucie obcej, jeśli zdefiniowano to wcześniej w systemie Comarch ERP XL. W przypadku, gdy kontrahent:

nie posiada limitu kredytowego, wówczas w aplikacji prezentowany jest: Brak bieżącego limitu kredytowego
posiada nieograniczony limit kredytowy, wówczas w aplikacji prezentowany jest: Nieograniczony.

Okno prezentowane jest po wybraniu przycisku grupie Handlowe w wierszu Limit kredytowy.

Karty kontrahentów wraz limitem kredytowym wyświetlanym w walucie krajowej i walucie obcej

Poniżej zostało zaprezentowane okno, w którym wyświetlane są informacje na temat limitów kredytowych danego kontrahenta.

Limity kredytowe zdefiniowane dla danego kontrahenta

Okno jest podzielone na trzy sekcje: Sekcja: Bieżący limit kredytowy:

Okres obowiązywania – zakres dat, w którym obowiązuje dany limit kredytowy

Definicja dokumentu FS w systemie Comarch ERP XL

Limit z kontrahenta – informacja na temat tego, czy limit kredytowy jest pobierany z karty kontrahenta, czy karty płatnika. Ustawienia, odnośnie pobierania limitu kredytowego z kontrahenta znajdują się w systemie Comarch ERP XL na Karcie kontrahenta\zakładka: [Handlowe]\ Forma i termin płatności oraz limit kredytowy z kart.

Karta kontrahenta w systemie Comarch ERP XL w zakładce Limity kredytowe pokazuje wykorzystanie limitu kredytowego.Zawiera następujące informacje:

Limitu kredytowego – kwota udzielonego limitu kredytowego
Wykorzystana – odzwierciedla wykorzystaną kwotę kredytu.
Pozostaje do wykorzystania – odzwierciedla kwotę kredytu możliwą do wykorzystania. Jeżeli kwota będzie ujemna, to zostanie wyświetlona w aplikacji w kolorze czerwonym
Dozwolona po terminie – odzwierciedla kwotę dozwoloną po terminie obowiązywania limitu
Przeterminowana – odzwierciedla kwotę przeterminowanych płatności. Jeżeli kwota przeterminowana będzie większa od kwoty dozwolonej po terminie, kwota ta zostanie wyświetlona w aplikacji w kolorze czerwonym

Limit kredytowy w systemie Comarch ERP XL

Sekcja: Następny limit kredytowy Prezentowana jest w przypadku, gdy kontrahent posiada zdefiniowane kolejne limity kredytowe. Po naciśnięciu na przycisk zostanie wyświetlone okno w którym zaprezentowane są wszystkie limity kredytowe określone dla danego kontrahenta. Składa się z prezentowanych chronologicznie kolejnych limitów kredytowych zaplanowanych dla danego kontrahenta. W sekcji widoczne są następujące informacje:

Lista limitów kredytowych w aplikacji Comarch Mobile

W aplikacji Comarch Mobile istnieje możliwość ukrywania 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. Więcej informacji na ten temat znajduje się TUTAJ.

Konfiguracja koncesji

W aplikacji Comarch Mobile istnieje możliwość sprzedawania artykułów objętych koncesją oraz posiadają informację o dacie ważności danej koncesji. W celu korzystania z funkcjonalności w systemie Comarch ERP XL konieczne jest, aby na karcie towaru określony był rodzaj koncesji niezbędny do jego sprzedaży jak na rysunku.

Wybór koncesji niezbędnej do sprzedaży towaru

Dodatkowo w systemie XL konieczne jest zdefiniowanie daty ważności danej koncesji na karcie kontrahenta jak na rysunku poniżej.

Definicja koncesji na karcie kontrahenta

Dzięki wprowadzeniu funkcjonalności kontroli koncesji przedstawiciel handlowy otrzyma informację, gdy będzie chciał sprzedać towar objęty koncesją dla kontrahenta, u którego koncesja jest przeterminowana.

Komunikat pojawiający się, gdy brak aktualnej koncesji dla kontrahenta

Prawo do edycji kontrahenta

W systemie Comarch ERP XL istnieje możliwość przypisania operatorowi prawa do edycji kontrahenta na urządzeniu mobilnym.

Przypisanie operatorowi prawa do edycji kontrahentów

Nowo dodani kontrahenci mogą być modyfikowani do momentu wysłania ich kart do systemu Comarch ERP XL. Aby edytować kartę kontrahenta pobranego z systemu Comarch ERP XL konieczne jest odpowiednie skonfigurowanie stanowiska mobilnego - więcej informacji znajduje się TUTAJ.

Wystawianie zamówień sprzedaży pomimo wstrzymanych transakcji dla kontrahenta

W aplikacji Comarch Mobile istnieje możliwość wystawiania dokumentu ZS (Zamówienie Sprzedaży) dla kontrahenta, który jednocześnie ma zablokowane wystawianie pozostałych dokumentów (FS, PA, WZ i WM).

Konfiguracja systemu Comarch ERP XL, aby możliwe było wystawienie dokumentów ZS, podczas gdy transakcje są zablokowane

Kartoteka kontrahenta – zablokowane transakcje, możliwość wystawienia dokumentu ZS, OS, RLS

Gdy w systemie Comarch ERP XL zaznaczony zostanie znacznik zarówno „Wstrzymano transakcje” jak i „Wstrzymano zamówienia” wówczas Przedstawiciel handlowy nie będzie miał możliwości wystawiania żadnych dokumentów na danego kontrahenta (nie dotyczy Oferty Sprzedaży oraz Reklamacji).

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

Określenie wymaganych pól podczas rejestracji lub edycji kontrahenta

W systemie Comarch ERP XL istnieje możliwość określenia pól, które będą wymagane podczas edycji lub dodawania nowego kontrahenta w aplikacji. Pola wymagane definiowane są w module Administrator Comarch ERP XL: Słowniki kategorii/CRM/ Rodzaje kontrahentów. Po wybraniu danego rodzaju kontrahenta należy określić, które informacje będą wymagane podczas rejestrowania lub edycji karty kontrahenta.

Określenie pól wymaganych podczas rejestracji kontrahenta dla danego rodzaju kontrahenta w systemie Comarch ERP XL

Uwaga

Istnieje możliwość określenia wymagalności pozostałych pól w pliku ...\Serwer synchronizacji\Methods\contractorstypes\contractorstypes.xl2017.statement. Dostępne opcje:

1 - Pole jest wymagane,
2 - Pole będzie dostępne do edycji,
4 - Zmiana pola wpłynie na zmianę adresu.

Możliwe jest sumowanie powyższych wartości.

Uwaga

Na chwilę obecną, w aplikacji Comarch Mobile nie jest obsłużony parametr Przy zapisie [Ostrzegaj/Zablokuj]. W przypadku niewypełnienia wymaganych pól zapis karty kontrahenta zostanie uniemożliwiony.

W momencie, gdy podczas rejestracji lub edycji karty kontrahenta w aplikacji, wymagane dane nie zostaną uzupełnione, nie będzie możliwe zapisanie tworzonej karty i wyświetlony zostanie odpowiedni komunikat informujący.

Uwaga

Istnieje możliwość sparametryzowania funkcjonalności dodawania i edycji kontrahentów przez operatorów. W zalezności od konfiguracji oddziału mobilnego w systemie Comarch ERP XL operator będzie mógł dodawać/edytować kontrahentów tylko o określonym rodzaju. Więcej informacji na ten temat znajduje się TUTAJ.

Obsługa atrybutów

Istnieje możliwość pobierania i wypełniania atrybutów. Atrybuty w aplikacji Comarch Mobile prezentowane są w sekcji: [Informacje dodatkowe]. Atrybuty można wyświetlać jako klasy lub klasy w grupach. Obsługa atrybutów przy współpracy z systemem Comarch ERP XL

Typy obiektów	Funkcjonalność
Kontrahenci	Podgląd i edycja
Towary	Podgląd
Samochody	Podgląd
Nagłówki dokumentów	Podgląd i edycja
Pozycje dokumentów	Podgląd i edycja

Aby klasa atrybutu była widoczna w aplikacji mobilnej należy w definicji atrybutu wskazać obiekty na zakładce [Obiekty] oraz zaznaczyć parametr [Podgląd] w grupie [Comarch Mobile] na zakładce [Ogólne]. Zaznaczenie parametru [Edycja] umożliwi dodatkowo edycję atrybutów na niektórych typach obiektów.

Przykładowa definicja klasy atrybutu w systemie Comarch ERP XL

W aplikacji mobilnej obsługiwane są również flagi [Wymagany] oraz [Automat]. Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie ERP, to w aplikacji Comarch Mobile jest oznaczony znakiem

. W aplikacji obsługiwane są następujące typy atrybutów:

Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta w domyślnej przeglądarce na urządzeniu mobilnym

W aplikacji obsłużone zostały następujące formaty atrybutów:

Tekst
Data
1234
1234.56
1234.5678
Zaawansowany

Aby była możliwość wyświetlania atrybutów w grupach należy w systemie Comarch ERP XL na liście Atrybutów z poziomu zakładki [Grupy klas atrybutów] stworzyć odpowiednie grupy atrybutów:

oraz przypisać do stworzonej grupy obiekt, z którego poziomu ma być dostępna grupa atrybutów.

Następnie należy przypisać odpowiednie klasy atrybutów. Jedna klasa może być przypięta do kilku grup jednocześnie.

Atrybut okresowy

Istnieje możliwość skonfigurowania atrybutu o parametrze [Okresowy]. Zaznaczając ten parametr możliwe będzie określenie wartości atrybutu oraz okresu jego obowiązywania.

Okno dodawania wartości atrybutu oraz edycja okresu obowiązywania

Możliwe jest utworzenie wielu wartości dla atrybutu w różnych okresach obowiązywania. Okresy obowiązywania nie mogą się pokrywać, w innym przypadku system nie pozwoli na zapisanie takich wartości.

Obsługa prolongat

Prolongata jest wystawiana w systemie Comarch ERP XL i umożliwia zmianę terminu płatności dla należności, w tym pochodzących z zaksięgowanych faktur sprzedaży. Występuje w dwóch wariantach:

Prolongata płatnościowa – zmienia termin płatności źródłowego dokumentu.
Prolongata informacyjna – nie zmienia terminu płatności na dokumencie źródłowym, a płatność nie jest wymagalna.

Lista prolongat w ERP XL

Aby otworzyć okno Listy prolongat należy w module Sprzedaż w zakładce Księgowość wybrać pozycję: Prolongaty.

Na zakładce Ogólne znajdują się prolongaty wszystkich kontrahentów. Opcja

[Dodaj] – umożliwia wygenerowanie prolongaty. Po naciśnięciu przycisku pojawi się lista kontrahentów, na której należy wybrać jednego kontrahenta, dla którego ma zostać wystawiona prolongata. Po wybraniu kontrahenta i naciśnięciu przycisku akceptacji

zostanie podniesiona Historia wybranego kontrahenta – zakładka Rozliczenia / Płatności.

Widok listy płatności kontrahenta w systemie ERP XL

Po wybraniu płatności do prolongowania oraz naciśnięciu przycisku akceptacji

zostanie podniesione okno: Generowanie prolongat. Możliwe jest zaznaczenie wielu płatności i wygenerowanie do nich jednego dokumentu prolongaty.

Uwaga

Więcej informacji o prolongatach i ich generowaniu w systemie Comarch ERP XL znajduje się TUTAJ.

Uwaga

Prolongaty, które mają harmonogram spłat w ratach nie są synchronizowane do Comarch Mobile.

Prolongaty w Comarch Mobile

W Comarch Mobile umożliwiono wyświetlanie i rozliczanie płatności dokumentów FS/FSE/PA, które w systemie Comarch ERP XL zostały prolongowane. Dokumenty objęte prolongatą w aplikacji są prezentowane w sekcji Płatności na karcie kontrahenta. Więcej informacji o płatnościach TUTAJ. Gdy do płatności dokumentów FS/FSE/PA w systemie ERP XL zostanie utworzona prolongata, po synchronizacji w sekcji Płatności zamiast takiego dokumentu będzie widoczna powiązana prolongata.

Rozliczając prolongatę użytkownik ma możliwość zadecydowania, czy zostanie rozliczona część dokumentów, które zawarte są w prolongacie czy wszystkie oraz, czy razem z dokumentami zostaną rozliczone koszty związane z prolongatą.

Rozliczenie prolongaty - szczegóły płatności

Uwaga

W odróżnieniu do innych dokumentów, w przypadku rozliczania prolongaty nie ma możliwości edycji wpłaty.

Uwaga

Jeśli w mobilnej bazie danych nie ma dokumentów powiązanych z płatnościami zawierającymi się w prolongacie, wówczas w sekcji Dotyczy dokumentów będzie widoczna informacja, że prolongata dotyczy dokumentu historycznego.

W widoku zapisu kasowego KP zostały wyszczególnione elementy prolongaty, czyli:

Kwota odsetek
Płatności prolongowane
Koszt prolongaty

O przeterminowaniu prolongaty, analogicznie jak w przypadku innych dokumentów, informuje zmiana koloru kwoty do zapłaty oraz terminu płatności na kolor czerwony.

Promocja "Budżet rabatowy operatora"

Istnieje typ rabatu Budżet rabatowy operatora, charakteryzujący się brakiem automatycznego naliczania w aplikacji, zdefiniowanym maksymalnym rabatem na towarach i grupach towarowych oraz wyliczaniem wartości budżetu, jaką przypisany do promocji operator będzie mógł wykorzystać.

Uwaga

Rabat ten obowiązuje na dokumentach sprzedaży tj.:

ZS – Zamówienie Sprzedaży
FS – Faktura Sprzedaży
PA – Paragon
WZ – Wydanie Zewnętrzne.

Aby skorzystać z tej funkcjonalności należy odpowiednio skonfigurować system Comarch ERP XL. W module Administrator należy zaznaczyć parametr [Rejestruj strukturę udzielonego rabatu] w konfiguracji modułu Sprzedaż.

Włączony parametr: Rejestruj strukturę udzielonego rabatu

W systemie Comarch ERP XL należy zdefiniować promocję, zaznaczając Budżet rabatowy [Operatora], po czym ustalić wartość netto tego budżetu na karcie operatora.

Ustalanie wartości budżetu dla operatora

Następnie należy ustawić maksymalny rabat dla towarów na definicji generowanej promocji w Comarch ERP XL.

Ustalenie maksymalnego rabatu o typie: Procent dla towaru na definicji promocji

Ustalenie maksymalnego rabatu o typie: Wartość dla towaru na definicji promocji

Uwaga

Możliwość korzystania z opcji budżetu rabatowego operatora jest dostępna tylko dla operatorów, którzy na oddziale mobilnym w systemie Comarch ERP XL, na definicji dokumentu, mają zaznaczony parametr Edycja cen i rabatów na pozycjach.

Uwaga

Po zmianie warunków handlowych, w zależności od ustawień aktualizacji danych na definicji dokumentu w systemie Comarch ERP XL, przeliczane są na nowo wartości nadanego budżetu na pozycjach.

Definicja dokumentu, zaznaczony parametr: Edycja cen i rabatów na pozycjach

Uwaga

Wykorzystanie promocji typu Budżet rabatowy operatora wraz z kontrolą maksymalnego rabatu wynikającego z tej promocji spowoduje, że na pozycji nie będzie można nadać dodatkowego rabatu operatora (niepowiązanego z żadną promocją).

Zmiana wartości rabatu po zmianie ilości na pozycji

Spis treści

Zmiana ilości na pozycji przy zaznaczonej wartości parametru: Utrzymuj wartość rabatu Zmiana ilości na pozycji przy zaznaczonej wartości parametru: Utrzymuj procent rabatu

W konfiguracji systemu Comarch ERP XL istnieje parametr dotyczący zachowania rabatu podczas zmiany ilości na pozycji jak na rysunku poniżej:

Parametr w konfiguracji: Przy zmianie ilości elementu utrzymuj: Wartość rabatu budżetowego / Procent rabatu budżetowego

Zmiana ilości na pozycji przy zaznaczonej wartości parametru: Utrzymuj wartość rabatu

Opcja ta sprawia, że aplikacja kontroluje, czy kwota nadanego rabatu nie przekracza obecnie maksymalnego rabatu z budżetu rabatowego operatora. Jeśli kwota ta jest przekroczona, wówczas zostanie naliczona maksymalna możliwa do naliczenia wartość. Kwota nadanego/ wykorzystanego rabatu z budżetu zostanie zachowana- oznacza to, że cena oraz wartość elementu po zmianie ilości ulegnie zmianie.

Zmiana ilości na pozycji przy zaznaczonej wartości parametru: Utrzymuj procent rabatu

Opcja ta sprawia, że aplikacja kontroluje, czy kwota nadanego rabatu nie przekracza obecnie maksymalnego rabatu z budżetu rabatowego operatora. Jeśli kwota ta jest przekroczona, wówczas zostanie naliczona maksymalna możliwa do naliczenia wartość. Procent nadanego rabatu zostanie zachowany - oznacza to, że cena oraz wartość elementu po zmianie ilości nie ulegnie zmianie.

Przykład

Dla operatora PH1 został zdefiniowany budżet rabatowy o wartości 500,00zł oraz przypisano do niego towary: Tow_1 z rabatem maksymalnym = 30%, ceną początkową (N): 100,00 zł; Tow_2 z rabatem maksymalnym = 80%. W aplikacji Comarch Mobile Sprzedaż dodano Zamówienie Sprzedaży ZS_1 z pozycją 10 szt. oraz naliczono rabat budżetowy: 100,00zł czyli 10%. W tym przypadku wartość pozycji po rabacie wynosi: (10szt x 100,00) – 100,00= 900,00zł Zostaje zmieniona przez operator ilość na pozycji na 4 szt.:

Jeżeli parametr w konfiguracji ustawiony jest na „Wartość”, wówczas:
- Wartość netto wykorzystanej kwoty budżetu na pozycji pozostaje na poziomie 100,00zł.
- Wartość pozycji będzie wynosić: (4szt x100,00) – 100,00= 400,00 400,00 – 100,00= 300,00zł
- Wartość dla pojedynczej jednostki (szt.) = 75,00.
- Rabat z budżetu wynosi: 25%; 100,00.
Jeżeli parametr w konfiguracji ustawiony jest na „Procent..”, wówczas:
- Wartość netto wykorzystanej kwoty budżetu na pozycji się zmieni. Wartość procentowa rabatu z budżetu pozostanie na tym samym poziomie: 10%.
- Wartość pozycji będzie wynosić: 4szt x [100,00 – (100,00*10%)]= 4 x [100,00 -10,00]= 4 x 90,00 = 360,00zł
- Wartość dla pojedynczej jednostki pozostanie bez zmian (szt.) = 90,00.
- Naliczony zostanie rabat budżetowy: 10%, natomiast wartość netto wykorzystanej kwoty budżetu na pozycji będzie wynosić: 40,00zł

Maksymalny rabat z karty operatora z systemu ERP

Istnieje możliwość ograniczenia wielkości rabatu, jaki operator może nadać („z ręki” na pozycji) niezależnie od rabatów wynikających z obowiązujących promocji. Dzięki tej funkcjonalności, firma może zdefiniować wielkość rabatu, jaki maksymalnie może pracownik nadać (obniżyć cenę towaru) podczas wystawiania dokumentów. Maksymalny rabat ustala się na karcie operatora na zakładce Parametry.

Określenie wysokości rabatu maksymalnego na karcie operatora w Comarch ERP XL

Uwaga

Parametr [MaxDiscountContolType], który decyduje o tym, jak restrykcyjna jest kontrola maksymalnego rabatu. Opis obsługi parametru znajduje się TUTAJ.

Promocja typu: "Stała cena"

W systemie Comarch ERP XL istnieją parametry regulujące naliczanie innych promocji, w przypadku obowiązywania promocji typu [Stała cena]. W konfiguracji systemu ERP, w parametrach sprzedaży zostały dodane ustawienia

Dla promocji typu stała cena:
- Naliczaj inne promocje/rabaty
- Kontroluj marżę minimalną

Parametry konfiguracyjne dla promocji typu stała cena w Comarch ERP XL

Zaznaczenie parametru [Naliczaj inne promocje/rabaty] spowoduje automatyczne włączenie kontroli marży minimalnej bez możliwości wyłączenia.

aplikacja mobilna będzie kolejno naliczała promocje wg ich priorytetu, również po naliczeniu już na pozycji promocji typu [Stała cena], o typie: PRM, TWU, KNU, KNT, PLT,
rabaty procentowe nadawane na nagłówku przez Operatora oraz promocja typu WTR, również będą nadawane na pozycjach, dla których obowiązuje promocja [Stała cena],
promocje będą się naliczać do momentu osiągnięcia minimalnej marży bez ograniczeń, co do ilości promocji.

Promocje pakietowe elastyczne w zależności od grup towarowych

W aplikacji na definicji promocji pakietowych elastycznych obowiązują dodatkowe warunki. (1) Minimalna ilość pozycji: Na poszczególnych progach promocji pakietowej elastycznej można określić minimalną ilość różnych pozycji tzn. pozycji z różnymi towarami; kilka pozycji na dokumencie z tym samym towarem jest liczone jako: 1. Będzie to dodatkowym warunkiem do spełnienia progu ilościowego lub wartościowego na dokumencie. Jeżeli nawet próg zostanie przekroczony, ale na dokument zostanie dodana zbyt mała ilość pozycji, promocja pakietowa nie zostanie zastosowana. Minimalną ilość będzie można zdefiniować dla progów ogólnych oraz dla progów wg grup. (2) Progi promocji wg grup towarowych Ilość – wartość progu: Dotychczasowe ogólne progi promocji można „rozbić” na wymagania dotyczące konkretnych grup towarowych, tak aby przykładowo zdefiniować: Ogólny próg dla promocji na poziomie: 10 szt., Progi wg grup: 4 szt. z Grupy A oraz 6 szt. z Grupy B. Po dodaniu na promocję grupy towarowej np. Grupy A, promocja będzie dotyczyć tylko towarów bezpośrednio należących (podpiętych) do wskazanej grupy (Grupy A). Nie będzie dotyczyć towarów należących do grup podrzędnych podpiętych do Grupy A. Typ progu: Progi ogólne w obrębie jednej promocji muszą dotyczyć jednego rodzaju tj. albo ilości, albo wartości, natomiast Progi wg grup (w ramach progu ogólnego) mogą się różnić, tj. dla jednej grupy może być: Ilościowy, dla innej: Wartościowy: Np. Próg ogólny: Ilościowy: 10 szt., Progi wg grup: 4 szt. z Grupy A oraz 500 PLN z Grupy B. Minimalna ilość pozycji: Podobnie jak dla progu ogólnego, również dla progów wg grup będzie można zdefiniować minimalną ilość pozycji. Typ i wielkość upustu: Podobnie jak dla towaru objętego promocją pakietową, dla całej grupy będzie można określić rabat: Stała cena: wartość, kierunek VAT ceny: netto lub brutto, lub Rabat procentowy: wartość Dodatkowe: Oprócz rzeczywistych grup towarowych, można dodać również wirtualną grupę: „Inne” służącą do podania wielkości progu, czy też minimalnej ilości pozycji dla towarów spoza dodanych grup. Do progu z grupy „Inne” będą należeć tylko towary dodane bezpośrednio na definicję promocji, nie powiązane z żadną z grup towarów dodanych na tą promocję. (3) Wymagalność elementów pakietu Poszczególne towary objęte promocją (konkretny indeks towarowy), można oznaczyć parametrem: „Wymagany” oznaczający, że aby pakiet mógł być zastosowany, wskazany towar musi wystąpić na dokumencie. Oznaczenie to będzie dotyczyło całej promocji (wszystkich progów) i tylko konkretnych towarów (niedostępny parametr dla grup towarowych). (4) Zamknięta lista towarów z grup Parametr ten obejmuje tylko konkretne grupy towarowe dodane na definicję promocji, np. SERY, SOKI itd., nie dotyczy grupy wirtualnej: [Inne].

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 jest w Comarch ERP XL na karcie kontrahenta w zakładce księgowe. Do aplikacji mobilnej pobierane są dane z definicji dokumentu na centrum mobilnym.

Ustawienie opcji VATu eksportowego na definicji dokumentu ZS

Kontrola marży minimalnej

Jeżeli na definicji dokumentu (na centrum mobilnym przedstawiciela w systemie Comarch ERP XL) została włączona kontrola marży minimalnej (zaznaczony parametr [Nie pozwalaj sprzedawać poniżej marży minimalnej]) - wówczas cena końcowa jest ustalana na pozycji zgodnie z narzuconym poziomem marży minimalnej (definiowanej na karcie towaru - więcej informacji TUTAJ) oraz określonej ceny bazowej.

Definicja dokumentu FS, zakładka Parametry

Przy próbie wprowadzenia niższej ceny niż zezwala na to marża minimalna, w aplikacji mobilnej pojawia się standardowy komunikat Uzyskana marża jest za niska.

Możliwość zmiany ceny początkowej na pozycji

Możliwość zmiany ceny początkowej na pozycji wystawianego dokumentu jest dostępna w aplikacji mobilnej dla operatorów, którzy na oddziale mobilnym w systemie Comarch ERP XL, na definicji dokumentu, mają zaznaczony parametr [Edycja cen i rabatów na pozycjach] oraz dodatkowo jeżeli na serwerze synchronizacji jest włączona opcja zmiany ceny początkowej – parametr [CanChangeStartPrice] w pliku konfiguracyjnym. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Promocje limitowane

W systemie Comarch ERP XL użytkownik może wybrać, czy chce ustawić limit na całej promocji PRM czy na poszczególnych towarach objętych promocją. Należy również wybrać, czy promocja ma zostać naliczana na dokumentach rozchodowych czy przychodowych.

Limit na całej promocji PRM nie-pakietowej dla wszystkich kontrahentów dodanych na promocji

Limit poszczególnych towarach objętych promocją obowiązujący osobno dla każdego kontrahenta przypiętego do promocji

Limit na danej promocji można edytować w Comarch ERP XL po zatwierdzeniu promocji pod warunkiem, że nowa ilość/wartość nie będzie mniejsza niż obowiązująca. Więcej informacji nt. promocji limitowanych znajduje się TUTAJ.

Edycja ilości gratisów

Jeżeli na progu promocji pakietowej w systemie Comarch ERP XL został zaznaczony parametr: [Edycja ilości wydawanych gratisów], operator będzie mógł przyznać na dokumencie dowolne z przypisanych do progu gratisów, w łącznej ilości nie większej niż zdefiniowana na progu suma ilości gratisów. Również w oknie definiowania gratisów podpowiadane są do przyznania domyślne gratisy zdefiniowane dla danego progu promocji pakietowej.

Parametr na progu promocji pakietowej pozwalający na edycję ilości gratisów na dokumencie

Więcej informacji nt. elastycznego dodawania gratisów znajduje się TUTAJ.

Uwzględnianie parametru Mnóż

Parametr [Mnóż] obowiązuje w aplikacji Comarch Mobile na wszystkich typach dokumentów z ustawioną na centrum obsługą promocji pakietowych – ZS, OS, FS, PA, WZ. Dzięki zastosowaniu parametru: [Mnóż] na promocji pakietowej elastycznej, nie ma potrzeby definiowania progów. Aby umożliwić wykorzystanie parametru [Mnóż] w aplikacji Comarch Mobile należy na poszczególnych gratisach promocji w systemie Comarch ERP XL ustawić odpowiedni parametr decydujący o tym czy „mnożyć” ilość gratisu stosownie do wielokrotności spełnionego warunku promocji. W aplikacji Comarch Mobile na zakładce [Gratisy], na karcie promocji pakietowej elastycznej, przy zdefiniowanej ilości gratisu i włączonym w systemie parametrze: Mnóż prezentowany jest napis informujący o tym, że gratis będzie mnożony.

Ustawienie parametru: [Mnóż] na gratisie pakietu elastycznego w systemie Comarch ERP XL

Określenie liczby pakietów do wykorzystania

W systemie Comarch ERP XL jest możliwość określenia z jakiej maksymalnie ilości pakietów można skorzystać w czasie trwania promocji. Funkcjonalność ta dotyczy zarówno pakietów stałych jak i elastycznych.

Jeżeli określony na promocji pakietowej limit dotyczy wszystkich kontrahentów (rodzaj: Ogółem) wyświetlana ilość pakietów do wykorzystania dotyczy ogólnej, dostępnej dla wszystkich kontrahentów, dodanych do promocji liczby pakietów, które można jeszcze wykorzystać. Jeżeli określony na promocji pakietowej limit dotyczy poszczególnych kontrahentów z osobna (rodzaj: Dla kontrahenta) wyświetlana ilość pakietów do wykorzystania dotyczy tego konkretnego kontrahenta, na którego rejestrowany jest dokument.

Uwaga

Promocje pakietowe, dla których została określona max. liczba pakietów są możliwe do zastosowania tylko na dokumentach ZS.

Sposób naliczania promocji pakietowych

Sposób naliczania promocji pakietowych uzależnione jest od tego, czy parametr: [Realizacja pakietów liczona od wartości początkowych] został zaznaczony w systemie Comarch ERP XL. Jeżeli tak, promocje będą naliczane od ceny początkowej, w przeciwnym wypadku promocje będą naliczane od ceny końcowej.

Zakładka z ustawieniem sposobu naliczania promocji pakietowych

Przykład

W systemie Comarch ERP XL została zdefiniowana promocja wartościowa zakładająca, iż za zakupy o wartości 1000 zł należy się 10% rabatu. W przypadku naliczania promocji od ceny początkowej Klient kupuje towar za 1000 zł, a płaci za niego 900 zł, natomiast przy liczeniu upustu od ceny końcowej Kontrahent musi kupić towaru za minimum 1111 zł, aby promocja się naliczyła (i zapłaci wówczas 1000 zł).

Towary wymagane

Jeżeli na promocji pakietowej elastycznej w systemie Comarch ERP XL dla towaru został zaznaczony parametr: [Wymagany], operator po wyborze promocji będzie musiał dodać ten towar na dokument.

Parametr Wymagany na definicji promocji pakietowej elastycznej

Towary wymagane mogą być automatycznie dodawane do koszyka dokumentu w aplikacji mobilnej. Za tę funkcjonalność odpowiada parametr AddRequiredItemsForPackagePromotionToCart. Więcej informacji nt. parametru znajduje się TUTAJ. Więcej informacji nt. pakietu elastycznego znajduje się TUTAJ.

Cykliczność wizyt handlowych

W systemie Comarch ERP XL na Karcie kontrahenta istnieje możliwość ustawienia opcji odbywania wizyt z określoną częstotliwością. W tym celu na Karcie kontrahenta należy wybrać zakładkę [Aplikacje], a następnie przycisk [Cykliczność wizyt].

Karta kontrahenta – wybór cykliczności wizyt

Po wybraniu przycisku [Cykliczność wizyt] możliwe jest zdefiniowanie warunków i parametrów związanych z realizowaniem danej wizyty.

Uwaga

Na chwilę obecną parametr [Koniec po X wystąpieniach] nie jest obsługiwany.

Kopiowanie atrybutów kontrahenta na element typu „inny”

Istnieje możliwość kopiowania atrybutu kontrahenta na element typu „Inny”. W plikach konfiguracyjnych znajdujących się w katalogu (domyślnie): C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [IsContractorsAttributeVisibleOnVisit] odpowiedzialny za to, czy atrybut z karty kontrahenta ma być widoczny na elemencie typu „Inny” czy też nie. Jeżeli parametr ten przyjmuje wartość 1, wówczas opcja kopiowania atrybutu na element wizyty typu „Inny” zostanie włączona. Dodatkowe informacje nt. tego parametru znajdują się TUTAJ. Funkcjonalność kopiowania atrybutu na element wizyty w Comarch Mobile dotyczy:

Klasy atrybutu typu: Tekst
Atrybutu widocznego w aplikacji Comarch Mobile
Klasy atrybutu przypiętej do obiektu: [Grupa kontrahenta].[Kontrahent]

Comarch ERP XL – definicja klasy atrybutu kontrahenta

Atrybut zdefiniowany w systemie Comarch ERP XL jak powyżej, wyświetlany jest na kartotece kontrahenta w Comarch Mobile jako informacja dodatkowa

Informacja dodatkowa z kartoteki kontrahenta zostanie skopiowana na element wizyty jeżeli:

parametr IsContractorsAttributeVisibleOnVisit = 1
na wzorcu wizyty dodany jest element wizyty o Rodzaju: Inny

Comarch ERP XL - definicja elementu wizyty

Jeżeli spełnione są określone powyżej warunki kopiowania atrybutu kontrahenta, wówczas w oknie wizyty, na liście Zadania do wykonania dla elementu wizyty o rodzaju Inny prezentowane są informacje jak poniżej

Zadania do wykonania dla Wizyty - kopiowanie atrybutu na element „Inny”

Planowanie wizyty bez podania wzorca

Istnieje możliwość planowania wizyt bez konieczności określania wzorca wizyty. Dzięki temu przedstawiciel handlowy, będąc na miejscu u Klienta, może określić charakter wizyty handlowej oraz wybrać najlepszy zestaw elementów wizyty do realizacji. Jeżeli podczas planowania wizyty nie zostanie wskazany jej wzorzec, konieczne będzie podanie nazwy wizyty. W plikach konfiguracyjnych znajdujących się w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [CanPlanVisitsWithoutPattern] odpowiedzialny za to, czy podczas planowania wizyty konieczne jest wskazanie wzorca. Domyślna wartość tego parametru wynosi 0. Dodatkowe informacje nt. konfiguracji tego parametru znajdują się TUTAJ. Jeśli wartość parametru została ustawiona na 1, wówczas:

Jeśli w definicji oddziału został dodany więcej niż jeden wzorzec podczas planowania wizyty pole z nazwą wzorca jest puste. Po podaniu nazwy wizytę można zapisać.

Jeśli w definicji oddziału został dodany tylko jeden wzorzec, podczas planowania wizyty ten wzorzec się podpowiada. Po dłuższym przytrzymaniu pola z nazwą wzorca zostanie on usunięty.

Automatyczne zamykanie i synchronizacja raportu kasowego podczas realizacji wizyty

Uwaga

Opcja dot. realizacji wizyty handlowej z elementem: Należności.

Dzięki opcji automatycznego zamykania raportu kasowego oraz uruchomienia synchronizacji po rozliczeniu płatności podczas wizyty, przedstawiciel nie będzie zmuszony do przerywania realizacji wizyty, a wyniki rozliczonych należności będą od razu po zatwierdzeniu wysyłane do systemu ERP. W plikach konfiguracyjnych znajdujących się w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [IsSettlementsSynchronizationOnVisitEnabled], odpowiedzialny za to czy opcja automatycznego zamykania raportu podczas synchronizacji ma być dostępna. Parametr ten może przyjmować wartości 0 (wartość domyślna) lub 1. Dodatkowe informacje nt. konfiguracji tego parametru zostały opisane TUTAJ. Jeżeli parametr [IsSettlementsSynchronizationOnVisitEnabled] przyjmuje wartość 1, wówczas w momencie zatwierdzenia wystawionego KP uruchamiana zostaje synchronizacja typu: Tylko wyślij.

Automatyczne zamykanie raportu kasowego i wysyłanie do go systemu ERP

Dodatkowo na elemencie wizyty typu: Należności, w menu kontekstowym dostępna jest opcja Synchro – uruchamiająca z poziomu wizyty synchronizację typu: Wszystko bez załączników.

Uruchamianie na elemencie wizyty typu: Należności synchronizacji typu: Wszystko bez załączników

Możliwość wysyłania realizacji elementu: Merchandising wiadomością e-mail

Uwaga

Opcja dot. realizacji wizyty handlowej z elementem: Merchandising.

W Comarch Mobile istnieje możliwość ustawienia, aby podczas wizyty (bezpośrednio z zadania typu: Merchandising) możliwe było wysłanie wiadomości e-mail z załączonym zdjęciem, wykonanym podczas realizacji tego zadania. Wykonywanie zdjęć podczas elementu wizyty: Merchandising może być wykorzystywane nie tylko do sprawdzenia ekspozycji towarów, ale również do udokumentowania pewnych operacji czy przekazanych dokumentów.

Przykład

Podczas wizyty handlowej Klient może przedstawić dokumenty umowy, czy potwierdzenia przelewu rozliczającego zaległe płatności, które jeszcze nie zostały zaksięgowane. Przedstawiciel wykonując zdjęcie może w ten sposób potwierdzić przekazanie lub podgląd danych dokumentów.

Uwaga

Możliwość wysłania wiadomości e-mail z załączoną realizacją elementu wizyty Merchandising jest dostępna tylko w przypadku, gdy na urządzeniu mobilnym zainstalowana jest aplikacja do obsługi poczty (np. Gmail) oraz odpowiednio skonfigurowany jest klient poczty.

W plikach konfiguracyjnych znajdujących się domyślnie w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods znajduje się parametr [CanSendMerchandisingRealization] - opis konfiguracji tego parametru znajduje się TUTAJ. Jeżeli parametr [CanSendMerchandisingRealization] przyjmuje wartość 1, wówczas w Ustawieniach aplikacji w sekcji Parametry działań pojawi się dodatkowe pole Odbiorca wysyłanych zdjęć. Naciśnięcie parametru spowoduje podniesienie okna z polem tekstowym, w którym umożliwione zostanie wprowadzenie adresu e-mail odpowiedniej osoby (np. odpowiedzialnej za odblokowywanie transakcji kontrahentom).

Ustawienia aplikacji Comarch Mobile – parametr: [Odbiorca wysyłanych zdjęć]

Jeżeli do zadania typu Merchandising dodano realizację (wykonano zdjęcie), wówczas naciśnięcie opcji: [Zatwierdź] w pasku górnym spowoduje rozwinięcie menu z dwoma opcjami:

Zakończ – powoduje zatwierdzenie realizacji
Zakończ i wyślij – powoduje zatwierdzenie realizacji i następnie przejście do akcji wysyłania wiadomości e-mail

Dwie opcje możliwe do wyboru, kiedy w aplikacji została udostępniona możliwość wysyłania zdjęć podczas realizacji elementu wizyty typu Merchandising

Jeżeli zdjęcie zostało wcześniej tylko zapisane, możliwość jego wysłania za pomocą opcji e-mail istnieje także z poziomu menu kontekstowego.

Menu kontekstowe dla zrealizowanego działania typu Merchandising

Możliwość kopiowania tygodniowego i dziennego planu wizyt

W aplikacji Comarch Mobile istnieje możliwość kopiowania tygodniowego i dziennego planu wizyt. Za tę opcje odpowiadają parametry [CanCopyWeeklyVisitPlan] i [CanCopyVisits], znajdujące się w plikach konfiguracyjnych katalogu (domyślnie): C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods. Parametr ten jest opisany TUTAJ. Więcej informacji na temat wspomnianych funkcjonalności znajduje się TUTAJ.

Obsługa ankiet z pytaniami wielokrotnego wyboru

Jednym z elementów wizyty handlowej są ankiety. W aplikacji Comarch Mobile Sprzedaż oprócz pytań otwartych i pytań jednokrotnego wyboru umożliwiono korzystanie z ankiet, gdzie konieczne jest wybranie kilku odpowiedzi na raz. W tym celu w pierwszej kolejności należy zdefiniować nowe pytanie i odpowiedzi w systemie Comarch ERP XL: Administrator Oddziałów/Narzędzia /Ankiety/Pytania. Za pomocą ikony plusa:

należy dodać nowe pytanie.

Wcześniej należy też zdefiniować odpowiedzi dla tych pytań. W przypadku pytań zamkniętych (w tym wielokrotnego wyboru) odpowiedzi mogą zostać wskazane jedynie spośród słownikowych wartości (zdefiniowanej listy wartości). Po naciśnięciu na przycisk [Rodzaj odpowiedzi] powinny podnieść się wszystkie zdefiniowane w systemie ERP słownikowe wartości dla rodzajów odpowiedzi Słowniki kategorii /Inne /Rodzaje odpowiedzi.

Kolejnym krokiem jest przypięcie pytania do ankiety. Z poziomu Administratora Oddziałów należy przejść na zakładkę [Narzędzia/Ankiety/Definicje ankiet], a następnie w definicji danej ankiety, w zakładce [Pytania], należy podpiąć pytanie wielokrotnego wyboru. Ostatnią rzeczą o jakiej należy pamiętać jest to, aby wzorzec wizyty udostępniony w Comarch Mobile Sprzedaż [Administrator Oddziałów/Oddziały/Lista oddziałów/Wizyty] na karcie danego oddziału zawierał element Ankiety i zdefiniowaną ankietę z pytaniem wielokrotnego wyboru.

Wyświetlanie dodatkowych parametrów na raportach towarowych

W aplikacji Comarch Mobile Sprzedaż istnieje możliwość wyświetlania na raporcie towarów konkurencji i raporcie obecności towarów dodatkowych kolumn zdefiniowanych w systemie Comarch ERP XL.

Za tę opcję odpowiada parametr [ShowColumnsOnReports], znajdujący się w plikach konfiguracyjnych w katalogu: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\ Methods. Możliwe wartości parametru to 0 (wartość domyślna), 1 lub 2. Dodatkowe informacje nt. konfiguracji tego parametru znajdują się TUTAJ.

Uwaga

Aby dodatkowa kolumna raportu była widoczna w aplikacji mobilnej, atrybut musi być udostępniony w aplikacji Comarch Mobile Sprzedaż.

Więcej informacji na temat wspomnianej funkcjonalności w raporcie towarów konkurencji znajduje się TUTAJ, a w raporcie obecności towarów - TUTAJ.

Wymagalność elementu wizyty

Istnieje możliwość definiowania własnych zapytań SQLite określających, czy element wizyty ma być wymagany. W tym celu w lokalizacji C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\VisitsElementsRequiredQueries (domyślna lokalizacja) należy utworzyć plik o nazwie <id>#<NazwaPliku>.xml, w którym należy umieścić definicje zapytania.

Wskazówka

Przykład takiego zapytania znajduje się w pliku readme.txt w folderze C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\VisitsElementsRequiredQueries

Wymagalność potwierdzania wizyty w zależności od wybranego wzorca

Funkcjonalność ta umożliwia większą kontrolę działań pracownika. Wszystkie wizyty wymagające potwierdzenia, dopóki nie zostaną potwierdzone, nie będą dostępne do realizacji. W celu skonfigurowania wymagalności potwierdzania wizyt z określonymi wzorcami należy:

Na definicji oddziału mobilnego, na zakładce: Wizyty musi zostać zaznaczony check: [Wymagaj potwierdzenia].

Ustawienie na definicji oddziału mobilnego: Wymagaj potwierdzenia.

Dodać atrybut o Nazwie: Wymagaj potwierdzenia, Typie: Flaga, Obiekty: [CRM].[Wzorzec wizyty].

Konfiguracja atrybutu: Wymagaj potwierdzenia

Skonfigurowany atrybut dodać na definicji wzorca wizyt oraz ustawić jego wartość na TAK lub <Brak>, jeśli potwierdzenie wizyty z takim wzorcem powinno być wymagane i NIE, jeśli potwierdzenie nie jest wymagane.

Dodanie atrybutu do definicji danego wzorca wizyty

Udostępnianie załączników

W aplikacji obsłużona jest funkcjonalność pobierania załączników z systemu Comarch ERP XL przypisanych do nagłówka, elementu wizyty handlowej lub wzorca wizyty. Aby załącznik został pobrany przy imporcie wizyty handlowej z Comarch ERP XL należy zaznaczyć na liście załączników opcję [Dostępność w Mobile Sprzedaż].

Udostępnianie załącznika w aplikacji Comarch Mobile

Aplikacja umożliwia pobieranie załączników w formatach typu:

Obraz
MSExcel
MSWord
Plik PDF
Inny

Uwaga

Do prawidłowego wyświetlenia załącznika niezbędne jest posiadanie na urządzeniu mobilnym aplikacji, które obsługują dany rodzaj pliku.

Określenie rodzajów kontrahentów na wzorcu wizyty

Istnieje możliwość planowania wizyt z uwzględnieniem rodzaju kontrahenta. Funkcjonalność ta jest zależna od określenia rodzajów kontrahentów na wzorcu wizyty w systemie Comarch ERP XL:

Zaznaczenie powyższego parametru spowoduje, że operator będzie mógł zaplanować wizytę z danym wzorcem tylko dla znajdujących się na liście rodzajów kontrahentów. Jeśli opcja ta zostanie odznaczona, będzie istniała możliwość dodania lub usunięcia danego rodzaju kontrahentów z listy.

Zdefiniowanie domyślnego rodzaju przejazdu

Istnieje możliwość zdefiniowania domyślnego rodzaju przejazdu. Wówczas podczas rejestracji przejazdu w pole [Rodzaj] automatycznie ustawiana jest domyślna wartość zdefiniowana w systemie Comarch ERP XL. Domyślną wartość dla rodzaju przejazdu należy ustawić w [Słownikach kategorii] w Administratorze Comarch ERP XL.

Zdefiniowanie domyślnej wartości dla rodzaju przejazdu w systemie Comarch ERP XL

Określanie towarów wymaganych

Aby towary były wymagane na takim dokumencie należy dodać je w systemie Comarch ERP XL w definicji elementu wzorca wizyty w oknie [Towary] wymagane. Dla każdego towaru można określić minimalną ilość, jaka jest wymagana oraz czy towar jest obowiązkowy (pole [Wymagaj] ustawione na Tak). Wszystkie towary z tej listy automatycznie dodadzą się do koszyka z ilością równą ilości minimalnej. Towar, który nie jest obowiązkowy ([Wymagaj]: Nie) można usunąć z koszyka poprzez wpisanie 0 w polu z ilością. W przypadku, gdy towar jest obowiązkowy ([Wymagaj]: Tak) nie można zmienić jego ilości na mniejszą od ilości minimalnej, ani też całkowicie usunąć go z koszyka.

Element wzorca wizyty w systemie Comarch ERP XL, towary wymagany

Konfiguracja elementu wizyty: Zrób zdjęcie punktu

Podczas realizacji elementu wizyty typu: Merchandising (wykonanie zdjęcia) z ustawionym kodem elementu: [ZRÓB ZDJĘCIE PUNKTU] jest zapisywany punkt GPS, który następnie jest ustawiany jako punkt wzorcowy dla danego kontrahenta. W takim przypadku, do wyświetlania trasy wzorcowej (zaplanowanej) nie będzie brany adres kontrahenta, tylko zarejestrowany punkt wzorcowy.

Uwaga

W przypadku korzystania z elementu wizyty Merchandising, w tym rejestracji pozycji GPS, wymagana jest licencja na Moduł Monitorowanie.

Kolorowanie wizyt handlowych

W celu wyróżnienia w aplikacji Comarch Mobile wizyt według ich typów, w systemie Comarch ERP XL istnieje możliwość konfiguracji ich kolorowania. Aby dany typ wizyty handlowej został wyróżniony w aplikacji należy w systemie Comarch ERP XL, w module [Administrator] wybrać z menu pozycję: Listy\Słowniki kategorii\CRM\Typy wizyt oraz przypisać odpowiedni kolor do danego typu wizyty.

Przypisywanie koloru do wizyty w systemie Comarch ERP XL

Aby odpowiednie typy wizyty zostały w aplikacji widoczne w określonym kolorze należy wykonać synchronizację. Po utworzeniu w aplikacji Comarch Mobile wizyty w określonym typie jest ona widoczna zgodnie ze skonfigurowanym wcześniej w systemie Comarch ERP XL ustawieniem kolorów.

Potwierdzenie przez kierownika wizyt planowanych w aplikacji

Istnieje możliwość ustawienia, aby WH zaplanowane przez Przedstawiciela Handlowego wymagały potwierdzenia przez Kierownika. Opcja dostępna jest po zaznaczeniu parametru dostępnego w systemie Comarch ERP XL na konfiguracji danego oddziału (zakładka: Wizyty) [Wymagaj potwierdzenia]

Po ustawieniu ww. parametru wizyta po zaplanowaniu przez Operatora będzie miała status „niezatwierdzony” i ustawioną automatycznie opcję [Wyślij po zaplanowaniu].

Planowanie WH podczas, gdy w systemie Comarch ERP XL została zaznaczona opcja: [Wymagaj potwierdzenia]

Z poziomu listy działań będzie prezentowana kolorem zielonym. Do momentu potwierdzenia wizyty w systemie Comarch ERP XL niemożliwa będzie realizacja wizyty.

Zaplanowana WH, która wymaga potwierdzenia przez kierownika

Po synchronizacji, w systemie Comarch ERP XL lub aplikacji Comarch Mobile Zarządzanie, kierownik ma możliwość zatwierdzenia, odrzucenia bądź przeniesienia wizyty na inny termin. Po wykonaniu kolejnej synchronizacji z poziomu urządzenia mobilnego (pobraniu potwierdzenia) przedstawiciel będzie miał możliwość realizacji wizyty.

Możliwość kopiowania pojedynczej wizyty

W aplikacji Comarch Mobile istnieje możliwość kopiowania pojedynczej niezrealizowanej wizyty. Za tę opcje odpowiada parametr [CanCopyVisits], znajdujący się w plikach konfiguracyjnych katalogu (domyślnie): C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods. Parametr ten jest opisany TUTAJ. Więcej informacji na temat wspomnianej funkcjonalności znajduje się TUTAJ.

Pobieranie dokumentów historycznych

Aby możliwe było pobranie dokumentów historycznych z systemu Comarch ERP XL należy:

ustawić parametry historyczności w aplikacji Comarch Mobile – opis tych ustawień znajduje się TUTAJ,
na karcie operatora w systemie Comarch ERP XL na zakładce Parametry/Uprawnienia w grupie opcji: Podgląd dokumentów wybrać opcję [Wszystkich].

Comarch ERP XL, karta operatora, parametr [Podgląd dokumentów]

Wystawianie dokumentów ZS i OS w innej walucie

W aplikacji Comarch Mobile Sprzedaż jest możliwe wystawianie zamówień i ofert sprzedaży w walucie obcej. Podczas wystawiania dokumentów OS i ZS na nagłówku dokumentu ustawiana jest waluta domyślna z karty kontrahenta.

Wskazówka

W systemie Comarch ERP XL waluty dodawane są z poziomu: Administrator/ Listy/ Waluty

Aby zmienić walutę domyślną na karcie kontrahenta należy przejść do zakładki [Rozliczenia]:

Ustawienie domyślnej waluty na karcie kontrahenta

Aby zmienić walutę domyślną na karcie kontrahenta należy przejść do zakładki [Rozliczenia]: Ustawienie domyślnej waluty na karcie kontrahenta od wersji ERP XL 2019.0Dodatkowo operator ma możliwość zmiany waluty oraz jej kursów 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, jak i jej kursu.

Uwaga

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

Wskazówka

Zmiany wartości parametru należy dokonać w pliku [configuration.xl2018.statement] dla Comarch ERP XL w wersji 2018.1 (lub [configuration.xl2017.statement] dla Comarch ERP XL w wersji 2017.1) znajdującego się domyślnie w folderze C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods. Wartości parametru wraz z ich znaczeniem opisane są TUTAJ.

Obsługa pola termin ważności na dokumencie OS

W aplikacji Comarch Mobile Sprzedaż istnieje możliwość definiowania własnych przedziałów dla daty ważności na Ofercie Sprzedaży. W celu dodania definicji należy przygotować odpowiedni plik xml i umieścić go na serwerze synchronizacji w katalogu Methods/timeintervalsofdocumentdate.

Wskazówka

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

Przykład

Poniższa definicja pozwala na wyświetlenie własnej listy wartości z konkretnymi interwałami jak np. 2 tygodnie, 1 miesiąc, które dostępne będą po wybraniu opcji:

. Po wskazaniu danej wartości z listy, data ważności oferty zostanie ustawiona zgodnie z wybranym przedziałem czasu.

Przykład

<list>

<nameOfInterval>2 tygodnie </nameOfInterval>

</TimeIntervalsOfDocumentDate>

<nameOfInterval>1 miesiąc </nameOfInterval>

</TimeIntervalsOfDocumentDate>

</list>

Pobieranie zamówień w buforze oraz umożliwienie zatwierdzania lub anulowania zamówień „producenta”

W aplikacji Comarch Mobile zostało umożliwione pobieranie z systemu Comarch ERP XL niepotwierdzonych dokumentów zamówień z centrali. Pobieranie zamówień będących w buforze jest uzależnione od tego czy na centrum mobilnym jest zaznaczony parametr [Eksport zamówień w buforze] oraz wymagane jest również zaznaczenie w ustawieniach aplikacji Comarch Mobile parametru [Pobieraj dokumenty z systemu].

Parametr "Eksport zamówień w buforze" w oddziale mobilnym

Do anulowania zamówień wymagane jest pobranie do aplikacji Comarch Mobile listy kodów fiaska zdefiniowanej w systemie Comarch ERP XL w module [Administrator/ Listy/ Słowniki kategorii/ Transakcje/ Kody fiaska].

Comarch ERP XL – Słowniki kategorii, Kody fiaska – sprzedaż

Synchronizacja zamówień z wykonaniem rezerwacji asortymentu w systemie ERP

W przypadku, gdy po synchronizacji zamówienia do systemu ERP rezerwacje zostaną utworzone na wszystkie pozycje z zamówienia, wówczas dokument ten otrzyma w systemie ERP status Potwierdzone. Natomiast jeżeli do zamówienia zostanie utworzona rezerwacja tylko dla części zasobów, wówczas dokument ten wróci do aplikacji ze statusem Niepotwierdzone.

Uwaga

W przypadku, gdy dla danego zamówienia zabraknie zasobów do rezerwacji, przedstawiciel handlowy będzie miał do dyspozycji trzy scenariusze działania:

dokonanie zamówienia z niepełnymi rezerwacjami,
zrezygnowanie z asortymentu, dla którego istnieją braki w magazynie,
zamówienie innego towaru (zamiennika), poprzez zmniejszenie ilości na pozycji z częściową rezerwacją i dodanie nowej pozycji na brakującą ilość.

Aby w aplikacji Comarch Mobile Sprzedaż istniała możliwość rezerwacji zasobów, należy odpowiednio skonfigurować definicję dokumentu dla centrum mobilnego w systemie ERP. W tym celu należy zaznaczyć parametry [Rezerwuj zasoby] oraz [Rezerwacje na niepotwierdzonym ZS].

Definicja dokumentu ZS w systemie Comarch ERP XL

Za funkcjonalność rezerwacji zasobów odpowiada parametr [IsOrdersResourcesReservationVerified] opisany TUTAJ.

Uwaga

Włączenie parametru [IsOrdersResourcesReservationVerified] spowoduje pominięcie ustawień parametrów konfiguracji oddziału mobilnego w systemie Comarch ERP XL: [Importuj jako potwierdzone] oraz [Automatyczne potwierdzanie zamówień].

Filtr na koszyku z opcją „rezerwacje na pozycji”

Istnieje możliwość filtrowania towarów dodanych do koszyka z opcją [Rezerwacje na pozycji], jeżeli w aplikacji została skonfigurowana możliwość rezerwowania i wyświetlania informacji o rezerwacji:

na definicji dokumentu ZS w konfiguracji oddziału mobilnego zostały zaznaczone parametry: [Rezerwuj zasoby] oraz [Rezerwacja na niepotwierdzonym ZS]

lub

w pliku konfiguracyjnym parametr [IsOrdersResourcesReservationVerified] ma wartość 1.

Więcej informacji nt. rezerwacji zasobów znajduje się TUTAJ.

Daty dostawy zamówienia wg kalendarza dostaw Kontrahenta

Funkcjonalność pozwala na uwzględnienie kalendarza dostaw zdefiniowanego dla danego kontrahenta podczas określania daty dostawy na dokumencie ZS. Dzięki temu przedstawiciel będzie mógł wskazać najbliższy możliwy termin dostawy zamówienia.

Definiowanie kalendarza dostaw Kontrahenta w Comarch ERP XL

Kalendarz dostaw, według którego ustalona będzie data realizacji zamówienia (dokument ZS) powinien zostać przypisany do danego kontrahenta. Kalendarz ten powinien być wskazany na karcie danego kontrahenta w zakładce kalendarze w sekcji kalendarz wysyłek.

Karta kontrahenta z przypisanym do niego kalendarzem dostaw

Jeden kalendarz może być przypięty do wielu Kontrahentów, jeśli terminy dostaw dla tych kontrahentów są zbieżne. W celu zdefiniowania nowego kalendarza dostaw dla kontrahenta należy kliknąć w przycisk [Kalendarz] w sekcji [Kalendarz wysyłek].

W oknie [Lista kalendarzy] zostaną wyświetlone wcześniej zdefiniowane kalendarze dla danego kontrahenta. Klikając w ikonę plusa można stworzyć nowy kalendarz dostaw Kontrahenta.

Na karcie nowego kalendarza należy zdefiniować kod danego kalendarza, jako typ wskazać [Wysyłka].

Definiowanie nowego kalendarza dostaw Kontrahenta

Dla danego kalendarza należy zdefiniować okresy, na podstawie których ustalany będzie najbliższy termin dostawy dla kontrahenta. Po kliknięciu w ikonę plusa otwiera się okno okresu kalendarza.

Definicja okresu kalendarza dostaw Kontrahenta

Istnieją dwa typy okresu kalendarza:

wysyłka – to podstawowy typ okresu kalendarza na podstawie którego ustalane są terminy dostaw na dokumencie ZS, ustalane terminy zależą dodatkowo od parametrów:
- Sposób dostawy: pole sposób dostawy w sekcji okres. Jego wskazanie nie jest wymagane - wtedy cykl lub termin będzie dotyczyć wszystkich sposobów dostawy, dla których nie zdefiniowano okresów w danym kalendarzu lub dla których wszystkie istniejące okresy są już nieaktywne
- Czas dostawy: pole czas dostawy w sekcji okres: oznacza liczbę dni jaka jest potrzebna na przygotowanie zamówienia
dzień wolny - oznacza okres, w którym kontrahent nie może odebrać zamówionego towaru. Parametr ten można zdefiniować jako pojedynczy termin bądź cykl dni. Wówczas nie istotne są parametry: czas dostawy i sposób dostawy. Okres kalendarza można zdefiniować jako:
- pojedynczy termin (zaznaczona opcja: Nie powtarzać, termin wprowadzony w polu: Od)
- cykl terminów: dzienny, tygodniowy, miesięczny lub roczny z możliwością określenia częstotliwości cyklu (zaznaczona opcja: Powtarzać co: X dni/tygodni/miesięcy/lat)
  - w przypadku cyklu tygodniowego należy wskazać dzień lub dni tygodnia, w których realizowane będą dostawy do kontrahenta
  - początek cyklu tygodniowego wyznacza termin wprowadzony w polu Data od w sekcji [Aktywny]
  - punkt początkowy pozostałych cyklów wyznacza termin wprowadzony w polu Od w sekcji [Okres]

Eksportowanie realizacji zamówień sprzedaży

W celu eksportu realizacji zamówień z systemu Comarch ERP XL do aplikacji konieczne jest włączenie parametru: [Eksport realizacji zamówień] na oddziale mobilnym w systemie ERP. W tym celu należy przejść do modułu [Administrator oddziałów/ Oddziały/ Lista oddziałów], a następnie podnieść do edycji wybrany oddział mobilny. Parametr ten znajduje się w zakładce [Parametry], jak na poniższym rysunku:

Parametr na oddziale mobilnym: Eksport realizacji zamówień

Więcej informacji dot. realizacji zamówień znajduje się TUTAJ.

Synchronizacja konfiguracji i ustawień odwrotnego obciążenia z ERP

Do poprawnego działania odwrotnego obciążenia VAT w aplikacji Comarch Mobile Sprzedaż wymagane jest ustawienie w Comarch ERP XL następujących elementów:

Stawkę VAT wskazaną w polu [Stawka VAT dla odwrotnego obciążenia] – Konfiguracja/ Sprzedaż, Zakładka [Stawki VAT]

Comarch ERP XL - konfiguracja stawki VAT dla odwrotnego obciążenia

Parametr [Podatnikiem jest nabywca] – karta kontrahenta, zakładka: [Księgowe\Typ kontrahenta]:

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

Opis działania tej funkcjonalności znajduje się TUTAJ.

Obsługa eksportowych stawek VAT

W aplikacji Comarch Mobile Sprzedaż istnieje możliwość wystawiania dokumentów ZS i OS z eksportowymi stawkami VAT. Dane dotyczące eksportowych stawek VAT pobierane są z systemu Comarch ERP XL.

Wyświetlanie informacji o cenie ewidencyjnej towaru

Istnieje możliwość wyświetlania ceny ewidencyjnej towaru, czyli najwyższej aktualnej ceny zakupu towaru, do którego przedstawiciel handlowy ma dostęp. Aby cena ewidencyjna towaru była wyświetlana w aplikacji, należy odpowiednio skonfigurować klasę atrybutu w systemie Comarch ERP XL.

Istnieje możliwość nadawania uprawnień do atrybutów per Operator. Na zakładce [Dostępność] można przypiąć operatorów, którzy powinni mieć dostęp do danej klasy atrybutu. Każdemu operatorowi można nadać dwa uprawnienia:

Wprowadzenie – możliwość przypisania wartości do atrybutu,
Zmiana – możliwość edycji wartości atrybutu,

lub nie zaznaczać żadnej z nich – wówczas taki operator będzie miał tylko możliwość podglądu atrybutu oraz przypięcia klasy, ale bez określania wartości. Aby udostępnić atrybut per operator w aplikacji Comarch Mobile, wymagane jest określenie dostępności takiego atrybutu na zakładce [Ogólne]. Jeśli na zakładce Dostępność zostanie określony operator, ale atrybut nie będzie udostępniony w Comarch Mobile (zakładka [Ogólne]) nie będzie on widoczny w aplikacji.

Obsługa kaucji

W aplikacji Comarch Mobile istnieje możliwość obsługi dokumentów kaucji: wystawianie dokumentów kaucji WKA oraz ich zwrotów za pomocą dokumentów korekt WKK. Aby dany towar wyświetlany był w aplikacji jako „kaucja” należy na karcie towaru na zakładce [Ogólne] zaznaczyć check w polu [Kaucja].

Karta towaru w Comarch ERP XL – oznaczenie towaru jako kaucji

Ponadto należy zdefiniować kontrahentów, dla których będą generowane płatności WKA. W tym celu należy przejść na kartę wybranego kontrahenta, następnie w zakładce [Handlowe] zaznaczyć check [Płatności]

Ustawienie na karcie kontrahenta w Comarch ERP XL - czy dokument kaucji ma generować płatność

Oraz zaznaczyć na definicji dokumentu WKA check [Generuje płatności].

Parametr [Generuje płatności] na definicji dokumentu WKA

Naliczanie kaucji odbywa się na podstawie schematów kaucji, zdefiniowanych dla danego towaru w systemie Comarch ERP XL. W schemacie określana jest ilość towaru, za jaką zostanie naliczona kaucja, oraz próg ilościowy, po przekroczeniu którego kaucja będzie naliczona. Zarówno ilość, jak i próg ilościowy mogą być definiowane osobno dla każdego opakowania danego towaru.

Przykład

Dla towaru Ketchup można określić osobną kaucję za wiaderko czy skrzynkę.

Na podstawie takiego schematu, dodając na dokument pozycje z powiązaną kaucją istnieje możliwość wygenerowania dokumentu kaucji (automatycznie lub ręcznie), który będzie zawierał opłatę za kaucję.

Widok schematu kaucji na karcie towaru w Comarch ERP XL

Uwaga

Aby kaucja generowała się automatycznie na dokumentach, należy na definicji dokumentów: MMW, FS, WZ i PA na zakładce [Inne] zaznaczyć parametr [Automatyczne generowanie dokumentów kaucji]. Do prawidłowego działania automatycznego generowania dokumentów niezbędne jest zdefiniowanie schematu kaucji.

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

W aplikacji Comarch Mobile Sprzedaż 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:

Faktura sprzedaży
Paragon
Oferta sprzedaży
Zamówienie sprzedaży
Wydanie zewnętrzne
Reklamacja sprzedaży (ilość dostępna w przypadku pozycji już dodanych do koszyka)
Wydanie magazynowe (ilość dostępna w przypadku pozycji już dodanych do koszyka)

Za tę funkcjonalność odpowiada parametr [IsBaseUnitVisible] - jest on opisany TUTAJ.

Zatwierdzanie dokumentu bez podpisu

W aplikacji istnieje możliwość pominięcia podpisu podczas wystawienia dokumentu. Funkcjonalność ta wymaga zmodyfikowania funkcji SyncFramework.GetNumerators (nazwa_bazy -> Programmability -> Functions-> Table-valued Functions -> SyncFramework.GetNumerators). Należy dodać warunek dotyczący konkretnego dokumentu, na którym ma być pominięty krok "Podpis". Przy wystawianiu pozostałych dokumentów podpis będzie wymagany.

Przykład

Konfiguracja funkcjonalności pominięcia kroku z podpisem na dokumencie Zamówienia Sprzedaży (ZS). CASE

WHEN mob.Dok_GIDTyp = 9472 THEN 0 /*ZS*/

ELSE 1

END AS IsSignatureRequired

Obsługa kosztów dodatkowych

Spis treści

Struktura definicji kosztu dodatkowego Elementy w definicji kosztu dodatkowego

W aplikacji umożliwiono skonfigurowanie doliczania kosztów dodatkowych do pozycji dokumentu. Istnieje możliwość dodania własnej definicji kosztów dodatkowych, w których określany jest sposób doliczania kosztów oraz uwarunkowania do jego naliczania. Podczas dodawania pozycji do dokumentu można określić m.in. następujące informacje dla kosztów dodatkowych:

nazwę kosztu;
na jakich typach dokumentów ma być doliczany;
czy koszt ma być wymagany; czy koszt może być edytowalny;
czy koszt ma być doliczany do ceny końcowej czy początkowej.

Aby umożliwić wyświetlanie kosztów dodatkowych w systemie Comarch ERP XL należy zdefiniować atrybut o nazwie WZTP, który powinien mieć następujące ustawienia:

Dodatkowo w pliku konfiguracyjnym należy odnaleźć parametr [IsAdditionalCostsEnabled] i zaznaczyć wartość 1 – parametr jest opisany TUTAJ.

Struktura definicji kosztu dodatkowego

Przygotowane definicje kosztów dodatkowych należy umieścić w pliku z rozszerzeniem XML w katalogu [AdditionalCostsDefinitions] katalogu głównego serwera synchronizacji (domyślna ścieżka: C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\AdditionalCostsDefinitions). Nazwa pliku musi składać się z <IdKosztuDodatkowego>#<NazwaKosztuDodatkowego>.xml

Przykład

1#KosztDodatkowy1.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.

Przykład

-1#KosztDodatkowy1.xml

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

…

</IsVisibleAdditionalCostsQuery>

…

</AfterAddPositionAdditionalCostsQuery>

…

</AfterRemovePositionAdditionalCostsQuery>

</AdditionalCosts>

Elementy w definicji kosztu dodatkowego

Name – nazwa kosztu dodatkowego
AttributeClassId – id atrybutu WZTP
SettleDocumentsValue – typy dokumentów, na których możliwe będzie stosowanie dodatkowych parametrów odnośnie kosztów dodatkowych. Zapytanie służy do określenia, czy dany koszt ma być naliczany. Poszczególne typy dokumentów będą miały przyporządkowane wartości:

1 – OS

2 – ZS

4 – FS

8 – PA

16 – WZ

32 – WKA

IsVisibleAdditionalCostsQuery – zapytanie służy do określenia, czy dany koszt ma być naliczany,
IsRequiredAdditionalCostsQuery – zapytanie służące do określenia, czy dany koszt jest wymagalny,
AddPositionAdditionalCostsQuery- algorytm do wyliczenia dodatkowych kosztów na pozycji dokumentu,
IsEditEnabled – zapytanie służące określeniu, czy parametr jest edytowalny (0 – nie, 1 – tak),
AfterAddPositionAdditionalCostsQuery– algorytm po zapisie pozycji dokumentu,
AfterRemovePositionAdditionalCostsQuery – algorytm po usunięciu pozycji dokumentu,
AdditionalCostsToEndPrice – zapytanie służy do określenia, czy koszty doliczane do ceny końcowej (0 – nie, 1 – tak),
IsMinusValueCostsEnabled – zapytanie służy do określenia, czy koszt może być ujemny.

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

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

Zamówienie Sprzedaży (ZS)
Oferta Sprzedaży (OS)
Faktura Sprzedaży (FS)
Paragon (Pa)
Wydanie Zewnętrzne (WZ)
Reklamacja sprzedaży (RLS)
Rozchód Wewnętrzny (RW)

W systemie Comarch ERP XL należy zdefiniować również sposób naliczania promocji w aplikacji. Parametr [Naliczaj rabaty dla kontrahenta] dla kontrahenta znajduje się w module Administrator w konfiguracji systemu ERP w zakładce [Rabaty i promocje]. Jeżeli zostanie wybrana opcja:

Głównego – po zmianie kontrahenta głównego przeliczone zostaną wszystkie promocje.
Docelowego – wówczas rabaty naliczane będą dla kontrahenta docelowego i zmiana kontrahenta głównego nie ma wpływu na przeliczanie rabatów.

Konfiguracja systemu ERP – wybór dla jakiego kontrahenta (główny/docelowy) powinny być naliczane rabaty

Edycja kontrahenta docelowego na nagłówku dokumentu

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

Zamówienie Sprzedaży (ZS)
Oferta Sprzedaży (OS)
Faktura Sprzedaży (FS)
Paragon (PA)
Wydanie Zewnętrzne ( WZ)
Reklamacja sprzedaży (RLS)
Rozchód Wewnętzrny (RW).

Uwaga

Po zmianie kontrahenta docelowego na dokumencie, np. z K1 na K2 należy pamiętać, że jeśli nowy kontrahent K2 nie ma przypisanego takiego samego kontrahenta głównego jaki był u K1, wówczas dodany dokument nie będzie widoczny w dokumentach kontrahenta K1.

W systemie Comarch ERP XL należy zdefiniować również sposób naliczania promocji w aplikacji. Parametr [Naliczaj rabaty] dla kontrahenta znajduje się w module Administrator w konfiguracji systemu ERP w zakładce [Rabaty i promocje].

Głównego – wówczas rabaty będą naliczane dla kontrahenta głównego, zmiana kontrahenta docelowego na nagłówku nie będzie miała wpływu na naliczanie rabatów;
Docelowego – wówczas rabaty będą naliczane dla kontrahenta docelowego;

W celu możliwości przeliczania promocji na dokumencie podczas zmiany kontrahenta docelowego należy w systemie Comarch ERP XL zaznaczyć parametr [Aktualizacji danych po zmianie: Kontrahenta].

Parametryzacja przeliczania promocji na dokumencie

Możliwość zmiany formy płatności na dokumentach „w dół”

W systemie Comarch ERP XL istnieje możliwość zmiany formy płatności na dokumentach „w dół”, to znaczy w sposób ograniczony przez kolejność form płatności ustaloną w Konfiguracji systemu.

Przykładowe zdefiniowane formy płatności w systemie Comarch ERP XL

Aby funkcjonalność można było zastosować dla przedstawiciela handlowego należy w domyślnym katalogu C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods zmienić wartość parametru [IsOnlyLowerPaymentFormsVisible] na wartość 1. Więcej informacji nt. tego parametru znajduje się TUTAJ. Dla prawidłowego działania funkcjonalności konieczne jest:

Zaznaczenie dostępnych form płatności dla konkretnego oddziału, do którego przypięty jest operator, jak na rysunku poniżej:

Zaznaczenie dostępnych form płatności na centrum mobilnym przypiętym do Operatora w systemie Comarch ERP XL

Zaznaczenie checku [Dostępny dla oddziału] po podniesieniu konkretnej formy płatności:

Zaznaczenie opcji „Dostępna w oddziale” form płatności dostępnych dla Operatora

Więcej informacji nt. zmian formy płatności znajduje się TUTAJ.

Edycja płatnika na nagłówku dokumentu

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

Zamówienie Sprzedaży (ZS)
Oferta Sprzedaży (OS)
Faktura Sprzedaży (FS)
Paragon (PA)
Wydanie Zewnętrzne (WZ)

Standardowo w aplikacji wyświetlane są informacje o płatniku ustawione na karcie kontrahenta w systemie ERP XL.

Informacja o płatniku w systemie ERP XL – skąd mają być pobierane warunki handlowe podczas wystawiania dokumentu

Uwaga

Opcja zmiany płatnika na nagłówku dokumentu jest możliwa tylko dla dokumentów wystawionych w aplikacji Comarch Mobile

Modyfikacja niepotwierdzonych zamówień pobranych z centrali

Uwaga

Niniejsza funkcjonalność dotyczy niepotwierdzonych dokumentów ZS pobranych z systemu Comarch ERP XL.

Modyfikacje pliku konfiguracyjnego należy przeprowadzać w plikach

[configuration.xl2018.statement] dla Comarch ERP XL w wersji 2018.2 lub
[configuration.xl20172.statement] dla Comarch ERP XL w wersji 2017.2.

Okno Małej kalkulacji podnosi się pod warunkiem, że w ustawieniach aplikacji zaznaczony jest parametr: [Używaj elementu skróconego] - więcej informacji nt. tego parametru znajduje się TUTAJ.

Modyfikacja ilości i/lub jednostki miary w oknie małej kalkulacji

W tym celu konieczne jest zaznaczenie w ustawieniach aplikacji Comarch Mobile parametru [Pokazuj elementy historyczne] (parametr ten został opisany TUTAJ).

Modyfikacja ceny w oknie małej kalkulacji

W tym celu konieczne jest:

zaznaczenie w ustawieniach aplikacji Comarch Mobile Sprzedaż parametru [Pokazuj elementy historyczne] (parametr ten został opisany TUTAJ),
zmiana w pliku konfiguracyjnym wartości parametru [IsDiscountsVisible] na 1.

Modyfikacja rabatu w oknie małej kalkulacji

W tym celu konieczne jest:

zaznaczenie parametru [Edycja cen i rabatów na pozycjach] na definicji dokumentu ZS dla centrum mobilnego w Comarch ERP XL,
zmiana w pliku konfiguracyjnym wartości parametru [IsDiscountsVisible] na 1

Modyfikacja marży, ceny końcowej, ceny końcowej za jednostkę podstawową, wartości elementu netto/brutto w oknie dużej kalkulacji

W tym celu konieczne jest:

zaznaczenie parametru [Edycja cen i rabatów na pozycjach] na definicji dokumentu ZS dla centrum mobilnego w Comarch ERP XL

Modyfikacja marży, rabatu,ceny początkowej, ceny końcowej, ceny końcowej za jednostkę podstawową, wartości elementu netto/brutto w oknie dużej kalkulacji

W tym celu konieczne jest:

zaznaczenie parametru [Edycja cen i rabatów na pozycjach] na definicji dokumentu ZS dla centrum mobilnego w Comarch ERP XL

Uwaga

W oknie dużej kalkulacji pozycji zamówienia możliwe jest dodanie atrybutu, jeżeli dla pozycji ZS w systemie Comarch ERP XL zdefiniowano odpowiedni atrybut i nadano uprawnienia do jego edycji w aplikacji Comarch Mobile Sprzedaż. Możliwa jest również modyfikacja atrybutu i jego usunięcie niezależnie czy dodano go na pozycję w centrali, czy z poziomu aplikacji, ale pod warunkiem, że w systemie Comarch ERP XL nadano dla atrybutu uprawnienia do edycji w aplikacji Comarch Mobile Sprzedaż.

Precyzja cen w aplikacji mobilnej

W aplikacji Comarch Mobile 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 miejscami 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 istniała możliwość prezentacji towaru na karcie towaru z precyzją do dwóch lub do czterech miejsc po przecinku. W systemie Comarch ERP XL w module [Administrator] należy zaznaczyć precyzję na typie ceny.

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

Zaznaczenie opcji [Cena z dokładnością do groszy] spowoduje wyświetlanie cen z dokładnością do dwóch miejsc po przecinku (standardowe działanie aplikacji), natomiast odznaczenie parametru spowoduje wyświetlanie cen z dokładnością do czterech miejsc po przecinku.

Prezentacja ceny na karcie towary z precyzją do dwóch miejsc po przecinku oraz do czterech miejsc po przecinku

Dodatkowo istnieje możliwość ustawienia precyzji ceny na definicji dokumentu na centrum operatora.

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

Zaznaczenie opcji [Cena z dokładnością do groszy] spowoduje wyświetlanie cen z dokładnością do dwóch miejsc po przecinku (standardowe działanie aplikacji), natomiast odznaczenie parametru spowoduje wyświetlanie cen z dokładnością do czterech miejsc po przecinku.

Prezentacja ceny podczas wystawiania dokumentu z precyzją a) do dwóch miejsc po przecinku, b) 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.

Obsługa atrybutów

Istnieje możliwość pobierania i wypełniania atrybutów. Atrybuty w aplikacji Comarch Mobile prezentowane są w sekcji: [Informacje dodatkowe]. Atrybuty można wyświetlać jako klasy lub klasy w grupach. Obsługa atrybutów przy współpracy z systemem Comarch ERP XL

Typy obiektów	Funkcjonalność
Kontrahenci	Podgląd i edycja
Towary	Podgląd
Samochody	Podgląd
Nagłówki dokumentów	Podgląd i edycja
Pozycje dokumentów	Podgląd i edycja

Aby klasa atrybutu była widoczna w aplikacji mobilnej należy w definicji atrybutu wskazać obiekty na zakładce [Obiekty] oraz zaznaczyć parametr [Podgląd] w grupie [Comarch Mobile] na zakładce [Ogólne]. Zaznaczenie parametru [Edycja] umożliwi dodatkowo edycję atrybutów na niektórych typach obiektów.

W aplikacji mobilnej obsługiwane są również flagi [Wymagany] oraz [Automat]. Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie ERP, to w aplikacji Comarch Mobile jest oznaczony znakiem

. W aplikacji obsługiwane są następujące typy atrybutów:

Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta w domyślnej przeglądarce na urządzeniu mobilnym

W aplikacji obsłużone zostały następujące formaty atrybutów:

Tekst
Data
1234
1234.56
1234.5678
Zaawansowany

Aby była możliwość wyświetlania atrybutów w grupach należy w systemie Comarch ERP XL na liście Atrybutów z poziomu zakładki [Grupy klas atrybutów] stworzyć odpowiednie grupy atrybutów:

oraz przypisać do stworzonej grupy obiekt, z którego poziomu ma być dostępna grupa atrybutów.

Następnie należy przypisać odpowiednie klasy atrybutów. Jedna klasa może być przypięta do kilku grup jednocześnie.

Obsługa marży minimalnej dla danego towaru

Aplikacja Comarch Mobile Sprzedaż umożliwia obsługę marży minimalnej dla danego towaru. Aby na towarze została uwzględniona marża minimalna należy w systemie Comarch ERP XL w oknie [Karta Towaru] w zakładce [Inne] określić procentową jej wielkość oraz zaznaczyć kontrolę minimalnej marży na definicji dokumentu.

Wprowadzone i zapisane zmiany z systemu Comarch ERP XL będą widoczne w aplikacji Comarch Mobile Sprzedaż po wykonaniu synchronizacji z poziomu urządzenia mobilnego.

Uwaga

W przypadku, gdy w systemie Comarch ERP XL zdefiniowana została promocja typu stała cena istnieje możliwość ustawienia kontroli marży minimalnej bądź ostrzeżenia, iż zakładana marża nie została osiągnięta.

Więcej informacji nt. obsługi marży minimalnej w aplikacji znajduje się TUTAJ.

Powielanie pozycji

W przypadku, gdy na definicji danego dokumentu w systemie Comarch ERP XL będzie zaznaczony parametr [Powielanie pozycji]: Zablokuj nie będzie możliwości odznaczenia parametru: [Pomiń towary będące w koszyku].

Definicja dokumentu FS z systemu Comarch ERP XL

Konfiguracja jednostki zbiorczej towaru

W systemie Comarch ERP XL na karcie towaru istnieje możliwość wskazania, która jednostka ma być jednostką zbiorczą.

Opcja wskazania w systemie ERP jednostki zbiorczej towaru

Informacje nt. działania tego ustawienia w aplikacji Comarch Mobile znajdują się TUTAJ.

Obsługa eksportowej stawki VAT

Obsługa VAT-u eksportowego w aplikacji Comarch Mobile Sprzedaż uzależniona jest od wartości „Tylko transakcje krajowe”:

„Tylko transakcje krajowe” zaznaczony: na nagłówku dokumentu typ: Krajowa, ustawiony jest bez możliwości zmiany
„Tylko transakcje krajowe” odznaczony:
- „VAT eksportowy” zaznaczony: na nagłówku dokumentu typ transakcji ustawia się zgodnie z kontrahentem z możliwością zmiany typu transakcji i wartości w polu VAT eksportowy (standardowe działanie)
- „VAT eksportowy” odznaczony: na nagłówku dokumentu typ transakcji ustawia się zgodnie z kontrahentem bez możliwości zmiany wartości w polu VAT eksportowy

Definicja dokumentu ZS: Transakcje krajowe oraz VAT Eksportowy

Parametryzacja edycji i widoczności ceny początkowej oraz rabatów

Istnieje możliwość zablokowania edycji cen i rabatów na elementach dokumentów – wartości są widoczne, ale nie można ich zmieniać. W przypadku współpracy z Comarch ERP XL obsłużony został parametry: [Edycja cen i rabatów na pozycjach] z definicji dokumentu.

Zaznaczenie opcji [Edycja cen i rabatów na pozycjach] w systemie Comarch ERP XL

Edycja cen i rabatów w elementach dokumentów

Wskazówka

Dzięki tej zmianie można tak skonfigurować aplikację, że przedstawiciel nie będzie mógł zmieniać warunków handlowych narzuconych z centrali firmy.

Istnieje również możliwość ukrywania cen początkowych i rabatów – Przedstawiciel pracujący w aplikacji może tylko operować ceną końcową (po uwzględnieniu wszystkich rabatów), ale nie ma możliwości wglądu w to, jakie promocje złożyły się na tą cenę oraz jaki rabat otrzymał odbiorca towarów. Więcej informacji znajduje się TUTAJ.

Aktualizacja warunków handlowych przy zmianie kontrahenta na nagłówku dokumentu

Aktualizacja warunków handlowych na dokumencie jest uzależniona od ustawienia na definicji dokumentu w systemie Comarch ERP XL - Aktualizacja danych po zmianie kontrahenta. Od wersji 2022.2.1 Comarch Mobile, jeżeli na definicji dokumentu pole [Kontrahent] jest:

- Zaznaczone - to przy zmianie kontrahenta na dokumencie otwiera się okno wyboru komunikat

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

Użytkownik decyduje, które elementy dokumentu tj. płatnik, kontrahent docelowy, typ transakcji, forma płatności, sposób dostawy 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

Odznaczony – po zmianie kontrahenta zmienione zostają tylko dane kontrahenta głównego.

Uwaga

Zmiana dokonana na nagłówku dokumentu nie wiąże się w żaden sposób z kartą kontrahenta, tzn. jeżeli na nagłówku wybrany zostanie z listy kontrahentów taki, który nie widnieje jako odbiorca/kontrahent główny tego kontrahenta w systemie Comarch ERP XL, nie zostanie on określony jako domyślny kontrahent docelowy/główny dla tego kontrahenta.

Więcej informacji nt. edycji kontrahenta na nagłówku dokumentu znajduje się TUTAJ.

Kontrola marży minimalnej

Jeżeli na definicji dokumentu (na centrum mobilnym przedstawiciela w systemie Comarch ERP XL) została włączona kontrola marży minimalnej (zaznaczony parametr [Nie pozwalaj sprzedawać poniżej marży minimalnej]) - wówczas cena końcowa jest ustalana na pozycji zgodnie z narzuconym poziomem marży minimalnej (definiowanej na karcie towaru - więcej informacji TUTAJ) oraz określonej ceny bazowej.

Przy próbie wprowadzenia niższej ceny niż zezwala na to marża minimalna, w aplikacji mobilnej pojawia się standardowy komunikat Uzyskana marża jest za niska.

Aktualizacja nagłówka dokumentu po zmianie daty

W przypadku zmiany daty wystawienia dokumentu na nagłówku, zmiany będą aktualizowane, jeżeli na definicji wystawianego dokumentu dla centrum mobilnego przedstawiciela będzie zaznaczony parametr [Aktualizacja danych po zmianie: Daty].

Możliwość zmiany ceny początkowej na pozycji

Możliwość zmiany ceny początkowej na pozycji wystawianego dokumentu jest dostępna w aplikacji mobilnej dla operatorów, którzy na oddziale mobilnym w systemie Comarch ERP XL, na definicji dokumentu, mają zaznaczony parametr [Edycja cen i rabatów na pozycjach] oraz dodatkowo jeżeli na serwerze synchronizacji jest włączona opcja zmiany ceny początkowej – parametr [CanChangeStartPrice] w pliku konfiguracyjnym. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Obsługa atrybutów

Istnieje możliwość pobierania i wypełniania atrybutów. Atrybuty w aplikacji Comarch Mobile prezentowane są w sekcji: [Informacje dodatkowe]. Atrybuty można wyświetlać jako klasy lub klasy w grupach. Obsługa atrybutów przy współpracy z systemem Comarch ERP XL

Typy obiektów	Funkcjonalność
Kontrahenci	Podgląd i edycja
Towary	Podgląd
Samochody	Podgląd
Nagłówki dokumentów	Podgląd i edycja
Pozycje dokumentów	Podgląd i edycja

Aby klasa atrybutu była widoczna w aplikacji mobilnej należy w definicji atrybutu wskazać obiekty na zakładce [Obiekty] oraz zaznaczyć parametr [Podgląd] w grupie [Comarch Mobile] na zakładce [Ogólne]. Zaznaczenie parametru [Edycja] umożliwi dodatkowo edycję atrybutów na niektórych typach obiektów.

W aplikacji mobilnej obsługiwane są również flagi [Wymagany] oraz [Automat]. Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie ERP, to w aplikacji Comarch Mobile jest oznaczony znakiem

. W aplikacji obsługiwane są następujące typy atrybutów:

Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta w domyślnej przeglądarce na urządzeniu mobilnym

W aplikacji obsłużone zostały następujące formaty atrybutów:

Tekst
Data
1234
1234.56
1234.5678
Zaawansowany

Aby była możliwość wyświetlania atrybutów w grupach należy w systemie Comarch ERP XL na liście Atrybutów z poziomu zakładki [Grupy klas atrybutów] stworzyć odpowiednie grupy atrybutów:

oraz przypisać do stworzonej grupy obiekt, z którego poziomu ma być dostępna grupa atrybutów.

Następnie należy przypisać odpowiednie klasy atrybutów. Jedna klasa może być przypięta do kilku grup jednocześnie.

Wydruk dokumentu

Poniżej został zaprezentowany standardowy wygląd wydruku PDF. 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.

Podgląd wydruku PDF wystawionego w aplikacji dokumentu

Obsługa zamienników

W aplikacji Comarch Mobile istnieje możliwość obsługi zamienników we współpracy z systemem Comarch ERP XL. Podczas wystawiania dokumentów istnieje opcja: Zamień, która służy do zamiany towaru na jego zamiennik. Opcja ta jest dostępna z poziomu:

Menu kontekstowego w koszyku,
Dużej kalkulacji pozycji.

Oznaczenie towarów posiadających zamienniki z poziomu wystawiania dokumentu

Opcja: Zamienniki

Z poziomu listy towarów podczas dodawania dokumentu, po rozwinięciu Menu kontekstowego (oprócz dotychczasowych opcji) jest wyświetlana opcja: „Zamienniki” umożliwiająca wyświetlenie zamienników danego towaru. Opcja jest dostępna tylko jeśli:

Dla towaru istnieją zamienniki obowiązujące dla dokumentów rozchodowych,
Towar nie został dodany jeszcze do koszyka.

Po wybraniu opcji: Zamienniki jest wyświetlana lista zamienników dla danego towaru. Na liście zamienników oprócz ilości w magazynie oraz ceny (standardowe informacje jak na liście towarów) są informacje na temat przelicznika (ile/za ile). Po wybraniu danego towaru z listy zamienników zostanie podniesiona standardowa kalkulacja danego towaru (zamiennika). Na kalkulacji domyślna ilość towaru (zamiennika) jest dodawana w jednostce domyślnej sprzedaży.

Wyświetlenie zamienników danego towaru z poziomu wystawiania dokumentu

W menu kontekstowym zamiennika są wyświetlane dwie opcje:

Dodaj do koszyka – po wybraniu tej opcji podniesie się kalkulacja towaru (zamiennika).
Szczegóły towaru – wyświetli się karta towaru. Po przejściu na kartę towaru, a następnie wybraniu opcji: Wstecz widok wróci na listę zamienników.

Opcje dostępne z poziomu menu kontekstowego zamiennika

Opcja: Zamień

Opcja: Zamień dotyczy towarów które zostały dodane do koszyka. Podobnie jak opcja: Zamienniki jest prezentowana tylko jeśli dla towaru istnieją zamienniki obowiązujące dla dokumentów rozchodowych. Opcja ta jest dostępna z poziomu:

Menu kontekstowego na liście towarów. Po wybraniu tej opcji i wskazaniu zamiennika towar powinien zostać zamieniony, bez podnoszenia kalkulacji.
Menu kontekstowego towarów dodanych do koszyka. Po wybraniu tej opcji i wskazaniu zamiennika towar powinien zostać zamieniony, bez podnoszenia kalkulacji.
Opcja dodatkowych na dużej kalkulacji pozycji. Po wybraniu tej opcji towar i wskazaniu zamiennika towar powinien zostać zamieniony, należy pozostawać w widoku dużej kalkulacji.

Opcja: Zamień dostępna z poziomu menu kontekstowego na liście towarów

Opcja: Zamień dostępna z poziomu menu kontekstowego towaru dodanego do koszyka

Opcja: Zamień dostępna z poziomu opcji dodatkowych na dużej kalkulacji pozycji

Po wybraniu opcji: Zamień jest wyświetlana lista z dostępnymi zamiennikami. Lista ta odpowiada tej wyświetlonej po wybraniu opcji: Zamienniki.

Po zamianie pozycji na zamiennik (np. dodaliśmy do Koszyka towar A i zamieniliśmy go na jego zamiennik – towar: B) na kalkulacji oraz na liście pozycji towar A zostanie usunięty, a dodany do zostanie towar B.
Jeżeli precyzja ustawiona na jednostce domyślnej i podstawowej zamiennika nie pozwala na zamienienie towaru w ilości wynikającej z przelicznika, wówczas ustawi się maksymalna ilość jaka wynika z przelicznika po zaokrągleniu lub ilość domyślna: 1 jeśli z przeliczenia wyjdzie ilość: 0
Jeżeli parametr: „Rejestruj w jednostkach całkowitych” jest zaznaczony wówczas precyzja zaokrąglania zawsze wynosi 0,
Jeżeli parametr: „Rejestruj w jednostkach całkowitych” nie jest zaznaczony, wówczas przy przeliczaniu i zaokrąglaniu jest sprawdzane jaka precyzja zaokrąglania jest ustawiona na jednostce.

Podczas procesu zamiany w przypadku dokumentów handlowych jest także weryfikowana ilość towaru (zamiennika) na magazynie mobilnym.

Jeżeli ilość zamiennika na magazynie mobilnym wynosi 0 przy próbie dodania takiego towaru (zamiennika) do Koszyka należy wyświetlać standardowy toast o treści: „Brak towaru na magazynie”.
dostępna jest pewna ilość zamiennika, jednak mniejsza niż ta wynikająca z przelicznika. W takiej sytuacji ustawiona zostanie maksymalna dostępna ilość przelicznika oraz wyświetlony komunikat:

Komunikat wyświetlany jeśli ilość zamiennika jest niewystarczająca

W przypadku dokumentów WM oraz MMW, dla których standardowo nie jest podnoszona duża kalkulacja (duża kalkulacja tylko jeśli na towarze włączona obsługa cech) dla takich dokumentów opcja zamień jest dostępna tylko z poziomu:

Menu kontekstowego na liście towarów,
Menu kontekstowego towarów dodanych do koszyka.

Zamienniki na WKA/WKK

Zamienniki na dokumentach WKA są obsługiwane analogicznie jak na dokumentach handlowych. Na liście zamienników prezentowane są tylko takie, które:

Są kaucjami,
udostępnione są na dokumentach przychodowych.

W przypadku automatycznego generowania kaucji do dokumentów handlowych lub dokumentu MMW:

jest możliwa zamiana kaucji, która została dodana do koszyka automatycznie na zamiennik.
Jeżeli kaucja została automatycznie naliczona (dodana do koszyka kaucji) a następnie został zamieniony towar, do którego kaucja się naliczyła kaucja zostanie usunięta (jeżeli zamiennikowi nie przysługuje kaucja) lub odpowiednio przeliczona jeżeli obowiązuje inna kaucja lub ta sama ale w innej ilości.

W przypadku dokumentów WKK zamiana kaucji na zamiennik powinna być możliwa tylko w przypadku zwrotów wykonywanych „ręcznie” tj. niezwiązanych z dokumentami WKA. Na liście zamienników powinny być dostępne tylko takie, które:

Są kaucjami,
udostępnione są na dokumentach przychodowych.

W przypadku zwrotów kaucji, możliwość zamiany kaucji na zamiennik powinna być możliwa z poziomu:

Kalkulacji zbiorczej kaucji – opcja zamień dostępna tylko dla pozycji niezwiązanych z dokumentem WKA,
Kalkulacji pozycji WKK niezwiązanej z dokumentem WKA – opcje dodatkowe,
Z poziomu dokumentu WKK (analogicznie jak w przypadku innych dokumentów) – opcje dodatkowe z poziomu widoku listy towarów (kaucji) oraz koszyka

Możliwość zamiany kaucji, która nie jest związana z dokumentem WKA

Uwaga

Jeżeli powielanie pozycji na definicji dokumentu zostało wyłączone, wówczas nie ma możliwości zamiany towaru na zamiennik, który jest już w koszyku. W takiej sytuacji po wybraniu zamiennika z listy nie podnosi się jego kalkulacja, wyświetla się informacja o treści: „Towar znajduje się już w koszyku”

Integracja Comarch Mobile z KSeF

Artykuł opisuje zmiany w aplikacji Comarch Mobile związane z korzystaniem z Krajowego Systemu e-Faktur (KSeF), który daje możliwość wystawiania faktur ustrukturyzowanych, jako jednej z dopuszczanych form dokumentowania transakcji obok faktur papierowych i obecnie występujących w obrocie gospodarczym faktur elektronicznych. Faktury ustrukturyzowane to faktury wystawiane przez podatników za pośrednictwem systemu teleinformatycznego (KSeF) oznaczone przydzielonym numerem identyfikującym fakturę w tym systemie. Otrzymywanie faktur ustrukturyzowanych przy użyciu KSeF będzie wymagało akceptacji odbiorcy takiej faktury. W sytuacji gdy odbiorca faktury ustrukturyzowanej nie wyrazi zgody na jej otrzymanie przy użyciu KSeF, wystawca zachowa prawo do wystawienia faktury ustrukturyzowanej w systemie, a wystawioną w ten sposób fakturę będzie zobowiązany przekazać odbiorcy w inny uzgodniony z nim sposób. W przypadku, gdy wystawca faktury w momencie tworzenia dokumentu i przekazywania go odbiorcy nie skorzysta z KSeF nie będzie miał już możliwości procesowania faktury za pośrednictwem KSeF. Konfiguracja systemu ERP XL na potrzeby obsługi Krajowego Systemu Obsługi e-Faktur została opisana TUTAJ.

Warunki konieczne w celu wysłania faktury z Comarch Mobile do KSeF

Na potrzeby integracji i obsługi wysyłki faktur bezpośrednio z Comarch Mobile do KSeF należy: 1. Na definicji dokumentu Faktury sprzedaży z poziomu [Edycji struktury firmy] centrum mobilnego w sekcji Wysyłanie dokumentu do KSeF zaznaczyć jeden z dwóch poniższych parametrów:

Konfiguracja KSeF na definicji dokumentu FS

- Wysyłaj,
- Zależnie od kontrahenta, wówczas dodatkowo zaznaczyć parametr Wysyłaj dokumenty do KSeF na karcie kontrahenta na zakładce Księgowe w sekcji KSeF/Sprzedaż.
  Konfiguracja KSeF na karcie kontrahenta

Uwaga

W Comarch Mobile wysyłka dokumentów odbywa się automatycznie i każda faktura będzie weryfikowana przed zatwierdzeniem. Nie jest wymagane zaznaczenie parametru Automatycznie podczas zatwierdzania.

2. Na karcie operatora na zakładce Parametry/Uprawnienia w sekcji KSEF zaznaczyć parametr Wysyłanie faktur/Pobieranie UPO.

3. W pliku konfiguracyjnym [configuration.xl2024.statement] w folderze [Methods] włączyć parametr [SendToKSeF] (Lokalizacja pliku C:\Program Files (x86)\Comarch Mobile\Serwer synchronizacji\Methods\configuration). Domyślna wartość parametru to „0”, która blokuje możliwość wysyłania dokumentów. Zmiana parametru na „1” odnosić będzie się do wszystkich operatorów mobilnych i umożliwi wysyłanie faktur do KSeF. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Uwaga

Jeżeli parametr SendToKSeF w pliku konfiguracyjnym będzie wyłączony, a pozostałe parametry w ERP XL będą zaznaczone, wówczas dokument nie będzie wysyłany z Comarch Mobile do KSeF.

Uwaga

Jeżeli parametr Zależnie od kontrahenta na definicji dokumentu Faktury sprzedaży jest włączony oraz na karcie kontrahenta są zaznaczone oba parametry: Wysyłaj dokumenty do KSeF oraz Poza systemem, wówczas dokument nie będzie wysyłany z Comarch Mobile do KSeF, ponieważ będzie to obsłużone poza systemem ERP i Comarch Mobile.

Uwaga

Jeżeli parametr Wysyłanie faktur/Pobieranie UPO na karcie operatora będzie włączony, ale nie będą włączone pozostałe parametry, to faktura z Comarch Mobile nie będzie mogła być zatwierdzona z powodu braku wysyłki do KSeF.

Zmiany funkcjonalne w aplikacji Comarch Mobile dotyczące obsługi KSeF

Parametr „Wysyłaj dokumenty do KSeF” na karcie kontrahenta

Parametr „Wysyłaj dokumenty do KSeF” jest widoczny na karcie kontrahenta:

Karta kontrahenta bez obsługi KSeF oraz z obsługą KSeF

Zmiany na liście dokumentów w Comarch Mobile

Na liście dokumentów umożliwiono wyświetlanie dodatkowych informacji o statusie KSeF dla faktur sprzedaży. To, czy informacje mają być widoczne na liście zależy od użytkownika aplikacji. Konfiguracja dostępna jest w ustawieniach aplikacji, gdzie dodano w sekcji Parametry aplikacji nową opcję Ustawienia listy dokumentów. Po wejściu tę opcję użytkownik będzie mógł włączyć lub wyłączyć możliwość wyświetlania statusów KSeF na liście dokumentów.

Zmiany na dokumencie faktury w Comarch Mobile

Wprowadzona została nowa zakładka KSeF na dokumencie faktury sprzedaży, dzięki której użytkownik ma możliwość podglądu dodatkowych informacji.

Opcja „Sprawdź poprawność KSeF”

Operacja sprawdzania poprawności w KSeF polega na wstępnym sprawdzeniu czy dany dokument zostałby uznany za poprawny gdyby w tej chwili został przesłany do KSeF. Podczas tej operacji następuje sprawdzenie, czy dokument zawiera wszystkie obowiązkowe informacje oraz czy format przekazanych informacji jest zgodny ze schematem e-faktury.

Uwaga

Merytoryczna poprawność faktury nie jest sprawdzana. Weryfikacja obejmuje tylko i wyłącznie poprawność semantyczną danych.

Sprawdzenie poprawności w Comarch Mobile odbywa się:

Automatycznie w momencie próby zatwierdzenia dokumentu,
W momencie wywołania akcji z poziomu menu kontekstowego dokumentu FS w buforze „Sprawdź poprawność w KSeF” na liście dokumentów,
W menu kontekstowym na podglądzie dokumentu.

Opcja sprawdzania poprawności KSeF z poziomu listy dokumentów i podglądu faktury

Jeżeli weryfikacja będzie pozytywna, wówczas wyświetlony zostaje komunikat: „Dokument [numer dokumentu] jest zgodny ze strukturą e-faktury” Jeżeli weryfikacja nie będzie pozytywna, wówczas wyświetlony zostaje komunikat: „Dokument [numer dokumentu] jest niezgodny ze strukturą e-faktury"

Eksport faktury do KSeF

W Comarch Mobile wysyłka dokumentów do KSeF odbywa się automatycznie i każda faktura będzie weryfikowana przed zatwierdzeniem, o czym użytkownik zostaje poinformowany odpowiednim komunikatem.

Komunikat informacyjny po zatwierdzeniu faktury wysłanej automatycznie do KSeF

Uwaga

Jeżeli eksport dokumentu do KSeF nie powiedzie się, wówczas użytkownik poinformowany odpowiednim komunikatem, a dokument faktury sprzedaży zostanie zapisany do bufora.

Opcja "Pobierz UPO"

Wysłanie faktury do KSeF nie zawsze jest jednoznaczne z tym, że faktura została wystawiona. Aby dokument mógł być nazywany fakturą ustrukturyzowaną, musi posiadać specjalny numer identyfikujący tę fakturę w systemie KSeF. Numer ten nadawany jest przez KSeF w momencie przetworzenia dokumentu, co potwierdzane jest w formie dokumentu UPO, czyli urzędowego poświadczenia odbioru faktury. Obecnie każdy z systemów ERP, w tym Comarch Mobile pobiera UPO jedynie na żądanie operatora. Opcja „Pobierz UPO” prezentowana jest w Comarch Mobile z poziomu menu kontekstowego dokumentu FS oraz w menu kontekstowym na podglądzie dokumentu tylko i wyłącznie wtedy, gdy:

Status dokumentu w KSeF to „Wysłano/Nie odebrano UPO”
Dokument został wystawiony przez zalogowanego w Comarch Mobile operatora
Operator ma nadane uprawnienie do wysyłania dokumentów do KSeF/Pobierania UPO

Opcja Pobierz UPO z poziomu listy dokumentów i podglądu faktury

Jeżeli uda się pobrać UPO, wówczas w aplikacji zostanie wyświetlony odpowiedni komunikat.

Uwaga

Po pobraniu UPO opcja „Pobierz UPO” nie będzie już dostępna dla danego dokumentu.

Może wystąpić sytuacja, w której UPO nie będzie jeszcze gotowe w systemie KSeF w związku z czym nie będzie możliwości pobrania go do Comarch Mobile. W takim wypadku zostanie wyświetlony odpowiedni komunikat: „Nie udało się pobrać UPO. UPO nie jest jeszcze gotowe.”

Kolorowanie towarów w aplikacji

W aplikacji Comarch Mobile, analogicznie jak w systemie Comarch ERP XL, istnieje możliwość kolorowania towarów ze względu na ich rodzaj. Aby dany rodzaj towarów został pokolorowany w Comarch Mobile należy w systemie Comarch ERP XL, w module [Administrator] wybrać z menu pozycję: Listy\Słowniki kategorii\Inne\Rodzaje towarów i przypisać odpowiedni kolor do danego rodzaju towaru.

Przypisywanie koloru do rodzaju towaru w systemie Comarch ERP XL

Karta towaru z oznaczonym rodzajem towaru

Po wykonaniu synchronizacji towary dostępne w aplikacji zostaną oznaczone na liście towarów odpowiednim kolorem. Co więcej, przed nazwą i kodem każdego pokolorowanego towaru będzie widoczny rodzaj towaru.

Dostępność jednostek pomocniczych w aplikacji

Istnieje możliwość określenia jednostki domyślnej przy sprzedaży oraz jednostek pomocniczych dostępnych w aplikacji Comarch Mobile. Odpowiednie ustawienie znajduje się na karcie towaru w zakładce: [Jednostki i kody/ Definicja jednostki pomocniczej]. Aby dana jednostka pomocnicza była dostępna w aplikacji Comarch Mobile należy zaznaczyć parametr [Dostępność w aplikacji: Mobile Sprzedaż]. Aby dana jednostka pomocnicza była jednostką domyślną przy sprzedaży w aplikacji Comarch Mobile należy zaznaczyć parametr [Dostępność w aplikacji: Domyślna].

Ustawianie jednostki dostępnej w aplikacji i domyślnej do sprzedaży

Widoczność zdjęć towarów w aplikacji

Aby zdjęcia dodane do kartotek towarowych systemu Comarch ERP XL były widoczne w aplikacji Comarch Mobile należy na zakładce [Załączniki] zaznaczyć poniższą opcję.

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 synchronizacji Comarch Mobile odnaleźć plik articlesphotos.configuration i go wyedytować w notatniku, podając długość dłuższej krawędzi zdjęcia.

W pliku articlesphotos.configuration znajdującym się domyślnie w folderze: C:\Program Files (x86)\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 w bazie systemu ERP znajduje się duża liczba załączników w wysokiej rozdzielczości, to zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania podczas 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 w bazie systemu ERP znajduje się duża liczba nieskompresowanych załączników, to zmiana parametru może skutkować znacznym zwiększeniem rozmiaru paczki do pobrania podczas 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 tego trybu może skutkować wzrostem obciążenia CPU, szczególnie w momencie wykonywania pierwszej synchronizacji załączników jednocześnie przez kilku operatorów.

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

Karty kontrahenta
Karty towaru
Nagłówka dokumentów
Pozycji dokumentów niektórych dokumentów. Więcej informacji znajduje się TUTAJ.

Szczegółowy opis funkcjonalności znajduje się TUTAJ.

Obsługa cech

Spis treści

Ustawienia wymagalności cech podczas rejestracji dokumentów

Aplikacja Comarch Mobile Sprzedaż obsługuje cechy towarów. W przypadku prezentacji zasobów z rozbiciem na partie prezentowane są Cechy towaru, Daty ważności oraz Kody EAN partii. Aplikacja umożliwia obsługę cech na dokumentach ZS, OS, PA, FS, WZ, RLS, RW, MMW, WM, WKA, WKK, MMP. Warunkiem jest przypisanie domyślnej cechy na towarze oraz prawidłowe ustawienie wartości parametrów opisanych poniżej.

Jeżeli w aplikacji ustawiony został parametr: Używaj elementu skróconego (więcej informacji TUTAJ) dla towarów z włączoną obsługą cech, dla których wskazanie cechy zostało określone jako wymagane pomijany jest element małej kalkulacji i od razu wyświetla się okno dużej kalkulacji.

Uwaga

Powyższa informacja dot. tylko dokumentów: ZS, WZ, FS, PAR

Do obsługi tej funkcjonalności wymagane są następujące parametry:

[IsItemsFeaturesEnabled] – parametr działa globalnie, domyślnie przyjmuje wartość 1, odpowiada za obsługę cech na wszystkich towarach. Dodatkowo w Comarch ERP XL na zakładce [Aplikacje] należy zaznaczyć znacznik [Wysyłanie partii], w innym przypadku pomimo włączenia parametru [IsItemsFeaturesEnabled] cechy na towarze nie będą obsługiwane. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Parametr na karcie towaru – czy partie towaru mają być wyświetlane w aplikacji

Informacja o zasobach danego towaru w Comarch ERP XL dostępna jest na karcie towaru, po przejściu na zakładkę: Zasoby/Wg położenia. Jeśli nie jest zaznaczona [Data ważności] na towarze, to nie ma możliwości określenia jej na dużej kalkulacji, pomimo posiadania zasobów z datą.

Informacja o zasobach danego towaru z rozbiciem na partie

[IsFeaturesOnComplaintEnabled] – parametr dotychczas nieobsługiwany w aplikacji, dotyczący możliwości określenia cechy towaru podczas rejestrowania dokumentu RLS. Jeśli RLS jest powiązany z dokumentem handlowym, to cecha jest pobierana z tego dokumentu. Więcej informacji nt. tego parametru znajduje się TUTAJ.
[CanAddValuesToOpenList] – parametr odpowiedzialny za to, czy użytkownicy powinni mieć możliwość dodawania wartości do listy otwartej. Na liście cech, na ostatniej pozycji pojawia się opcja plusika, po wprowadzeniu wartości zostaje ona dodana do listy. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Definiowanie cech i ich wartości w module Sprzedaż, z poziomu menu: Listy/Cechy

Ustawienia wymagalności cech podczas rejestracji dokumentów

W Comarch ERP XL na karcie towaru, w sekcji Inne dostępna jest opcja: [Przy sprzedaży] określająca sposób rejestrowania cech towaru przy jego sprzedaży.

Uwaga

Parametr dotyczy obsługi FS, PA, WZ, ZS.

Nie wymagaj: Określenie cechy towaru nie jest wymagane, użytkownik może zapisać pozycję bez podania cechy.
Zarejestruj: Określenie cechy towaru jest wymagane, domyślnie nie jest ustawiana żadna wartość cechy. Przy zapisie pozycji, jeśli cecha nie zostanie określona, to powinien zostać wyświetlony odpowiedni komunikat.
Z listy: Określenie cechy towaru jest wymagane, domyślnie nie jest ustawiana żadna wartość cechy. Przy zapisie pozycji, jeśli cecha nie zostanie określona, to powinien zostać wyświetlony odpowiedni komunikat.
Z zasobu: Określenie cechy towaru powinno być wymagane, domyślnie należy ustawiać cechę z zasobu.

Ustawienia dotyczące sposobu rejestrowania cech towaru podczas sprzedaży

W aplikacji mobilnej na karcie towaru po wejściu w sekcję Stany/W centrali i/lub U mnie, następnie w wybrany magazyn są wyświetlane stany z rozbiciem na poszczególne partie. Jeżeli partie towaru opatrzone są Datą ważności i/lub kodem EAN, to takie informacje także będą prezentowane.

Ilość danego zasobu (danej partii) wyświetlana jest w jednostce domyślnej towaru. Istnieje również możliwość filtrowania po wszystkich parametrach wskazanych na partii, tj. cecha, data ważności, więcej informacji nt. temat znajduje się TUTAJ.

Wyświetlanie/ukrywanie informacji o stanach magazynowych

Istnieje możliwość wyboru wyświetlenia lub ukrycia informacji o stanach magazynowych w centrali.

Uwaga

W folderze [Methods], w pliku konfiguracyjnym [configuration.xl.statement] znajduje się parametr odpowiedzialny za tę funkcjonalność: [IsHeadquarterStocksVisible]. Domyślna wartość parametru to „1” i oznacza, że informacje o stanach magazynowych są widoczne na urządzeniu mobilnym. Zmiana tego parametru w pliku konfiguracyjnym odnosić będzie się do wszystkich operatorów mobilnych. Więcej informacji nt. tego parametru znajduje się TUTAJ

W przypadku chęci ukrycia stanów magazynowych konkretnemu operatorowi należy w systemie Comarch ERP XL na karcie operatora w zakładce Atrybuty utworzyć atrybut: ‘Czy widzi stany magazynowe’ o Typie: Flaga i ustawić jego wartość na 'NIE'.

Atrybut: ‘Czy widzi stany magazynowe’ do ukrywania widoczności stanów magazynowych konkretnym operatorom

Uzupełniony atrybut 'Czy widzi stany magazynowe' na karcie operatora

Wyświetlanie procentu rabatu na liście towarów

Za opcję wyświetlania procentu rabatu na liście towarów odpowiada parametr [IsDiscountVisible]. Więcej informacji nt. tego parametru znajduje się TUTAJ.

Ustawienia aplikacji – dodatkowy parametr [Obliczaj hipotetyczny rabat]

Dostępność kartotek towarowych w aplikacji

Aby kartoteki z wybranej grupy towarowej były widoczne w aplikacji Comarch Mobile należy w zakładce Aplikacje na karcie towaru zaznaczyć opcję [Dostępny w: Comarch Mobile]. Po zaznaczeniu pola i wykonaniu synchronizacji towar będzie widoczny na urządzeniu mobilnym.

Dostępność kartoteki towarowej w aplikacji

Dostępność można oznaczyć również dla wszystkich kart towarowych znajdujących się w grupie. Odbywa się to poprzez edycje wzorca grupy i zaznaczenie opcji [Dostępny w: Comarch Mobile] na zakładce [Aplikacje]. W pierwszej kolejności należy zaznaczyć pole: [Dostępny w: Comarch Mobile]. Aby nowododane do grupy lub jej podgrup towary miały automatycznie zaznaczoną dostępność w Mobile Sprzedaż trzeba również zaznaczyć opcję [Aktualizacja wzorców] i wybrać [Zmienione pola].

Ustawianie dostępności kartotek towarowych na wzorcu grupy

Uwaga

Aby karta towaru była dostępna w aplikacji Comarch Mobile Sprzedaż, oprócz zaznaczenia opcji dostępności kartoteki w Comarch Mobile w systemie Comarch ERP XL, należy również przypiąć odpowiednią grupę towarową w konfiguracji centrum mobilnego.

Uwaga

Aplikacja Comarch Mobile Sprzedaż nie obsługuje zestawów towarowych.

Obsługa zamienników

Spis treści

Dodawanie zamiennika w systemie ERP Rodzaje zamienników

Dodawanie zamiennika w systemie ERP

W celu prawidłowej konfiguracji zamiennika należy określić w systemie ERP:

Kod zamiennika,
Rodzaj zamiennika (Jednostronny, Obustronny, Równoważny wszystkim),
Ile zamiennika (np. T2) przysługuje danej ilości towaru podstawowego (np. T1) (wyrażone w jednostkach podstawowych obydwu towarów),
Na jakich dokumentach ma być dostępny zamiennik (Rozchodowe, Przychodowe),
Miejsce w strukturze firmy – wskazać należy odpowiedni Oddział mobilny, jeśli zamiennik ma być dostępny w aplikacji.

Konfiguracja zamiennika w Comarch ERP XL

W konfiguracji oddziału mobilnego w Comarch ERP XL należy zaznaczyć check: „Wysyłaj informacje o zamiennikach towarów”.

Check: „Wysyłaj informacje o zamiennikach towarów” w konfiguracji oddziału mobilnego.

Pobranie zamienników do Comarch Mobile wymaga:

Włączenia pobierania zamienników dla oddziału mobilnego,
Udostępnienia w Comarch Mobile towaru będącego zamiennikiem,
Wskazanie na karcie zamiennika, na zakładce: Miejsca w strukturze firmy, centrum mobilnego do którego należy operator zalogowany w aplikacji.

Rodzaje zamienników

Zamiennik Jednostronny – jeśli dla towaru T1 został określony zamiennik T2 będzie to oznaczało, że:
- Na karcie towaru T1 będzie widoczny zamiennik T2,
- Na karcie towaru T2 nie będzie widoczny zamiennik T1,
- Jeżeli na dokumencie zostanie wybrany towar T1, będzie można zamienić go na T2,
- Jeżeli na dokumencie zostanie wybrany towar T2, nie będzie można zamienić go na T1.
Zamiennik Obustronny – jeżeli dla towaru T1 został określony zamiennik obustronny T2 i do towaru T2 zdefiniowany zamiennik obustronny T3, będzie to oznaczało, że:
- Na karcie towaru T1 będzie widoczny zamiennik T2, ale nie będzie widać zamiennika T3,
- Na karcie towaru T2 będą widoczne zamienniki: T1 i T3,
- Na karcie towaru T3 będzie widoczny zamiennik T2, ale nie będzie widoczny zamiennik T1,
- Jeżeli na dokumencie zostanie wybrany towar T1, będzie można zamienić go na T2, ale nie na T3,
- Jeżeli na dokumencie zostanie wybrany towar T2, będzie można zamienić go na T1 lub T3,
- Jeżeli na dokumencie zostanie wybrany towar T3, będzie można zamienić go na T2, ale nie na T1.
Równoważny wszystkim – jeżeli dla towaru T1 zostanie określony zamiennik równoważny T2 i do towaru T2 zostanie zdefiniowany zamiennik równoważny T3, będzie to oznaczało, że:
- Na karcie towaru T1 będą widoczne zamienniki: T2 i T3,
- Na karcie towaru T2 będą widoczne zamienniki: T1 i T3,
- Na karcie towaru T3 będą widoczne zamienniki: T1 i T2,
- Jeżeli na dokumencie zostanie wybrany towar T1, będzie można zamienić go na T2 lub na T3,
- Jeżeli na dokumencie zostanie wybrany towar T2, będzie można zamienić go na T1 lub na T3,
- Jeżeli na dokumencie zostanie wybrany towar T3, będzie można zamienić go na T1 lub na T2.

Typy dokumentów, dla których obsłużono zamienniki:

Zamówienie Sprzedaży (ZS),
Oferta Sprzedaży (OS),
Faktura Sprzedaży (FS),
Paragon (PA),
Wydanie Zewnętrzne (WZ),
Wydanie Magazynowe (WM),
Rozchód Wewnętrzny (RW),
Przesunięcie Międzymagazynowe (MMW),
Wydanie Kaucji (WKA),
Korekta Wydania Kaucji (WKK).

Precyzja cen w aplikacji mobilnej

W aplikacji Comarch Mobile 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 miejscami 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 istniała możliwość prezentacji towaru na karcie towaru z precyzją do dwóch lub do czterech miejsc po przecinku. W systemie Comarch ERP XL w module [Administrator] należy zaznaczyć precyzję na typie ceny.

Zaznaczenie opcji [Cena z dokładnością do groszy] spowoduje wyświetlanie cen z dokładnością do dwóch miejsc po przecinku (standardowe działanie aplikacji), natomiast odznaczenie parametru spowoduje wyświetlanie cen z dokładnością do czterech miejsc po przecinku.

Dodatkowo istnieje możliwość ustawienia precyzji ceny na definicji dokumentu na centrum operatora.

Zaznaczenie opcji [Cena z dokładnością do groszy] spowoduje wyświetlanie cen z dokładnością do dwóch miejsc po przecinku (standardowe działanie aplikacji), natomiast odznaczenie parametru spowoduje wyświetlanie cen z dokładnością 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.

Obsługa atrybutów

Istnieje możliwość pobierania i wypełniania atrybutów. Atrybuty w aplikacji Comarch Mobile prezentowane są w sekcji: [Informacje dodatkowe]. Atrybuty można wyświetlać jako klasy lub klasy w grupach. Obsługa atrybutów przy współpracy z systemem Comarch ERP XL

Typy obiektów	Funkcjonalność
Kontrahenci	Podgląd i edycja
Towary	Podgląd
Samochody	Podgląd
Nagłówki dokumentów	Podgląd i edycja
Pozycje dokumentów	Podgląd i edycja

Aby klasa atrybutu była widoczna w aplikacji mobilnej należy w definicji atrybutu wskazać obiekty na zakładce [Obiekty] oraz zaznaczyć parametr [Podgląd] w grupie [Comarch Mobile] na zakładce [Ogólne]. Zaznaczenie parametru [Edycja] umożliwi dodatkowo edycję atrybutów na niektórych typach obiektów.

W aplikacji mobilnej obsługiwane są również flagi [Wymagany] oraz [Automat]. Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie ERP, to w aplikacji Comarch Mobile jest oznaczony znakiem

. W aplikacji obsługiwane są następujące typy atrybutów:

Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta w domyślnej przeglądarce na urządzeniu mobilnym

W aplikacji obsłużone zostały następujące formaty atrybutów:

Tekst
Data
1234
1234.56
1234.5678
Zaawansowany

Aby była możliwość wyświetlania atrybutów w grupach należy w systemie Comarch ERP XL na liście Atrybutów z poziomu zakładki [Grupy klas atrybutów] stworzyć odpowiednie grupy atrybutów:

oraz przypisać do stworzonej grupy obiekt, z którego poziomu ma być dostępna grupa atrybutów.

Następnie należy przypisać odpowiednie klasy atrybutów. Jedna klasa może być przypięta do kilku grup jednocześnie.

Definiowania wielu cen tego samego rodzaju, określania dat i godzin obowiązywania cenników oraz różnych statusów cenników

Istnieje możliwość definiowania dla towaru wielu cen tego samego rodzaju, określania dat i godzin obowiązywania cenników oraz różnych statusów cenników (niepotwierdzonych, zatwierdzonych oraz anulowanych).

Na karcie i liście towarów prezentowana jest cena wybrana, jako domyślna w konfiguracji centrum mobilnym.

Dostępne rodzaje cen i domyślna cena na centrum mobilnym przedstawiciela

Prezentacja cen sprzedaży na karcie towaru

Widoczność cen zakupu

Na karcie operatora można określić widoczność cen zakupu towarów oraz wysokość marży na elemencie lub dokumencie. Decyduje o tym opcja [Widzi ceny zakupu], znajdująca się na karcie operatora w zakładce [Parametry/Handlowe].

Obsługa atrybutów

Istnieje możliwość pobierania i wypełniania atrybutów. Atrybuty w aplikacji Comarch Mobile prezentowane są w sekcji: [Informacje dodatkowe]. Atrybuty można wyświetlać jako klasy lub klasy w grupach. Obsługa atrybutów przy współpracy z systemem Comarch ERP XL

Typy obiektów	Funkcjonalność
Kontrahenci	Podgląd i edycja
Towary	Podgląd
Samochody	Podgląd
Nagłówki dokumentów	Podgląd i edycja
Pozycje dokumentów	Podgląd i edycja

Aby klasa atrybutu była widoczna w aplikacji mobilnej należy w definicji atrybutu wskazać obiekty na zakładce [Obiekty] oraz zaznaczyć parametr [Podgląd] w grupie [Comarch Mobile] na zakładce [Ogólne]. Zaznaczenie parametru [Edycja] umożliwi dodatkowo edycję atrybutów na niektórych typach obiektów.

W aplikacji mobilnej obsługiwane są również flagi [Wymagany] oraz [Automat]. Jeżeli dany atrybut jest oznaczony jako Wymagany w systemie ERP, to w aplikacji Comarch Mobile jest oznaczony znakiem

. W aplikacji obsługiwane są następujące typy atrybutów:

Flaga
Tekst
Liczba
Lista
Adres URL – w przypadku wskazania adresu strony internetowej, po naciśnięciu przycisku strona zostanie otwarta w domyślnej przeglądarce na urządzeniu mobilnym

W aplikacji obsłużone zostały następujące formaty atrybutów:

Tekst
Data
1234
1234.56
1234.5678
Zaawansowany

Aby była możliwość wyświetlania atrybutów w grupach należy w systemie Comarch ERP XL na liście Atrybutów z poziomu zakładki [Grupy klas atrybutów] stworzyć odpowiednie grupy atrybutów:

oraz przypisać do stworzonej grupy obiekt, z którego poziomu ma być dostępna grupa atrybutów.

Następnie należy przypisać odpowiednie klasy atrybutów. Jedna klasa może być przypięta do kilku grup jednocześnie.

Stany magazynowe pomniejszone o rezerwacje

W aplikacji Comarch Mobile Sprzedaż standardowo wyświetlane są stany magazynów centralnych, które nie uwzględniają rezerwacji towarów. Istnieje możliwość wyświetlania stanów magazynowych pomniejszonych o rezerwacje oraz wyświetlanie stanów zarezerwowanych. W tym celu konieczne jest ustawienie wartości 1 dla parametru StockLevelsLessReservation. Parametr ten opisany jest szczegółowo w dokumentacji dostępnej TUTAJ. Po włączeniu parametru widoczne będą dwie wartości stanów magazynowych towaru. Stany widoczne będą we wszystkich miejscach w aplikacji, w których widoczne były do tej pory, w tym podczas wystawiania dokumentów na magazyn centralny, z wyłączeniem Zleceń Serwisowych. Przykładowe stany magazynowe:

318 szt. (dost.) - ilość towaru dostępna tj. ilość pomniejszona o rezerwacje
100 szt. (rez.) - ilość zarezerwowana

Suma powyższych wartości jest rzeczywistą ilością towaru znajdującą się na magazynie.

Stany magazynowe pomniejszone o rezerwacje i stany zarezerwowane widoczne na liście towarów

Dodatkowo w aplikacji pojawi się opcja szybkiej synchronizacji stanów magazynowych w menu kontekstowym listy towarów oraz menu kontekstowym towaru na liście towarów.

W filtrze Stan dostępnym na liście towarów pojawi sie również dodatkowa opcja wyszukiwania Zarezerwowane.

Konfiguracja funkcjonalności

Parametry

Kontrahenci

Kontrahenci

Dokumenty

Nagłówek dokumentu

Działania

Promocje

Inne

Ukrywanie i zmiana kolejności elementów w aplikacji

Rozszerzalność aplikacji

Ukrywanie cen oraz wartości towarów w kafelku Towary i na konkretnych dokumentach

Dodawanie niestandardowego filtra do listy

Dodawanie filtra

Usuwanie filtra

Elementy składowe filtra

Przykład

Raporty

Edycja raportów

Konfiguracja raportów prowizji

Elementy składowe

Nagłówek

Typ raportu

Kolejność raportów

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

Wydruk termiczny

Układ wydruku

Elementy - wydruk do pdf

Elementy - wydruk termiczny

Wygląd wydruku

Wydruk do pdf

Atrybuty zawężające

Selektory

Reguły

Przykłady wydruków fiskalnych

Przykłady wydruków termicznych

Przykłady modyfikacji wydruków do pdf

Dodawanie kolumny

Zmiana kolorystyki

Dodawanie/usuwanie/zmiana logo

Dodanie nowych danych na wydruk

Przykłady modyfikacji wydruków termicznych

Usunięcie tabeli i przesunięcie tekstu

Dodanie nowych danych na wydruk

Kasa

Automatyczna zapłata

Kontrahenci

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 XL

Wyświetlanie limitu kredytowego do wykorzystania przez kontrahenta

Przypisanie grupy towarów oraz magazynów do kontrahenta

Wyświetlanie waluty na karcie kontrahenta

Określenie rodzajów kontrahentów na wzorcu wizyty

Kolorowanie kontrahentów

Konfiguracja limitu kredytowego kontrahenta

Konfiguracja koncesji

Prawo do edycji kontrahenta

Wystawianie zamówień sprzedaży pomimo wstrzymanych transakcji dla kontrahenta

Blokada realizacji działań handlowych dla nowo utworzonego kontrahenta

Określenie wymaganych pól podczas rejestracji lub edycji kontrahenta

Obsługa atrybutów

Atrybut okresowy