JPK DOKUMENTACJA 2016-07-14 BIURO USŁUG INFORMATYCZNYCH "T-SOFT" s.c. 30-702 Kraków ul. Romanowicza 17
1. Ogólne Program do generowania jednolitego pliku kontrolnego jest przewidziany do uruchomienia na komputerach z zainstalowanym systemem z rodziny Windows (od systemu Windows XP w górę). Program będzie działał zarówno na systemach 32-bitowych jak i 64-bitowych. Wymagania sprzętowe są zgodne z wymaganiami systemowymi.
2. Wymagane programy Do prawidłowego działania programu do generowania JPK Potrzebne są następujące programy: Microsoft.NET Framework 4 baza danych PostgreSQL Microsoft OLE DB Provider for Visual FoxPro 9.0
3. Instalacja Opis instalacji został podzielony na instalację programu jak i dodatkowych komponentów. 3.1. Microsoft.NET Framework 4 Framework 4.0 jest już zwykle zainstalowany na komputerze. W razie problemów proszę pobrać go z wykorzystaniem witryny internetowej (https://www.microsoft.com/pl-pl/download/details.aspx?id=17851). Zaleca się również pobranie aktualizacji do tego frameworka z wykorzystaniem mechanizmu Windows Update (lub ręczną instalacją jeśli mechanizm Windows Update z jakiś powodów jest niedostępny). 3.2. Baza danych PostgreSQL Jeśli na serwerze lub komputerze pełniącym jego funkcję jest już zainstalowana baza PostgreSQL to należy się upewnić, że jest to wersja 9. Instalacja polega na ściągnięciu wybranej bazy danych ze strony producenta (https://www.postgresql.org/). Dla programu jest to zupełnie nieistotne na jakim serwerze uruchomimy silnik bazy danych (czyli serwer może być np. na Linuxie). Instalując bazę należy zapamiętać hasło użytkownika oraz numer portu, który wybraliśmy. Jeśli na serwerze działa firewall to należy dodać do jego wyjątków port bazy danych. 3.3. Microsoft OLE DB Provider for Visual FoxPro 9.0 Należy pobrać ze strony producenta (https://www.microsoft.com/enus/download/details.aspx?id=14839) plik instalacyjny (msi lub msm - jest to bez znaczenia). A następnie go uruchomić. Jedyną istotną kwestią jest ustawienie instalacji dla wszystkich użytkowników systemu. 3.4. JPK Po pobraniu pliku jpk.zip należy go rozpakować do docelowej lokalizacji (np. c:\ts01\prg\jpk).
4. Pierwsze uruchomienie Uruchamiając program po raz pierwszy należy wykonać następujące czynności. Przygotować pustą bazę danych o dowolnej nazwie tylko ten parametr określamy (na screenie przykład stworzenia bazy z poziomu pg_admina) uruchomić program jpk.exe (jeśli klient chce mieć więcej niż jedną bazę jpk to powinien w takiej sytuacji uruchamiać program ze skrótu tak zbudowanego, że 'element docelowy' nie znajduję się w ścieżce 'rozpocznij w' a każda instancja programu ma swój folder 'rozpocznij w' na wzór programu FK) uzupełnić konfigurację od tego momentu program za każdym razem będzie łączył się do
bazy danych o określonych koordynatach chcąc zmienić parametry należy odnaleźć w katalogu z bazą plik 'configurepostgres.dat', jest to zwykły plik tekstowy, w którym można zmienić wszystkie parametry poza hasłem (hasło jest przechowywane w formie zaszyfrowanej więc jedyny sposób na jego zmianę to skasowanie pliku i ponowna konfiguracja)
5. Opis funkcji Po uruchomieniu programu należy skonfigurować program. Z głównego menu należy wybrać konfiguracja a następnie: konfiguracja danych jednostki wszystkie pola z wyjątkiem 'REGON' oraz 'Numer lokalu' są polami obowiązkowymi. Brak ich wypełnienia skutkować będzie błędem podczas generowania jpk (błąd będzie na tyle czytelny, że użytkownik sam zorientuje się co nie gra). Konfiguracja urzędu skarbowego należy wybrać właściwy urząd skarbowy
następnie należy skonfigurować ścieżki lub parametry baz danych poszczególnych programów (FK, FR, GM). W zależności od programu będą to inne ścieżki (przykład dla FK) pole nazwa (kod) służy określeniu tego co w danej ścieżce przechowujemy jest to nazwa własna, którą nigdzie nie wykorzystujemy (poza nazwą pliku do zapisu). Poprzez ścieżkę rozumiemy folder, w którym znajduję się dany rodzaj pliku(ów). Dodając parametry (dla nowego programu FR) dodajemy parametry na wzór okna do zapisu konfiguracji połączenia Po zapisaniu ścieżek bądź parametrów możemy przejść do tworzenia właściwego pliku JPK. Wybieramy z menu program, z którego chcemy generować jpk a następnie z dolnego menu wybieramy generuj JPK. Otworzy się nam wtedy okno wyboru zakresu dat.
Po prawidłowym wybraniu zakresu dat (dat końcowa musi być większa lub równa od początkowej a mniejsza bądź równa dacie bieżącej). Następnie wskazujemy gdzie zapisać plik. W razie błędów formalnych pliku zostaniemy o tym poinformowani.
6. Uwagi dodatkowe Na administratorze systemu spoczywa obowiązek wykonywania kopii zapasowej. Kopię można wykonać zarówno z poziomu pg_admina (graficzny interfejs użytkownika dla bazy danych dostarczony z PostgreSQL) jak i za pomocą wiersza poleceń (przykładowy skrypt : ścieżka_do_pg_dump\pg_dump.exe --host adres_serwera --port 5432 --username "postgres" --no-password --format tar --blobs --verbose --file ścieżka_do_zapisu_kopii\nazwa_pliku.backup nazwa_bazy Pogrubioną czcionką zaznaczyłem elementy, które trzeba dostosować we własnym zakresie). Po reszte informacji odsyłam na stronę producenta bazy danych (czyli np. można znaleźć tam zasady robienia kopii a także inne mechanizmy backupu).
7. Zmiany 2016-07-14 wersja 1.0.0.