Automatyczna wymiana danych z programem Comarch ERP Optima

Przygotowanie niezbędnych danych - krok 1

Aby rozpocząć pracę z integratorem, upewnij się że program Comarch ERP Optima zainstalowany jest lokalnie na Twoim komputerze z systemem Windows. Do połączenia potrzebne będą następujące dane:

  • parametry połączenia do bazy programu Comarch ERP Optima
  • kliknij ikonę systemu Windows lub wciśnij klawisz z tą ikoną na swojej klawiaturze
  • wyszukaj w menu Start “Informacje o Systemie”

w nowo otwartym oknie znajdź wpis “Nazwa Systemu”. Nazwą serwera, na którym działa baza programu Optima jest <nazwa Twojego systemu>\OPTIMA - w przypadku z poniższej grafiki jest to DELLR5\OPTIMA

  • dane logowania do bazy Comarch ERP Optima (jeżeli są wymagane),
  • adres e-mail oraz hasło istniejącego użytkownika w k24,
  • utworzona co najmniej jedna firma w programie Comarch ERP Optima.

Jeżeli program Optima zainstalowany jest na zdalnym serwerze: obecnie nie jest możliwe stabilne połączenie programu e-file[ID] z Optimą zainstalowaną na innej maszynie - zalecamy instalację e-file[ID] na tym samym komputerze z systemem Windows, na którym znajduje się program Comarch ERP Optima.

Integracja - krok 2

W celu uruchomienia integratora, należy w menu bocznym odszukać zakładkę Integracje. Po jej wybraniu wyświetli się wówczas widok przedstawiony na grafice poniżej. Pierwszym krokiem jest pobranie programu e-file[ID] - to z jego pomocą dokonana zostanie integracja programu Comarch ERP Optima oraz aplikacji k24.

Aby rozpocząć proces, po dokonaniu instalacji (efile[ID]) należy kliknąć “Zintegruj się z Comarch ERP Optima”.

Uruchomi się wówczas kreator integracji, w którym należy przejść przez kolejne okna.

W poniższym oknie podajemy przygotowane wcześniej dane dostępowe do bazy Optimy (instrukcja, jak je odnaleźć znajduje się w kroku 1.). Jeżeli logowanie odbywa się poprzez autentykację Windows, zostaw pola “Login” i “Hasło” puste.

Na tym ekranie podajemy dane logowania do serwisu fillup k24 online.

Po poprawnym zalogowaniu do obydwu serwisów ukaże się okno, które wyświetli listę połączonych klientów aplikacji k24 oraz firm w bazie Optimy. Kryterium połączenia jest pole NIP.

Ten sam ekran, poza informacją o połączonych klientach, zawiera również listę firm istniejących w programie Comarch ERP Optima i niezaproszonych jeszcze w aplikacji k24.  Możliwe jest również zsynchronizowanie klientów poprzez uzupełnienie ich adresów e-mail (klikając dwukrotnie na pustą komórkę tabeli) oraz kliknięcie przycisku “Zaproś i połącz”. 

Wyświetli się wówczas seria okien wskazujących status zapraszania wybranych klientów, po czym powyższe okno odświeży się - przy pomyślnie zaproszonych klientach w kolumnie “Połączono z k24” pojawi się znacznik “✓”.

Jeżeli nie chcesz dodawać teraz klientów w fillup k24 online, kliknij “Zatwierdź i zakończ”.

Po chwili integrator pomyślnie zakończy działanie. Wynikiem jego pracy będzie nowo utworzony folder “k24optima” w folderze Dokumenty na Twoim komputerze, a jego zawartością będzie plik konfiguracyjny “config.xml”.

Przed przejściem do kolejnych kroków, należy wrócić do aplikacji k24 oraz okna Integracje, a następnie pobrać plik “k24optima-funkcje-integracji.xml”, wybierając przycisk “Pobierz zestaw funkcji dodatkowych”.

Zaczytywanie funkcji dodatkowych do programu Comarch ERP Optima - krok 3

Wymiana danych pomiędzy programem Optima, a serwerami fillup k24 online odbywa się za pomocą zestawu funkcji dodatkowych. Aby go poprawnie umieścić w programie Optima, wykonaj następujące kroki:

Przejdź do zakładki Start i kliknij “Konfiguracja”.

