# Nastavení synchronizace - IS Pohoda

## Obsah

1. Účel ERP Bridge Proxy
2. Systémové požadavky a předpoklady
3. Stažení a instalace Proxy
4. Konfigurace Proxy
5. Spuštění / restart Proxy
6. Registrace instance ERP ve webovém uživatelském rozhraní
7. 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(224, 62, 45);">// Deprecated - 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(224, 62, 45);">kde $INSTANCE je název instance Atollonu, např. firma.atollon.com</span>

## Účel ERP Bridge Proxy

**Atollon ERP Bridge Proxy** je lehká aplikace pro Windows, která zajišťuje bezpečnou obousměrnou komunikaci mezi synchronizačním serverem **Atollon ERP Bridge** systému **Atollon** a lokálním on‑premise ERP systémem (např. Pohoda, Pohoda E1, 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.

Běžící aplikaci Atollon ERP Bridge Proxy najdete v systémové tray ikonce MS Windows:

[![erpbridge-proxy.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/erpbridge-proxy.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/erpbridge-proxy.png)

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

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

> **Tip pro pilotní testování**  
> Pokud chcete ověřit chod řešení v izolovaném testovacím prostředí, nejprve nainstalujte pracovní stanici s přístupem uživatele do systému pouze na testovací databázi. Ze zkušeností je tento přístup více než opatrný. V prvním kole synchronizace "full sync" (Restart) se přenáší data zejména z IS Pohoda do Atollonu:
> 
> 1. Účtová osnova
> 2. Číselné řady
> 3. Střediska, Činnosti, Zakázky
> 4. Kontakty (podle příznaku v IS Pohoda potom vytváří v Atollonu složku Zákazníci nebo Dodavatelé
> 5. Produkty
> 6. Pokud je to konfigurované, přenáší se do Atollonu i historické objednávky a faktury
> 
> Při běžné synchronizaci se přenáší schválené doklady - objednávky, faktury (přijaté i vydané).

## Stažení a instalace Proxy

1. Otevřete prohlížeč a přejděte na: [https://vaseinstance.atollon.com/ui/erpbridge/](https://vaseinstance.atollon.com/ui/erpbridge/) (kde místo "vaseinstance" zadejte název instance vaší firmy).  
    *Přihlaste se údaji poskytnutými konzultantem Atollonu.*
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. Je vhodné ověřit, že po restartu OS se ERP Bridge Proxy automaticky nastartuje.

[![erpbridge-proxy-download.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/erpbridge-proxy-download.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/erpbridge-proxy-download.png)

> **Výsledek**: Tři odkazy na aplikace jsou vytvořené ve **Start Menu › Programy › Atollon ERP Bridge Proxy**:  
> • **ERPBridge** – nastartuje synchronizační službu  
> • **Configuration** – otevře Proxy editor konfigurace  
> • **Uninstall Atollon ERP Bridge Proxy** - odinstaluje synchronizátor

## Konfigurace Proxy

1. Otevřete zástupce **Configuration**. Zobrazí se dialog *Instance Configuration* (viz Obrázek 1).
    
    
    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)**
2. 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></tbody></table>
3. V poli **Key** se objeví vygenerovaný GUID.
    
    > **Okno Instance Configuration**
    > 
    > [![erpbridge-confg.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/erpbridge-confg.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/erpbridge-confg.png)
4. Stiskněte **Save** – *tento krok nevynechávejte!*
    
    Nastavení se uloží do `C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\application.yml`.

## 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. Ve **Správci úloh › Procesy na pozadí** ověřte, že běží `ERPBridge` 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)

## Registrace ERP Bridge instance ve webovém rozhraní

1. Ve Web UI http://&lt;vaseinstance&gt;.atollon.com/ui/erpbridge klikněte na **Add New**. Zobrazí se formulář *Add New Instance*.
2. V poli **Instance Type** zvolte svůj ERP (např. **Pohoda**).
3. Nastavte **Frequency** – pro testování doporučujeme *každých 5 minut* (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 ERP Bridge Proxy výše.
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\` (ponechte zpětné lomítko na konci cesty)
    - **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)
    - V případě varianty Pohoda E1 - cesta k MS SQL pro případ, že je MS SQL na stejném stroji nebo ve vnitřní síti: **SERVER-POHODA-N\\POHODA;trustServerCertificate=true**
        - Zkontrolujte, že je MS SQL dostupné na TCP/IP portu 1434
8. Zkontrolujte zaškrtávací pole (Product sync, Contact sync, Import invoices, …) a aktivujte požadované funkce.
9. Klikněte na **Confirm**.

> **Příklad nastavení IS Pohoda (lokální databáze)**
> 
> **[![pohoda-local-setup-1.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/pohoda-local-setup-1.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/pohoda-local-setup-1.png)[![pohoda-local-setup-2.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/pohoda-local-setup-2.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/pohoda-local-setup-2.png)**

> **Příklad nastavení IS Pohoda E1 (MS SQL)**
> 
> **[![pohoda-e1-setup-1.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/pohoda-e1-setup-1.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/pohoda-e1-setup-1.png)[![pohoda-e1-setup-2.png](https://navody.atollon.cz/uploads/images/gallery/2025-07/scaled-1680-/pohoda-e1-setup-2.png)](https://navody.atollon.cz/uploads/images/gallery/2025-07/pohoda-e1-setup-2.png)**

## První spuštění synchronizace

1. Označte řádek instance a zvolte **⋯ Action › Restart**
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. První synchronizace tisíců záznamů může trvat půl hodiny, první nicméně uvidíte přírůstky v kontaktech.

### Konfigurace v Atollonu po první synchronizaci

1. Při první synchronizaci se z IS Pohoda natáhne účtová osnova a číselné řady. V případě číselných řad (Faktury vydané, Faktury přijaté, Objednávky, apod.) je nutné před jejich použitím v Atollonu nastavit výchozí finanční účty. Tyto slouží k přednastavení zaúčtování přenášených transakcí. Cílem je nastavit systém tak, aby se přenášené doklady již nemusely v IS Pohoda upravovat ručně. 
    1. Nastavení výchozích účtů pro číselné řady / deníky najdete v návodu na [nastavení deníků](https://navody.atollon.cz/books/atollon-pro-finance/page/nastaven%C3%AD-den%C3%ADk%C5%AF "Nastavení deníků").
    2. Nastavení výchozích účtů pro produkty (služby) najdete v návodu na [vytvoření nových produktů](https://navody.atollon.cz/books/atollon-pro-obchod-a-marketing/page/vytvo%C5%99en%C3%AD-nov%C3%A9ho-produktu#bkmrk-nastaven%C3%AD-pro-%C3%BA%C4%8Detni).


## Pravidelná synchronizace

ERP Bridge instance umožňuje nastavit frekvenci synchronizace (počet minut). Doporučujeme nastavit 5 - 15 minut. V průběhu pravidelné synchronizace se přenáší pouze parciální změny - kontrolují se zejména schválené doklady - objednávky a faktury přijaté nebo vydané, které se přenesou z Atollonu do Pohody, případně pokud je to nastaveno se přenesou objednávky a faktury z Pohody do Atollonu.

## Údržba a aktualizace

<table id="bkmrk-%C3%9Akon-doporu%C4%8Den%C3%AD-wind" style="width: 100%;"><tbody><tr><td style="width: 24.216301%;">Úkon</td><td style="width: 75.783699%;">Doporučení</td></tr><tr><td style="width: 24.216301%;">**Vždy přihlášený uživatel**</td><td style="width: 75.783699%;">Na PC / serveru, kde běží Atollon ERP Bridge Proxy je potřeba, aby byl trvale přihlášen uživatel, pod kterým byla služba instalována. IS Pohoda neumožňuje headless provoz.</td></tr><tr><td style="width: 24.216301%;">**Aktualizace Proxy**</td><td style="width: 75.783699%;">Stáhněte novou verzi instalátoru a spusťte ji; soubor `application.yml` zůstane zachován.</td></tr><tr><td style="width: 24.216301%;">**Log soubory**</td><td style="width: 75.783699%;">`%PROGRAMDATA%\Atollon\ERPBridge\logs\*.log` – rotujte měsíčně.</td></tr><tr><td style="width: 24.216301%;">**Zálohy databáze**</td><td style="width: 75.783699%;">Použijte nativní postup vašeho ERP (Pohoda, Helios, …). Bridge sám o sobě data neukládá.</td></tr></tbody></table>

## 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>**Různé problémy s importem do IS Pohoda**</td><td>Chyba na straně API nebo nastavení IS Pohoda</td><td>Pro debug mode umožnit uchování (nemazání) REQUEST XML souborů v API ERP Pohoda, pomocí úpravy parametru keep-pohoda-xmls: true do application.yml  
  
```
erpproxy:
  clientKey: 123
  mainServer: ws://localhost:8080/ws-endpoint
  updater:
#    cron: 0 */5 * * * ?
    currentVersion: 1.0.1
    url: https://river.atollon.com/erpbridge/update
  keep-pohoda-xmls: true
```

</td></tr></tbody></table>


## Výchozí umístění souborů

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

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