Aplikacja konsolowa KontoX

Przykład

java -jar kontox_cli.jar -e demo@kontomierz.pl -p demo123

Download

kontox_cli.jar

Uruchamiaj wyłącznie na zaufanym komputerze

Użycie konsolowej wersji KontoXa powoduje (sanie na komput. Twojego hasła do Kontomierza (*).
Hasło do Kontomierza zabezpiecza (pośrednio szyfruje) Twoje hasła bankowe. Dlatego uruchamiaj konsolowy KontoX wyłącznie na własnym, dobrze zabezpieczonym komputerze.

Aby sprawdzić czy pobrany kontox_cli.jar jest autentyczny i pochodzi od Kontomierz.pl wykonaj komendę:
jarsigner -verify -verbose -certs sciezka/do/kontox_cli.jar

zostaną wypisane wszystkie podpisy aplikacji, w skrócie powinny być one wystawione przez "Kontomierz.pl Sp. z o.o.", a podpis Kontomierz.pl potwierdzony przez "VeriSign, Inc."

(*) np. w historii konsoli, lub (na życzenie) do pliku KATALOG_DOMOWY/.kontomierz/cli_credentials_to_kontomierz.save

Wymagania

Do uruchomienia programu wymagana jest Java 1.8.0_161+ ( Pobierz najnowszą Javę ) i oczywiście połączenie z internetem. Polecenie 'java' musi być dostępne z konsoli.

Konfiguracja

Po udanym połączeniu się z serwerem Kontomierz.pl nastąpi próba importu danych z banków. Do tego celu program potrzebuje listy banków oraz danych dostępowych. Dane te są zapisywane ( w postaci zaszyfrowanej ) do pliku z rozszerzeniem .kontomierz.save, który znajduje się w katalogu domowym użytkownika (uwaga: w przypadku systemów unix plik jest zapisywany w podkatalogu .kontomierz).

Plik ten jest tworzony w momencie pierwszego importu danych za pomoca narzędzia Java Applet. W związku z powyższym na początku wymagany jest import danych przez aplikację webową (tj. z poziomu przeglądarki internetowej).

Automatyzacja

Główną zaletą programu jest oczywiście jego postać. Fakt, że jest to jeden plik pozwala na jego szybkie uruchomienie w różnych konfiguracjach. Pod windowsem jako task Windows Schedulera, pod Linuxem task crona, pod OS X (Mac) jako natywna aplikacja skonwertowana za pomocą Jar Bundlera itp.

Przykłady użycia

Linux: Utwórz plik kontox.sh w katalogu domowym lub w utworzonym katalogu ~/kontox/.

W pliku kontox.sh wpisz:
cd sciezka/do/kontox/ &&
java -jar kontox_cli.jar -e demo@kontomierz.pl -p demo123

i po zapisaniu wykonaj polecenie chmod u+x kontox.sh.

Następnie wykonaj polecenie crontab -e i po wyborze edytora wpisz
0 3 * * * /sciezka/do/kontox.sh
Zapisanie zmian spowoduje uruchamianie skryptu codziennie o 3 rano. Oczywiście możliwe są inne konfiguracje.



Windows:
Utwórz plik kontox.bat w katalogu domowym lub w utworzonym katalogu katalog_domowy/kontox/.

W pliku kontox.bat wpisz:
cd sciezka\\do\\kontox_cli.jar
java -jar kontox_cli.jar -e demo@kontomierz.pl -p demo123

Po zapisaniu pliku należy zaplanować cykliczne uruchamianie skryptu.

Aby otworzyć narzędzie Zaplanowane zadania, kliknij przycisk Start, kliknij polecenie Wszystkie programy, wskaż polecenie Akcesoria, wskaż polecenie Narzędzia systemowe, a następnie kliknij polecenie Zaplanowane zadania. Dodaj zaplanowane zadanie i z listy programów wybierz skrypt kontox.bat. Określ częstotliwość oraz informacje dotyczące dnia i godziny uruchomienia skryptu.



Mac OS X:
Utwórz plik kontox.sh w katalogu domowym lub w utworzonym katalogu katalog_domowy/kontox/.

W pliku kontox.sh wpisz:
cd sciezka/do/kontox/ &&
java -jar kontox_cli.jar -e demo@kontomierz.pl -p demo123

i po zapisaniu wykonaj polecenie chmod u+x kontox.sh.

Przejdź do katalogu $HOME/Library/LaunchAgents i utwórz w nim plik kontox.plist.

Otwórz plik w edytorze i dodaj:

  
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>label</key>
    <string>kontox</string>

    <key>ProgramArguments</key>
    <array>
      <string>/sciezka/do/kontox.sh</string>
    </array>

    <key>OnDemand</key>
    <false/>

    <key>Nice</key>
    <integer>1</integer>

    <key>StartInterval</key>
    <integer>86400</integer>

    <key>StandardErrorPath</key>
    <string>/tmp/kontox.err</string>

    <key>StandardOutPath</key>
    <string>/tmp/kontox.out</string>
  </dict>
</plist>

Powiadom system o istnieniu nowego zadania:
launchctl load kontox.plist

(*) W komendzie uruchamiajęcej kontox_cli.jar parametr -e oznacza e-mail, a -p hasło do serwisu Kontomierz.pl.
(*) Używanie aplikacji konsolowej jest niemożliwe po usunięciu konta z serwisu Kontomierz.pl.

Konfiguracja daty pobrania historii transakcji

Domyślnie KontoX CLI pobiera wszyskie nowe transakcje od daty ostatniej zaimportowanej transakcji. W związku z tym transakcje księgowane z opóźnieniem zostaną pominięte.

Aby umożliwić pobranie takich transakcji dodaliśmy nową opcję --full.
Uruchomienie KontoX CLI z tą opcją, czyli:
java -jar kontox_cli.jar -e demo@kontomierz.pl -p demo123 --full
spowoduje, że pobrane zostaną transakcje od:
Data ostatniej zaimportowanej transakcji minus 8 dni wstecz.

Sugerujemy raz na dobę uruchamiać program z opcją --full, a w innych przypadkach (częściej niż raz na dobę) bez tej opcji.
Nie zalecamy uruchamiania programu częściej niż raz na godzinę.

Interakcja

Program nie posiada graficznego interfejsu użytkownika, a więc postęp importu danych jak również komunikaty błędów są przekierowywane na standardowe wyjście. W przypadku wystąpienia błędów związanych z importem, wysyłana jest informacja na serwer Kontomierz.pl.

Plany

Obecnie aplikacja konsolowa KontoX jest darmowa, jednak w przyszłości planujemy wprowadzenie wersji płatnej.

Nowe zasady dotyczące cookies. Używamy plików cookies do zapewnienia Ci wygodnego korzystania z serwisu, gromadzenia danych analitycznych i statystycznych oraz wyświetlania reklam dostosowanych do Twoich preferencji i przeglądanych treści. Kontynuując przeglądanie zgadzasz się na wykorzystanie plików cookies w powyższym celu przez nas (Kontomierz.pl sp. z o.o.) i naszych partnerów. Możesz zmienić warunki przechowywania i dostępu do plików cookies, w tym zablokować te pliki, w ustawieniach przeglądarki. W związku z korzystaniem z serwisu przetwarzamy również dane osobowe. Zapoznaj się z polityką prywatności Kontomierz.pl, aby dowiedzieć się więcej o przetwarzaniu Twoich danych osobowych i plikach cookies.