Atollon ERP Bridge - Nastavení a instalace

Atollon ERP Bridge Proxy - Průvodce instalací a nastavením

Obsah

1. Účel ERP Bridge Proxy

2. Systémové požadavky a předpoklady

3. Krok 1 - Stažení a instalace Proxy

4. Krok 2 - Spuštění služby Proxy

5. Krok 3 - Konfigurace Proxy

6. Krok 4 - Registrace instance ERP ve webovém uživatelském rozhraní

7. Krok 5 - Spuštění první synchronizace

8. Údržba a aktualizace

9. Řešení problémů

10. Příloha A - Výchozí umístění souborů.

1  Účel ERP Bridge Proxy

Atollon ERP Bridge Proxy je lehká aplikace pro Windows, která zajišťuje bezpečnou obousměrnou synchronizaci mezi cloudovou platformou Atollon One a lokálním on‑premise ERP systémem (např. Pohoda, Helios Inuvio, Byznys CG, Money S3 aj.).
Komunikace probíhá přes protokol WebSocket/HTTPS na portu 443, takže není nutné otvírat příchozí pravidla firewallu – postačí pouze odchozí provoz HTTPS.

2  Systémové požadavky a předpoklady

Komponenta	Požadavek
Operační systém	Windows 10 (64‑bit) nebo novější / Windows Server 2016 nebo novější
Oprávnění	Lokální administrátor pro instalaci a počáteční konfiguraci
Síť	Odchozí přístup na *.atollon.com přes TCP 443
ERP klient	Již nainstalovaná podporovaná ERP aplikace (Pohoda, Helios Inuvio, …)
Přístupové údaje	Přihlášení do webové správy ERP Bridge (obvykle admin nebo root)

Tip – Staging environment
Perform the first installation on a staging workstation or VM to validate connectivity before deploying to production.

3  Krok 1 – Stažení a instalace Proxy

1. Otevřete prohlížeč a přejděte na https://chytrafirma.atollon.com/ui/erpbridge.
   Přihlaste se údaji poskytnutými konzultantem Atollon.

2. V levém panelu zvolte ERP Bridge Proxy Download.
   Stáhne se instalační soubor (EXE/MSI, ≈ 40 MB).

3. Spusťte instalátor jako správce a dokončete průvodce.
   Restart Windows obvykle není nutný, ale proved’te jej, pokud k němu instalátor vyzve.

Result: Three shortcuts are created under Start Menu › Programs › Atollon ERP Bridge Proxy:
• ERPBridge – starts the background sync service
• Configuration – opens the Proxy configuration editor
• Uninstall Atollon ERP Bridge Proxy

4  Krok 2 – Spuštění služby Proxy

1. Spusťte ERPBridge ze Start menu (nebo jej později zaregistrujte jako službu – viz kapitola Údržba).

2. V Správci úloh › Procesy na pozadí ověřte, že běží ERPBridge.exe a že se neobjevila výstraha firewallu.

Good to know
ERPBridge starts in silent mode and continues to run after you close the terminal window.

5  Krok 3 – Konfigurace Proxy

1. Otevřete zástupce Configuration. Zobrazí se dialog Instance Configuration (viz Obrázek 1).
   

1. 1. Figure 1 – Configuration app shortcut

      

2. Vyplňte následující pole:

   Pole	Hodnota
   Instance	wss://<název-instance>.atollon.com (např. wss://chytrafirma.atollon.com)
   Port	443 (výchozí)

3. V poli Key se objeví vygenerovaný GUID.

   
   

   Figure 2 – Instance Configuration window

   

    

4. Stiskněte Save – tento krok nevynechávejte!

   Nastavení se uloží do C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\application.yml.

---

6  Krok 4 – Registrace ERP instance ve webovém rozhraní

1. Ve Web UI klikněte na Add New. Zobrazí se modal Add New Instance (Obrázek 2).

2. V poli Instance Type zvolte svůj ERP (např. Pohoda).

3. Nastavte Frequency – pro testování doporučujeme každou 1 minutu (lze změnit později).

4. Vyberte Atollon Instance (tenant) ze seznamu.

5. Zadejte Instance Name (např. Pohoda‑Office).

6. Vložte Client Key vygenerovaný v kroku 3.

7. Doplňte ERP‑specifické cesty a přístupové údaje:

   • Cesta k Pohoda.exe – např. C:\Program Files (x86)\STORMWARE\POHODA\Pohoda.exe

   • XML folder – např. C:\ProgramData\STORMWARE\POHODA01\Data

   • Database files folder – stejné nebo vlastní umístění dat

   • Uživatelské jméno/heslo Pohoda – účet s právy XML Import

   • ICO – IČO společnosti (jen pro Pohodu)

8. Zkontrolujte zaškrtávací pole (Product sync, Contact sync, Import invoices, …) a aktivujte požadované funkce.

9. Klikněte na Confirm.

Figure 2 – Add New Instance for Pohoda

A new row appears in the My Instances table with status Scheduled.

7  Krok 5 – První spuštění synchronizace

1. Označte řádek instance a zvolte ⋯ Action › Synchronise Now.

2. Sledujte ukazatele Last Synchronisation a Failed instances.
   • Zelená = úspěch, • Červená = chyba (viz Odstraňování problémů).

3. Ověřte, že se data (např. kontakty, produkty) zobrazila ve vašem ERP.

Gratulujeme – Bridge je aktivní!

8  Údržba a aktualizace

Úkon	Doporučení
Windows služba	Na serverech spusťte ERPBridge.exe --install pro registraci služby a nastavte typ spuštění Automaticky (zpožděné).
Aktualizace Proxy	Stáhněte novou verzi instalátoru a spusťte ji; soubor application.yml zůstane zachován.
Log soubory	%PROGRAMDATA%\Atollon\ERPBridge\logs\*.log – rotujte měsíčně nebo napojte na SIEM.
Zálohy databáze	Použijte nativní postup vašeho ERP (Pohoda, Helios, …). Bridge sám o sobě data neukládá.

9  Odstraňování problémů

Projev	Možná příčina	Řešení
„Instance unreachable“	Proxy neběží	Restartujte službu Atollon ERP Bridge Proxy.
Synchronizace končí HTTP 403	Neplatný client key	Vygenerujte nový key v Configuration, zadejte jej do Web UI a uložte.
Data se neimportují	Chybná cesta XML/dat	Zkontrolujte cesty ve formuláři Add New Instance.
Port 443 je obsazen	Jiná služba používá 443	Změňte Port v Configuration a uvolněte jej ve firewallu.

10  Příloha A – Výchozí umístění souborů

Soubor / Složka	Výchozí cesta
Spustitelné soubory	C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\
Konfigurační soubor	application.yml (stejná složka jako výše)
Logy	%PROGRAMDATA%\Atollon\ERPBridge\logs\
Zástupci Start menu	%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\Atollon ERP Bridge Proxy\

© 2025 Atollon Consulting s.r.o.