Moneta Bank konektor#

Popis funkcionality#

Rozšíření Moneta Bank konektor propojuje Microsoft Dynamics 365 Business Central přímo s bankou MONETA Money Bank, a. s. prostřednictvím jejího API rozhraní. Odpadá ruční export a import souborů přes internetové bankovnictví – platby se z BC odesílají do banky jedním kliknutím a pohyby na účtu se do bankovního výpisu v BC načítají přímo z banky.

Rozšíření navazuje na českou lokalizaci Business Central (Banking Documents Localization for Czech) a pracuje se standardními doklady Platební příkaz a Bankovní výpis. Nevyžaduje žádné externí komponenty ani middleware – veškerá komunikace probíhá přímo z Business Central přes HTTPS volání Moneta API.

Přehled funkcí#

Funkce	Směr	Popis
Export platebního příkazu	BC → Moneta	Vydaný platební příkaz se odešle do Moneta banky, kde čeká na finální schválení v internetovém bankovnictví.
E-mail schvalovateli	BC → schvalovatel	Po odeslání příkazu může systém automaticky poslat e-mail schvalovateli plateb s PDF příkazu v příloze.
Import bankovního výpisu	Moneta → BC	Načte zaúčtované transakce za zvolené období do řádků bankovního výpisu včetně VS, KS, SS, čísla účtu a IBAN protistrany.
On-line zůstatek	Moneta → BC	Zobrazí aktuální účetní a disponibilní zůstatek účtu přímo z banky.

Funkce rozšíření se zobrazují pouze u bankovních účtů MONETA Money Bank – tedy u účtů, jejichž číslo končí kódem banky /0600. U ostatních bankovních účtů zůstávají akce skryté.

---

Nastavení (jednorázové, před prvním použitím)#

Získání API tokenu v MONETA Money Bank#

Pro komunikaci s bankou je nutný API token vydaný bankou MONETA pro firemní klientelu. O zřízení přístupu k API (služby pro informace o účtu a pro zadávání plateb) požádejte svého bankéře nebo podporu MONETA API. Token má omezenou platnost – po jejím vypršení je nutné vygenerovat nový a vložit jej do nastavení.

Token musí mít oprávnění jak pro čtení účtů a transakcí, tak pro zadávání plateb. Pokud chybí oprávnění pro platby, export platebního příkazu skončí chybou.

Nastavení Moneta Bank konektoru#

Otevřete stránku Nastavení Moneta Bank konektoru (Moneta Bank Con. Setup NTC). Stránku najdete vyhledáním v Business Central (kategorie Správa).

Pole	Popis
Licence Moneta Bank konektor	Licenční kód rozšíření. Bez licence lze rozšíření používat ve zkušebním režimu (viz níže). Licenci získáte od společnosti Navitec systems s.r.o. – kontaktujte helpdesk@navitec.cz.
Adresa na API Moneta	Adresa API rozhraní Moneta. Je předvyplněna standardní produkční adresou https://api.moneta.cz/api/v3/vip/aisp/my/accounts – neměňte ji.
Token pro API Moneta	API token vydaný bankou MONETA. Hodnota je v rozhraní maskována.

Licence a zkušební režim

• Bez licenčního kódu je rozšíření možné využívat pro zkušební účely: lze exportovat 3 platební příkazy a importovat 3 bankovní výpisy.
• Licence je vázána na IČO společnosti (pole IČO v Informacích o společnosti) a má datum platnosti.
• 15 dní před koncem platnosti licence systém při každém použití upozorní na blížící se expiraci.
• Po vypršení licence systém export i import zablokuje – kontaktujte helpdesk@navitec.cz pro nový licenční kód.

Nastavení bankovního účtu#

Na kartě Bankovního účtu se u účtů MONETA (číslo účtu končí /0600) zobrazí záložka Moneta Banka konektor.

Pole	Popis
ID účtu Moneta Bank	Identifikátor účtu v Moneta API. Jedná se o číslo účtu bez kódu banky a bez lomítka, doplněné zleva nulami na délku 10 znaků (např. účet 123456789/0600 → 0123456789). Bez vyplnění tohoto pole nelze importovat výpisy ani zobrazit zůstatek.
Předmět e-mailu schválení plateb	Předmět e-mailu, který se po odeslání platebního příkazu zašle schvalovateli.
Email schvalovatele plateb	E-mailová adresa osoby, která platby schvaluje v internetovém bankovnictví. Pokud je pole prázdné, e-mail se neodesílá.

