Instrukcja uż ytkowania rejestru KIDT...str. 1 Infolinia: 41 333 50 00 Obsługa klienta:41 333 50...

76
str. 1 Infolinia: 41 333 50 00 Obsługa klienta:41 333 50 01, e-mail: [email protected] Ostatnia modyfikacja 2016-11-21 Wersja 1.0.16 Instrukcja użytkowania rejestru KIDT Spis treści 1 Informacje ogólne ............................................................................................................... 3 2 Rozpoczęcie pracy z rejestrem KIDT ................................................................................... 4 2.1 Uwierzytelnienie oraz Autoryzacja .............................................................................. 4 2.2 Uruchomienie aplikacji ................................................................................................ 5 3 Instalacja oraz korzystanie z certyfikatów osobistych dostarczonych jako pliki PFX ......... 7 3.1 Przeglądarka Mozilla Firefox ....................................................................................... 7 3.1.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ............................................. 7 3.1.2 Instalacja certyfikatu użytkownika ..................................................................... 10 3.1.3 Autoryzacja (logowanie) w rejestrze KIDT ......................................................... 13 3.2 Magazyn systemu operacyjnego MS Windows ® – przeglądarka Internet Explorer, Opera, Google Chrome ......................................................................................................... 14 3.2.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ........................................... 14 3.2.2 Instalacja certyfikatu osobistego. ...................................................................... 18 3.2.3 Autoryzacja (logowanie) w rejestrze KIDT ......................................................... 19 3.3 Przeglądarka Safari Apple ® iOS urządzenia mobilne iPhone................................... 21 3.3.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ........................................... 21 3.3.2 Instalacja certyfikatu osobistego. ...................................................................... 25 4 Autoryzacja (logowanie) w rejestrze KIDT ........................................................................ 27 5 Funkcje rejestru KIDT. ....................................................................................................... 30 6 Rejestr KIDT ....................................................................................................................... 34 6.1 Informacje Statystyczne ............................................................................................ 34 6.2 Rejestracja dłużnika ................................................................................................... 35 6.3 Wyszukiwanie i modyfikacja prowadzonych spraw - „Lista spraw”.......................... 38