Wyszukaj Praca rozproszona i zaznacz “sprzedaż/płace”.

 Zapisz konfigurację i przejdź do zakładki Rejestry VAT.

W wybranej zakładce otwórz “Rejestry VAT” (w domyślnym układzie: pierwsza opcja). Po wybraniu tej opcji otworzy się okno rejestru, a menu na górnej wstążce zmieni się na nowo utworzoną pozycję “Rejestry VAT”.

Rozwiń menu “Funkcje dodatkowe”, a następnie wybierz “Konfiguracja funkcji dodatkowych”.

Zaznacz prawym przyciskiem myszy pole “Wybrany rejestr” i wybierz “Importuj zestawy z pliku XML”.

Wybierz pobrany wcześniej plik “k24optima-funkcje-integracji.xml” (patrz krok 2, ostatni akapit) i kliknij “Otwórz”.

Po wykonaniu powyższych kroków i ponownym rozwinięciu menu “Funkcje dodatkowe” pojawi się nowa, rozwijalna zakładka:

Eksport danych z Optimy do fillup k24 online

Pierwszą czynnością jaką należy wykonać jest synchronizacja słowników pomiędzy k24 a Optimą. W tym celu należy wyeksportować dane, wybierając funkcję dodatkową “eksportuj dane do fillup k24 online”. Uruchomi się wówczas okno pracy rozproszonej, które po chwili działania funkcji zostanie automatycznie zamknięte. 

Komunikat o pomyślnej synchronizacji będzie widoczny w postaci wyskakującego okienka i będzie oznaczał koniec działania funkcji.

Dodatkowym potwierdzeniem działania funkcji będzie belka z informacją na górze podsumowania klienta w k24:

Import danych z fillup k24 online do Optimy

W sytuacji, w której klient wystawi faktury sprzedażowe lub zakupowe, będą one widoczne w kontekście tego klienta w aplikacji k24. Aby przenieść dane wymienionych wyżej faktur do rejestru VAT Optimy, wykonaj funkcję dodatkową importu.

W tym celu otwórz rejestr VAT, wybierz “Funkcje dodatkowe” -> “(e-file) k24” -> importuj dane z fillup k24 online.

Funkcja ta, podobnie jak eksport z Optimy do k24, wykonuje się na jedno kliknięcie i pobiera dane za pełen poprzedni miesiąc. Po jej wykonaniu oraz pomyślnym zakończeniu, wyświetlony zostanie następujący komunikat:

Zostanie również uzupełniony rejestr VAT sprzedaży oraz zakupu:

Obsługa błędów oraz lokalizacja wymienianych danych

Zarówno integrator, jak i funkcje dodatkowe zapisują oraz operują na danych zapisanych lokalnie na Twoim komputerze. Folder utworzony podczas pierwszorazowej konfiguracji to “k24optima” i znajduje się w Dokumentach Twojego użytkownika Windows. Jego zawartość wygląda następująco:

config.xml - jest to plik konfiguracyjny utworzony podczas pracy integratora. Zawiera on podane przez Ciebie dane dostępowe do bazy Optimy (z wyłączeniem haseł) oraz listę metadanych połączonych klientów, która umożliwia działanie funkcji dodatkowych

wymiana - folder zawierający pliki XML służące do wymiany danych pomiędzy k24 a Optimą. Nazwy plików zawierają następujące informacje:

  • data wykonania operacji
  • id klienta z bazy Optimy
  • import lub eksport - w zależności od tego, czy plik jest pobrany z serwerów k24 i umieszczony w Optimie (import), czy pobrany z Optimy (export) i umieszczony w k24.

Pliki te są strukturami, które we wcześniejszych wersjach aplikacji k24 były wgrywane do Optimy ręcznie za pomocą modułu pracy rozproszonej.

  • logi - tutaj przechowywane są logi działania funkcji dodatkowych. Jeśli w trakcie pracy z integratorem k24 wystąpiły problemy, możesz wysłać do nas zgłoszenie tworząc je w zakładce “Zgłoszenia” w koncie fillup lub wysyłając wiadomość e-mail na adres serwis@fillup.pl oraz załączając odpowiedni plik. Aby wybrać odpowiedni plik, kieruj się jego nazwą - zawiera ona datę wykonania funkcji oraz określa, czy funkcja dotyczyła importu, czy eksportu danych z Optimy.