Popis ovladače CZ_MultiCash.hbd

Tento ovladač je nástupcem dřívějšího ovladače MtCash.hbd. Je určen pro nového bankovního klienta BusinessBanking24, který je používán řadou bank.

Parametry tohoto ovladače jsou uspořádány do následujících záložek:

Obsažené záložky: Obecné Platební příkazy Bankovní výpisy

Přípony příkazů pro tento ovladač:

  • Přípona příkazů - tuzemské: *.CFD, zahraniční: *.CFA (definovatelná)
  • Přípona výpisů - *.STA (definovatelná)

Obecné

Název Doplňující popis
Banka a verze

Zde je třeba nastavit, pro jakou banku budete daný ovladač využívat, jelikož u těchto bankovních ústavů existují drobné odlišnosti v použití bankovního klienta a tvaru souborů, a dále zvolíte verzi, pokud je pro danou banku k dispozici více než jedna. Číslo verze může ovlivňovat např., jaké budou použity oddělovače v záhlaví příkazů apod.

Banka VUB automaticky podporuje import plateb SEPA.

Vytvářet zahr. platební příkazy pro platby v tuzemsku v cizí měně

Řešení požadavku, aby bankovní ovladač generoval zahraniční platební příkazy (*.CFA) z korunového účtu. Chce-li zákazník provést platbu v cizí měně z korunového účtu a není-li položka zatržena, systém vygeneruje tuzemský platební příkaz (*.CDF). Pokud však banka požaduje zahraniční plat. příkaz, je možné zatrhnout tuto položku. Zahraniční platební příkaz totiž vznikne, je-li splněna jedna z následujících podmínek:

  • Země banky příkazce (země vyplněná u bankovního účtu v agendě Bankovní účty) je odlišná od země cílového bankovního účtu (tj. od země vyplněné u bankovního účtu partnera na žádosti o platební příkaz). Jsou-li země shodné a není-li zatrženo toto zatržítko, je platba považována za tuzemskou a vytvoří se tuzemský platební příkaz.
  • Je zatrženo toto zatržítko - bez ohledu na shodnost či neshodnost zemí se pro platbu v cizí měně vytvoří zahraniční platební příkaz.
Předčíslí pro zahraniční platby Předčíslí, které je potřebné pro generování plateb do zahraničí. Jen pro některé bankovní ústavy, např. ČSOB.
Strukturovaný formát bankovního výpisu Ovlivňuje import variabilních symbolů. Jen pro některé bankovní ústavy, např. UniCredit Bank CZ.
Zadat společný popis účtu příjemce

Pokud je volba zatržená, tak se při exportu platebních příkazů (PLP) zobrazí dialog pro zadání textu a zadaný text se zapíše do souboru s plat. příkazem nakonec řádku "UK:".

Použití: při generování PLP je kreditní účet (účet příjemce) identifikován takto: UK:000006 7523566011 TEXT. První dvě položky v části "UK:" jsou podle definice formátu povinné, třetí TEXT je nepovinná a jedná se o volitelný text, max. 20 znaků. Ta nepovinná má význam "zkratka účtu příjemce" nebo "popis účtu příjemce" a pokud se vynechá, banka (např. TABA) do následného BV vloží automaticky název účtu příjemce (samozřejmě jen pro vnitro bankovní transakce, kde název příjemce pozná), což bývá většinou jméno fyzické osoby. Potom účetní i jiní ve firmě mohou vidět, který zaměstnanec dostává jakou mzdu na účet netto, přestože je to v dané firmě neveřejná informace a do PLP jsme ji neuvedli. Tomu lze zabránit tak, že se TEXT do zmíněné nepovinné položky vyplní, což umožňuje právě tato položka.

Formát BusinessNet Jen pro některé bankovní ústavy, např. UniCredit Bank CZ.
Formát výpisu MT940_SEPA Umožní importovat bankovní výpisy v tomto formátu. Volba je dostupná pouze pro banku Tatra Banka.