Transcript of Instrukcja uż ytkowania rejestru KIDT...str. 1 Infolinia: 41 333 50 00 Obsługa klienta:41 333 50...

  • str. 1

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Ostatnia modyfikacja 2016-11-21

    Wersja 1.0.16

    Instrukcja uż ytkowania rejestru KIDT

    Spis treści

    1 Informacje ogólne ............................................................................................................... 3

    2 Rozpoczęcie pracy z rejestrem KIDT ................................................................................... 4

    2.1 Uwierzytelnienie oraz Autoryzacja .............................................................................. 4

    2.2 Uruchomienie aplikacji ................................................................................................ 5

    3 Instalacja oraz korzystanie z certyfikatów osobistych dostarczonych jako pliki PFX ......... 7

    3.1 Przeglądarka Mozilla Firefox ....................................................................................... 7

    3.1.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ............................................. 7

    3.1.2 Instalacja certyfikatu użytkownika ..................................................................... 10

    3.1.3 Autoryzacja (logowanie) w rejestrze KIDT ......................................................... 13

    3.2 Magazyn systemu operacyjnego MS Windows® – przeglądarka Internet Explorer,

    Opera, Google Chrome ......................................................................................................... 14

    3.2.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ........................................... 14

    3.2.2 Instalacja certyfikatu osobistego. ...................................................................... 18

    3.2.3 Autoryzacja (logowanie) w rejestrze KIDT ......................................................... 19

    3.3 Przeglądarka Safari Apple® iOS urządzenia mobilne iPhone................................... 21

    3.3.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA ........................................... 21

    3.3.2 Instalacja certyfikatu osobistego. ...................................................................... 25

    4 Autoryzacja (logowanie) w rejestrze KIDT ........................................................................ 27

    5 Funkcje rejestru KIDT. ....................................................................................................... 30

    6 Rejestr KIDT ....................................................................................................................... 34

    6.1 Informacje Statystyczne ............................................................................................ 34

    6.2 Rejestracja dłużnika ................................................................................................... 35

    6.3 Wyszukiwanie i modyfikacja prowadzonych spraw - „Lista spraw” .......................... 38

    mailto:[email protected]

  • str. 2

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    6.3.1 Lista spraw .......................................................................................................... 38

    6.4 Operacje Grupowe: zamykanie oraz usuwanie spraw .............................................. 44

    6.4.1 Zamykanie: ......................................................................................................... 44

    6.4.2 Usuwanie: ........................................................................................................... 45

    6.5 Wyszukiwanie dłużników ........................................................................................... 46

    7 Import masowy dłużników ................................................................................................ 48

    8 Plik wymiany danych CSV.................................................................................................. 53

    8.1 Szczegółowa struktura pliku CSV ............................................................................... 54

    8.2 Przykłady plików CSV ................................................................................................. 60

    8.2.1 Dodanie nowych spraw do ewidencji długów alimentacyjnych ........................ 61

    8.2.2 Modyfikacja dwóch spraw ewidencja długów alimentacyjnych. ....................... 62

    8.2.3 Zamknięcie dwóch spraw Ewidencja długów alimentacyjnych ......................... 63

    8.2.4 Usunięcie dwóch, zamkniętych spraw Ewidencja długów alimentacyjnych ..... 64

    8.3 Szybkie tworzenie pików importu CSV ...................................................................... 65

    9 WEB Service KIDT-API ....................................................................................................... 67

    9.1 Zabezpieczenia serwisu WS_KIDT ............................................................................. 69

    10 Podstawowe pojęcia ..................................................................................................... 71

    11 Index .............................................................................................................................. 74

    12 Spis ilustracji .................................................................................................................. 75

    mailto:[email protected]

  • str. 3

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    1 Informacje ogólne

    Rejestr KIDT to system informatyczny wspomagający wymianę informacji gospodarczych

    pomiędzy partnerami w zakresie dopuszczonym Ustawą z dnia 9 kwietnia 2010 roku o

    udostępnianiu informacji gospodarczych i wymianie danych gospodarczych oraz na

    warunkach określonych w Regulaminie zarządzania danymi KIDT BIG S.A..

    Rejestr KIDT dostarcza serwisy internetowe umożliwiające manualne przetwarzania informacji

    jak i automatyzujące współpracę systemów informatycznych partnerów:

    Zarejestrowani użytkownicy mogą korzystać z Rejestru KIDT.

    Systemy informatyczne partnerów mogą korzystać z WEB service API do automatyzacji

    przekazywania, modyfikowania oraz pobierania danych.

    Głównym produktem rejestru KIDT są narzędzia pozwalające na zmniejszenie ryzyka

    prowadzenia działalności gospodarczej partnerów z obszaru usług telekomunikacyjnych jak

    i narzędzia do realizacji ustawowych obowiązków dla Biur Informacji Gospodarczej.

    System KIDT udostępnia ewidencje:

    Rejestr KIDT

    Rejestr dłużników alimentacyjnych

    Rejestr dłużników z tytułu pieczy zastępczej

    Rejestr posłużenia się podrobionym lub cudzym dokumentem.

    Rejestr długów na podstawie Kodeksu Karnego Wykonawczego

    mailto:[email protected]

  • str. 4

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    2 Rożpocżęcie pracy ż rejestrem KIDT

    2.1 Uwierzytelnienie oraz Autoryzacja

    Serwis KIDT jest dostępny wyłącznie dla użytkowników zarejestrowanych i posiadających

    certyfikat osobisty wydany przez Centrum Certyfikacji KIDT.

    Certyfikaty osobiste dostarczane są wraz z ich numerami seryjnymi po podpisaniu umowy

    pomiędzy KIDT BIG S.A., a Partnerem (podmiotem, osobą fizyczną) o powierzeniu danych oraz

    akceptacji regulaminu. Certyfikaty osobiste generowane są dla każdej osoby upoważnionej

    przez partnera i są ważne przez okres obowiązywania umowy.

    Po podpisaniu umowy za pośrednictwem poczty elektronicznej zostaną dostarczone

    certyfikaty w postaci plików PFX dla każdej osoby upoważnionej do korzystania z rejestru oraz

    informacja o tzw. loginach i hasłach dostępu.

    Certyfikaty osobiste przekazywane w plikach PFX zabezpieczone są hasłami, które zostaną

    przekazane w bezpieczny sposób.

    Istnieje możliwość dostarczenia certyfikatów osobistych zabezpieczonych na kartach

    kryptograficznych. Dostarczenie kart kryptograficznych oraz czytników wymaga odrębnych,

    dotyczących opłat ustaleń z partnerami.

    W przypadku, gdy użytkownik posiada cyfrowy podpis kwalifikowany, na specjalnie życzenie

    np. poprzez wysłanie e-maila podpisanego certyfikatem kwalifikowanym, do systemu KIDT

    może zostać dopisane uwierzytelnienie dla tego użytkowania i jego podpisu.

    mailto:[email protected]

  • str. 5

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    2.2 Uruchomienie aplikacji

    Do uruchomienia oraz korzystania z aplikacji wymagana jest jedna z nowoczesnych

    przeglądarek internetowych posiadająca aktywną obsługę skryptów JavaScript oraz

    zapewniających poprawną obsługę protokołów TLS/SSL.

    W nagłówku stron serwisu WWW umieszczony został link do aplikacji KIDT pod przyciskiem

    (Panel Klienta), za pomocą którego użytkownik w dowolnej chwili może uruchomić panel

    logowania do aplikacji.

    Rys. 1 Okno serwisu WWW z zaznaczonym przyciskiem logowania do systemu.

    Można również korzystać z bezpośredniego linku do aplikacji KIDT:

    https://www.kidt.pl/kidtstart

    W przypadku braku podpisu cyfrowego lub jego wygaśnięcia aplikacja KIDT udostępni jedynie

    okno informacyjne bez możliwości logowania do systemu:

    mailto:[email protected]://www.kidt.pl/kidtstart

  • str. 6

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 2 Okno powitalne aplikacji KIDT w przypadku braku ważnego certyfikatu osobistego.

    mailto:[email protected]

  • str. 7

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3 Instalacja oraz korżystanie ż certyfikatów osobistych

    dostarczonych jako pliki PFX

    Poniżej zostały opisane procedury wymagane do prawidłowej autoryzacji dla wybranych

    przeglądarek internetowych w przypadku otrzymania certyfikatu elektronicznego

    umieszczonego w kontenerze - pliku PFX.

    W pierwszym kroku należy zarejestrować i zaufać Certyfikatowi centrum certyfikacji KIDT

    kidt_CA, które wystawia certyfikaty osobiste. Certyfikat ten potwierdza własność klucza

    publicznego i pozwala stronom polegać na podpisach lub zapewnieniach złożonych poprzez

    certyfikaty osobiste uwierzytelnionym przez kidt_CA.

    3.1 Przeglądarka Mozilla Firefox

    3.1.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA

    Po uruchomieniu przeglądarki Firefox należy wybrać opcje Menu Opcje

    Rys. 3 Menu programu FireFox.

    mailto:[email protected]

  • str. 8

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    W kolejnym kroku należy wybrać kartę Zaawansowane, a następnie zakładkę Certyfikaty

    Rys. 4 Parametry zawansowane – certyfikaty

    Po wybraniu przycisku Wyświetl certyfikaty zostanie uruchomiony Menadżer Certyfikatów.

    Należy uruchomić procedurę importu certyfikatu kliknięciem na przycisk Importuj.

    Rys. 5 Importy certyfikatu

    mailto:[email protected]

  • str. 9

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Wyświetlone zostanie okno do wyboru pliku z certyfikatem. Należy wskazać plik z

    certyfikatem kidt_CA.crt (https://www.kidt.pl/kidtstart/cacrt/kidt_CA.crt)

    Klikniecie Otwórz rozpocznie import certyfikatu

    Rys. 6 Wyszukiwanie pliku z certyfikatem

    Należy potwierdzić prośbę o dołączenie certyfikatu kidt_CA wydanego przez Cetrum

    Certyfikacji KIDT.

    Rys. 7 Wybór magazynu certyfikatów

    mailto:[email protected]://www.kidt.pl/kidtstart/cacrt/kidt_CA.crt

  • str. 10

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.1.2 Instalacja certyfikatu użytkownika

    Aby zainstalować certyfikat należy uruchomić menu w przeglądarce następnie wybrać

    Opcje --> zaawansowane i z dostępnych zakładek wybrać Certyfikaty i wybrać opcję Wyświetl

    certyfikaty

    Rys. 8 Parametry zawansowane - certyfikaty

    W menadżerze certyfikatów z zakładek należy wybrać Użytkownik kliknąć Importuj

    Rys. 9 Import certyfikatu osobistego.

    mailto:[email protected]

  • str. 11

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Zostanie otwarte okno do wyszukania certyfikatu. Należy wyszukać i wskazać plik

    dostarczony wraz z Kartą profilu (w przypadku gdy certyfikat nie jest widoczny należy

    zmienić wyświetlane rozszerzenie na Wszystkie pliki (*.*))

    Rys. 10 Wybór typu kontenera certyfikatu.

    Rys. 11 Wyszukiwanie pliku z certyfikatem osobistym.

    Po wybraniu pliku pojawi się okno do wpisania hasła, w którym należy podać hasło do konta

    KIDT.

    mailto:[email protected]

  • str. 12

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 12 Wprowadzenie hasła do pliku PFX

    Po zaakceptowaniu pojawi się zainstalowany certyfikat.

    Rys. 13 Widok magazynu z zaimportowanym certyfikatem osobistym.

    mailto:[email protected]

  • str. 13

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.1.3 Autoryzacja (logowanie) w rejestrze KIDT

    Przy uruchamianiu się strony wyświetli się okno do wyboru certyfikatu użytkownika

    zainstalowanego wcześniej. Aby upewnić się, że wybrany certyfikat jest tym, który

    zainstalowaliśmy należy sprawdzić czy dane użytkownika znajdują się w szczegółach

    wybranego certyfikatu (w naszym przypadku Jan Nowak).

    Istnieje także możliwość sprawdzenia numeru seryjnego dostarczonego z certyfikatem oraz

    użytkownika.

    Rys. 14 Okno z informacjami o wybranym certyfikacie, który zostanie użyty do procesu uwierzytelnienia użytkowania.

    Jeżeli cały proces instalacji i wyboru certyfikatu przebiegł pomyślnie aplikacja KIDT

    automatycznie udostępni okno logowania z prośbą o podanie loginu oraz hasła.

    mailto:[email protected]

  • str. 14

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 15 Okno logowania.

    3.2 Magazyn systemu operacyjnego MS Windows® – przeglądarka Internet

    Explorer, Opera, Google Chrome

    3.2.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA

    Zainstalowanie certyfikatów w ten sposób pozwoli na używanie ich między innymi w

    przeglądarkach Google Chrome i Internet Explorer.

    W tym celu pobieramy ten certyfikat tutaj. Plik kidt_CA.crt należy uruchomić. W Oknie

    certyfikatu należy wybrać opcje Zainstaluj certyfikat, aby go zainstalować.

    mailto:[email protected]://dev1.kidt.pl/kidtstart/cacrt/kidt_CA.crt

  • str. 15

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 16 Okno kreatora importu certyfikatów.

    Pojawi się okno kreatora importu certyfikatów .

    Należy wybrać opcję Dalej, aby przejść do kolejnego kroku instalacji.

    mailto:[email protected]

  • str. 16

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 17 Wybór magazynu do którego zostanie zaimportowany certyfikat.

    Następnie należy wybrać opcje Automatycznie wybierz magazyn certyfikatów na podstawie

    typu certyfikatu i potwierdzić Dalej >

    Rys. 18 Potwierdzenie importu.

    Po kliknięciu Zakończ certyfikat zostanie dodany lub może pojawić się okno Ostrzeżenie o

    zabezpieczeniach.

    mailto:[email protected]

  • str. 17

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 19 Komunikat informujący o zamiarze importu i instalacji certyfikatu z kluczem prywatnym

    Należy potwierdzić i wybrać opcję Tak.

    mailto:[email protected]

  • str. 18

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.2.2 Instalacja certyfikatu osobistego.

    Instalacja przeprowadzana jest w ten sam sposób jak dla certyfikatu KIDT z taką różnicą, że

    podczas instalacji trzeba podać hasło (jak na zdjęciu poniżej) dostarczone wraz z certyfikatem.

    Rys. 20 Okno parametrów importu certyfikatu osobistego.

    mailto:[email protected]

  • str. 19

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.2.3 Autoryzacja (logowanie) w rejestrze KIDT

    Strona autoryzacji w Rejestrze KIDT dostępna jest pod adresem:

    https://www.kidt.pl/kidtstart

    Przy uruchamianiu się strony wyświetli się okno do wyboru certyfikatu użytkownika. Aby

    upewnić się, że wybrany certyfikat jest tym, który zainstalowaliśmy, należy sprawdzić czy

    właściwe dane użytkownika znajdują się w szczegółach wybranego certyfikatu (w naszym

    przypadku Jan Nowak).

    Wyświetli się okno wyboru certyfikatu, gdzie należy wybrać ten, który jest opisany Imieniem i

    Nazwiskiem osoby, na którą został wystawiony.

    Dla przykładu w Internet Explorer:

    Rys. 21 Okno z informacjami o wybranym certyfikacie, który zostanie użyty do procesu uwierzytelnienia użytkowania.

    Po zainstalowaniu certyfikatu i wybraniu go z listy dostępnych na stronie logowania będzie

    widoczne Imię i Nazwisko posiadacza konta jak wyżej:

    mailto:[email protected]://www.kidt.pl/kidtstart

  • str. 20

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 22 Okno logowania.

    Następnie po podaniu prawidłowego loginu oraz hasła użytkownik otrzyma dostęp do Rejestru

    KIDT

    mailto:[email protected]

  • str. 21

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.3 Przeglądarka Safari Apple® iOS urządzenia mobilne iPhone

    W przypadku korzystania z urządzeń mobilnych iPhone należy do systemu plików przenieść

    pliki z certyfikatami. Jednym ze sposobów jest utworzenie e-maila z załączonymi plikami i

    wysłanie pocztą na skrzynkę, która jest obsługiwana przez urządzenie.

    Systemy operacyjny iOS automatycznie rozpoznaje zawartość plików i podczas próby otwarcia

    plików przez użytkownika rozpocznie proces instalacji certyfikatów.

    Zainstalowane certyfikaty będę widoczne po wybraniu opcji

    Ustawienia -> Ogólne -> Profile

    Rys. 23 Podgląd zainstalowanych certyfikatów.

    3.3.1 Instalacja certyfikatu Centrum autoryzacji kidt_CA

    Po wgraniu do pamięci masowej urządzenia np. poprzez wysłanie e-maila z załączonym

    certyfikatem, należy otworzyć plik kidt_CA.crt.

    System Operacyjny iOS automatycznie rozpozna format i wyświetli okno informacyjne z

    aktywną opcją instalacji

    mailto:[email protected]

  • str. 22

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 24 Okno potwierdzenia instalacji certyfikatu.

    Podczas procesu instalacji wyświetlone zostaną kolejne monity o potwierdzenia wykonania

    poszczególnych kroków:

    Rys. 25 Monit o rozpoczęcie procesu instalacji

    mailto:[email protected]

  • str. 23

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 26 Informacja o roli certyfikatu, który zostanie dodany do zaufanych certyfikatów.

    Rys. 27 Ostateczny monit o potwierdzenie instalacji.

    Prawidłowa instalacja zostanie potwierdzona odpowiednim komunikatem:

    mailto:[email protected]

  • str. 24

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 28 Zainstalowany, poprawny certyfikat kidt_CA .

    mailto:[email protected]

  • str. 25

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3.3.2 Instalacja certyfikatu osobistego.

    W podobny sposób jak instalacja certyfikatu głównego będzie przebiegał proces instalacji

    certyfikatu użytkownika.

    Próba otwarcia pliku PFX z certyfikatem użytkownika uruchomi proces instalacji

    Rys. 29 Komunikat z monitem o rozpoczęcie procesu instalacji certyfikatu osobistego.

    Rys. 30 Informacja o wczytaniu pliku PFX z certyfikatem i informacją o ochronie hasłem.

    mailto:[email protected]

  • str. 26

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 31 Prośba o podanie hasła zabezpieczającego zawartość pliku PFX

    Rys. 32 Widok informujący o zainstalowanych certyfikatach.

    mailto:[email protected]

  • str. 27

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Zainstalowane certyfikaty będą widoczne po wybraniu opcji

    Ustawienia -> Ogólne -> Profile

    Rys. 33 Prawidłowo zainstalowany certyfikat użytkownika.

    4 Autoryzacja (logowanie) w rejestrze KIDT

    W nagłówku strony serwisu WWW umieszczony został link do aplikacji KIDT pod przyciskiem

    (Panel Klienta), za pomocą którego użytkownik w dowolnej chwili może uruchomić panel

    logowania do aplikacji.

    mailto:[email protected]

  • str. 28

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 34 Okno serwisu WWW z zaznaczonym przyciskiem logowania do systemu.

    Można również korzystać z bezpośredniego linku do aplikacji KIDT:

    https://www.kidt.pl/kidtstart

    Pomocne może być ponowne uruchomienie przeglądarki internetowej w celu zainicjowania

    wzajemnych uwierzytelnień Serwisu KIDT oraz Klienta.

    Informacja - rejestr KIDT jest dostępny wyłącznie dla użytkowników z ważnym certyfikatem

    osobistym oznacza, że nie jest dostępny poprawny certyfikat osobisty. Należy zweryfikować

    poprawność instalacji tego certyfikatu zgodnie z opisem w rozdziale Instalacja oraz korzystanie

    z certyfikatów osobistych dostarczonych jako pliki PFX3.

    mailto:[email protected]://www.kidt.pl/kidtstart

  • str. 29

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 35 Okno powitania w przypadku braku ważnego certyfikatu osobistego.

    W przypadku prawidłowej instalacji certyfikatów pojawi się strona z możliwością autoryzacji

    loginem i hasłem.

    Rys. 36 Okno logowanie do rejestru KIDT.

    mailto:[email protected]

  • str. 30

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Korzystając z zakładki CERTYFIKATY można uzyskać informacje jaki certyfikat będzie użyty do

    uwierzytelnienia użytkowania w serwisie KIDT.

    W przypadku, gdy certyfikat dotyczy innej osoby (np. został źle wybrany z listy dostępnych)

    należy ponownie uruchomić przeglądarkę internetową, aby zainicjować ponownie wybór

    certyfikatu.

    Rys. 37 Informacje o rozpoznany certyfikacie osobistym

    5 Funkcje rejestru KIDT.

    Po zalogowaniu, w zależności od uprawnień, użytkownik otrzymuje dostęp do poszczególnych

    operacji poprzez wybór opcji z menu.

    W przypadku urządzeń z dużym ekranem, menu występuje po lewej stronie okna aplikacji.

    mailto:[email protected]

  • str. 31

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 38 Widok menu oraz okna profilu użytkowania.

    W przypadku urządzeń mobilnych widok menu pozostaje ukryty do chwili wywołania przez

    użytkownika.

    mailto:[email protected]

  • str. 32

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 39 Widok menu oraz okna profilu użytkowania - urządzenie mobilne.

    Widok menu zależny jest od posiadanych uprawnień zalogowanego użytkownika i może

    zawierać opcje

    Rejestr KIDT - rejestr i obsługa dłużników, w tym lista spraw, wyszukiwanie dłużników

    spośród wszystkich rejestrów, rejestracja dłużnika, masowa obsługa dłużników oraz

    informacje statystyczne

    Rejestr alimentacyjny - ewidencja dłużników alimentacyjnych, możliwość wyświetlania

    listy dłużników alimentacyjnych oraz rejestracji nowego dłużnika alimentacyjnego

    Rejestr dokumentów - rejestr podrobionych dokumentów oraz prób posłużenia się

    cudzym dokumentem, zawiera listę spraw w zakresie dokumentów i możliwość

    rejestracji nowej sprawy

    Rejestr dłużników z tytuły pieczy zastępczej - lista dłużników z tytułu pieczy zastępczej

    oraz możliwość rejestracji nowego dłużnika

    Ewidencja dłużników na podstawie Kodeksu Karnego Wykonawczego

    mailto:[email protected]

  • str. 33

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Operacje masowe

    Narzędzia administracyjne

    Lista dostępnych funkcji zależy od zamówionych opcji przez partnera oraz uprawnień

    użytkownika.

    Tabela 1 Tabela uprawnień

    Zakres uprawnień Nazwa funkcji Opis

    Ewidencja: Rejestr KIDT Informacje statystyczne zob. 6.1

    Rejestracja dłużnika

    Lista Spraw

    Wyszukiwanie dłużników

    Masowa obsługa dłużników

    Słowniki

    Ewidencja: Rejestr dłużników alimentacyjnych

    Rejestracja dłużnika alimentacyjnego

    Lista dłużników alimentacyjnych

    Ewidencja: Rejestr fałszywych dokumentów

    Rejestracja fałszywych dokumentów

    Lista dokumentów

    Ewidencja: Rejestr dłużników z tytułu pieczy zastępczej

    Rejestracja dłużnika z tytułu pieczy zastępczej

    Lista dłużników z tytułu pieczy zastępczej

    Ewidencja: Rejestr dłużników na podstawie Kodeksu Karnego Wykonawczego

    Rejestracja dłużnika na podstawie przepisów Kodeksu Karnego wykonawczego

    Lista dłużników na podstawie przepisów Kodeksu Karnego wykonawczego

    Użytkownik: Administrator Użytkownicy

    Słowniki

    Użytkownik

    Mój profil

    Wyloguj

    mailto:[email protected]

  • str. 34

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    6 Rejestr KIDT

    Głównym produktem rejestru KIDT są narzędzia pozwalające na zmniejszenie ryzyka

    prowadzenia działalności gospodarczej partnerów jak i narzędzia do realizacji ustawowych

    obowiązków dla Biur Informacji Gospodarczej.

    Rys. 40 Widok profilu partnera

    6.1 Informacje Statystyczne

    mailto:[email protected]

  • str. 35

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 41 Informacje statystyczne

    6.2 Rejestracja dłużnika

    Aby rozpocząć proces rejestracji dłużnika należy wybrać pozycję z menu 'Rejestr KIDT', a

    następnie funkcję 'Rejestracja dłużnika'.

    Podczas rejestrowania nowej sprawy dłużnika wymagane jest podanie jednego z

    identyfikatorów: PESEL, NIP, REGON jednoznacznie określającego dłużnika. Następnie wybrać

    przycisk z prawej strony DALEJ.

    Rys. 42 Wprowadzenie unikatowego identyfikatora dłużnika

    mailto:[email protected]

  • str. 36

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    W kolejnym kroku, po wykonaniu polecenia Dalej system sprawdzi czy w rejestrze nie widnieją

    już dane dłużnika. Jeśli znaleziono danego dłużnika w systemie (w bazie danych) i ma on

    zarejestrowaną przynajmniej jedną sprawę to powinniśmy dostać podobne okno:

    W przypadku wystąpienia dłużnika w rejestrze wyświetlona zostanie tabelka z aktualnymi

    sprawami dla wyszukanego dłużnika. Aby przejść do rejestracji dłużnika należy wybrać jedną z

    nich. Po wyborze zostanie wyświetlony formularz z uzupełnionymi danymi wybranego

    dłużnika, które należy zweryfikować i w razie konieczności zmodyfikować, aby były zgodne z

    danymi wprowadzanej sprawy.

    mailto:[email protected]

  • str. 37

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    W sytuacji, gdy w systemie nie ma jeszcze dłużnika powiązanego z wpisanymi danymi, po

    kliknięciu 'Dodaj' wyświetli się od razu formularz dodawania dłużnika i sprawy.

    Po zapisaniu sprawy jest ona natychmiast dostępna w systemie. Można ją wyszukać i przejrzeć

    na kilka różnych sposobów np. w pozycji z menu "Lista Spraw" lub poprzez "Wyszukiwanie

    dłużników" i przejście z tabelki wynikowej do danej sprawy lub powtarzając powyższe kroki.

    mailto:[email protected]

  • str. 38

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    6.3 Wyszukiwanie i modyfikacja prowadzonych spraw - „Lista spraw”

    6.3.1 Lista spraw

    Zakładka "Lista Spraw" pozwala na przeszukiwanie i przeglądanie spraw wprowadzonych do

    systemu.

    Rys. 43 Widok: Lista spraw

    W górnym oknie widoku „Parametry wyszukiwania" znajdują się filtry określające kryteria

    wyszukiwania spraw. Umożliwiają one wyszukiwanie według kategorii sprawy (1), zakresu

    (2), sygnatury bądź jej fragmentu (3), czasu rejestracji sprawy w systemie (4), wyszukiwanie

    w kolumnie po dowolnej frazie (5) oraz statusu sprawy (6).

    Rys. 44 Kontrolka filtrów wyszukiwania spraw

    mailto:[email protected]

  • str. 39

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Kiedy zastosowany jest filtr szukania sprawy po wartości w wybranej kolumnie (5) po wpisaniu

    szukanej frazy i kliknięciu w pusty obszar strony pojawi się zbiór operacji w polu wyboru

    poniżej. Dla frazy, która zawiera tekst czyli np. litery dostępne będą operacje porównania:

    równe (identyczna wartość)

    nie równe (różne, różnica minimum jednym znakiem)

    zawiera (małe i duże znaki są traktowane jednakowo)

    nie zawiera (małe i duże znaki są traktowane jednakowo)

    Jeśli natomiast wartość w polu tekstowym szukanej frazy zinterpretowana będzie jako

    poprawna wartość numeryczna (także liczba zmiennoprzecinkowa z częścią dziesiętną)

    dostępne operacje powyżej będą rozszerzone o operacje:

    większe

    większe lub równe

    mniejsze

    mniejsze lub równe

    W przypadku porównywania wartości w kolumnach np. 0.0 z częścią dziesiętną będzie równe

    0 jako liczbie całkowitej, to samo np. 15.0 jest tożsame z 15.

    Rys. Wyszukiwanie po wartości w wybranej kolumnie

    Po określeniu kryteriów i kliknięciu na przycisk "Wyświetl sprawy" w oknie dolnym "Lista

    spraw" wyświetlone zostaną wyniki wyszukiwania.

    mailto:[email protected]

  • str. 40

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 45 Zestawienie listy spraw

    Kontrolka zestawienia udostępnia funkcje formatowania tabeli wg wymagań użytkowania

    oraz umożliwia eksport wszystkich lub wybranych pozycji do plików w formacie csv, excel,

    json, xml.

    Poniżej przedstawiony jest eksport wybranych spraw - w liście wyboru ustawienia eksportu

    ustawione na Eksportuj wybrane, zaznaczone interesujące nas pozycje w pierwszej kolumnie

    od lewej, oraz przyciśnięta nazwa formatu w ostatniej ikonce nad tabelką z prawej strony.

    mailto:[email protected]

  • str. 41

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. Eksport wybranych wierszy do pliku CSV

    W przypadku kiedy użytkownik chce zmienić kolejność kolumn wystarczy "złapać" kursorem

    nagłówek kolumny i przeciągnąć go za lub przed inny nagłówek kolumny. Nowe ustawienie

    zostanie zapisane i zastosowane przy ponownym wejściu użytkownika na daną podstronę. To

    samo dotyczy wyboru widocznych kolumn, które można ukrywać / odkrywać używając

    przycisku z ikonką nr (3) opisaną poniżej, umieszczoną w prawym górnym rogu tabelki.

    Rys. Zmiana ustawień wyświetlania i kolejności kolumn

    mailto:[email protected]

  • str. 42

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    W przypadku, kiedy ilość zwróconych przez system spraw jest większa niż ilość wyświetlanych

    wierszy w tabelce (którą można zmienić w polu wyboru poniżej tabelki), wyświetlona jest tak

    zwana paginacja czyli wybór stron, na które podzielone są wyniki wyszukiwania (dzieląc ilość

    wszystkich rekordów przez ilość rekordów na stronę). Możliwe jest także w tym wypadku

    przejście na określoną stronę wpisując jej numer w polu Idź do strony w pole nad tabelą i

    zatwierdzenie enterem lub klikając w przyciski tego pola ze strzałkami góra/dół (oznaczające

    poprzednią i następną stronę licząc od wpisanej w to pole).

    Rys. 46 Funkcje kontrolki zestawienia listy spraw

    Opis funkcji kontrolki (Rys. 46):

    1) rejestracja nowego dłużnika / nowej sprawy

    2) zakres eksportu widocznych spraw:

    - „Eksportuj wszystkie” eksportuj widoczną listę wyników

    - „Eksportuj wybrane” eksportuj zaznaczone rekordy

    3) Przełączenie na stronę nr ...

    4) Pobranie zaznaczonych pozycji jako arkusza CSV w formacie zgodnym z plikiem importu

    masowego – umożliwia szybką modyfikację masową wybranych spraw

    mailto:[email protected]

  • str. 43

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    5) odświeżanie ostatniego wyszukiwania (ponowne odpytanie systemu z tymi samymi

    parametrami)

    6) zmiana prezentacji wyników pomiędzy widokiem tabeli a widokiem listy (przejrzystszym dla

    urządzeń mobilnych)

    7) Wybór wyświetlanych / ukrywanych kolumn

    8) Wybór konwersji danych do wybranego formatu, dostępne opcje to JSON, XML, CSV, EXCEL.

    9) kliknięcie w link w kolumnie KIDT ID przenosi na podstronę prezentującą szczegóły wybranej

    sprawy

    10) Ilość wyświetlanych rekordów na jednej stronie

    11) Nawigacja pomiędzy stronami

    12) Kliknięcie na nazwę kolumny wymusza sortowanie rosnąco lub malejąco

    mailto:[email protected]

  • str. 44

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    6.4 Operacje Grupowe: zamykanie oraz usuwanie spraw

    6.4.1 Zamykanie:

    W celu zamknięcia kilku spraw jednocześnie należy je zaznaczyć, a następnie nacisnąć "Zamknij

    grupę spraw"

    Rys. 47 Wybór grupy spraw i uruchomienie grupowej operacji zamykania.

    Następnie należy potwierdzić chęć ich zamknięcia,

    Rys. 48 Potwierdzenie operacji grupowej

    Po wykonaniu żądanych operacji zostanie wyświetlone okno podsumowania z informacją o

    poprawności lub błędzie dla wszystkich zaznaczonych pozycji:

    mailto:[email protected]

  • str. 45

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 49 Raport operacji grupowej

    .

    6.4.2 Usuwanie:

    W celu usunięcia kilku spraw jednocześnie należy je zaznaczyć, a następnie nacisnąć „Usuń grupę

    spraw".

    Rys. 50 Wybór grupy spraw i uruchomienie grupowej operacji usuwania..

    Wybór należy potwierdzić:

    Rys. 51 Potwierdzenie wykonania operacji grupowej

    mailto:[email protected]

  • str. 46

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Po wykonaniu żądanych operacji zostanie wyświetlone okno podsumowania z informacją o

    poprawności lub błędzie dla wszystkich zaznaczonych pozycji:

    Rys. 52 Raport wykonania grupowej operacji usuwania.

    6.5 Wyszukiwanie dłużników

    Rys. 53 Funkcje kontrolki wyszukiwania dłużników

    mailto:[email protected]

  • str. 47

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Widok umożliwia wyszukiwanie spraw dla wybranych cech dłużnika / dłużników

    1) Pola gwarantujące unikalność dla każdej osoby takie jak PESEL, NIP, REGON powinny

    zwrócić listę spraw danego dłużnika.

    2) Przycisk "Dodaj dłużnika" przenosi na podstronę umożliwiającą rejestrację nowej sprawy.

    3) Przycisk "Szukaj" wysyła żądanie do systemu aby zwrócił wynik wg podanych kryteriów.

    4) Przycisk "Wyczyść" resetuje wszystkie pola tekstowe, pola z datami, pola wyboru oraz czyści

    tabelkę wyników tak aby przygotować wszystko do nowego zapytania bez obaw, że wyszukuje

    rekordy wg poprzednich kryteriów.

    5) Przycisk "Generuj raport" powoduje wygenerowanie dokumentu w formacie PDF

    prezentującego raport dotyczący wybranego dłużnika, jego dane osobowe, listę i krótki opis

    spraw wraz z kwotami zadłużenia. W raporcie uwzględnione są też dane i statystyki

    użytkownika, który wnioskuje o ich wygenerowanie.

    Przykładowy raport poniżej:

    Rys. 54 Przykładowy raport o dłużniku.

    Pierwsza tabela raportu zawiera dane użytkownika generującego raport, poniżej dane

    dłużnika oraz szczegóły zobowiązań.

    mailto:[email protected]

  • str. 48

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    7 Import masowy dłużników

    Funkcja umożliwia dodawanie/modyfikację danych dotyczących dłużników i spraw w sposób

    masowy poprzez załadowanie pliku wymiany danych w formacie CSV wg specyfikacji.

    Funkcja wymaga posiadania przez użytkownika uprawnień „Import Masowy”.

    Uprawnienia może nadawać lub wyłączać użytkownik z uprawnieniami Administrator.

    W przypadku, gdy brak jest opcji Import Masowy w menu (opis poniżej), należy uaktywnić ją

    w menadżerze uprawnień jak na rysunku poniżej.

    Rys. Lista przydzielonych uprawnień użytkowania

    Proces importu można rozpocząć po wybraniu z menu funkcji Operacje masowe-> Import

    plików CSV

    Rys. 55 Menu - Operacje masowe

    mailto:[email protected]

  • str. 49

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rejestrowanie nowych spraw (operacja=1)

    Modyfikację Spraw (operacja=2)

    Zamykanie Spraw (operacja=4)

    Usuwanie spraw (operacja=3)

    Proces importu składa się z 5 etapów:

    1. Przekazywanie pliku CSV

    2. Analizy i importu pliku CSV

    3. Raportu o poprawności lub błędach poszczególnych wierszy

    4. Zatwierdzeniu importu poprawnych wierszy

    5. Podsumowania importu

    Etap 1 Przekazywanie pliku CSV:

    Rys. 56 Okno przekazywania pliku CSV do rejestru KIDT

    Rys. 57 Informacja o postępie przysłania pliku.

    mailto:[email protected]

  • str. 50

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Błędy w przekazywaniu pliku sygnalizowane są poprzez wizualizację graficzną :

    Rys. 58 Błąd przekazywania pliku CSV na serwery KIDT

    Przyczyną błędu podczas przekazywania pliku może być:

    brak lub niewłaściwe nagłówki w pierwszym wierszu pliku

    Dopuszczalne nagłówki to (obowiązkowe pogrubiono):

    REG;OPERACJA;ID;ID2;RODZAJDOK;PESEL;NIP;REGON;IDINNE;IMIE;NAZWISKO;ADRE

    S;KODPOCZTOWY;MIEJSCOWOSC;KRAJ;FIRMA;REJESTRAD;NRREJESTRAD;KORESPADR

    ES;KORESPKODP;KORESPMIEJSCOWOSC;KORESPKRAJ;IDTYPDLUZNIKA;SYGNATURA;SY

    GWIERZYCIELA;NALEZNA;DATAPOWSTANIA;ZALEGLA;KWESTIONOWANA;ORGAN;DAT

    ATYTUL;DATASTART;DATASTOP;IDSTATUS;IDTYTUL;IDWALUTA;IDKATEGORIA;DOKUME

    NT;SERIANR;DATAWYDANIA;WYSTAWCA;POSIADACZ;DOKINFO;DOKORGAN;OPIS

    i/lub

    niewłaściwe kodowanie znaków

    Plik z danymi powinien być zapisany w jednym z następujących formatów

    - UTF-8

    - windows-1250

    i/lub

    niewłaściwe rozszerzenie pliku

    Dopuszczalne rozszerzenie pliku to CSV, XLSX, XLS, ODS

    Poprawne przekazanie pliku na serwery KIDT spowoduje przejście do etapu 2 procesu

    importu, w którym użytkownik może rozpocząć proces przetwarzania i walidacji pliku CSV lub

    anulować operacje.

    mailto:[email protected]

  • str. 51

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 59 Etap 2 Importu – rozpoczęcie analizy pliku CSV.

    W zależności od ilości danych przekazywanych w pliku CSV – proces analizy może wymagać

    dłuższego czasu. Postęp analizy sygnalizowany jest w oknie Etapu 3

    Rys. 60 Etap 3 – Okno informacji o post postępie analizy pliku CSV.

    System przetwarza przesłane przez użytkownika dane w tle i informuje o postępach procesu

    importowania danych. W tym czasie można dalej korzystać z systemu wykonując inne

    czynności i w każdej chwili powrócić do okna importu.

    W pasku nawigacji zostaną wyświetlone informacje o statusie importu.

    Rys. 61 Informacja o postępie analizy pliku CSV w pasku nawigacyjnym

    Po wykonaniu analizy przesłanych danych zostanie wyświetlona informacja z listą

    przetworzonych spraw oraz błędach.

    mailto:[email protected]

  • str. 52

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 62 Etap 4 Raport o przetworzonych sprawach oraz błędach

    Import na tym etapie można przerwać lub zatwierdzić.

    Zatwierdzenie zakończy proces importu i dane zostaną zapisane w rejestrze KIDT.

    Podsumowanie będzie widoczne do czasu potwierdzenia zamknięcia importu.

    Rys. 63 Etap 5 Podsumowanie importu

    Dokumentacja funkcji importu jest również rozwijana na stronie pomocy kontekstowej

    https://www.kidt.pl/kidtstart//kidtapi/?import-masowy

    mailto:[email protected]://www.kidt.pl/kidtstart/kidtapi/?import-masowy

  • str. 53

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8 Plik wymiany danych CSV

    Mechanizm importu danych z plików tekstowych bazuje na formacie CSV z następującymi

    ograniczeniami:

    Pierwszy wiersz zawiera nazwy pól (kolumn) (nazwy pól opisano poniżej w Błąd! Nie

    ożna odnaleźć źródła odwołania.)

    Wszystkie kolumny muszą wystąpić.

    Pierwszą i drugą kolumną muszą być pola REG oraz OPERACJA. Kolejność pozostałych

    kolumn jest dowolna

    Mogą być stosowane znaki rozdzielające:

    o Przecinek

    o Średnik

    o Pipe ‘|’

    o Tabulator

    Wartości kwot pieniężnych podawane w groszach (dla uproszczenia analizy oraz

    uniknięcia stosowania separatorów dziesiętnych oraz tysięcy itd. wyeliminowano inne

    znaki niż cyfry)

    Nie wbudowano mechanizmu rozpoznawania znaków otaczających wartości

    tekstowych np. cudzysłowów

    Preferowane jest stosowanie ‘|’ (pipe) lub ‘;’ (średnika) jako znaków rozdzielających.

    Dopuszczalny jest znak ‘,’ (przecinek) znak ‘, ‘ – jednak przecinek może często występować w

    wartościach kolumn.

    Poniżej, w Tabeli 2 opisano znaczenie oraz funkcje poszczególnych pól . oraz przykład plików

    CSV.

    mailto:[email protected]

  • str. 54

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.1 Szczegółowa struktura pliku CSV

    Tabela 2 Struktura pliku wymiany danych CSV .

    Obiekt,

    którego

    dotyczą dane

    Typ

    Danych KLUCZ Nazwa pola Opis

    Wymagane:

    [nr rejestru]

    Opcjonalne:

    {nr rejestru}

    Ewidencja numer REG Selektor ewidencji

    1-Rejestr KIDT 2-Rejestr długów alimentacyjnych 3-Rejestr Dokumentów 4-Rejestr dłużnika z tytułu pieczy

    zastępczej

    5-Rejestr długów na podst. KKW (skorelowane z IDKATEGORIA)

    [1] [2] [3] [4] [5]

    Akcja numer OPERACJA Selektor operacji dla

    sprawy

    1-Dodanie nowej sprawy

    2-Modyfikacja istniejącej sprawy

    3-Usunięcie istniejącej sprawy

    4-Zamknięcie istniejącej sprawy

    [1] [2] [3] [4] [5]

    Dłużnik

    Tekst,

    dowolny

    ciąg

    znaków

    ID Unikatowy klucz Dłużnika Oznaczenie dłużnika nadane przez

    Wierzyciela/Partnera {1}{2}{3}{4}{5}

    mailto:[email protected]

  • str. 55

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Tekst,

    dowolny

    ciąg

    znaków

    ID2 Pomocniczy unikatowy

    klucz

    Inny systemowy unikatowy klucz

    dłużnika nadany przez Partnera (np.

    integracja z innym systemem

    informatycznym)

    {1}{2}{3}{4}{5}

    pesel PESEL PESEL

    [1] [2] [3] [4] [5]

    nip NIP NIP Wymagany jeden z podanych

    regon REGON REGON

    8 IDINNE Dodatkowy Identyfikator

    dłużnika Inny, dowolny identyfikator np. nr

    paszportu {1}{2}{3}{4}{5}

    Tekst IMIE Imię (Imiona) Dopuszczalne typowe znaki dla imion

    Pojedyncze imię lub imiona oddzielone przecinkami

    [1] [2] [3] [4] [5]

    Tekst NAZWISKO Nazwisko

    Dopuszczalne typowe znaki dla

    nazwisk

    Pojedyncze nazwisko lub kilka nazwisk połączonych myślnikiem

    [1] [2] [3] [4] [5]

    Tekst ADRES Adres np. ul. Zielona 23/4 {1}{2}{3}{4}{5}

    Kod

    pocztowy KODPOCZTOWY Kod pocztowy

    poprawny kod pocztowy w formacie DD-DDD (gdzie D to pojedyncza cyfra) np. 20-235

    {1}{2}{3}{4}{5}

    Tekst MIEJSCOWOSC Miejscowość poprawna nazwa miejscowości lub miasta

    {1}{2}{3}{4}{5}

    Tekst KRAJ Kraj dozwolone znaki oprócz liter (myślnik, nawiasy pół-okrągłe)

    {1}{2}{3}{4}{5}

    Tekst FIRMA Nazwa firmy {1}

    Tekst REJESTRAD Ewidencja podmiotu

    gospodarczego np. Ewidencja działalności

    gospodarczej {1}

    mailto:[email protected]

  • str. 56

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Tekst NRREJESTRAD Nr w ewidencji związane z poprzednim polem, numer

    w tejże ewidencji {1}

    Tekst KORESPADRES Adres Korespondencyjny np. ul. Zielona 23/4 {1}{2}{3}{4}{5}

    Tekst KORESPKODP Kod pocztowy

    korespondencja

    poprawny kod pocztowy w formacie DD-DDD (gdzie D to pojedyncza cyfra) np. 20-235

    {1}{2}{3}{4}{5}

    Tekst KORESPMIEJSCOWOSC Adres Korespondencyjny -

    Miejscowość poprawna nazwa miejscowości lub miasta

    {1}{2}{3}{4}{5}

    Tekst KORESPKRAJ Adres Korespondencyjny -

    Kraj dozwolone znaki oprócz liter (myślnik, nawiasy pół-okrągłe)

    {1}{2}{3}{4}{5}

    Numer

    wg

    słownika IDTYPDLUZNIKA Id typ dłużnika

    Zgodnie ze słownikiem

    Domyślnie 1 Osoba fizyczna (konsument) 2 Osoba fizyczna prowadząca działalność gospodarczą 3 Podmiot posiadający osobowość prawną 4 Forma nieokreślona (traktowany jako osoba fizyczna)

    [1]

    Sprawa Tekst SYGNATURA Sygnatura Sprawy

    Oznaczenie Unikatowe Sprawy w

    Systemie Wierzyciela. Pominięte

    oznacza autonumeracje - Standardowo

    SYG/[lp]/[mies]/[rok]/[idpartnera].

    Format sygnatury może być

    automatycznie generowany z użyciem

    bieżącego miesiąca-%m roku-%y

    oraz kolejnego numeru-%n.

    {1}{2}{3}{4}{5}

    mailto:[email protected]

  • str. 57

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Domyślnie format dla Partnerów:

    SYG/%n/%m/%y/[idpartnera]

    Przykład:

    AKT / %n/PR/%y - zostanie

    automatycznie uzupełnione o kolejny

    numer (%n) oraz bieżący rok (%y)

    liczba

    całkowita NALEZNA

    Łączna kwota

    zobowiązania Wartość w groszach (dla uniknięcia

    problemu znaku dziesiętnych) {1}{2}{3}{4}{5}

    data DATAPOWSTANIA Data powstania zaległości Format ISO 8601 (2014-01-01) [1] [2] [3] [4] [5]

    liczba

    całkowita ZALEGLA Kwota zaległości

    Wartość w groszach (dla uniknięcia

    problemu znaku dziesiętnych) Wartość

    Zero oznacza polecenie zamknięcia

    sprawy

    [1] [2] [3] [4] [5]

    liczba

    całkowita KWESTIONOWANA Kwota kwestionowana

    Wartość w groszach (dla uniknięcia

    problemu znaku dziesiętnych) [1] [2] [3] [4] [5]

    Data DATAWYMAGANA Wymagana data zapłaty Format ISO 8601 (2014-01-01) {1}{2}{3}{4}{5}

    ORGAN Organ orzekający Niewykorzystana Wartość nie jest

    analizowana

    Data DATATYTUL Data wezwania do zapłaty Format ISO 8601 (2014-01-01) [1] {2}{3}{4}{5}

    Data DATASTART Data utworzenia sprawy Format ISO 8601 (2014-01-01)

    Domyślnie dzień operacji {1}{2}{3}{4}{5}

    data DATASTOP Data zakończenie spawy Domyślnie 300-01-01 oznacza

    niezakończoną sprawę {1}{2}{3}{4}{5}

    mailto:[email protected]

  • str. 58

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Numer

    wg

    słownika IDSTATUS Id Status sprawy

    Zgodnie ze słownikiem

    Domyślnie 0 nieokreślony

    1 Po pierwszym wezwaniu do zapłaty 2 Drugie wezwanie do zapłaty 3 Nie jest toczone postępowanie sądowe 4 W trakcie postępowania przed sądem 5 Wydano orzeczenie - nakaz zapłaty 6 Egzekucja sądowa

    [1] {2}{3}{4}{5}

    Numer

    wg

    słownika IDTYTUL Id Tytuł egzekucyjny

    Zgodnie ze słownikiem

    Domyślny 0 Nieokreślony

    1 Wezwanie do zapłaty 2 Tytuł egzekucyjny

    {1}{2}{4}{5}

    Numer

    wg

    słownika IDWALUTA Id Waluta

    Zgodne ze słownikiem typ waluty

    Domyślny 1 PLN (polski złoty) 2 USD (amerykański dolar) 3 EUR (euro) 4 GBP (funt brytyjski)

    {1}{2}{4}{5}

    Numer

    wg

    słownika IDKATEGORIA Id Kategoria/Typ Sprawy

    Zgodnie ze słownikiem (skorelowane

    z REG) Wartość pominięta -

    domyślna wartość dla REG

    1 Zaległość 2-miesięczna (warunki płatności) 2 Zaległość 3-miesięczna (warunki płatności)

    [1] [2]{3}{4}{5}

    mailto:[email protected]

  • str. 59

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    3 Przekroczona wartość zaległości (warunki płatności) 4 Błędne dane osobowe (niesolidność / oszustwo) 5 Przekroczenie warunków umowy (niesolidność / oszustwo) 6 Fraud (kradzież impulsów) 7 Fałszerstwo dokumentów 8 Dłużnik z tytułu pieczy zastępczej 10 Inne używane tylko w rejestrze alimentacyjnym (2) Domyślnie 7 Zaległość alimentacyjna (gdy kwota zaległości jest podawana jako suma fundusz + zaliczka) 17 Fundusz alimentacyjny 18 Zaliczka alimentacyjna używane tylko w rejestrze długów (EDKKW) (5) 11 Grzywna 12 Koszty 13 Nawiązek na rzecz S.P. 14 Przedmiot przepadku 15 Kara porządkowa 16 Grzywna i koszty

    Tekst OPIS Dowolny opis szczegółów

    sprawy

    {1}{2}{3}{4}{5}

    mailto:[email protected]

  • str. 60

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Dokument Tekst DOKUMENT Nazwa dokumentu [3]

    Tekst SERIANR Seria i numer dokumentu [3]

    Data DATAWYDANIA

    Data wystawienia

    dokumentu Format ISO 8601 (2014-01-01) [3]

    Tekst WYSTAWCA

    Oznaczenia i dane wystawcy

    dokumentu [3]

    Tekst POSIADACZ

    Dane osób, których dotyczy

    dokument [3]

    Tekst DOKINFO Dodatkowe informacje {3}

    Tekst DOKORGAN Dane organu

    stwierdzającego

    nieprawidłowości [3]

    8.2 Przykłady plików CSV

    Wraz z dokumentacją przygotowano przykładowe paczki plików CSV.

    Test CSVTestEiwdencja2.zip zawiera 4 pliki kolejno rejestrujący nowe sprawy, modyfikujący te sprawy oraz zamykający i kasujący testowe sprawy

    mailto:[email protected]

  • str. 61

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.2.1 Dodanie nowych spraw do ewidencji długów alimentacyjnych

    REG;OPERACJA;ID;ID2;PESEL;NIP;REGON;IDINNE;IMIE;NAZWISKO;ADRES;KODPOCZTOWY;MIEJSCOWOSC;KRAJ;FIRMA;REJESTRAD;NRREJESTR

    AD;KORESPADRES;KORESPKODP;KORESPMIEJSCOWOSC;KORESPKRAJ;IDTYPDLUZNIKA;SYGNATURA;NALEZNA;DATAPOWSTANIA;ZALEGLA;KW

    ESTIONOWANA;DATAWYMAGANA;ORGAN;DATATYTUL;DATASTART;DATASTOP;IDSTATUS;IDTYTUL;IDWALUTA;IDKATEGORIA;DOKUMENT;SE

    RIANR;DATAWYDANIA;WYSTAWCA;POSIADACZ;DOKINFO;DOKORGAN;OPIS

    2;1;idTEST_abc_005;;36021516431;2539601862;956320492;Oznaczenie3_005;Imię_abc_005;Nazwisko_abc_005;Adres_abc_005;15-

    005;Miasto_abc_005;Kraj_abc_005;Firma_abc_005;Ewidencja_abc_005;NrEwidencji_abc_005;Kadres_abc_005;15-

    005;Kmiasto_abc_005;Kkraj_abc_005;1;ASYG/412/2/2016/202;59275;2016-10-08;59275;0;2016-10-22;OrganOrzek_abc_005;2016-10-

    29;2016-01-05;2016-10-29;1;1;1;7;;;;;;;;

    2;1;idTEST_abc_006;;47072917881;4911010241;714420229;Oznaczenie3_006;Imię_abc_006;Nazwisko_abc_006;Adres_abc_006;15-

    006;Miasto_abc_006;Kraj_abc_006;Firma_abc_006;Ewidencja_abc_006;NrEwidencji_abc_006;Kadres_abc_006;15-

    006;Kmiasto_abc_006;Kkraj_abc_006;1;ASYG/413/2/2016/202;32177;2016-02-11;32177;0;2016-02-25;OrganOrzek_abc_006;2016-03-

    03;2016-01-05;2016-03-03;1;1;1;7;;;;;;;;

    mailto:[email protected]

  • str. 62

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.2.2 Modyfikacja dwóch spraw ewidencja długów alimentacyjnych.

    REG;OPERACJA;ID;ID2;PESEL;NIP;REGON;IDINNE;IMIE;NAZWISKO;ADRES;KODPOCZTOWY;MIEJSCOWOSC;KRAJ;FIRMA;REJESTRAD;NRREJESTR

    AD;KORESPADRES;KORESPKODP;KORESPMIEJSCOWOSC;KORESPKRAJ;IDTYPDLUZNIKA;SYGNATURA;NALEZNA;DATAPOWSTANIA;ZALEGLA;KW

    ESTIONOWANA;DATAWYMAGANA;ORGAN;DATATYTUL;DATASTART;DATASTOP;IDSTATUS;IDTYTUL;IDWALUTA;IDKATEGORIA;DOKUMENT;SE

    RIANR;DATAWYDANIA;WYSTAWCA;POSIADACZ;DOKINFO;DOKORGAN;OPIS

    2;2;idTEST_abc_005;;36021516431;2539601862;956320492;Oznaczenie3_005;Imię_abc_005;Nazwisko_abc_005;Adres_abc_005;15-

    005;Miasto_abc_005;Kraj_abc_005;Firma_abc_005;Ewidencja_abc_005;NrEwidencji_abc_005;Kadres_abc_005;15-

    005;Kmiasto_abc_005;Kkraj_abc_005;1;ASYG/412/2/2016/202;0;2016-10-08;0;0;2016-10-22;OrganOrzek_abc_005;2016-10-29;2016-01-

    05;2016-10-29;1;1;1;7;;;;;;;;

    2;2;idTEST_abc_006;;47072917881;4911010241;714420229;Oznaczenie3_006;Imię_abc_006;Nazwisko_abc_006;Adres_abc_006;15-

    006;Miasto_abc_006;Kraj_abc_006;Firma_abc_006;Ewidencja_abc_006;NrEwidencji_abc_006;Kadres_abc_006;15-

    006;Kmiasto_abc_006;Kkraj_abc_006;1;ASYG/413/2/2016/202;0;2016-02-11;0;0;2016-02-25;OrganOrzek_abc_006;2016-03-03;2016-01-

    05;2016-03-03;1;1;1;7;;;;;;;;

    mailto:[email protected]

  • str. 63

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.2.3 Zamknięcie dwóch spraw Ewidencja długów alimentacyjnych

    REG;OPERACJA;ID;ID2;PESEL;NIP;REGON;IDINNE;IMIE;NAZWISKO;ADRES;KODPOCZTOWY;MIEJSCOWOSC;KRAJ;FIRMA;REJESTRAD;NRREJESTRAD;K

    ORESPADRES;KORESPKODP;KORESPMIEJSCOWOSC;KORESPKRAJ;IDTYPDLUZNIKA;SYGNATURA;NALEZNA;DATAPOWSTANIA;ZALEGLA;KWESTIONO

    WANA;DATAWYMAGANA;ORGAN;DATATYTUL;DATASTART;DATASTOP;IDSTATUS;IDTYTUL;IDWALUTA;IDKATEGORIA;DOKUMENT;SERIANR;DATAW

    YDANIA;WYSTAWCA;POSIADACZ;DOKINFO;DOKORGAN;OPIS

    2;4;idTEST_abc_005;;36021516431;2539601862;956320492;Oznaczenie3_005;Imię_abc_005;Nazwisko_abc_005;Adres_abc_005;15-

    005;Miasto_abc_005;Kraj_abc_005;Firma_abc_005;Ewidencja_abc_005;NrEwidencji_abc_005;Kadres_abc_005;15-

    005;Kmiasto_abc_005;Kkraj_abc_005;1;ASYG/412/2/2016/202;0;2016-10-08;0;0;2016-10-22;OrganOrzek_abc_005;2016-10-29;2016-01-05;2016-

    10-29;1;1;1;7;;;;;;;;

    2;4;idTEST_abc_006;;47072917881;4911010241;714420229;Oznaczenie3_006;Imię_abc_006;Nazwisko_abc_006;Adres_abc_006;15-

    006;Miasto_abc_006;Kraj_abc_006;Firma_abc_006;Ewidencja_abc_006;NrEwidencji_abc_006;Kadres_abc_006;15-

    006;Kmiasto_abc_006;Kkraj_abc_006;1;ASYG/413/2/2016/202;0;2016-02-11;0;0;2016-02-25;OrganOrzek_abc_006;2016-03-03;2016-01-05;2016-

    03-03;1;1;1;7;;;;;;;;

    mailto:[email protected]

  • str. 64

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.2.4 Usunięcie dwóch, żamkniętych spraw Ewidencja długów alimentacyjnych

    REG;OPERACJA;ID;ID2;PESEL;NIP;REGON;IDINNE;IMIE;NAZWISKO;ADRES;KODPOCZTOWY;MIEJSCOWOSC;KRAJ;FIRMA;REJESTRAD;NRREJESTRAD;

    KORESPADRES;KORESPKODP;KORESPMIEJSCOWOSC;KORESPKRAJ;IDTYPDLUZNIKA;SYGNATURA;NALEZNA;DATAPOWSTANIA;ZALEGLA;KWESTION

    OWANA;DATAWYMAGANA;ORGAN;DATATYTUL;DATASTART;DATASTOP;IDSTATUS;IDTYTUL;IDWALUTA;IDKATEGORIA;DOKUMENT;SERIANR;DAT

    AWYDANIA;WYSTAWCA;POSIADACZ;DOKINFO;DOKORGAN;OPIS

    2;3;idTEST_abc_005;;36021516431;2539601862;956320492;Oznaczenie3_005;Imię_abc_005;Nazwisko_abc_005;Adres_abc_005;15-

    005;Miasto_abc_005;Kraj_abc_005;Firma_abc_005;Ewidencja_abc_005;NrEwidencji_abc_005;Kadres_abc_005;15-

    005;Kmiasto_abc_005;Kkraj_abc_005;1;ASYG/412/2/2016/202;0;2016-10-08;0;0;2016-10-22;OrganOrzek_abc_005;2016-10-29;2016-01-

    05;2016-10-29;1;1;1;7;;;;;;;;

    2;3;idTEST_abc_006;;47072917881;4911010241;714420229;Oznaczenie3_006;Imię_abc_006;Nazwisko_abc_006;Adres_abc_006;15-

    006;Miasto_abc_006;Kraj_abc_006;Firma_abc_006;Ewidencja_abc_006;NrEwidencji_abc_006;Kadres_abc_006;15-

    006;Kmiasto_abc_006;Kkraj_abc_006;1;ASYG/413/2/2016/202;0;2016-02-11;0;0;2016-02-25;OrganOrzek_abc_006;2016-03-03;2016-01-

    05;2016-03-03;1;1;1;7;;;;;;;;

    mailto:[email protected]

  • str. 65

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    8.3 Szybkie tworzenie pików importu CSV

    Dla ułatwienia oraz przyspieszenia tworzenia plików CSV w formacie importu masowego,

    System KIDT umożliwia eksport listy wybranych spraw w postaci pliku CSV w formacie

    przygotowanym do importu. Na Rys. 64 przedstawiono sposób generowania pliku.

    W wyświetlanej liście spraw należy zaznaczyć (wybrać) jedną lub kilka spraw:

    Rys. 64 Szybkie przygotowanie pliku CSV do importu

    a nastęnie za pomocą funkcji generatora wybrać jeden ze znaków rozdzielająch:

    Wybór spowoduje uruchomienie generatora i przesłanie żądanego pliku CSV. Plik ten jest

    automatycznie interpretowany przez np. program MS Excel – standardowo kreator importu

    poprosi o potwierdzenie formatu: znaku rozdzielającego oraz kodowania.

    W procesie importu wymagane jest kodowanie UTF-8 i w takim formacie zostanie przesłany

    plik CSV.

    mailto:[email protected]

  • str. 66

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 65 Kreator importu pliku CSV do arkusza MS Excel

    Przesłany plik wymaga wybrania przez użytkownika typu operacji jaka będzie wykonywana w

    danym wierszu poprzez ustawienia kodu operacji w kolumnie OPERACJA.

    Rys. 66 Wczytany arkusz CSV

    mailto:[email protected]

  • str. 67

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    9 WEB Service KIDT-API

    Pełna, aktualna dokumentacja serwisu udostępniana na witrynie pomocy

    https://www.kidt.pl/kidtstart//kidtapi/

    Aktualne wersje

    v1.2.0 [ WERSJA RC.1 ]

    Serwer produkcyjny: https://www.kidt.pl/kidt/soap/ws/v1_2_0/ws.php?wsdl

    Serwer testowy: https://www.kidt.pl:9443/kidt/soap/ws/v1_2_0/ws.php?wsdl

    v1.1.1

    Serwer produkcyjny: https://www.kidt.pl/kidt/soap/ws/ws.php?wsdl

    Serwer testowy: https://www.kidt.pl:9443/kidt/soap/ws/ws.php?wsdl

    Rejestr KIDT dostarcza usługę WEBService, która umożliwia bezpośrednią komunikację

    pomiędzy systemem KIDT a systemami informatycznymi Partnerów. Wymiana danych

    następuje automatycznie w trybie online według określonych parametrów z godnie z

    opublikowanym API serwisu WS_KIDT. Usługa oparta jest o standard automatycznej

    komunikacji - technologię SOAP w wersji 1.1 styl komunikatów Document/Literal

    Na Rys. 67 przedstawiono listę funkcji usługi.

    mailto:[email protected]://www.kidt.pl/kidtstart/kidtapi/https://www.kidt.pl/kidt/soap/ws/v1_2_0/ws.php?wsdlhttps://www.kidt.pl:9443/kidt/soap/ws/v1_2_0/ws.php?wsdhttps://www.kidt.pl/kidt/soap/ws/ws.php?wsdlhttps://www.kidt.pl:9443/kidt/soap/ws/ws.php?wsd

  • str. 68

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 67 Definicja portu usługi WS_KIDT - lista operacji

    Poniżej zostały zamieszczone odnośniki do dokumentacji technicznej umożliwiającej

    implementację strony klienckiej wykorzystującej API. Poza opisem interfejsu w języku WSDL

    udostępniono dokumentację UML oraz przykłady rozwiązań i testów na platformach .net (C#

    Visual Studio 2013) oraz java (SoapUI).

    Dostępny jest Serwis testowy, na którym można przeprowadzać testy.

    Serwis Testowy, ze względu na swoje przeznaczenie, nie przechowuje danych dłużej niż 48

    godzin. Dane mogą być również kasowane w krótszych odstępach czasu.

    Tabela 3 Lista odnośników dokumentacji serwisu WS_KIDT

    Przykłady programowania pakiet SDK Dokumentacja użytkownika

    https://www.kidt.pl/kidtstart/kidtapi/?kidt-web-api-sdk/

    WSDL https://www.kidt.pl/kidt/soap/ws/ws.php?wsdl

    Serwis produkcyjny endpoint

    https://www.kidt.pl/kidt/soap/ws/ws.php

    Serwis Testowy endpoint

    https://www.kidt.pl:9443/kidt/soap/ws/ws.php

    class PortTypes

    «WSDLportType»

    KIDTWS

    + addDocumentCase(addDocumentCase, addDocumentCaseResponse*)

    + addEDKKWCase(addEDKKWCase, addEDKKWCaseResponse*)

    + addKIDTCase(addKIDTCase, addKIDTCaseResponse*)

    + addMaintenanceCase(addMaintenanceCase, addMaintenanceCaseResponse*)

    + addRespiteCareCase(addRespiteCareCase, addRespiteCareCaseResponse*)

    + getCreditorInfo(getCreditorInfo, getCreditorInfoResponse*)

    + getDictionary(getDictionary, getDictionaryResponse*)

    + getDocumentList(getDocumentList, getDocumentListResponse*)

    + getEDKKWList(getEDKKWList, getEDKKWListResponse*)

    + getKIDTCaseList(getKIDTCaseList, getKIDTCaseListResponse*)

    + getMaintenanceList(getMaintenanceList, getMaintenanceListResponse*)

    + getRespiteCareList(getRespiteCareList, getRespiteCareListResponse*)

    + getUserInfo(getUserInfo, getUserInfoResponse*)

    + login(login, loginResponse*)

    + logout(logout, logoutResponse*)

    + serviceInfo(serviceInfo, serviceInfoResponse*)

    mailto:[email protected]://www.kidt.pl/kidtstart/kidtapi/?kidt-web-api-sdk/https://www.kidt.pl/kidt/soap/ws/ws.php?wsdlhttps://www.kidt.pl/kidt/soap/ws/ws.phphttps://www.kidt.pl:9443/kidt/soap/ws/ws.php

  • str. 69

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    9.1 Zabezpieczenia serwisu WS_KIDT

    Dostęp do usług serwisu KIDT_WS jest chroniony dwustronną wymianą certyfikatów

    cyfrowych. Komunikacja odbywa przy użyciu protokołów ssl/tls. Do uwierzytelnienia może być

    użyty certyfikat osobisty zarejestrowanego użytkownika lub dedykowany certyfikat dla

    aplikacji klienckiej.

    Serwis KIDT_WS posiada zabezpieczenie przeciwko wielokrotnym, „złośliwym” wywołaniom

    operacji serwisu prostym mechanizmem numerowania kolejnych zaleceń zalogowanego

    klienta – INONCE .

    Zarówno klient jak i serwer numerują kolejne zlecenia. Klient w każdym zleceniu przesyła

    wartość licznik – INONCE. Niezgodność numerów sekwencji powoduje natychmiastowe

    zerwanie połączenia.

    mailto:[email protected]

  • str. 70

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 68 Scenariusz przekazywania INONCE podczas logowania oraz kolejnych operacji

    uc Scenariusz przekazywania INONCE podczas sesj i komunikacyjnej

    System KIDT - WEB Serwice API

    login(login, md5

    (passwd))

    WS_Client

    getCreditorInfo

    (sessionid,inonce)

    KIDT_WS

    return->sessionid

    return->inonce

    Return->CreditorInfo

    INONCE++

    generate sessionid

    and INONCE

    Test INONCE

    «Consumer»

    «Provider»

    «Consumer»

    «Provider»

    mailto:[email protected]

  • str. 71

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    10 Podstawowe pojęcia

    Kontrahent: Osoba fizyczna lub prawna.

    Partner: podmiot, który zawarł z KIDT BIG umowę oraz podmioty ustawowo zwolnione z

    obowiązku zawarcia Umowy, o których mowa w art. 12a oraz art. 16 ust. 5-7 Ustawy.

    Umowa partnerska: umowa o udostępnianie informacji gospodarczych, której przedmiotem

    są zasady współpracy pomiędzy KIDT BIG a Partnerem, posiadającym obowiązek

    zawarcia Umowy, w zakresie przekazywania, przechowywania, aktualizowania,

    usuwania i ujawniania informacji gospodarczych; przedmiotem Umowy mogą być

    również zasady ujawniania danych gospodarczych, tj. danych udostępnionych przez

    instytucje utworzone na podstawie art. 105 ust. 4 ustawy z dnia 29 sierpnia 1997 r. Prawo

    bankowe lub danych dotyczących wiarygodności płatniczej pochodzących od instytucji

    dysponujących takimi danymi, mających siedzibę w państwach członkowskich Unii

    Europejskiej, Konfederacji Szwajcarskiej lub państwach członkowskich Europejskiego

    Porozumienia o Wolnym Handlu (EFTA) – stronach umowy o Europejskim Obszarze

    Gospodarczym.

    Użytkownik: Osoba reprezentująca Partnera posiadająca dostęp do rejestru KIDT i

    uprawnienia do wyszukiwania, rejestracji i modyfikacji dłużników.

    Administrator: Osoba reprezentująca kontrahenta posiadająca dostęp do rejestru KIDT i

    uprawnienia do wyszukiwania, rejestracji i modyfikacji dłużników, a także zażądanie

    innymi użytkownikami, zarządzenie profilem kontrahenta.

    Profil użytkownika: szczegółowe dane osoby posiadającej uprawnienia dostępu do rejestru

    KIDT

    Podpis cyfrowy: Rejestr KIDT posiada własne, niekwalifikowane centrum autoryzacji

    KIDT_CA. Dla każdego użytkownika dostarczany jest certyfikat osobisty (Certyfikat

    X.509) umożliwiający identyfikacje oraz autoryzację w rejestrze KIDT. Podpis cyfrowy

    stanowi parę: Klucz publiczny (Certyfikat osobisty) - Klucz prywatny.

    mailto:[email protected]

  • str. 72

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Certyfikat użytkownika – zob. Podpis cyfrowy

    Certyfikat osobisty: - zob. Podpis cyfrowy

    Plik .pfx: stanowi bezpieczny magazyn dla podpisu cyfrowego oraz niezbędnych certyfikatów,

    Magazyn .pfx używany do dostarczania użytkownikom podpisu cyfrowego. Większość

    standardowo stosowanego oprogramowania komputerowe umożliwia importu i

    eksportu certyfikatów oraz kluczy prywatnych do magazynów przeglądarek

    internetowych. Dostęp do pliku .pfx jest chroniony hasłem.

    Protokoły SSL/TLS: zapewniają uwierzytelnienie serwera i (opcjonalnie) klienta oraz

    bezpieczeństwo komunikacji pomiędzy nimi.

    Profil Kontrahenta: szczegółowe dane kontrahenta.

    Karta profilu kontrahenta: dokument PDF zawierający informacje dot. danych dostępowych

    kontrahenta w tym loginy i hasła dla zarejestrowanych użytkowników, a także komplet

    podpisów cyfrowych.

    Rejestr KIDT: baza zawierająca dane o zaległościach finansowych konsumentów i

    przedsiębiorców.

    Aplikacja KIDT aplikacja typu WEB udostępniająca zasoby rejestru KIDT dla użytkowników.

    Aplikacja wymaga standardowej przeglądarki internetowej dla implementacji interfejsu

    użytkownika i umożliwia pracę zarówno na komputerach osobistych jaki urządzeniach

    mobilnych.

    Centrum Certyfikacji KIDT: Dedykowana aplikacja implementując Centrum Certyfikacji.

    Dostarcza mechanizmy tworzenia profili użytkowników wraz z podpisami cyfrowymi.

    mailto:[email protected]

  • str. 73

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Certyfikat główny kidt_CA.crt: Rejestr KIDT posiada własne, niekwalifikowane centrum

    autoryzacji KIDT. Dla poprawnej współpracy należy dodać certyfikat kidt_CA

    (https://www.kidt.pl/kidtstart/cacrt/kidt_CA.crt) do zaufanych urzędów certyfikacji

    RPC: Remote Procedure Call, ang. zdalne wywołanie procedury; mechanizm pozwalający na

    wywołanie procedur udostępnionych przez serwer.

    SOAP: protokół typu RDP oparty na XML-u. To jego wykorzystujemy łącząc się z KIDT

    WebAPI.

    WSDL: Web Services Desription Language, ang. język opisu usług sieciowych. To język

    umożliwiający poinformowanie kodu klienckiego o tym, jakie procedury udostępnia

    serwer usługi. KIDT WebAPI posiada definicję zapisaną w tym formacie.

    mailto:[email protected]://www.kidt.pl/kidtstart/cacrt/kidt_CA.crt

  • str. 74

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    11 Index

    A

    Administrator · 69

    Aplikacja KIDT · 3

    C

    Centrum Certyfikacji KIDT · 70

    Cetrum Certyfikacji KIDT · 9

    K

    Kartą profilu · 11

    Kontrahent · 69

    P

    Partner · 69

    plik .pfx · 70

    Profil Kontrahenta · 70

    Profil użytkownika · 69

    R

    Rejestr KIDT · 70

    U

    Użytkownik · 69

    mailto:[email protected]

  • str. 75

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    12 Spis ilustracji

    Rys. 1 Okno serwisu WWW z zaznaczonym przyciskiem logowania do systemu. ..................... 5

    Rys. 2 Okno powitalne aplikacji KIDT w przypadku braku ważnego certyfikatu osobistego. .... 6

    Rys. 3 Menu programu FireFox. ................................................................................................. 7

    Rys. 4 Parametry zawansowane – certyfikaty ............................................................................ 8

    Rys. 5 Importy certyfikatu .......................................................................................................... 8

    Rys. 6 Wyszukiwanie pliku z certyfikatem .................................................................................. 9

    Rys. 7 Wybór magazynu certyfikatów ........................................................................................ 9

    Rys. 8 Parametry zawansowane - certyfikaty .......................................................................... 10

    Rys. 9 Import certyfikatu osobistego. ...................................................................................... 10

    Rys. 10 Wybór typu kontenera certyfikatu. ............................................................................. 11

    Rys. 11 Wyszukiwanie pliku z certyfikatem osobistym. ........................................................... 11

    Rys. 12 Wprowadzenie hasła do pliku PFX ............................................................................... 12

    Rys. 13 Widok magazynu z zaimportowanym certyfikatem osobistym. ................................. 12

    Rys. 14 Okno z informacjami o wybranym certyfikacie, który zostanie użyty do procesu

    uwierzytelnienia użytkowania. ................................................................................................. 13

    Rys. 15 Okno logowania. .......................................................................................................... 14

    Rys. 16 Okno kreatora importu certyfikatów. .......................................................................... 15

    Rys. 17 Wybór magazynu do którego zostanie zaimportowany certyfikat. ............................ 16

    Rys. 18 Potwierdzenie importu. ............................................................................................... 16

    Rys. 19 Komunikat informujący o zamiarze importu i instalacji certyfikatu z kluczem

    prywatnym ............................................................................................................................... 17

    Rys. 20 Okno parametrów importu certyfikatu osobistego..................................................... 18

    Rys. 21 Okno z informacjami o wybranym certyfikacie, który zostanie użyty do procesu

    uwierzytelnienia użytkowania. ................................................................................................. 19

    Rys. 22 Okno logowania. .......................................................................................................... 20

    Rys. 23 Podgląd zainstalowanych certyfikatów. ...................................................................... 21

    Rys. 24 Okno potwierdzenia instalacji certyfikatu. .................................................................. 22

    Rys. 25 Monit o rozpoczęcie procesu instalacji ....................................................................... 22

    Rys. 26 Informacja o roli certyfikatu, który zostanie dodany do zaufanych certyfikatów. ...... 23

    Rys. 27 Ostateczny monit o potwierdzenie instalacji. ............................................................. 23

    Rys. 28 Zainstalowany, poprawny certyfikat kidt_CA . ............................................................ 24

    Rys. 29 Komunikat z monitem o rozpoczęcie procesu instalacji certyfikatu osobistego. ....... 25

    Rys. 30 Informacja o wczytaniu pliku PFX z certyfikatem i informacją o ochronie hasłem. .... 25

    Rys. 31 Prośba o podanie hasła zabezpieczającego zawartość pliku PFX ................................ 26

    Rys. 32 Widok informujący o zainstalowanych certyfikatach. ................................................. 26

    Rys. 33 Prawidłowo zainstalowany certyfikat użytkownika. .................................................... 27

    Rys. 34 Okno serwisu WWW z zaznaczonym przyciskiem logowania do systemu. ................. 28

    Rys. 35 Okno powitania w przypadku braku ważnego certyfikatu osobistego. ...................... 29

    mailto:[email protected]

  • str. 76

    Infolinia: 41 333 50 00

    Obsługa klienta:41 333 50 01, e-mail: [email protected]

    Rys. 36 Okno logowanie do rejestru KIDT. ............................................................................... 29

    Rys. 37 Informacje o rozpoznany certyfikacie osobistym ........................................................ 30

    Rys. 38 Widok menu oraz okna profilu użytkowania. .............................................................. 31

    Rys. 39 Widok menu oraz okna profilu użytkowania - urządzenie mobilne. ........................... 32

    Rys. 40 Widok profilu partnera ................................................................................................ 34

    Rys. 41 Informacje statystyczne ............................................................................................... 35

    Rys. 42 Wprowadzenie unikatowego identyfikatora dłużnika ................................................. 35

    Rys. 43 Widok: Lista spraw ....................................................................................................... 38

    Rys. 44 Kontrolka filtrów wyszukiwania spraw ........................................................................ 38

    Rys. 45 Zestawienie listy spraw ................................................................................................ 40

    Rys. 46 Funkcje kontrolki zestawienia listy spraw ................................................................... 42

    Rys. 47 Wybór grupy spraw i uruchomienie grupowej operacji zamykania. ........................... 44

    Rys. 48 Potwierdzenie operacji grupowej ................................................................................ 44

    Rys. 49 Raport operacji grupowej ............................................................................................ 45

    Rys. 50 Wybór grupy spraw i uruchomienie grupowej operacji usuwania.............................. 45

    Rys. 51 Potwierdzenie wykonania operacji grupowej ............................................................. 45

    Rys. 52 Raport wykonania grupowej operacji usuwania. ....................................................... 46

    Rys. 53 Funkcje kontrolki wyszukiwania dłużników ................................................................. 46

    Rys. 54 Przykładowy raport o dłużniku. ................................................................................... 47

    Rys. 55 Menu - Operacje masowe ............................................................................................ 48

    Rys. 56 Okno przekazywania pliku CSV do rejestru KIDT ......................................................... 49

    Rys. 57 Informacja o postępie przysłania pliku. ....................................................................... 49

    Rys. 58 Błąd przekazywania pliku CSV na serwery KIDT .......................................................... 50

    Rys. 59 Etap 2 Importu – rozpoczęcie analizy pliku CSV. ......................................................... 51

    Rys. 60 Etap 3 – Okno informacji o post postępie analizy pliku CSV. ...................................... 51

    Rys. 61 Informacja o postępie analizy pliku CSV w pasku nawigacyjnym ................................ 51

    Rys. 62 Etap 4 Raport o przetworzonych sprawach oraz błędach .......................................... 52

    Rys. 63 Etap 5 Podsumowanie importu ................................................................................... 52

    Rys. 64 Szybkie przygotowanie pliku CSV do importu ............................................................. 65

    Rys. 65 Kreator importu pliku CSV do arkusza MS Excel .......................................................... 66

    Rys. 66 Wczytany arkusz CSV ................................................................................................... 66

    Rys. 67 Definicja portu usługi WS_KIDT - lista operacji ........................................................... 68

    Rys. 68 Scenariusz przekazywania INONCE podczas logowania oraz kolejnych operacji ........ 70

    mailto:[email protected]