Dále zkontrolujte, že má bankovní účet správně vyplněno pole IBAN. IBAN můžete v BC zadat s mezerami i bez nich – rozšíření jej před odesláním do banky automaticky převede do strojového formátu (bez mezer).

Pro odesílání e-mailů schvalovateli musí být v Business Central nastaven e-mailový účet pro výchozí scénář (Nastavit e-mail / E-mailové účty).

---

Export platebního příkazu do Moneta banky#

Jak odeslat platební příkaz#

1. Vytvořte a vydejte platební příkaz standardním postupem české lokalizace (Platební příkazy → Vydat).
2. Otevřete Vydaný platební příkaz.
3. Klikněte na akci Export plateb do Moneta Banky pomocí API rozhraní (záložka Zpracování).
4. Systém vytvoří dávku plateb a odešle ji do Moneta banky.
5. Po úspěšném odeslání se zobrazí hlášení Bankovní příkaz byl nahrán do Moneta banky ke schválení.
6. Je-li na bankovním účtu vyplněn e-mail schvalovatele, odešle systém schvalovateli e-mail s částkou a PDF platebního příkazu v příloze.
7. Platby schvalte (podepište) v internetovém bankovnictví MONETA. Teprve tím jsou platby bankou skutečně provedeny.

Co se odesílá do banky

Pro každý řádek platebního příkazu se do banky předá:

• částka a měna platby,
• název a účet příjemce (u tuzemských plateb číslo účtu, u zahraničních IBAN),
• účet plátce (bankovní účet z hlavičky příkazu),
• variabilní, konstantní a specifický symbol,
• popis platby jako zpráva pro příjemce.

O tom, zda se příkaz odešle jako tuzemský nebo zahraniční, rozhoduje kód měny v hlavičce platebního příkazu: prázdný kód měny (CZK) = tuzemské platby, vyplněný kód měny = zahraniční platby (identifikace účtů přes IBAN).

Opakované odeslání#

Po úspěšném odeslání se na vydaném platebním příkazu nastaví příznak Exportováno do Moneta banky a uloží se datum a čas exportu. Při pokusu o opakované odeslání systém upozorní dotazem Bankovní příkaz byl již nahrán do Moneta banky ke schválení. Chcete jej poslat znovu? – potvrďte pouze tehdy, pokud jste si jisti, že platby v bance nejsou (jinak hrozí duplicitní platby).

Pokud odeslání skončí chybou#

Systém zobrazí hlášení Error sending JSON to service: s HTTP kódem a odpovědí banky. Příkaz se v takovém případě neoznačí jako exportovaný a lze jej po odstranění příčiny odeslat znovu. Nejčastější příčiny:

Chyba	Příčina a řešení
401	Neplatný nebo expirovaný API token – vygenerujte nový token a vložte jej do Nastavení Moneta Bank konektoru.
400 – AG01	Banka odmítla operaci. Zkontrolujte, že token má oprávnění pro zadávání plateb a že IBAN / číslo účtu příjemce i plátce je platné. (Od verze 25.0.0.6 se IBAN odesílá automaticky bez mezer.)
400 – jiný kód	Neplatná data platby (např. chybějící název příjemce u zahraniční platby, neplatný symbol). Opravte platební příkaz a odešlete znovu.

---

Import bankovního výpisu z Moneta banky#

Jak načíst transakce do bankovního výpisu#

1. Otevřete Bankovní výpisy a vytvořte nový výpis pro bankovní účet MONETA.
2. Na výpisu klikněte na akci Import bank. výpisu z Moneta.. (záložka Zpracování).
3. Vyplňte období Od data a Do data a potvrďte.
4. Systém stáhne z banky všechny transakce za zadané období (včetně stránkování u velkého počtu pohybů) a vloží je jako řádky výpisu.
5. Výpis zkontrolujte a pokračujte standardním postupem – Vydat a spárovat.

Co se načítá do řádku výpisu

Pole řádku	Zdroj v Moneta API
Popis	Popis transakce a zpráva pro příjemce.
Částka	Částka transakce – příchozí platby kladně, odchozí platby záporně.
Kód měny	Měna transakce (vyplní se, pokud se liší od místní měny).
Číslo účtu	Číslo účtu protistrany.
IBAN	IBAN protistrany.
Variabilní symbol	VS z platebních údajů.
Konstantní symbol	KS z platebních údajů.
Specifický symbol	SS z platebních údajů.

