Novinky

Účetní systém Money S3 od společnosti Seyfor (dříve známé jako Solitea) patří mezi nejrozšířenější účetní řešení na českém trhu. Dativery pro něj nabízí širokou škálu integrací, které umožňují automatický přenos dat mezi Vaším účetnictvím a dalšími aplikacemi.

V tomto návodu se krok za krokem dozvíte, jak propojit Vaši instalaci Money S3 s Dativery, jaké údaje budete k tomu potřebovat a kde je získáte i zadáte. Předpokládáme, že již máte vytvořený účet ve webové aplikaci Dativery.

Příprava v Money S3

Aby bylo možné připojit Money S3 k Dativery pomocí rozhraní API, budete potřebovat znát několik údajů:

• adresu vaší instalace Money S3 API (tzv doménu; např. https://dativery.api.moneys3.eu/),
• Client ID a Client Secret z vygenerovaného API klíče,
• název účtované firmy (agendy), kterou chcete propojit.

Pokud již tyto informace máte k dispozici, můžete tuto kapitolu přeskočit a pokračovat rovnou ke kapitole Připojení Money S3 k Dativery níže.

Aktivace modulu S3 API

Aby bylo možné propojit Money S3 s Dativery, je nutné mít zakoupený a aktivovaný rozšiřující modul S3 API. Pokud tento modul ve své instalaci nemáte, kontaktujte obchodní oddělení Money S3 na e-mailové adrese obchod@money.cz nebo telefonním čísle + 420 549 522 511.

Podrobný popis instalace a aktivace modulu naleznete v oficiálním návodu Money S3 v kapitolách „Instalace API“ a „Nastavení API v Money S3“.

Nastavení uživatele pro API

Pro správné fungování připojení je potřeba mít v systému Money S3 založeného uživatele určeného pro API (např. s názvem API). Tento uživatel musí mít přístup ke klíčům API. Název uživatele nesmí obsahovat mezery.

Zjištění domény (jména serveru pro API)

Pro propojení aplikace Dativery s Money S3 budete potřebovat znát tzv. doménu – tedy adresu Vaší instalace Money S3 API.

1. V Money S3 otevřete nabídku Nástroje → S3 API → Konfigurace API.
2. Zobrazí se okno Obecné nastavení S3 API.
3. V sekci „Vaše doména“ uvidíte adresu, kterou budete později zadávat do Dativery.

Připojení Money S3 k Dativery

Ve webové aplikaci Dativery můžete účetní systém Money S3 připojit buď samostatně, nebo při aktivaci některého z integračních scénářů. V tomto návodu si ukážeme postup pro samostatné připojení Money S3. Předpokládáme, že již máte vytvořený svůj účet v aplikaci Dativery.

1. Ve webové aplikaci Dativery v pravém sloupci klikněte na položku Aplikace.
2. V seznamu dostupných aplikací vyhledejte Money S3 a klikněte na něj.
3. Na zobrazené stránce aplikace Money S3 poté klikněte na tlačítko +Propojit.

Zobrazí se první krok průvodce připojením, ve kterém budete vyplňovat několik formulářových polí potřebných k propojení.

Zadání dat

1. Do pole „Jméno serveru pro API“ zadejte adresu Vaší instalace Money S3 API, například https://dativery.api.moneys3.eu/.
2. Pokud omezujete přístup ke své instalaci Money S3 pouze na konkrétní IP adresy, zaškrtněte volbu „Přistupovat z pevné IP adresy“. V takovém případě bude Dativery přistupovat výhradně z IP adresy 46.101.177.29. Nemáte-li přísně omezený přístup, ponechte toto pole nezaškrtnuté.
3. Do polí „Client ID“ a „Client Secret“ vyplňte údaje z vygenerovaného API klíče, který je určený pro propojení. Tyto přihlašovací údaje jsou mimořádně citlivé – Dativery je proto ukládá v odděleném, šifrovaném úložišti s omezeným přístupem (viz také Zásady zpracování osobních údajů).
4. V poli „Domácí měna“ vyberte měnu, ve které daná firma účtuje – v České republice obvykle CZK, na Slovensku EUR.
5. Po vyplnění všech údajů klikněte na tlačítko „Další“, čímž přejdete do druhého kroku průvodce. Dativery se v této fázi pokusí připojit k Vaší instalaci Money S3 a ověřit správnost zadaných údajů. Pokud se spojení nepodaří, zobrazí se chybové hlášení s možností zobrazit odeslaný požadavek, přijatou odpověď a vysvětlení příčiny chyby.
6. Na druhém kroku průvodce vyberte z nabídky účtovaných společností (agend) tu, kterou chcete s Dativery propojit.
7. Po výběru stiskněte tlačítko „Uložit nastavení“. Tímto je připojení dokončeno a zobrazí se Vám stránka s nově propojenou aplikací. Tuto aplikaci pak můžete použít při nastavení libovolného scénáře integrace s Money S3.

Po kliknutí na právě propojenou aplikaci Money S3 se na její stránce v pravém sloupci zobrazí odkaz „Nastavení připojení“. Tento odkaz Vám umožní znovu otevřít průvodce připojením – například v případě, že budete potřebovat změnit přihlašovací údaje.

Jakmile máte Money S3 úspěšně připojeno, můžete přejít k dalšímu kroku – výběru jedné z mnoha dostupných integrací. Vyberete si některou z nich a necháte Dativery automatizovat přenos dat za Vás?

Co dělat, když propojení aplikace selže na chybě

Pokud se propojení s Money S3 nezdaří, zobrazí se chybové hlášení s možností zobrazit odeslaný požadavek, přijatou odpověď a často také vysvětlení příčiny chyby. V takovém případě doporučujeme postupovat následovně:

Ověřte funkčnost služby S3 API

Proveďte test spojení pomocí tlačítka „Stav API“ v systému Money S3. Pokud je vše v pořádku, zobrazí se zpráva: „Test spojení se službou S3Api proběhl úspěšně.“

Zkontrolujte, zda je verze Money S3 aktuální

Ujistěte se, že používáte nejnovější verzi Money S3. Modul API je vždy vytvářen pro aktuální vydanou verzi, takže pro jeho správné fungování je nutné mít systém aktualizovaný.

Ověřte, že služba S3 API běží

Otevřete Služby ve Windows a vyhledejte službu s názvem S3 Api. Zkontrolujte, zda je její stav „Spuštěno“. Pokud služba neběží, spusťte ji. Pokud již spuštěná je, doporučujeme ji restartovat.

Ověřte správnost domény

V Money S3 otevřete Nástroje → S3 API → Konfigurace API. Po kliknutí na tlačítko „Nastavit“ by se vedle názvu domény mělo zobrazit modré kolečko s bílou fajfkou, které potvrzuje, že doména je aktivní a správně nakonfigurovaná.

Kdy kontaktovat podporu

Pokud jste všechny výše uvedené kroky provedli a problém přetrvává, obraťte se na technickou podporu Money S3 na e-mailové adrese podpora@money.cz. Uveďte, že se jedná o problém s připojením přes S3 API, a pokud možno přiložte i chybovou hlášku, která se v Dativery zobrazila.

Integrace s Money S3 pro více firem

V případě, že potřebujete využívat integrace pro více účtovaných firem, je nutné připojit Money S3 samostatně pro každou z nich.

Na stránce propojené aplikace pak v pravém sloupci najdete odkaz „Pojmenování…“, který Vás přenese na stránku, kde můžete své propojení pojmenovat. Díky tomu snadno rozlišíte jednotlivé připojené firmy a budete mít ve svých integracích lepší přehled.

Mimochodem, pokud připojujete více účtovaných firem, doporučujeme zvážit založení samostatné organizace pro každou z nich. Více informací naleznete v části Správa více organizací.