Platební příkazy

Název Doplňující popis
Cesta pro ukládání vygenerovaného platebního příkazu

Zde je třeba zadat platné jméno adresáře včetně disku a koncového zpětného lomítka. Adresář musí být vytvořen.

Ovladač vytváří soubory platebních příkazů se strukturou jména RR_MM_DD_NN, kde NN je pořadové číslo v rámci dne od 1 do 99 (tudíž je-li v jeden den více souborů, nepřepisují se). Od verze 9.01 je tato funkcionalita podporována pro všechny banky, které podporuje tento driver.

Po exportu spustit Po vlastním exportu je možné spustit externí program, například program, který rovnou umožní vytvořený el. platební příkaz odeslat do banky (odpovídající stránka WWW). Ve volání programu lze využívat parametry - viz popis u funkce Parametry.
Přípona souboru tuzemského příkazu Výchozí hodnota je CFD. Vygenerované soubory budou mít zde zadanou příponu. Jaké soubory vzniknou, ovlivňuje též nastavení režimu SEPA, viz dále.
Přípona souboru zahraničního příkazu Výchozí hodnota je CFA. Vygenerované soubory budou mít zde zadanou příponu.
Přípona souboru příkazu SEPA Výchozí hodnota je XML. Vygenerované soubory budou mít zde zadanou příponu.
Krátké označení účtu

Krátké textové označení účtu plátce.

  • Při generování tuzemských příkazů se exportuje do subpole 3 v rámci pole UD:.

    Některé banky (např. Oberbank) mohou vyplnění tohoto subpole vyžadovat, v takovém případě je nutné položku vyplnit.

  • Při generování zahraničních příkazů se exportuje do pole :01: (reference zákazníka - součást záhlaví souboru).
Kódování výst. souboru Možnost nastavit způsob kódování souborů s daty platebních příkazů. Způsob kódování vyberete ze skrytého seznamu. Kromě defaultního kódování Windows-1250 můžete tedy zvolit i jinou znakovou sadu tak, aby byl soubor např. z hlediska české diakritiky v pořádku.
Režim SEPA

Slouží pro realizaci SEPA plateb přímo v rámci tohoto ovladače. Zde jsou k dispozici následující možnosti:

  • Nepoužívat SEPA ISO XML - formát SEPA ISO XML nebude používán.
  • Používat jen SEPA ISO XML - formát SEPA ISO XML bude používán pro všechny příkazy.
  • SEPA ISO XML jen pro příkazy do oblasti SEPA - formát SEPA ISO XML bude používán pouze pro příkazy, které jsou vystaveny na firmu, jež má v adrese sídla uvedenu zemi náležející do oblasti SEPA.
  • SEPA ISO XML pro všechny zahraniční příkazy - formát SEPA ISO XML bude používán pro všechny zahraniční příkazy.

U jiných režimů než Nepoužívat SEPA ISO XML se Lokální platba v EUR považuje také za SEPA platbu a vyexportuje se v XML.

Podle tohoto nastavení se pak vytváří výstupní soubory: pokud se v příkaze najdou řádky, které podle výše uvedeného nastavení nastavení spadají do zpracování pomocí SEPA XML, tak se pro ně vytvoří adekvátní soubor. V důsledku tudíž mohou pro platby vzniknout až tři soubory (domácí/zahraniční a SEPA XML).

Pokud nastavíte formát výpisů na SEPA, je třeba zkontrolovat, že jsou vyplněny následující položky v Adresáři firem: Název firmy, IBAN, Ulice, Město a Kód země.

Kódování SEPA XML

Vzhledem k tomu, že jednotlivé banky podporující komunikaci dle ISO 20022 mohou vyžadovat různé způsoby kódování znaků v platebních příkazech, je třeba dle informací z konkrétní banky vybrat v této položce odpovídající znakovou sadu, ve které bude platební příkaz vytvořen. K dispozici jsou tyto možnosti:

  • WINDOWS_1250
  • UTF_8
  • ISO_8859_2
  • CP_852
  • CP_895
  • UTF_16

