Specyfikacja formatu Yonick 2.0

Transkrypt

YONICK
IMPORT DANYCH Z
PLIKÓW CSV
SPECYFIKACJA PLIKU
Wersja 2.0 z dnia 2001-02-01
Numer dokumentu
2006/IT-P/??
Kategoria dokumentu
Projekt
Status dokumentu
Opracowanie zewnętrzne
Słowa kluczowe
Biuro Informacji Gospodarczej, BIG, Rahl, Nicci, Siddin, Transza, Web Service
Copyright © Krajowy Rejestr Długów, 2006
Wszelkie korekty, komentarze oraz uwagi proszę przesyłać na adres [email protected]
GKK, ul. Armii Ludowej 21, 51-214 Wrocław
Tel. +48(71)7850000, fax +48(71)7850100, http://www.krd.pl
Yonick
Import danych z plików CSV
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
Atrybuty dokumentu
Atrybut
Wartość
A
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
B
Numer
Projekt
Tytuł
Podtytuł
Wersja
Czas wersji
Kategoria
Plik
Lokalizacja
2006/IT-P/??
Yonick
Specyfikacja pliku
2.0
2006.09.08
Projekt
Yonick-2.0.doc
http://www.krd.pl/exchange/public/Dział
Informatyczny/Dokumenty/Archiwum/Projekty
13
Normal.dotm
<BRAK>
Radek Soska, Sebastian T. Tkocz, Maciej Kasierski
Liczba stron
Szablon
Instrukcja
Autorzy
Nadzór
Dział
Kontakt - email
Kontakt - telefon
Prawa autorskie
Komentarz
Sebastian Tkocz
Dział Informatyczny
[email protected]
+48(71)7850213
Historia dokumentu
1
2
3
4
5
6
Atrybut
Wartość
A
B
Wersja
Autor
Sprawdził treść
Sprawdził formę
Zatwierdził
Opis
1.0
Sebastian Tkocz
Radosław Soska
1.1
Maciej Kasierski
Radosław Soska
Data
2006-04-20
2006-04-20
Druga wersja
Wartość
1.2
Maciej Kasierski
Rafał Stramski
Data
2006-08-28
2006-08-28
Dodanie do drugiej wersji “zawieszania” i “powiadamiania”
Atrybut
Wersja
Autor
Sprawdził treść
Sprawdził formę
Zatwierdził
Opis
2005-04-25
Wartość
Atrybut
Wersja
Autor
Sprawdził treść
Sprawdził formę
Zatwierdził
Opis
C
2005-04-10
Pierwsza wersja
Atrybut
Wersja
Autor
Sprawdził treść
Sprawdził formę
Zatwierdził
Opis
Data
Wartość
2.0
Maciej Kasierski
Rafał Stramski
Data
2011-02-15
2011-02-15
Dodanie specyfikacji dotyczącej spraw z klauzulą wykonalności
Strona 2 z 13
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
Spis treści
SPIS TREŚCI ....................................................................................................... 3
WSTĘP ................................................................................................................ 4
1.
DANE PRZEKAZYWANE DO BIURA ................................................................ 5
1.1.
1.2.
2.
1.2.1.
Dane dłużnika ................................................................................... 6
1.2.2.
Dane zobowiązania ............................................................................ 7
1.2.3.
Dane zawieszania i powiadomienia ...................................................... 9
1.2.4.
Dane zobowiązań z klauzulą wykonalności ...........................................10
TYPY ZLECEŃ ............................................................................................. 11
2.1.
2.2.
2.3.
3.
DANE STERUJĄCE ......................................................................................... 5
INFORMACJE GOSPODARCZE............................................................................. 5
ZLECENIA DOTYCZĄCE INFORMACJI GOSPODARCZYCH ..............................................11
OPCJE ZLECEŃ ...........................................................................................12
POTWIERDZENIA .........................................................................................12
PLIK WYJŚCIOWY ...................................................................................... 13
Strona 3 z 13
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
Wstęp
Protokół NICCI pozwala na zdefiniowanie w formie pliku XML listy zleceń dla
systemu KRD. Zlecenia te obejmują między innymi dodawanie, aktualizację i
usuwanie różnych typów informacji gospodarczej, zarządzanie monitoringiem
itp. Jednak z powodu różnorodności operacji i danych na których te operacje
są wykonywane struktura pliku NICCI jest dość skomplikowana.
Yonick jest odpowiedzią na potrzeby tych klientów, którzy nie potrzebują
pełnej funkcjonalności protokołu NICCI, a chcą w prostszy sposób
zautomatyzować proces przekazywania danych o swoich dłużnikach do bazy
KRD. Z tego powodu jako bazę, zamiast formatu XML wykorzystanego w
protokole NICCI, wybiera format plików tekstowych CSV. Ogranicza też ilość
możliwych operacji (dodawanie, aktualizacja i usuwanie, zawieszanie
odwieszanie spraw) oraz typów danych (tylko informacje gospodarcze o
niespłaconych zobowiązaniach) jakimi jest w stanie operować.
Pliki w formacie Yonick będą konwertowane do plików transzy NICCI w
systemach informatycznych klienta i w takiej postaci przesyłane do KRD.
Zadanie to wykona np. program SABAR – klient protokołu SIDDIN, który
wysyła transze NICCI do KRD.
Dokument ten opisuje strukturę pliku CSV, który jest zgodny z protokołem
Yonick.
Strona 4 z 13
Yonick
2006/IT-P/??
1.
Wersja: 2.0
Z dnia:2011-02-01
Dane przekazywane do biura
Dane, które można przekazać do biura infomacji gospodarczej reguluje
ustawa. Określa ona minimalny i maksymalny zakres danych, a także
dodatkowe warunki jakie muszą zostać spełnione, by biuro miało prawo te
dane przyjąć.
Jedynym typem informacji gospodarczej jaki definiuje protokół Yonick są
informacje o niespełnionych zobowiązaniach podmiotów gospodarczych.
Pojedyńcza linia pliku CSV definiuje jedno niespełnione zobowiązanie.
Zobowiązania wobec jednego dłużnika mogą zostać zgrupowane w pojęcie
sprawy, pod warunkiem że w pliku CSV będą one także zgrupowane, czyli jeśli
będą znajdować się w kolejnych, nastepujących po sobie liniach pliku CSV
oraz jeśli identyfikator sprawy i dane dłużnika będą w każdej linii identyczne.
Jeśli grupowanie nie nastąpi, do systemu KRD przekazywane zostaną sprawy
zawierające pojedyńcze zobowiązania. Jest to o tyle istotne, że pewne
warunki wymagane by możliwe było przyjęcie danych przez KRD (np.
sumaryczna, minimalna kwota zobowiązań) sprawdzane są na poziomie
sprawy.
Pojęcie sprawy widoczne jest jedynie dla klienta wprowadzającego tę sprawę.
Dla osób trzecich, którym zostaną ujawnione informacje gospodarcze
dotyczące dłużnika, zobowiązania jednej sprawy widoczne będą jako
niepowiązane ze sobą (poza danymi wierzyciela, jeśli nie zastrzegł on sobie
ich ujawniania) informacje gospodarcze dotyczące niespełnionych zobowiązań.
1.1.
Dane sterujące
Dane przekazywane protokołem Yonick do systemu KRD są zleceniami
wykonania konkretnych operacji: np dadania nowej informacji gospodarczej
do bazy KRD. Rodzaj operacji jaka zlecana jest systemowi KRD, jej
ewentualne opcje oraz typ informacji gospodarczej na której będzie
wykonywana dana operacja gospodarcza ujęte są w protokole Yonick w
pierwszych dwóch kolumnach.
Tabela 1 : Dane sterujące
Numer(y)
kolumny
Nazwa kolumny
A
1
2
3
B
Opis
Uwagi
Wymagane
C
C
D
Kody operacji są
trzyliterowe
Dwuliterowy kod CM
lub LP
Max. 128 znaków
1
OPERATIONTYPE
2
INFORMATIONTYPE
Typ zlecanej operacji wraz z
ewentualnymi opcjami
Typ informacji gospodarczej
3
CASEID
Identyfikator sprawy
TAK
TAK
TAK
Typy operacji i ich opcje są opisane w rozdziale drugim.
Identyfikator sprawy (pojęcie sprawy wyjasnionen jest w punkcie 1.2) jest
konieczny w celu późniejszego modyfikowania/usuwania spraw protokołem
Yonick. Identyfikatorem może być dowolny ciąg znaków o maksymalnej
długości 128 znaków. Musi on być unikalny w ramach klienta (nie trzeba się
martwić o nałożenie się identyfikatorów z innymi klientami biura)
Identyfikator należy umieścić w trzeciej kolumnie pliku.
1.2.
Informacje gospodarcze
Ustawa definiuje cztery typy informacji gospodarczych, jakie mogą być
przechowywane w biurach informacji gospodarczej. Są to informacje o
niespłaconych zobowiązaniach konsumentów i przedsiębiorców, informacje o
spłaconych zobowiązaniach oraz informacje o posłużeniu się fałszywym bądź
skradzionym dokumentem. Protokół Yonick umożliwia operowanie jedynie
Strona 5 z 13
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
informacjami gospodarczymi o niespłaconych zobowiązaniach. W przypadku
takich informacji KRD BIG S.A. tworzy pojęcie sprawy.
Sprawa to grupa informacji gospodarczych dotyczących niespłaconych
zobowiązań jednego dłuznika wobec klienta zgłaszającego tę informację.
System KRD operuje pojęciem sprawy by umożliwić dodanie w jednej
transakcji więcej niż jednego zobowiązania dłużnika oraz by ułatwić
zarządzanie tymi zobowiązaniami, np. umożliwić aktualizację danych dłużnika
w jednym miejscu. Dłużnikiem może być konsument bądź osoba prawna.
Sprawa składa się z identyfikatora, danych dłużnika oraz danych zobowiązań
(co najmniej jednego zobowiązania).
1.2.1. Dane dłużnika
Dłużnikiem zdefiniowanym w pliku Yonick może być osoba fizyczna lub osoba
prawna. Jednak tylko określone w ustawie podmioty mogą dostarczać
informacje gospodarcze dotyczące konsumentów (osób fizycznych).
Rozróżnienie tego czy zgłaszany dług jest długiem przedsiębiorcy (nawet
jednoosobowego) czy długiem osoby fizycznej następuje na podstawie
zakresu danych – jeśli w krotce pliku podany jest NIP, dług uznawany jest za
dług przedsiębiorcy (niezaleznie od tego czy podany zostanie także numer
PESEL)
Dla określenia, czy dłużnik jest osobą fizyczną czy też osobą prawną w
kolumnie nr 2 należy wprowadzć kod CM (konsument) lub LP (osoba prawna)
1.2.1.1.
Podmiot gospodarczy
Wymagane dane przedsiębiorstwa (“podmiotu będącego osobą prawną lub
jednostką organizacyjną nieposiadającą osobowości prawnej”) to oznaczenie,
siedziba i adres oraz numer identyfikacji podatkowej. Opcjonalnie można
podać numer REGON, numer pod którym podmiot wpisany jest do właściwego
rejestru (wraz z oznaczeniem sądu rejestrowego) oraz główny przedmiot
działalności gospodarczej.
Numer identifikacji podatkowej może być podany jako ciąg 10 cyfr bez kresek,
bądź jako oddzielone kreskami: 3, 3, 2 i 2 cyfry (np. 112-123-09-01) lub 3, 2,
2 i 3 cyfry (np. 112-21-30-901). Numer REGON to 9 cyfr.
Adres w protokole Yonick zdefiniowany jest jako ciąg 2 do 4 pól, w których
powinny się znaleźć wszystkie dane potrzebne do dostarczenia przesyłki, czyli
co najmniej kod pocztowy i nazwa miejscowości, oraz wskazanie posesji (np.
ulica i numer domu).
Kod pocztowy i nazwa miejscowości muszą znajdować się w jednym polu
(system identyfikuje nazwę miejscowości tym, że przed nią znajduję się kod
pocztowy).
System rozpoznaje następujące przedimki w nazwie posesji:
ul.- ulica, al.- aleja, pl.- plac
Inne przedimki zostaną potraktowane jako składowe nazwy.
Jeśli dłużnikiem jest przedsiębiorstwo jednosobowe, można podać dane osoby
fizycznej, która jest tym przedsiębiorstwem. Dane te nie muszą spełniać
ustawowych wymogów dotyczących zakresu wymaganych danych osoby
fizycznej.
Strona 6 z 13
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
Tabela 2 : Dane przedsiębiorstwa
Numer(y)
kolumny
Nazwa kolumny
A
Opis
B
C
4
NAME
Nazwa
przedsiębiorstwa
5
NIP
Numer identyfikacji podatkowej
6
7
REGON
EKD
8
9
REGISTRATIONNUMBER
REGISTRYNAME
Numer regon przedsiębiorstwa
Numer
EKD
(Europejska
Klasyfikacja Działalności)
Numer w rejestrze
Nazwa rejestru, w którym jest
w/w numer
1
2
3
4
5
10-13
SEATADDRESS
(oznaczenie)
Siedziba i adres
6
Uwagi
Wymagane
C
D
Niepusty tekst,
max. 128
znaków
Niepusty tekst,
max. 13 znaki
Max. 9 cyfr
Max. 128
znaków
Muszą wystąpić
razem,
każda max.
128 znaków
Cztery linie,
każda max.
128 znaków
TAK
TAK
NIE
NIE
NIE
TAK
Protokół Yonick nie ma możliwości podania imion i nazwisk osób wchodzących
w skład organów zarządzających, prokurentów lub pełnomocników tego
podmiotu. Nie ma też możliwośći wprowadzenia informacji o wspólnikach czy
aukcjonariuszach dłużnika.
1.2.1.2.
Osoba fizyczna
Wymagane dane osoby fizycznej to imię i nazwisko, obywatelstwo oraz numer
PESEL (dla obywateli polskich) lub seria i numer dokumentu potwierdzającego
tożsamość (dla obcokrajowców). Pozostałe, opcjonalne dane to adres
zameldowania (na pobyt stały lub czasowy) i data urodzenia. Dla obywateli
polskich można także podać serię i numer dowodu osobistego lub innego
dokumentu potwierdzającego tożsamość.
Jeśli dłużnikiem jest osoba fizyczna prowadząca działalność gospodarczą,
można podać dane jego przedsiębiorstwa, dane te nie podlegają jednak wtedy
ustawowym wymogom wymagalności danych osób prawnych.
Tabela 3 : Dane osoby fizycznej
Numer(y)
Kolumny
Nazwa
kolumny
A
Opis
B
C
14
FIRSTNAME
Imię
15
SECONDNAME
Drugie imię
16
SURNAME
Nazwisko
17
CITIZENSHIP
Obywatelstwo
18-21
ADDRESS
Adres zameldowania
czasowy)
22
BIRTHDAY
Data urodzin
23
PESEL
Numer PESEL (wymagany dla obywateli
polskich)
Opis
dokumentu
potwierdzającego
tożsamość
1
2
3
4
5
6
7
24-26
IDENTITYCARD
8
(pobyt
stały
lub
Uwagi
Wymagane
D
E
Niepusty
tekst, max.
32 znaki
Max. 32
znaki
Niepusty
tekst, max.
64 znaki
Niepusty
tekst, max.
64 znaki
Cztery linie,
każda max.
128 znaków
Format daty
rrrr-MM-dd
TAK
NIE
TAK
TAK
NIE
NIE
11 cyfr
Typ, seria i
numer,
każdy max.
128 znaków
Jedno lub
drugie
1.2.2. Dane zobowiązania
Zobowiązanie
opisane
jest
co
najmniej
czterema
elementami:
identyfikatorem, tytułem prawnym zobowiązania, kwotą zaległości oraz datą
Strona 7 z 13
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
powstania zaległości. Protokół Yonick nie pozwala na przekazywanie informacji
o zobowiązaniach w walutach innych niż PLN.
Dodatkowo podać można kwotę zobowiązania (kwoty te będą różne np.
wtedy, kiedy zobowiązanie zostało częściowo spłacone).
Do danych wierzytelności można także dodać opis stanu postępowań
dotyczących zobowiązania (np. o toczących się postępowaniach sądowych lub
egzekucyjnych) oraz informację o kwestionowaniu przez dłużnika całości bądź
części zobowiązania. Opisy te mają formę luźnego tekstu o maksymalnej
długości 1024 znaków.
Przekazując do biura dane o zobowiązaniu, klient musi podać datę wysłania do
dłużnika wezwania do zapłaty tego zobowiązania. To wezwanie do zapłaty
musi zawierać ostrzeżenie o zamiarze przekazania danych do biura informacji
gospodarczej, z podaniem nazwy i adresu siedziby tego biura.
Aby informacja o zobowiązaniu mogła zostać przyjęta przez biuro, przekazane
dane muszą spełniać trzy warunki (poza dostarczeniem minimalnych danych):

Zobowiązanie jest wymagalne od co najmniej 60 dni (czyli od daty
“PaymentDate” minęło 60 dni)

Upłynął co najmniej miesiąc od wysłania wezwania do zapłaty (czyli od
daty “CallSent”)

Łączna kwota zobowiązań dłużnika wobec klienta przekroczyła 200zł
jeśli dłużnikiem jest konsument, oraz 500zł jeśli dłużnikiem jest
podmiot gospodarczy.
Naturalnie spełnione muszą być też wszystkie pozostałe, określone przez
ustawę wymogi, które nie są wyspecyfikowane w danych (np. posiadanie
uprawnień do dostarczania informacji gospodarczych o konsumentach).
Dane zobowiązania przekazywane do biura zebrane są w tabeli 4.
Tabela 4 : Dane zobowiązania
Numer
Kolum
ny
Nazwa
kolumny
A
27
B
ID
1
2
3
4
5
6
28
TITLE
29
30
31
32
33
DEBT
ARREARS
CURRENCY
PAYMENTDATE
OBJECTIONS
34
PROCEEDINGS
35
CALLSENT
7
8
9
Opis
Uwagi
Wymagane
C
D
E
Identyfikator zobowiązania. Dowolny
ciąg znaków ustalony przez klienta.
Identyfikator musi być
unikalny dla wszystkich
zobowiązań klienta,
max. 128 znaków
Element niepusty, max.
128 znaków
Tytuł prawny zobowiązania, np.
„Faktura 145/A/02”
Kwota zobowiązania
Kwota zaległości
Waluta zobowiązania i zaległości
Data powstania zaległości
Informacja o kwestionowaniu przez
dłużnika
całości
lub
części
zobowiązania.
Opis stanu postępowań dotyczących
tego zobowiązania
Data wysłania do dłużnika wezwania
do zapłaty
Strona 8 z 13
Max. 3 znaki, np. „PLN”
Format rrrr-MM-dd
Wymagane, jeśli
istnieją, max. 1024
znaki
TAK
TAK
NIE
TAK
TAK
TAK
NIE
Max. 1024 znaki
NIE
Format rrrr-MM-dd
TAK
Yonick
2006/IT-P/??
Wersja: 2.0
Z dnia:2011-02-01
UWAGA! Pole “OBJECTIONS” musi być, zgodnie z wymogami Ustawy,
wypełnione zawsze, gdy dłużnik kwestionuje wierzytelności umieszczone w
Rejestrze. Zarzuty mogą być wprowadzone do bazy wraz z zobowiązaniami
(operacja dodania sprawy), jeśli zaś zostaną zgłoszone przez dłużnika, gdy
sprawa widnieje już w KRD, należy dokonać modyfikacji danych.
Fakultatywność pola „OBJECTIONS” należy rozumieć w kontekście technicznym.
Merytorycznie pozostawienie pola “OBJECTIONS” pustego oznacza
brak
zarzutów, jego wypełnienie oznacza wprowadzenie do bazy treści zarzutów.
Każde zarzuty dłużnika muszą być dopisane do sprawy, poprzez użycie
protokołów lub poprzez serwis WWW.
1.2.3. Dane zawieszania i powiadomienia
Ustawa pozwala na zawieszenie na czas okreslony publikacji informacji
gospodarczych. Zawieszona informacja gospodarcza nie będzie udostępniana
osobom trzecim w ramach wyszukiwania. Natomiast informacja taka znajduje
się dalej w bazie danych KRD i zostanie ujawniona w ramach zapytania o
siebie.
W celu zawieszenia publikacji należy oprócz wybrania odpowiedniego kodu
operacji, podać datę końcową zawieszenia w polu nr 36. W celu wznowienia
publikacji należy wybrać odpowiedni kod operacji oraz pozostawić pole nr 36
puste. W obu przypadkach wymagane jest podanie identyfikatora
zobowiązania (kolumna 27), którego operacja dotyczy.
System KRD umożliwia wysłanie do dłużnika powiadomienia o tym, że został
dopisany do bazy KRD. Powiadomienie takie można wysłać listem zwykłym
bądź poleconym. Można je także wysłać na adres korespondencyjny, inny niż
ten podany w informacji gospodarczej.
Typ listu jaki należy wysłać do dłuznika określa się kodem umieszczonym w
polu 37. Jeśli nie chcemy wysyłac powiadomienia, pozostawiamy je puste. Kod
“P” oznacza prośbę o wysłanie listu zwykłego a kod “R” prośbę o wysłanie listu
poleconego. Jeśli pola 38-41 zostaną wypełnione, to list zostanie wysłany na
podany w nich adres korespondencyjny dłużnika. W przeciwnym wypadku list
zostanie wysłany na adres zamieszkania lub siedziby dłużnika podany w
ramach informacji gospodarczej.
Zestawienie danych umieszczone zostało w tabeli nr 5. Formaty daty
zawieszenia i adresu korespondencyjnego są analogiczne do innych dat i
adresów w protokole Yonick.
Tabela 5 : Dane zawieszania i powiadomień
Numer
Kolum
ny
Nazwa kolumny
Uwagi
Wymagane
D
E
Format rrrr-MM-dd
NIE
A
B
C
36
SUSPENDCASEO
BLIGATIONDATE
Data końcowa zawieszenia informacji
gospodarczej.
Wymagana,
gdy
zlecamy
zawieszenie
publikacji
informacji
Opcjonalne
zlecenie
wysyłki
do
dłużnika
powiadomienia
listem
poleconym lub zwykłym
Adres, na jaki zostanie wysłane
powiadomienie
1
37
NOTIFYDEBTOR
2
3
Opis
38-41
NOTIFYADDRESS
Strona 9 z 13
Wpisanie P lub p list
zwykły r lub R
polecony
Cztery linie, każda
max. 128 znaków
NIE
NIE
Yonick
2006/IT-P/??
1.2.4.
Wersja: 2.0
Z dnia:2011-02-01
Dane zobowiązań z klauzulą wykonalności
Dla zobowiązań z klauzulą wykonalności Ustawa wymaga przekazania do KRD
dodatkowych danych. Są one wymagane przy wybraniu opcji ^E przy kodach
operacji z kolumny 1
Tabela 6 : Dane zobowiązań z klauzulą wykonalności
Numer
Kolum
ny
A
1
2
3
42
43
44
Nazwa kolumny
B
SIGNATURE
EXECUTIVEOBLI
GATIONDATE
DECIDINGAUTH
ORITY
Opis
Uwagi
C
Sygnatura akt
Data wydania tytułu wykonawczego
Dane organu orzekającego
Strona 10 z 13
Wymagane
D
E
Max. 128 znaków
NIE
Format rrrr-MM-dd
NIE
Max. 128 znaków
NIE
Yonick
2006/IT-P/??
2.
Wersja: 2.0
Z dnia:2011-02-01
Typy zleceń
2.1.
Zlecenia dotyczące informacji gospodarczych
Do biura informacji gospodarczych można przekazywać zlecenia wykonania
usług. Te usługi dotyczą zarządzania informacjami gospodarczymi:
dodawania, modyfikacji, usuwania, zawieszania i odwieszania publikacji
informacji gospodarczych, zlecania wysyłki do dłużnika powiadomień listem
zwykłym lub poleconym.
Aktualnie protokół Yonick obsługuje następujące rodzaje zleceń:

dodanie informacji gospodarczej

aktualizacja informacji gospodarczej

usunięcie informacji gospodarczej

zawieszanie publikacji informacji gospodarczej

wznowienie publikacji informacji gospodarczej
Podczas zlecania dodania informacji gospodarczej, można także zlecić
wysłanie do dłużnika powiadomienia o tym, że został on dodany do bazy KRD.
Powiadomienie takie wysyłane jest listem zwykłym lub poleconym.
Nie planuje się obsługi innych typów informacji
informacjami o niespłaconych zobowiązaniach)
gospodarczej
(poza
Typ zlecenia, czyli rodzaj zlecanej operacji umieszcza się dla protokołu Yonick
w pierwszej kolumnie pliku CSV. Aktualnie obługiwane kody to:
-
‘ADD’, oznaczający dodanie informacji gospodarczej,
-
‘UPD’, oznaczający aktualizowanie informacji gospodarczej,
-
‘RMV’, oznaczający usuwanie sprawy (wszystkich informacji gospodarczych
o tym samym identyfikatorze z kolumny 2 “INFORMATIONTYPE”)
-
‘SSP’ oznaczający zawieszenie informacji gospodarczej
-
‘USP’ oznaczający odwieszenie informacji gospodarczej
Aby usunąć pojedyńczą informację gospodarczą, gdy jest ona przypisana do
sprawy składającej się z więcej niż jednego zobowiązania, należy podczas
aktualizacji danych nie umieszczać jej w pliku aktualizacyjnym (np gdy została
spłacona jedna z trzech faktur danego dłużnika, należy wykonać aktualizację
dwóch pozostałych). Analogicznie można dopisać dowolną ilość informacji
gospodarczych do istniejącej już sprawy. (np wprowadzić pięć zobowiązań w
pliku aktualizacyjnym, gdzie sprawa składa się z trzech faktur).
UWAGA!
Aktualizując sprawę należy w pliku zapisać WSZYSTKIE informacje
gospodarcze składające się na tą sprawę. Pominięcie któregoś
zobowiązania będzie skutkowało jego usunięciem z KRD.
Przy zawieszaniu i odwieszaniu wierzytelności wymagane jest jedynie podanie
identyfikatora zobowiązania.
Należy też zwrócić uwagę, na to, że identyfikatory sprawy i zobowiązania
muszą być unikalne w ramach wszystkich spraw i zobowiązań klienta KRD.
Ponadto do zlecenia wysyłki powiadomienia do dłużnika służy kolumna
NotifyDebtor, gdzie po wprowadzeniu symboli P lub R zlecony zostaje
odpowiednio list zwykły lub polecony. Powiadomienie wysyłane jest na główny
adres dłużnika (w przypadku przedsiębiorcy DebtorSeatAddress; w przypadku
konsumenta DebtorAddress) chyba, że w kolumnach NOTIFYADDRESS podany
zostanie adres korespondencyjny.
Strona 11 z 13
Yonick
2006/IT-P/??
2.2.
Wersja: 2.0
Z dnia:2011-02-01
Opcje zleceń
W polu kodu zlecanej operacji można też umieścić opcje dotyczące tego
zlecenia. Opcje oddziela się od kodu operacji znakiem ^ (spacing circumflex
accent, kod ASCII $5E). Nazwa opcji składa się z jednego znaku.
Obsługiwaną w ten sposób opcją jest żądanie pełnego potwierdzenia
wykonanej operacji przez odesłanie danych zawartych w bazie KRD przed
bądź po wykonaniu usługi. Kodem tej opcji jest V (duża litera, kod ASCII $56)
Więcej informacji o potwierdzeniach znajduje się w punkcie 2.3.
Opcje zleceń stosuje się również przy określaniu danego zadłużenia jako
wysyłanego do KRD po wyroku, z klauzulą wykonalności. W takim wypadku po
znaku ^ należy wprowadzić literę E (duża litera, kod ASCII $45). W tym
wypadku opcja może zostać dołączona do rekordu wysyłanego do KRD (kod
operacji ADD) lub aktualizowanego w KRD (kod operacji UPD)
2.3.
Potwierdzenia
W standardowym pliku wyjściowym znajduje się tylko informacja o statusie
zlecenia, czyli o tym czy zlecenie zostało zrealizowane poprawnie, czy też
wystąpił jakiś błąd.
Jednak na wyraźne żądanie, w pliku wyjściowym może się znaleźć komplet
danych jakich dotyczyła operacja. Jest to stan danych po dodaniu lub
aktualizacji zobowiązania lub przed jego usunięciem.
Pobrane z systemu dane są prezentowane w identyczny sposób w jaki zostały
dodane, tzn. w postaci linii protokołu Yonick z wypełnionymi odpowiednimi
kolumnami – powinny one być identyczne
Generowanie potwierdzeń po wykonaniu operacji wykonywane jest w osobnej
transakcji. Jeżeli w trakcie pobierania danych do potwierdzenia wystąpi błąd,
wykonana operacja nie jest odwoływana, a do zlecającego zwracany jest
status pierwotnej operacji wraz z pustym potwierdzeniem.
Strona 12 z 13
Yonick
2006/IT-P/??
3.
Wersja: 2.0
Z dnia:2011-02-01
Plik wyjściowy
W wersji 2.0 protokołu mozliwe stało się generowanie raportu wyjściowego.
Zawiera on co najmniej status wykonania zleconych usług, czyli informację o
poprawnym wykonaniu danej usługi lub informację o błędzie jaki wystąpił.
Jeśli zlecana była pełna weryfikacja usługi, plik wyjściowy będzie zawierał
dodatkowo dane związane z tą usługą. Będą one przezentowane w takiej
samej formie w jakiej wystąpiły w zleceniu wykonania usługi w pliku
wejściowym – w tych samych kolumnach i w tym samym formacie.
Plik wyjściowy rózni się od wejściowego dodatkowymi kolumnami oraz
zmienioną wymagalnością kolumn.
Dwie dodane do końca linii kolumny to kod statusu operacji oraz opis błędu.
Kod stausu operacji może przyjmować wartości “S” jeżeli operacja wykonana
zostala poprawnie (od ang. “Success”) oraz “F” jeśli wystąpił błąd (od ang.
“Fail”). Jeśli wykonanie zlecenia się nie powiodło, w polu opisu błędu znajdzie
się tekst dotyczący przyczyny błędu.
Wypełnione zostaną także trzy pierwsze kolumny każdej linni, czyli typ
zlecenia, typ informacji gospodarczej na jakiej operowalo zlecenie oraz
identyfikator sprawy.
Pozostałe kolumny, zawierające dane dłużnika, zobowiązania, zawieszenia i
powiadomień wypełnione zostaną tylko jeśli żądano pełnego potwierdzania
operacji (opcja “V” zlecenia).
Tabela 7 : Kolumny pliku wyjściowego
Numer
Kolum
ny
1
2
3
4
5
6
Nazwa kolumny
A
B
1
OPERATIONTYPE
2
INFORMATIONTY
PE
CASEID
3
4-41
42
43
STATUSCODE
ERRORDESC
Opis
C
Typ
zlecanej
operacji
wraz
ewentualnymi opcjami
Typ informacji gospodarczej
z
Identyfikator sprawy
Dane przekazane do biura w pliku
wejściowym
Stan zlecenia
Opis błędu
Uwagi
Wymagane
D
E
Kody operacji są
trzyliterowe
TAK
Dwuliterowy kod
TAK
Taki jaki w zleceniu
Wypełnione, jeśli
żądano potwierdzenia
„S” lub „F”
Wolny tekst
TAK
NIE
TAK
NIE
Szablon dokumentu: Normal.dotm v.1.0 2002-06-20; instrukcja: <BRAK>
KONIEC DOKUMENTU
Strona 13 z 13

Specyfikacja formatu Yonick 2.0

Transkrypt

Podobne dokumenty

Import danych z plików CSV

Krajowy Rejestr Długów Biuro Informacji Gospodarczej SA zarządza

Specyfikacja formatu Tovi 3.0

USOSweb: Protokoły elektroniczne

Masz firmę i zalegasz w ZUS i US? Mam dla Ciebie k

Regulamin Konkursu „Jedź na wakacje. Dłużników zostaw nam

laboratorium v