Napojení na účetní systém MoneyS3 - Hybrid agent (přes API)

Před tím než připojíte účetní jednotku, tak je potřeba mít nainstalovaný modul API v Money S3. Objednat si ho můžete přímo přes webové stránky Seyfor  👉https://money.cz/vlastnosti/api/ 👈 Jedná se o jednorázovou investici a tento modul pak můžete kromě Digitoo.ai využívat i pro napojení například na banky nebo e-shopové platformy.

Nastavení MoneyS3 API

Jestliže už máte API modul koupený a aktivovaný, tak musíte mít správně nastavený klíč API. Toto nastavení naleznete v MoneyS3 - Možnosti a nastavení - klíče API:

Zde kliknete na “Přidat” a Následně přidáte tyto povinné pole:

• Client ID: digitoo
• Client Secret: Nastavte si vlastní Client Secret
• Zvolíme uživatele: {uživatel}

Nastavení vlastní Client Secret

Client Secret je potřeba zadat v agentovi v pokročilém nastavení - Money Client Secret.

Velmi důležité je také, abyste měli API aktualizované na nejnovější verzi, a pokud nevíte, jestli ho máte aktualizované, obraťte se prosím na podporu Seyfor.

Zvolíme uživatele ze seznamu: {uživatel}

Pro předcházení možným problémům doporučujeme nastavit uživateli API nejvyšší možnou úroveň oprávnění, například roli Admin. Pokud uživatel již úspěšně exportuje dokumenty v XML verzi a přechází na API verzi, může pro API využít stejného uživatele jako v XML agentovi.

Napojení účetního systému Money S3 s Digitoo.ai

V Digitoo.ai aplikaci si nejprve přidejte účetní jednotku kliknutím na plusové tlačítko v levém dolním rohu. Pouze uživatel s oprávněním super admin nebo vlastník může vytvořit nové účetní jednotky. Zde vyberte propojení pro Money S3 API.

Jakmile si přidáte účetní jednotku a vyplníte název firmy, IČO a DIČ, v druhém kroku si stáhnete instalační soubor pro konektor na Money S3 - Digitoo Agenta.

Ten musí být stažený na počítač či server, kde probíhá práce účetní. Soubor následně otevřete. Agent zajišťuje obousměrnou komunikaci mezi Digitoo.ai a účetním systémem MoneyS3. Umožní do účetního systému odesílat doklady z Digitoo.ai aplikace a z MoneyS3 přenese veškeré číselníky do Digitoo.ai aplikace.

Ve třetím kroku si pak zkopírujte token, který budete potřebovat pro dokončení propojení, jakmile dokončíte instalaci agenta.

Jakmile proběhne stažení instalačního souboru, otevřete si záložku, kam se vám soubor stáhnul a klikněte na něj. Po otevření se vám pravděpodobně otevře varovné okénko "Windows Defender" Jelikož se jedná o testovací verzi produktu, nedošlo ještě k registraci u společnosti Microsoft. Software je však bezpečný.  Potvrďte tedy, že chcete program nainstalovat.

Po úspěšné instalaci se vám objeví na ploše ikona Digitoo.ai agenta.

Průvodce propojením - první připojení

Po otevření Digitoo Agenta se vám zobrazí úvodní stránka, která vás provede nastavením a připojením agenta. Konfigurace se nastaví ve 4 krocích.

1. Propojení s vaším Digitoo.ai účtem
2. Přihlášení do Money S3
3. Propojení účetní jednotky
4. Nastavení přenosu dat do Money S3

1. Propojení s vaším Digitoo.ai účtem

Po kliknutí na tlačítko “Začít” přejdete na krok 1: Propojení s vaším Digitoo.ai účtem. Zde zadáte e-mail, který používáte k přihlášení do Digitoo.ai, 

a přístupový token k dané účetní jednotce, který jste zkopírovali v Digitoo.ai při jejím vytvoření.

Pokud jste si token nezkopírovali při vytváření jednotky, můžete ho dodatečně najít v aplikaci Digitoo.ai v Nastavení v levém horním rohu - sekce "Seznam připojení". Zde ho pak najdete pod názvem konkrétní firmy, kterou chcete připojit. Kliknutí na ikonu obdélníků ho jednoduše zkopírujete.

Přihlášení do Money S3

Po ověření přejdete na krok 2: Přihlášení do Money S3, kde se přihlásíte do svého účetního systému svým heslem přímo z Money S3.

Pokud přihlášení proběhlo úspěšně, přejděte na krok 3.

