1.1 SOUBORY V DATOVÉ VÝMĚNĚ
Datová výměna probíhá dávkově logickým blokem souborů. Soubory mají formát CSV.
1.1.1 JMENNÁ KONVENCE PŘENÁŠENÝCH SOUBORŮ
Jména souborů jsou složena z tříznakové zkratky, čtyřznakového čísla banky nebo pobočky banky z jiného než členského státu, dvouznakového kódu země zahraniční pobočky (u souborů pro české pobočky není tento kód vyplněn) a pětiznakové extenze (sufixu). Název a extenze souboru jsou odděleny tečkou. Extenze je ve tvaru 99999 a určuje pořadové číslo dávky. První dávka začíná extenzí 00001.
1.1.2 SEZNAM PŘENÁŠENÝCH SOUBORŮ
V datové výměně jsou definovány tyto soubory:
| Soubory a prefixy vět souborů | |||||
|---|---|---|---|---|---|
| Soubor | Typ souboru | Prefix věty | Generuje | Přijímá | Popis souboru |
| DIB | CSV | U | Garanční systém | vyplácená banka nebo pobočka banky z jiného než členského státu | Hlavička dávky |
| DIM | CSV | G | Garanční systém | vyplácená banka nebo pobočka banky z jiného než členského státu | Řídící zprávy |
| DIE | CSV | H | Garanční systém | vyplácená banka nebo pobočka banky z jiného než členského státu | Chybové / informační zprávy |
| DIP | CSV | V | Garanční systém | vyplácená banka nebo pobočka banky z jiného než členského státu | Výplaty |
| DIW | CSV | R | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Hlavička dávky |
| DIC | CSV | E | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Oprávněné osoby |
| DIA | CSV | T | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Účty |
| DIL | CSV | O | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Společné účty |
| DII | CSV | D | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Účty ve speciálním režimu |
| DIN | CSV | X | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Řídící zprávy |
| DIF | CSV | K | vyplácená banka nebo pobočka banky z jiného než členského státu | Garanční systém | Chybové / informační zprávy |
1.1.3 DÁVKY
Soubory, které dávka obsahuje, jsou indikovány datovými prvky v hlavičkovém souboru dávky (např. N_CLIENT, N_ACOUNT, N_COLLECTIVE a N_COMMAND v souboru DIW). Soubor reprezentující hlavičku dávky musí být vždy v každé dávce. Pokud je hodnota nějakého z datových prvků udávajícího počet vět v jednotlivých souborech nulová, soubor v dávce nesmí existovat; pokud je větší než nula, soubor s uvedeným počtem vět musí existovat. Pokud je hodnota záporná, jedná se o chybu a dávka je odmítnuta.
Platná dávka pro CSV soubory tedy je například ta, která obsahuje soubory DIW, DIC a DIA. Typická řídící dávka obsahuje soubory DIW a DIN.
1.1.4 POTVRZENÍ DÁVKY
Po úspěšném zpracování jakékoliv dávky potvrzuje Garanční systém toto zpracování zasláním zprávy s kódem 40000. V případě jakékoliv chyby ve zpracovávané dávce vrací Garanční systém množinu chybových zpráv.
1.1.5 SOUBORY PŘENÁŠEJÍCÍ ŘÍDÍCÍ ZPRÁVY
Řídící zprávy se přenáší v souborech DIM, DIN a definují požadovanou činnost nad datovým blokem definovaným klíčem I_IDC.
1.1.6 POPIS DATOVÉ VÝMĚNY
Datová dávka je komprimována algoritmem ZIP do jednoho společného souboru. Soubory patřící do jedné tranše jsou do komprimovaného souboru přidávány bez cest. Komprimovaný soubor je zašifrován asymetrickým šifrovacím algoritmem PGP s tím, že po dohodě s Garančním systémem je možné použít i jiný způsob šifrování alespoň stejné bezpečnosti.
1.1.6.1 CSV SOUBORY
1.1.6.1.1 FORMÁT SOUBORŮ
Všechny soubory jsou typu CSV, tedy:
a) textový ASCII soubor v kódování CP-1250 (Win-1250)
b) jednotlivé řádky (věty) jsou ukončeny znakem LF (0x0A), nebo dvojicí znaků CR, LF (0x0D, 0x0A)
c) jednotlivé datové prvky jsou odděleny znakem čárka (COMMA - 0x2C)
d) za posledním datovým prvkem (řádkem) je znak čárka (COMMA - 0x2C) nepřípustný
e) pokud soubor obsahuje znak NULL (0x00), je považován za konec souboru
1.1.6.1.2 OBECNÁ PRAVIDLA JEDNOTLIVÝCH TYPŮ DATOVÝCH PRVKŮ
Texty - pokud textový datový prvek obsahuje znak čárka (COMMA - 0x2C), musí být celý text ohraničen znakem horní uvozovky (Quotation mark - 0x22). Pokud textový datový prvek obsahuje znak horní uvozovky (0x22), musí být tento znak zdvojen.
Částky - 15 cifer včetně úvodních nul, bez desetinného oddělovače, bez oddělovačů tisíců, poslední dvě pozice vpravo představují setiny měny (např. haléře v případě měny Kč).
Datum - pořadí rok, měsíc, den, včetně případných předřazených nul u měsíců a dnů, bez oddělovačů.
Čas - pořadí hodiny, minuty, vteřiny, včetně případných předřazených nul, bez oddělovačů.
Procento - bez oddělovače, doplněno na 4 cifry.
1.1.6.1.3 VYSVĚTLIVKY POPISU DATOVÝCH PRVKŮ
Délka: N - maximální délka
Formát: X - znaky Windows 1250
9 - numerické znaky (0x30 - 0x39)
YYYY - rok
MM - měsíc
DD - den
hh - hodina
mm - minuta
ss - vteřina
(N) - definuje variabilní délku s maximální délkou N; opakování znaků X, 9, atp. definuje pevnou délku v počtu opakování.
* - indikuje datový prvek, jehož hodnota může být prázdná.
Všechny datové prvky jsou povinné, tedy i prázdný datový prvek označený * musí být uveden pomocí znaku čárka (COMMA - 0x2C).