> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/pohoda.md).

# POHODA

Modul **POHODA** pro e-shop Rocketoo umožňuje automatickou synchronizaci dat mezi vaším e-shopem a účetním systémem POHODA. Díky tomuto propojení můžete efektivně spravovat produkty, objednávky, faktury a zákazníky bez nutnosti ručního přepisování dat mezi systémy.

Co modul POHODA umožňuje?

* ✅ **Synchronizaci produktů** z POHODY do e-shopu (včetně cen, dostupnosti, obrázků)
* ✅ **Export objednávek** z e-shopu do POHODY
* ✅ **Export faktur** z e-shopu do POHODY
* ✅ **Synchronizaci zákazníků** (adresář) v obou směrech
* ✅ **Synchronizaci ceníků** z POHODY do e-shopu
* ✅ **Automatické párování kategorií, dopravců a plateb**

***

## Požadavky

#### Systémové požadavky

* **Účetní systém POHODA** nainstalovaný na počítači s Windows
* **Správná verze tarifu** e-shopu Rocketoo (Enterprise nebo speciální tarif s podporou POHODY)

#### Podporované tarify

Modul POHODA je dostupný pro tyto tarify:

* Basic + Pohoda
* Business + Pohoda
* Enterprise
* Rocketoo MAX

Pokud používáte jiný tarif, kontaktujte obchodní oddělení pro přechod na kompatibilní tarif.

***

## Instalace a základní konfigurace

{% stepper %}
{% step %}

#### Aktivace modulu

* Přihlaste se do **administrace vašeho e-shopu Rocketoo**
* V hlavním menu přejděte do sekce **Nastavení**
* Vyberte kartu **Doplňky** nebo **Aplikace**
* Najděte modul **POHODA** a klikněte na **Aktivovat**

Poznámka: Pokud modul POHODA nevidíte, zkontrolujte, zda máte správný tarif. V případě demo verze e-shopu není modul dostupný.
{% endstep %}

{% step %}

#### Přechod do nastavení POHODA

* V hlavním menu **Nastavení** přejděte do sekce **Rozšíření**
* Vyberte rozšíření **POHODA**
  {% endstep %}

{% step %}

#### Konfigurace připojení

**Používat nový způsob synchronizace**

Zaškrtněte tuto možnost, pokud chcete používat **PowerShell skript** pro automatickou synchronizaci (doporučeno).

A vyplňte následující údaje:

| Pole                           | Popis                                                                                          |
| ------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Uživatelské jméno**          | Přihlašovací jméno do účetního systému POHODA                                                  |
| **Heslo**                      | Heslo k účtu v POHODĚ                                                                          |
| **Název datového souboru**     | Název datového souboru v POHODĚ s příponou `.mdb` (např. `StwPh_12345678_2024.mdb`)            |
| **Cesta k souboru Pohoda.exe** | Úplná cesta k souboru na disku počítače (např. `C:\Program Files\STORMWARE\POHODA\Pohoda.exe`) |

{% hint style="success" %}
**Tip:** Nový způsob synchronizace je jednodušší na nastavení a nevyžaduje instalaci služby Rocketoo Service.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Nastavení synchronizace

Po vyplnění přihlašovacích údajů můžete nakonfigurovat, co a jak se bude synchronizovat.

### Synchronizace objednávek (E-shop → POHODA)

V záložce **Objednávky** nastavte:

#### **Základní nastavení**

| Parametr                                   | Popis                                                                             |
| ------------------------------------------ | --------------------------------------------------------------------------------- |
| **Synchronizovat objednávky**              | Vyberte režim: *Nesynchronizovat* / *V intervalech* / *V intervalech a při změně* |
| **Kolik objednávek maximálně posílat**     | Limit počtu objednávek v jedné dávce (výchozí: 1000)                              |
| **Synchronizovat objednávky vytvořené po** | Datum, od kterého se mají objednávky synchronizovat                               |

#### Podmínky pro export

Můžete specifikovat, které objednávky se mají exportovat do POHODY:

* **Synchronizovat objednávky ve stavu** - Výchozí stav objednávky pro export
* **Párování Typ platby + Stav objednávky** - Přesnější nastavení pro různé kombinace plateb a stavů

***Příklad:***

* Objednávka s *platbou předem* se exportuje až ve stavu *Zaplaceno*
* Objednávka s *dobírkou* se exportuje hned ve stavu *Nová*

#### Střediska a sklady

* **Středisko** - Atribut střediska, který se propisuje do POHODY
* **Sklad** - Atribut skladu, který se propisuje do POHODY

***

### Synchronizace faktur (E-shop → POHODA)

