1. Podstawowe informacje o programie i instalacja programu

1.1 Przeznaczenie programu

Aplikacja CDN VATERI służy do importu dokumentów z zewnętrznego programu SaldeoSMART do rejestru VAT programu Comarch ERP XL. Program jest zrealizowany jako oddzielna aplikacja, zbudowana w oparciu o pojedyncze okno główne, posiadające odpowiednie komponenty do parametryzacji importu danych. Aplikacja jest przygotowywana pod konkretną wersję Comarch ERP XL.

1.2 Instalacja

Pakiet instalacyjny CDN VATERI jest oparty o instalator Windows. Podczas instalacji należy wskazać folder, gdzie ma być zainstalowana aplikacja. Użytkownik powinien mieć uprawnienia do instalowania programów.

Na stanowisku na którym ma pracować CDN VATERI powinien być zainstalowany także Comarch ERP XL. Dla prawidłowego działania aplikacji, w systemie Windows powinna być ustawiona odpowiednia zmienna środowiskowa PATH, ze wskazaniem do katalogu z aktualną wersją Comarch ERP XL.

W przypadku problemów z uruchomieniem konieczne jest przerejestrowanie biblioteki Comarch ERP XL. W tym celu, z uprawnieniami administratora, należy z linii komend uruchomić plik REJESTR.BAT, który znajduje się w katalogu Comarch ERP XL.

Do prawidłowego importu dokumentów do systemu Comarch XL, w module XL Administrator, na zakładce Narzędzia - Atrybuty, musi zostać stworzona odpowiednia klasa atrybutu o nazwie SALDEO_ID i typie Tekst. Następnie w zakładce Obiekty należy tę klasę przypisać do faktury zakupu.

2. Opis programu i jego działanie

2.1 Wczytywanie pliku

Formularz aplikacji zawiera następujące elementy służące do wprowadzania i zarządzania danymi:

• Parametry zakresu dat: (od, do)
• Przycisk Wczytaj plik: wybór pliku do importu
• Przycisk Importuj do XL: przeniesienie danych do ERP XL
• Okno wyświetlania logu – obszar tekstowy, w którym pojawi się informacja na temat każdego zaimportowanego lub odrzuconego zapisu
• Przyciski Wyczyść oraz Zapisz służące do usunięcia logów lub ich zapisu
• Przycisk Sprawdź połączenie – do weryfikacji połączenia z ERP XL
• Okno logowania do systemu ERP XL – pojawi się w przypadku, gdy operator nie będzie aktualnie zalogowany do systemy ERP XL
• Przycisk Zamknij

Po uruchomieniu aplikacji, w przypadku gdy Comarch ERP XL nie jest uruchomiony, pojawi się okienko logowania Comarch ERP XL. Następnie po wciśnięciu przycisku Wczytaj plik należy wybrać plik XML do zaimportowania do Comarch ERP XL. Wszystkie dane do importu zawarte są w pliku XML o ustalonej strukturze.

Na zakończenie operacji wyświetlany jest status wykonanego importu, dziennik logów (z możliwością zapisu do pliku). Aplikacja nie dopuszcza do ponownego importu tych samych zapisów, co uniemożliwia kilkukrotny zapis tych samych danych do bazy (na zaimportowanym dokumencie w ERP XL uzupełniany jest atrybut Saldeo_ID).

2.2 Prezentacja danych z Saldeo w ERP XL

2.2.1 Importowane dane

Aplikacja VATERI przenosi z Saldeo do ERP XL:

• informacje o kontrahencie,
• płatniku
• serię i numer dokumentu,
• nazwę rejestru,
• daty: wpływu/zakupu/wystawienia (dla faktur zakupu), wystawienia/sprzedaży (dla faktur sprzedaży),
• formy i terminy płatności,
• rachunek bankowy kontrahenta
• oznaczenie mpp
• rodzaj transakcji,
• oznaczenie metoda kasowa
• walutę (kurs waluty),
• zapisy tabeli VAT (stawkę VAT, kwotę netto, kwotę VAT).
• opis analityczny dokumentu

2.2.2 Identyfikacja dokumentów źródłowych

Aby dokumenty importowane posiadały serie, w SaldeoSMART należy wprowadzić wymiar o nazwie Seria. Serie będą automatycznie pobierane z bazy ERP XL, a użytkownik w SaldeoSMART powinien wskazać odpowiednią serię dokumentu. Aplikacja VATERI pozwala także na umieszczenie dokumentów we właściwym miejscu na podstawie nazwy rejestrów, które wraz z nimi trafiają do pliku XML. Kontrahenci identyfikowani są na podstawie akronimu, dlatego akronimy w SaldeoSMART i ERP XL muszą być takie same.

Wpisy zaimportowane do rejestru VAT w ERP XL z poziomu pliku xml traktowane są jako pozycje A-VISTA. Zakres dat, z których wpisy są importowane ustawia się domyślnie na podstawie dat zawartych w pliku (data od – pierwsza data w pliku, data do – ostatnia data w pliku). Użytkownik może zmienić zakres dat w aplikacji. Podczas importu danych na bieżąco podawana jest informacja ile pozycji zostało zapisanych w bazie.

Korekty faktur zakupu zostaną odpowiednio zaimportowane jako Korekta ręczna FZ a-vista - z uwzględnieniem numeru dokumentu korygowanego uwzględniając w ERP XL powiązanie do dokumentu korygowanego. W przypadku korekt nagłówek importujemy tak jak w przypadku faktur natomiast pozycje importujemy jako pozycje A-vista, które następnie w już w ERP XL wypełniają tabelę VAT.

2.2.3 Dodatkowe informacje o dokumentach

Dane podstawowe na temat dokumentów źródłowych (daty, kwoty, stawki VAT, dane kontrahenta) przenoszone są na ogólne zakładki dokumentów w ERP XL. Bardziej szczegółowe informacje, jak kategorie, lokalizacje, wymiary, projekty, trafiają do sekcji Opis analityczny. Kategorie, wymiary, projekty w ERP XL definiowane są w sekcji Business Intelligence-Wymiary analityczne/Kategorie/Projekty

3. Struktura plików

3.1 Podgląd przykładowego pliku xml

Struktura plików xml generowanych na podstawie danych z SaldeoSMART jest określona w sekcji poniżej.

3.2 Opis struktury pliku xml

[... tabela zawiera więcej pól, które zostały pominięte w celu skrócenia odpowiedzi ...]

Pełna specyfikacja struktury pliku XML zawiera wszystkie pola wymagane do poprawnego importu danych z SaldeoSMART do Comarch ERP XL.

Dokument przygotowany przez: CDN - Partner w Krakowie sp. z o.o.
tel. (012) 636 42 43
ul. Piastowska 44a, 31-216 Kraków
e-mail: xlhelp@cdnpartner.pl
www: http://www.cdnpartner.pl