V některých případech Digitoo Agent nenajde cestu k EXE souboru automaticky, pak se po přihlášení objeví formulář „Cesta k Money S3 EXE souboru“. Často jde o situaci, kdy Money S3 běží na serveru nebo na vzdálené ploše.

Cestu k Money S3 najdete následujícím způsobem: klikněte pravým tlačítkem myši na ikonu Money S3 na ploše - Vlastnosti - Cíl. V řádku Cíl/Target zkopírujte vše, co je uvedeno (včetně případných uvozovek).

⚠️ POZOR: pokud se nastavuje cesta k EXE souboru, tak cesta k EXE souboru musí mít vždy přiřazeno písmeno např. C:\ , nestačí zadat pouze \\.

3: Propojení účetní jednotky

Po ověření přístupových údajů do Money S3 přejděte na krok 3: Propojení účetní jednotky. V tomto kroku zadáte název jednotky, kterou chcete propojit s aplikací Digitoo.ai. Název jednotky nemusí být přesný, slouží pouze pro vaši orientaci.

Do dalšího pole ve formuláři zkopírujete kód agendy, který najdete ve vašem Money v Agenda > Výběr agendy > kód agendy jsou tři písmenka/číslice přímo za tečkou názvu Agendy.

4. Nastavení přenosu dat do Money S3

Po propojení účetní jednotky přejdete na poslední krok 4: Nastavení přenosu dat do Money S3.

Jsou zde čtyři možnosti nastavení:

• Dokumenty, které jsem odeslal/a já.
• Dokumenty, které jsem odeslal/a já nebo automatizace.
• Všechny dokumenty.
• Žádné.

V tuto chvíli je účetní jednotka připojena a veškeré zpracované faktury, budou na pozadí ze strany Digitoo.ai zaslány přímo do Vašeho účetního systému MoneyS3.

Pokud nastala situace, kdy jste průvodce nastavení přeskočili, nastavení můžete provést dodatečně v Pokročilém nastavení.

Připojení další jednotky

Pokud chcete přidat další účetní jednotky, musíte vždy vytvořit účetní jednotku nejprve v Digitoo.ai aplikaci ve webovém prohlížeči, abyste měli token potřebný pro vytvoření propojení s danou firmou v MoneyS3. Teprve potom ji můžete přidat do ‘Seznamu připojení’ v agentovi.

V agentovi klikněte na záložku Připojené agendy a následně na modré tlačítko vpravo nahoře “Připojit agendu”. Případně můžete také kliknout na šedé plus vlevo vedle nadpisu ,,agendy".

Do prvního řádku zadejte libovolný název agendy (účetní jednotky).

Do dalšího pole ve formuláři zkopírujete kód agendy, který najdete ve vašem MoneyS3 v: Agenda > Výběr agendy > kód agendy jsou tři písmenka/číslice přímo za tečkou názvu Agendy.

Následně zadejte přístupový token patřící k dané účetní jednotce, který jste zkopírovali v Digitoo.ai při vytvoření účetní jednotky.

Pokud jste si token nezkopírovali při vytváření jednotky, můžete ho dodatečně najít v Nastavení v levém horním rohu - sekce "Seznam připojení". Zde ho pak najdete pod názvem konkrétní firmy, kterou chcete připojit. Kliknutí na ikonu obdélníků ho jednoduše zkopírujete.

V záložce “Připojené agendy” můžete případně připojení zrušit nebo přidat další účetní jednotky.

⚠️ POZOR: Pokud přecházíte z integrace Money XL na API a připojíte agendy v novém agentovi Digitoo Agent Money2 (verze pro připojení na Money S3 API), používejte prosím vždy pouze jednu verzi agenta. Verzi Digitoo Agent Money Pro (původní XML verze) nemusíte hned odinstalovat, ale tato verze nesmí běžet zároveň s verzí Digitoo Agent Money2.

Agent běží na pozadí, a mimo počáteční nastavení a propojení nových účetních jednotek s ním nepracujete - můžete ho tedy minimalizovat. Klient se schová a najdete ho na liště vpravo dole pod zobáčkem.

Pokud se propojení Digitoo.ai aplikace s MoneyS3 nezdařilo, zobrazí se vám v Digitoo.ai aplikaci oranžový banner upozorňující, že nemáte hotovo. 

Případně v agentovi v záložce ‘Historie událostí’ se objeví chybová hláška.
Prověřte, že jste zadali všechny údaje správně. Případně nás kontaktujte na tvujteam@digitoo.cz a rádi vám pomůžeme.