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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/pohoda.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.