Výchozí hodnota je UTF_8.

Formát příkazu SEPA

Verze formátu zprávy (rovněž dle ISO 20022). K dispozici jsou tyto možnosti:

  • pain.001.001.02 (CustomerCreditTransferInitiationV02)
  • pain.001.001.03 (CustomerCreditTransferInitiationV03)

Je zapotřebí zvolit formát podporovaný konkrétní bankou. Výchozí hodnota je pain.001.001.03.

Odstraňovat diakritiku v ISO XML souboru

Parametr, který určuje, zda vygenerovaném platebním příkaze budou znaky bez diakritiky. Výchozí hodnota je Ano.

Platební příkazy bez diakritiky vyžadují např. banky Tatrabanka, Unicredit aj.

Nevyplněné kódy zemí nahrazovat kódem lokální země v ISO XML souboru Primárně systém ABRA Gen do platebního příkazu ISO XML přebírá kód země z položky Kód země na firmě, která je zadána na platebním příkazu. Pokud země na firmě není vyplněna, je možné pomocí tohoto parametru zvolit, aby se do platebního příkazu převzala lokální země z agendy Firemní údaje.

Bankovní ovladač nepodporuje odeslání (přenos) adresy banky příjemce (přenáší se jen číslo účtu příjemce a název banky příjemce). Dále ovladač nepodporuje přenos jména referenční osoby příjemce.

Bankovní výpisy

Název Doplňující popis
Cesta k datům bankovního výpisu Zde je třeba zadat platné jméno adresáře včetně disku a koncového zpětného lomítka. Adresář musí být vytvořen.
Před importem spustit Před vlastním importem je možné spustit libovolný externí program. Zadaný program se spustí ještě před vyhledáním importních souborů. Tuto vlastnost je tedy možné využít pro spuštění programu, který stahuje výpisy z banky.
Přípona souboru výpisu

Výchozí hodnota je STA. Exportované výpisy musí mít příponu shodnou se zde zadanou příponou.

Pro import souboru STA platí: bloky MT942 se neimportují. Jedná se o bloky, které jsou identifikované klíčovým slovem STARTDISP a které se nemají do ERP systémů importovat. Pokud výpisy obsahují jenom bloky MT942, tak se z takových výpisů se nenaimportuje žádný řádek.

Jaké soubory budou načítány, ovlivňuje též nastavení režimu SEPA, viz dále.
Přípona souboru výpisu SEPA ISO XML

Výchozí hodnota je XML. Exportované výpisy musí mít příponu shodnou se zde zadanou příponou.

Výpis je distribuován jako ZIP archiv Parametr je třeba zatrhnout, pokud je výpis distribuován bankou (toho času Tatrabankou) jako zazipovaný soubor.
Přípona archivu Nastavuje příponu souboru zazipovaného výpisu. Typicky ZIP.
Ořezávat nuly zleva u variabilního symbolu Pokud zatrhnete tuto předvolbu, bude ovladač ořezávat všechny nuly zleva u variabilních symbolů na výpisech z účtů. Nastavení nemá žádný vliv na vytvářené platební příkazy.
Přebírat datum účtování

Pokud je zatrženo, tak se do data na řádku BV vyplní datum účtování BV, které je uvedené v importovaném BV (v souboru, který importujeme). A to následovně:

  • pro všechny banky podporované ovladačem kromě Raiffeisen bank - z pole 61 (řádek výpisu)
  • pro Raiffeisen bank - z pole 60F (počáteční zůstatek) - Datum účtování totiž v případě Raiffeisen bank není v poli 61 uloženo.

Pokud není zatrženo, vyplní se datum na řádku BV datem obratu položky, které je uvedené v importovaném BV.

