k
Klientský formát pohledávky
Klientský formát POHLEDÁVKY podporovaný v KB platný od 23. 10. 2010
Komerční banka, a.s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054
1/5 VERZE 1.4 AKTUALIZACE: 23.10.2010.
k 1
Klientský formát pohledávky
Úvod ............................................................................................................................................... 2
1.1 Účel dokumentu ....................................................................................................................... 2 1.2 Charakteristiky formátu POHLEDAVKA a práce se seznamem .............................................. 2 1.3 Kontrola limitů a přístupů ......................................................................................................... 2 2 Formální kontrola v případě formátu POHLEDAVKA ................................................................ 3
1 Úvod 1.1
Účel dokumentu
Účelem tohoto dokumentu je popis formátu POHLEDAVKA a požadovaných validací při IMPORTu dat ve vazbě na návazné účetní SW klientů. IMPORT je možné provádět prostřednictvím služeb přímého bankovnictví Komerční banka Mojebanka a Profibanka. Popis je členěn do následujících skupin Import – obecný popis Popis importního souboru Souhrn validací a typy detekovaných chyb.
1.2
Charakteristiky formátu POHLEDAVKA a práce se seznamem
Klient má možnost předat Komerční bance seznam pohledávek navržených k zastavení, které jsou vygenerovány v jeho účetnictví prostřednictvím tzv. IMPORTu. Klient předává dávku (seznam pohledávek) formou importu do Mojebanka nebo Profibanka. Banka zajistí formální validaci a klient je informován, zda byla dávka přijata nebo odmítnuta (včetně detekovaných důvodů odmítnutí). V Profibanka je validace ve dvou krocích. V prvním kroku se seznam nahrává do lokální databáze a kontroluje se na formální správnost. V druhém kroku probíhá odeslání do KB a zde je kontrolována duplicita zaslaných pohledávek vůči již dříve zaslaným seznamům a jejich splatnost. V Mojebanka probíhají obě části validace najednou při zasílání seznamu do KB. Přijatému seznamu je přidělena jednoznačná identifikace v rámci zástavní smlouvy. Detailní popis validací je předmětem dalších kapitol tohoto materiálu.
1.3
Kontrola limitů a přístupů
Obecně mohou být importy limitovány : přístupovými právy k zástavní smlouvě
Komerční banka, a.s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054
2/5 VERZE 1.4 AKTUALIZACE: 23.10.2010.
k
Klientský formát pohledávky
2 Formální kontrola v případě formátu POHLEDAVKA
Soubor POHLEDAVKA obsahuje 1 hlavičku, n plateb a 1 patičku. Validace délky věty fixní 213 bytů. Numerické údaje jsou zarovnány vpravo a zleva doplněny nulami Řetězcové údaje jsou zarovnány vlevo a zprava doplněny mezerami.
Pozn.: povinné informace jsou zobrazeny tučně. poř čís 1. 2. 3.
Název
délka
offset
obsah dat ve službě MB, PCB
Formát a validace
Typ věty Filler Datum vytvoření
2 9 6
0 2 11
HO Mezery datum vytvoření souboru
HO - konstanta
4.
Číslo smlouvy
20
17
Číslo zástavní smlouvy
5. 6.
Filler Koncový znak
174 2
37 211
Mezery CRLF
(YYMMDD) platné datum <= systémovému (Alfanumerické) Smlouva existuje, je aktivní (platnost odplatnost do) a přihlášený uživatel má plnou moc pro tuto smlouvu
Tab. 1: Hlavička přenosového souboru Pozn.: V Profibanka se testy provádějí oproti lokální databázi, která musí být před importem aktualizována. Chybové situace: Validace / podmínka Datum vytvoření je vyšší než aktuální datum Smlouva neexistuje. Datum zpracování je nižší než datum zahájení platnosti smlouvy. Zobrazuje se v situaci, kdy datum zpracování je vyšší než datum ukončení platnosti. Neexistuje plná moc k dané smlouvě.
Chybová hláška Neplatné datum vytvoření souboru.
Odmítnut soubor
Neplatné číslo smlouvy. Smlouva dosud není aktivní.
soubor soubor
Smlouva je již ukončena.
soubor
Nemáte oprávnění zasílat soubor pohledávek k dané smlouvě.
soubor
Komerční banka, a.s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054
3/5 VERZE 1.4 AKTUALIZACE: 23.10.2010.
k
Klientský formát pohledávky
Validace / podmínka Typ věty je jiný než HO.
Chybová hláška Není nebo chybně vyplněn povinný údaj – typ věty.
Odmítnut soubor
poř čís 1. 2. 3.
Název
délka
offset
obsah dat ve službě MB, PCB
Formát a validace
Typ věty Filler Datum vytvoření
2 9 6
0 2 11
TO nyní nevyužito = mezery datum vytvoření souboru
TO - konstanta
4.
Počet záznamů
6
17
počet vět 42 v souboru
5.
Kontrolní součet
18
23
suma pole Částka všech vět 42
6. 7.
Filler Koncový znak
170 2
41 211
nyní nevyužito a nekontrolováno CRLF
(YYMMDD) platné datum <= systémovému (Numerické - int) Počet záznamů typu 42 (Numerické - float) Součet všech záznamů typu 42
Tab. 2: Patička přenosového souboru Chybové situace: Validace / podmínka Počet záznamů v souboru je roven hodnotě v poli Počet záznamů Součet částek všech záznamů v souboru bez ohledu na měnu musí být shodný s kontrolním součtem. Datum Vytvoření v Patičce musí být shodný s datumem vytvoření v hlavičce Typ věty je jiný než TO.
Chybová hláška Počet záznamů v souboru neodpovídá hodnotě v poli. Součet částek neodpovídá kontrolnímu součtu.
Soubor
Není nebo chybně vyplněn povinný údaj – typ věty.
Soubor
Název
délka
offset
obsah dat ve službě MB, PCB
Typ věty číslo pohledávky
2 5
0 2
42 Pořadové číslo v rámci seznamu
3.
IČO
10
7
IČO poddlužníka V případě zahraničního poddlužníka je uvedeno IČO dlužníka zprava doplněné dvěma libovolnými čísly Jméno / název poddlužníka
Jméno
50
17
5.
Variabilní symbol
10
67
6. 7.
Číslo faktury Datum Splatnosti
20 6
77 97
8.
Datum vystavení
6
103
9.
Částka
15
109
10. Měna
3
124
11. Právní titul
70
127
Soubor
Datumy nejsou shodné
po ř 1. 2.
4.
Odmítnut Soubor
Formát a validace
(Numerické - int) Unikátní v rámci seznamu (Numerické) Je-li vyplněno, kontrola na platné ICO dle modulo.
(Alfanumerické) Not null (Numerické, povolené Variabilní symbol pohledávky znaky 0-9) Not null Číslo faktury (pohledávky) pokud se liší od VS Alfanumerické (YYMMDD) Datum splatnosti pohledávky Platné datum (YYMMDD) Datum vystavení pohledávky Platné datum Částka pohledávky uvedená v haléřích bez Numerické (float) desetinné čárky (Alfanumerické) ISO kód měny pohledávky Existuje v číselníku měn Právní titul pohledávky - Typ a číslo dokladu (Alfanumerické) na základě kterého pohledávka vznikla. (Příklad : Smlouva o dílo č. 12345 ze dne 11.11.2001)
Komerční banka, a.s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054
4/5 VERZE 1.4 AKTUALIZACE: 23.10.2010.
k 12. Filler 13. CRLF
14 2
Klientský formát pohledávky 197 211
Mezery
Tab. 3: Věta typu 42 POHLEDAVKA – detailní informace o pohledávkách v seznamu Chybové situace: Validace Číslo pohledávky je v souboru unikátní Jméno je vyplněno Variabilní symbol je vyplněn Variabilní symbol obsahuje povolené znaky Datum vystavení je vyplněn Datum splatnosti je vyplněn Částka je vyplněna, číslo Měna je vyplněna, existence měny v číselníku Datum splatnosti je ve formátu YYMMDD Datum vystavení je ve formátu YYMMDD Měna existuje v číselníku měn IČO je platné dle kontroly modulo. Záznam není duplicitní v seznamu
Chybová hláška při porušení Číslo pohledávky XXX není v souboru unikátní. V záznamu XXX není vyplněn požadovaný údaj: jméno. V záznamu XXX není vyplněn požadovaný údaj: variabilní symbol. Variabilní symbol v záznamu XXX obsahuje nepovolené znaky. V záznamu XXX není vyplněn požadovaný údaj: datum vystavení. V záznamu XXX není vyplněn požadovaný údaj: datum splatnosti. V záznamu XXX není vyplněn požadovaný údaj: částka. V záznamu XXX není vyplněn požadovaný údaj: měna. V záznamu XXX není platné datum: datum splatnosti. V záznamu XXX není platné datum: datum vystavení. V záznamu XXX není platný údaj: měna. V záznamu XXX IČO nevyhovuje kontrole. Záznam XXX je duplicitní v tomto seznamu
Odmítnut soubor záznam soubor záznam záznam soubor soubor soubor soubor záznam soubor záznam soubor
Poznámka. • za symbol XXX se dosazuje číslo pořadové pohledávky v seznamu. • *) Záznam je duplicitní, jestliže v seznamu existuje jiný záznam shodný v těchto parametrech: 1. stejný VS; 2. stejné datum vystavení pohledávky
Není-li vyplněno pole právní titul, je automaticky vyplněno hodnotou „smlouva – dle faktury“ Přípona importního souboru je ckm. Duplicita pohledávek v seznamu je důvodem pro odmítnutí přijetí celého seznamu (viz validace výše). Pohledávky po splatnosti budou importem zpracovány a přijaty k dalšímu zpracování. Při automatickém vyhodnocení zaslaného seznamu budou: • pohledávky po splatnosti navrženy na vyřazení. Jejich finální přijetí či vyřazení závisí na rozhodnutí odpovědného pracovníka KB. • pohledávky, které budou duplicitní vůči dříve zaslaným pohledávkám, automaticky vyřazeny z dalšího zpracování
Komerční banka, a.s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054
5/5 VERZE 1.4 AKTUALIZACE: 23.10.2010.