V záložce **Faktury** nastavte:

| Parametr                                                       | Popis                                                         |
| -------------------------------------------------------------- | ------------------------------------------------------------- |
| **Synchronizovat faktury**                                     | Režim synchronizace (*Nesynchronizovat* / *V intervalech*)    |
| **Synchronizovat jen zaplacené faktury**                       | Zaškrtněte, pokud chcete exportovat pouze uhrazené faktury    |
| **Synchronizovat jen faktury se synchronizovanou objednávkou** | Export pouze faktur, které mají navázanou objednávku v POHODĚ |
| **Kolik faktur maximálně posílat**                             | Limit počtu faktur v jedné dávce                              |
| **Synchronizovat faktury vytvořené po**                        | Datum, od kterého se mají faktury synchronizovat              |
| **Středisko**                                                  | Atribut střediska pro faktury v POHODĚ                        |

***

### Synchronizace produktů (POHODA → E-shop)

V záložce **Zásoby** nakonfigurujte import produktů:

#### Základní nastavení

| Parametr                                            | Popis                                                              |
| --------------------------------------------------- | ------------------------------------------------------------------ |
| **Synchronizovat zásoby**                           | *Nesynchronizovat* / *V intervalech* / *V intervalech a při změně* |
| **Importovat jenom položky s příznakem "Internet"** | Pouze produkty označené v POHODĚ pro e-shop                        |
| **Znak oddělující název produktu a varianty**       | Oddělovač mezi názvem produktu a varianty (výchozí: `\|`)          |

#### Chování importéru

Nastavte, jak se má systém chovat v různých situacích:

* Akce pro zásoby v e-shopu, které v POHODĚ nejsou:
  * Neimportovat, smazat existující
  * Neimportovat, skrýt existující
  * Ponechat
* Akce pro zásoby bez kategorie v POHODĚ:
  * Neimportovat
  * Importovat
  * Neimportovat, smazat existující
* Akce pro zásoby s kategorií, která není na e-shopu:
  * Neimportovat
  * Importovat
  * Neimportovat, smazat existující

#### Párování existujících variant

Pokud již máte produkty v e-shopu a nechcete, aby je POHODA duplicitně zakládala:

* Zaškrtněte **Při prvním importu párovat na existující varianty**
* Vyberte **Políčko varianty v e-shopu** (SKU, MPN, ISBN, EAN, supplier\_code)
* Vyberte **Políčko zásoby v POHODĚ** (code, EAN, PLU)

#### Omezení pole, které POHODA upravuje

Můžete omezit, která pole produktů se budou aktualizovat při synchronizaci:

* Hlavní varianta, Má varianty, SKU, Kód dodavatele, Název, Dodatek k názvu, Popis, Dlouhý popis, Hmotnost, Množství, Prodejní cena, Nákupní cena, Sazba DPH, Dostupnost, Obrázky, Ceníky

#### Omezení na konkrétní sklady

Pokud chcete importovat pouze z určitých skladů:

* Zaškrtněte **Omezit import jen na konkrétní sklady**
* Zadejte **Název skladů** (oddělené čárkou)

***

### Synchronizace adres

V záložce **Adresy** nastavte:

| Parametr                        | Popis                                                                      |
| ------------------------------- | -------------------------------------------------------------------------- |
| **Synchronizovat adresy**       | Režim (*Nesynchronizovat* / *V intervalech* / *V intervalech a při změně*) |
| **Které adresy synchronizovat** | Všechny / Registrované / Autorizované                                      |
| **Skupina**                     | Atribut skupiny, který se propisuje do POHODY                              |

***

### Párování sazeb DPH

V záložce **DPH** namapujte sazby DPH mezi e-shopem a POHODOU:

| Sazba v POHODĚ     | Sazba v e-shopu     |
| ------------------ | ------------------- |
| **Bez DPH**        | 0%                  |
| **Základní sazba** | 21% (CZ) / 20% (SK) |
| **Snížená sazba**  | 15% (CZ) / 10% (SK) |
| **3. sazba**       | Pouze pro SK verzi  |

#### OSS (One Stop Shop)

* Zaškrtněte **Doklady vystavovat v režimu OSS**
* Vyberte **Pro tyto krajiny doručení použít OSS**
* Zadejte **Druh služby (MOSS)**

#### Cizí měna

* Zaškrtněte **Doklady v POHODĚ jsou v jiné měně**
* Zadejte **Směnný kurz Rocketoo => POHODA**

***

### Párování dopravců

V záložce **Dopravci** propojte dopravce z e-shopu s dopravci v POHODĚ:

* Klikněte na **Přidat novou vazbu na dopravce**
* Vyberte **Dopravce** z e-shopu
* Zadejte **ID nebo IDS v POHODĚ**

***Příklad:***

| Dopravce v e-shopu | ID v POHODĚ |
| ------------------ | ----------- |
| Česká pošta        | CP          |
| PPL                | PPL         |
| Zásilkovna         | ZASILKOVNA  |

***

### Párování plateb

V záložce **Platby** propojte platby z e-shopu s platbami v POHODĚ:

* Klikněte na **Přidat novou vazbu na platbu**
* Vyberte **Platba** z e-shopu
* Zadejte **ID nebo IDS v POHODĚ**

***Příklad:***

| Platba v e-shopu | ID v POHODĚ |
| ---------------- | ----------- |
| Bankovní převod  | PREVOD      |
| Dobírka          | DOBIRKA     |
| Karta online     | KARTA       |

***

### Párování kategorií

Pokud chcete propojit kategorie mezi POHODOU a e-shopem:

* V záložce **Kategorie** zaškrtněte **Neimportovat všechny kategorie**
* Vyberte nebo zadejte **názvy kořenových kategorií v POHODĚ**, které NECHCETE importovat
* Zaškrtněte **Napárované kategorie nesynchronizovat**, pokud chcete kategorie upravovat pouze na e-shopu

***

### Párování dostupností

V záložce **Dostupnosti** propojte dostupnosti z POHODY s dostupnostmi v e-shopu:

* Klikněte na **Přidat dostupnost**
* Vyberte **Dostupnost** v e-shopu
* Zadejte **Název dostupnosti v POHODĚ**

***Příklad:***

| Dostupnost v e-shopu | Název v POHODĚ |
| -------------------- | -------------- |
| Skladem              | skladem        |
| Na objednávku        | objednavka     |
| Vyprodáno            | vyprodano      |

***

## Nastavení automatické synchronizace

Po konfiguraci všech nastavení je třeba nastavit automatickou synchronizaci.

### Nový způsob (PowerShell skript)

{% hint style="success" %}
**DOPORUČENO:** Nový způsob synchronizace je jednodušší na nastavení a nevyžaduje instalaci služby Rocketoo Service.
{% endhint %}

{% stepper %}
{% step %}

#### Stažení spouštěcího souboru

* V nastavení modulu POHODA klikněte na tlačítko **Stáhnout spouštěcí soubor**
* Uložte soubor `rocketoo_sync_launcher.bat` na počítač, kde máte nainstalovaný systém POHODA
  {% endstep %}

{% step %}

#### Spuštění BAT souboru

* Klikněte pravým tlačítkem na soubor `rocketoo_sync_launcher.bat`
* Vyberte **Spustit jako správce**
  {% endstep %}

{% step %}

#### Konfigurace skriptu

Skript se vás zeptá:

* **Zadejte token pro přístup k API** - pro získání tokenu nás kontaktujte.
* Skript automaticky ověří platnost tokenu
* Vytvoří potřebné složky a konfigurační soubory
* Nabídne možnost **přidat do plánovače úloh Windows**:
  * Nepřidávat do plánovače
  * Spouštět každých 5 minut
  * Spouštět každých 20 minut
  * Spouštět každou hodinu

Co skript dělá?

* ✅ Stáhne a nastaví PowerShell skript pro synchronizaci
* ✅ Vytvoří strukturu složek:
  * `config/` - konfigurační soubory
  * `requests/` - XML požadavky pro POHODU
  * `responses/` - XML odpovědi z POHODY
  * `files/` - soubory ke zpracování
  * `images/` - obrázky produktů
* ✅ Nastaví automatické spouštění podle vybraného intervalu
* ✅ Zajistí obousměrnou komunikaci mezi e-shopem a POHODOU

Manuální spuštění

* Otevřete PowerShell jako **správce**
* Přejděte do složky se skriptem: `cd C:\cesta\ke\slozce`
* Spusťte: `.\rocketoo_sync.ps1`

Pro zobrazení debug informací použijte: `.\rocketoo_sync.ps1 -v`
{% endstep %}
{% endstepper %}

***

## Sledování synchronizace

### Přehled žádostí a odpovědí

V sekci **Aplikace → POHODA** najdete záložku **Žádosti a odpovědi**, kde můžete sledovat:

| Sloupec         | Popis                                                           |
| --------------- | --------------------------------------------------------------- |
| **Typ**         | Typ synchronizace (Zásoby, Objednávky, Faktury, Adresy, Ceníky) |
| **Soubor**      | Název XML souboru                                               |
| **Request**     | Soubor požadavku                                                |
| **Response**    | Soubor odpovědi                                                 |
| **Dokončeno**   | Stav zpracování                                                 |
| **V pořádku**   | Úspěšnost                                                       |
| **Důvod chyby** | Chybová hláška (pokud nastala chyba)                            |
| **Vytvořeno**   | Datum a čas vytvoření                                           |
| **Upraveno**    | Datum a čas poslední změny                                      |

### Importované produkty

V záložce **Importované produkty** najdete přehled všech produktů importovaných z POHODY:

| Sloupec                  | Popis                                                                           |
| ------------------------ | ------------------------------------------------------------------------------- |
| **ID produktu v POHODĚ** | Identifikátor produktu v POHODĚ                                                 |
| **Název**                | Název produktu                                                                  |
| **Kód**                  | SKU/kód produktu                                                                |
| **Akce**                 | Co se s produktem stalo (Importovaný, Ponechaný, Skrytý, Smazaný, Neimportován) |
| **Důvod akce**           | Proč byla provedena daná akce                                                   |
| **Datum**                | Datum poslední synchronizace                                                    |

### Ruční zpracování odpovědí

* V seznamu **Žádosti a odpovědi** zaškrtněte požadované záznamy
* Klikněte na tlačítko **Zpracovat odpověď**
* Systém znovu zpracuje vybrané odpovědi

### Odstranění odpovědí

* V seznamu zaškrtněte záznamy
* Klikněte na **Odstranit odpověď**
* Potvrzením se smažou odpovědi a resetují se příznaky

***

## Typy synchronizací

Modul POHODA podporuje následující typy synchronizací:

### E-shop → POHODA (Export)

| Typ              | Popis                                     | Frekvence       |
| ---------------- | ----------------------------------------- | --------------- |
| **Objednávky**   | Export objednávek podle nastavených stavů | Každé 3 hodiny  |
| **Faktury**      | Export faktur (zaplacené/všechny)         | Každých 5 minut |
| **Adresy (E2P)** | Export zákazníků do adresáře POHODY       | Podle nastavení |

### POHODA → E-shop (Import)

| Typ                        | Popis                           | Frekvence           |
| -------------------------- | ------------------------------- | ------------------- |
| **Produkty (celý import)** | Import všech produktů           | Jednou denně (0:00) |
| **Produkty (změny)**       | Import pouze změněných produktů | Každé 2 hodiny      |
| **Adresy (P2E)**           | Import zákazníků z POHODY       | Podle nastavení     |
| **Ceníky**                 | Import individuálních ceníků    | Podle nastavení     |
| **Kategorie**              | Import kategorií produktů       | Podle nastavení     |
| **Střediska**              | Načtení seznamu středisek       | Podle potřeby       |
| **Sklady**                 | Načtení seznamu skladů          | Podle potřeby       |

***

## Časté problémy a řešení

#### Token není platný

***Problém:*** Po zadání tokenu skript hlásí chybu o neplatném tokenu.

***Řešení:***

1. Ověřte, že jste správně zkopírovali token z administrace
2. Zkontrolujte, že nemáte v tokenu přebytečné mezery
3. Ujistěte se, že máte aktivní tarif podporující modul POHODA

#### Produkty se neimportují

***Problém:*** V e-shopu se nezobrazují produkty z POHODY.

***Řešení:***

1. Zkontrolujte, zda jsou produkty v POHODĚ označeny příznakem "Internet"
2. Ověřte, že produkty mají přiřazenou kategorii
3. Zkontrolujte nastavení **Chování importéru**
4. V záložce **Importované produkty** najděte důvod, proč nebyly importovány

#### Objednávky se neexportují

***Problém:*** Objednávky z e-shopu se nedostanou do POHODY.

***Řešení:***

1. Zkontrolujte nastavení **Synchronizovat objednávky ve stavu**
2. Ověřte, že objednávky odpovídají nastaveným podmínkám (stav + typ platby)
3. V záložce **Žádosti a odpovědi** zkontrolujte chyby

#### Cesta k Pohoda.exe není platná

***Problém:*** Skript hlásí, že cesta k Pohoda.exe neexistuje.

***Řešení:***

1. Ověřte cestu v nastavení modulu
2. Správný formát: `C:\Program Files\STORMWARE\POHODA\Pohoda.exe`
3. Zkontrolujte, zda máte na počítači nainstalovaný systém POHODA
4. Ujistěte se, že cesta neobsahuje diakritiku nebo speciální znaky

#### Synchronizace se nespustí automaticky

Pro PowerShell skript:

1. Otevřete **Plánovač úloh Windows** (Task Scheduler)
2. Najděte úlohu **PohodaSync**
3. Ověřte, že je úloha **povolena**
4. Zkontrolujte nastavení triggeru (frekvence spouštění)

Pro Rocketoo Service:

1. Otevřete **Správce služeb** (services.msc)
2. Najděte službu **Rocketoo Service**
3. Ověřte, že je služba **spuštěna** a nastavena na **Automaticky**

#### Duplikátní produkty

**Problém:** V e-shopu se vytváří duplikáty produktů.

***Řešení:***

1. Použijte funkci **Při prvním importu párovat na existující varianty**
2. Nastavte správné párování polí (SKU, EAN, MPN)
3. Smažte duplicitní produkty a spusťte synchronizaci znovu

#### Chybí obrázky produktů

**Problém:** Produkty se importují, ale bez obrázků.

***Řešení:***

1. Ověřte, že v POHODĚ máte k produktům přiřazeny obrázky
2. Zkontrolujte, že složka `images/` má správná oprávnění
3. V nastavení ověřte, že není zaškrtnuto omezení pole "Obrázky"

***

## Pokročilá nastavení

### Nastavení intervalů synchronizace

Výchozí intervaly můžete změnit v konfiguračním souboru nebo v administraci:

| Synchronizace          | Výchozí interval    |
| ---------------------- | ------------------- |
| Zpracování odpovědí    | Každou minutu       |
| Objednávky             | Každé 3 hodiny      |
| Faktury                | Každých 5 minut     |
| Produkty (celý import) | Jednou denně (0:00) |
| Produkty (změny)       | Každé 2 hodiny      |
| Adresy                 | Každou hodinu       |
| Ceníky                 | Podle nastavení     |

### Použití více e-shopů

* Každý e-shop musí mít vlastní token
* PowerShell skript automaticky detekuje všechny e-shopy pod jedním tokenem
* Synchronizace probíhá pro všechny e-shopy najednou

### Předkontace a členění DPH

| Parametr            | Umístění    | Popis                            |
| ------------------- | ----------- | -------------------------------- |
| **Předkontace**     | Záložka DPH | Předkontace pro doklady v POHODĚ |
| **Typ členění DPH** | Záložka DPH | Typ členění (výchozí: UD)        |

### Přepis čísel objednávek

* V záložce **Objednávky** zaškrtněte **Přepisovat číslo objednávky**
* Funguje pouze pro číselné formáty objednávek

***

## Bezpečnost a zálohování

#### Ochrana tokenu

* Token je uložen v souboru `config/token.txt`
* Nikdy nesdílejte tento token s neoprávněnými osobami
* Token má plný přístup k API vašeho e-shopu

#### Zálohování konfigurace

Doporučujeme pravidelně zálohovat:

* Konfigurační soubory z složky `config/`
* XML soubory z `requests/` a `responses/` (volitelně)
* Nastavení z administrace e-shopu

#### Logování

PowerShell skript vytváří logy průběhu synchronizace:

* Pro zobrazení podrobných informací použijte parametr `-v` (verbose mode)
* Příklad: `.\rocketoo_sync.ps1 -v`

***

## Výkonnostní tipy

#### Optimalizace synchronizace produktů

* Používejte synchronizaci změn místo celého importu
* Omezit import na konkrétní sklady
* Vyloučit nepotřebné kategorie

#### Omezení velikosti dávek

* **Objednávky:** Výchozí 1000 ks
* **Faktury:** Výchozí 1000 ks

#### Frekvence synchronizace

* Pro malé e-shopy: Každou hodinu
* Pro střední e-shopy: Každých 20 minut
* Pro velké e-shopy: Každých 5 minut

***

## Časté dotazy (FAQ)

<details>

<summary>Musím mít POHODU spuštěnou při synchronizaci?</summary>

Ne, POHODA se spustí automaticky pouze pro zpracování XML požadavků a poté se ukončí.

</details>

<details>

<summary>Mohu synchronizovat více e-shopů s jednou POHODOU?</summary>

Ano, PowerShell skript podporuje synchronizaci více e-shopů najednou.

</details>

<details>

<summary>Co se stane, když se změní cena produktu v e-shopu?</summary>

Při další synchronizaci se cena přepíše hodnotou z POHODY (pokud není nastaveno jinak v omezení polí).

</details>

<details>

<summary>Jak často se synchronizují data?</summary>

Záleží na nastavení intervalů. Výchozí nastavení je pro produkty 1× denně (celý import) a každé 2 hodiny (změny), pro objednávky každé 3 hodiny.

</details>