Rozpoznávat číslo vlastního bankovního účtu

Pokud je zatrženo, tak se do BV naimportují jenom ty řádky BV, na kterých je uvedeno číslo bank.účtu stejné, jako je číslo bank.účtu zadané uživatelem ručně na hlavičce BV.

Jedna z možností rozpoznávání čísla účtu. Viz též parametr Krátké označení účtu.

Desetinný oddělovač Možnost určit, jaký znak bude desetinným oddělovačem. Defaultně je nastaveno na ",". Určeno pro případ, kdy je v importním souboru s bankovními výpisy desetinný oddělovač jiný než čárka.
Kódování vst. souboru Možnost nastavit způsob kódování souborů s daty bankovních výpisů. Způsob kódování vyberete ze skrytého seznamu. Kromě defaultního kódování Windows-1250 můžete tedy zvolit i jinou znakovou sadu tak, aby byl soubor např. z hlediska české diakritiky v pořádku.
Jméno defaultního souboru Více viz Defaultní importní soubor.
Režim SEPA

Možnost nastavit zda má být využíván režim SEPA. Lze zvolit následující hodnoty:

  • Nepoužívat výpis SEPA ISO XML - pokud je nastavena tato hodnota, režim SEPA pro výpisy nebude používán.
  • Používat pouze výpis SEPA ISO XML - pokud je nastavena tato hodnota, budou se importovat výpisy pouze ve formátu SEPA ISO XML.
  • Používat oba formáty naráz - v tomto módu jsou v adresáři očekávány oba formáty. Pokud systém ABRA Gen najde pouze jeden z nich, výpis se nenačte.
Soubor výpisu po zpracování

Nastavení, co se má se souborem výpisu stát po zpracování. Možnosti jsou následující:

  • neprovádět žádnou akci
  • přesunout soubor do jiné složky (v tom případě je nutné ještě nastavit cestu do této složky, viz parametr Soubor výpisu přesunout do složky)
  • smazat
Soubor výpisu přesunout do složky Složka, do které se má soubor výpisu přesunout po zpracování. Relevantní pouze v kombinaci s nastavením předchozího parametru na "Přesunout soubor do jiné složky".

Ovladač pro ČSOB BusinessBanking 24 umí na řádek bankovního výpisu ukládat kromě variabilního symbolu a částky jako další údaj o příchozí platbě i číslo účtu "druhé strany" do definovatelné položky.

HB driver CZ_MtCash.hbd umí načíst číslo účtu protistrany do komunikačního XML. Před zavedením položky Číslo účtu protistrany na řádku bankovního výpisu v agendě Bankovní výpisy se při zpracování komunikačního XML číslo účtu protistrany ('BankAccount') zapisovalo do uživatelsky definovatelné položky typu string 'U_BankAccount' (pokud taková položka existovala). Pokud taková položka neexistovala, neprovedlo se nic. Plní se následovně: Pokud je v souboru číslo účtu ve tvaru kód banky/předčíslí-číslo_účtu, zobrazí se číslo účtu ve tvaru předčíslí-číslo_účtu/kód banky. Jinak se přebere ze souboru tak, jak v něm je (např. u některých položek v dodaných souborech je jako číslo účtu protistrany uveden jenom kód banky).

Pro import čísla účtu protistrany zavedena podpora pro IBAN. Podpora umožňuje výrobci nastavit v ovladači číslo účtu protistrany (na řádku BV) ve formátu IBAN. Zatím toto podporuje jenom ovladač CZ_MultiCash pro banku Expobank.

ING - Při importu BV se importují pouze transakce typu PA (Fund Transfer – Payment initiated by the Bank) a RE (Fund Transfer – Payment Received in the bank).

U tohoto ovladače platí, že pokud je na všech řádcích BV stejné datum, převezme se dané datum do hlavičky dokladu BV v systému ABRA Gen.