# Atollon - IS Pohoda - Nastavení synchronizace

## 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ů.

<span style="color: rgb(230, 126, 35);">// Pozn.: dočasné řešení pro připojení k ERP Bridge serveru na microservices vyžaduje zavedení záznamu do c:\\Windows\\System32\\drivers\\etc\\hosts</span>

```
89.187.158.194 $INSTANCE.atollon.com
```

<span style="color: rgb(230, 126, 35);">kde $INSTANCE je název instance Atollonu</span>

## 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.

[![erpBridge_webapp_empty.PNG](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/PkI4iI38DbmfDKJa-erpbridge-webapp-empty.PNG)](https://help.atollon.com/uploads/images/gallery/2025-06/PkI4iI38DbmfDKJa-erpbridge-webapp-empty.PNG)

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

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

> **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 <a>**https://chytrafirma.atollon.com/ui/erpbridge**</a>.  
    *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.

[![eprbridge_webapp_.PNG](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/giYurK3PZPbR6asa-eprbridge-webapp.PNG)](https://help.atollon.com/uploads/images/gallery/2025-06/giYurK3PZPbR6asa-eprbridge-webapp.PNG)

> **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.

[![image.png](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/LMMwuV4d3Z5OCzZi-image.png)](https://help.atollon.com/uploads/images/gallery/2025-06/LMMwuV4d3Z5OCzZi-image.png)

> **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).
2. 1. > **Figure 1 – Configuration app shortcut**
        > 
        > **[![image.png](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/BKXe0xeFMWjnbs4v-image.png)](https://help.atollon.com/uploads/images/gallery/2025-06/BKXe0xeFMWjnbs4v-image.png)**
3. Vyplňte následující pole:
    
    <table><tbody><tr><td>Pole</td><td>Hodnota</td></tr><tr><td>**Instance**</td><td>`wss://<název-instance>.atollon.com` (např. `wss://chytrafirma.atollon.com`)</td></tr><tr><td>**Port**</td><td>`443` (výchozí)</td></tr></tbody></table>
4. V poli **Key** se objeví vygenerovaný GUID.
    
    > **Figure 2 – Instance Configuration window**
    > 
    > **[![ERP_bridge_configuration.PNG](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/gBKwytGMaB3Qke6w-erp-bridge-configuration.PNG)](https://help.atollon.com/uploads/images/gallery/2025-06/gBKwytGMaB3Qke6w-erp-bridge-configuration.PNG)**
5. 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**
> 
> [![erprbidge_setup2.PNG](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/sap6vLkwv5VKYgC8-erprbidge-setup2.PNG)](https://help.atollon.com/uploads/images/gallery/2025-06/sap6vLkwv5VKYgC8-erprbidge-setup2.PNG)
> 
> [![Frame 1.png](https://help.atollon.com/uploads/images/gallery/2025-06/scaled-1680-/Cj16xcmvrmbuqHvo-frame-1.png)](https://help.atollon.com/uploads/images/gallery/2025-06/Cj16xcmvrmbuqHvo-frame-1.png)

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

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

## 9 Odstraňování problémů

<table id="bkmrk-projev-mo%C5%BEn%C3%A1-p%C5%99%C3%AD%C4%8Dina"><tbody><tr><td>Projev</td><td>Možná příčina</td><td>Řešení</td></tr><tr><td>**„Instance unreachable“**</td><td>Proxy neběží</td><td>Restartujte službu *Atollon ERP Bridge Proxy*.</td></tr><tr><td>**Synchronizace končí HTTP 403**</td><td>Neplatný client key</td><td>Vygenerujte nový key v **Configuration**, zadejte jej do Web UI a uložte.</td></tr><tr><td>**Data se neimportují**</td><td>Chybná cesta XML/dat</td><td>Zkontrolujte cesty ve formuláři *Add New Instance*.</td></tr><tr><td>**Port 443 je obsazen**</td><td>Jiná služba používá 443</td><td>Změňte **Port** v *Configuration* a uvolněte jej ve firewallu.</td></tr></tbody></table>


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

<table id="bkmrk-soubor-%2F-slo%C5%BEka-v%C3%BDch"><tbody><tr><td>Soubor / Složka</td><td>Výchozí cesta</td></tr><tr><td>Spustitelné soubory</td><td>`C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\`</td></tr><tr><td>Konfigurační soubor</td><td>`application.yml` (stejná složka jako výše)</td></tr><tr><td>Logy</td><td>`%PROGRAMDATA%\Atollon\ERPBridge\logs\`</td></tr><tr><td>Zástupci Start menu</td><td>`%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\Atollon ERP Bridge Proxy\`</td></tr></tbody></table>

<div id="bkmrk--23">---

</div>© 2025 Atollon Consulting s.r.o.