Datum dokladu výpisu se nastaví na nejpozdější datum zaúčtování mezi importovanými transakcemi a výpis se označí příznakem Importováno z Moneta banky.

Načítají se pouze transakce zaúčtované bankou. Transakce čekající na zpracování (stav PDNG) se do výpisu nevkládají – načtou se při dalším importu, až je banka zaúčtuje.

Import řádky do výpisu přidává za již existující řádky. Pokud import spustíte za stejné období opakovaně, transakce se ve výpisu objeví vícekrát – před opakovaným importem stávající řádky smažte.

Pokud import skončí chybou#

Chyba	Příčina a řešení
Pole datum od a datum do musí být vyplněno	Doplňte obě data na úvodní stránce importu.
ID účtu Moneta Bank musí mít hodnotu	Na kartě bankovního účtu vyplňte pole ID účtu Moneta Bank.
Token pro API Moneta musí mít hodnotu	V Nastavení Moneta Bank konektoru vyplňte API token.
Výpis neobsahuje žádné řádky	Za zvolené období nejsou v bance zaúčtované transakce, nebo je token neplatný / expirovaný.

---

On-line zůstatek účtu#

Na kartě Bankovního účtu MONETA je k dispozici akce Moneta - zobraz on-line zůstatek. Systém se dotáže banky a zobrazí:

• Účetní zůstatek (kód CLBD) – zůstatek zaúčtovaných pohybů,
• Dostupný zůstatek (kód CLAV) – disponibilní zůstatek včetně blokací a čekajících transakcí.

---

Rozšíření polí#

Vydaný platební příkaz#

Pole	Popis
Exportováno do Moneta banky	Příznak – platební příkaz byl úspěšně odeslán do Moneta banky.
Export to Moneta Bank DateTime	Datum a čas posledního úspěšného odeslání do banky.

Bankovní výpis / Vydaný bankovní výpis#

Pole	Popis
Importováno z Moneta banky	Příznak – řádky výpisu byly načteny z Moneta API.

---

Kontakt#

V případě nejasností kontaktujte technickou podporu na helpdesk(at)navitec.cz

---

Release notes#

25.0.0.6#

Opravy

• Export platebního příkazu – chyba AG01 při IBAN s mezerami. Moneta API odmítala platby, u kterých byl IBAN příjemce nebo plátce v Business Central uložen s mezerami (např. CZ65 0800 0000 1920 0014 5399), a vracela zavádějící chybu AG01 – You do not have sufficient rights to perform the operation. IBAN se nyní před odesláním automaticky převádí do strojového formátu – bez mezer, pomlček a dalších oddělovačů, velkými písmeny. Uživatelé již nemusí IBAN v BC ručně upravovat.
• Párování bankovních účtů podle IBAN. Při načítání účtů z Moneta API se IBAN porovnává v normalizovaném tvaru, takže se správně spárují i bankovní účty, které mají IBAN v BC zapsaný s mezerami.

25.0.0.5#

Opravy

• Import bankovního výpisu – nezaúčtované transakce. Do bankovního výpisu se již nenačítají transakce, které banka dosud nezaúčtovala (stav PDNG). Tyto transakce se načtou při dalším importu po jejich zaúčtování bankou. Odstraňuje duplicity a rozdíly mezi výpisem v BC a výpisem banky.

25.0.0.4#

Opravy

• Import bankovního výpisu – specifický symbol. Opraveno načítání specifického symbolu (SS) z transakcí Moneta API do řádků bankovního výpisu. SS se nově přebírá jako text, takže se zachovají úvodní nuly a nedochází k chybě převodu u nečíselných hodnot.

25.0.0.3#

Nový produkt

• Vytvoření produktu Moneta Bank konektor:
  • export vydaných platebních příkazů do MONETA Money Bank přes API (tuzemské i zahraniční platby) s finálním schválením v internetovém bankovnictví,
  • volitelný e-mail schvalovateli plateb s PDF platebního příkazu v příloze,
  • import transakcí do bankovního výpisu za zvolené období (VS, KS, SS, číslo účtu a IBAN protistrany),
  • zobrazení on-line účetního a disponibilního zůstatku na kartě bankovního účtu,
  • licencování přes licenční kód Navitec, zkušební režim 3 platební příkazy / 3 bankovní výpisy.