Průvodce propojením s Pohodou
Provoz ve zkušební verzi e-shopu
V rámci 30denní zkušební doby na platformě Upgates máte k dispozici všechny funkce, včetně možnosti propojení s účetním systémem Pohoda. To znamená, že Pohodu můžete během zkušebního období bezplatně využívat pro nastavení pravidelných a automatických importů a exportů dat mezi oběma systémy.
Kompatibilita
Propojení s Pohodou je podporováno výhradně na aktuálních verzích operačních systémů Windows a Windows Server, na kterých bude spuštěn konektor Upgates. Na starších verzích těchto systémů, jiných zařízeních či jiných operačních systémech nemůže být zajištěna plná funkčnost. Zároveň je nezbytné, aby ve vašem operačním systému Windows byla aktivní podpora protokolu TLS 1.2.
Ke stažení
Upgates-konektor-2.0.18.msi
Aktuální verze: 2.0.18
Příprava před instalací konektoru
Aktualizace Pohody
Před instalací konektoru je nutné zajistit, aby váš účetní systém Pohoda byl aktualizován na nejnovější dostupnou verzi. Aktualizaci provedete přímo v programu Pohoda. V hlavním menu klikněte na záložku Nápověda a z rozbalovací nabídky vyberte možnost Aktualizovat. Tímto krokem spustíte automatickou aktualizaci programu Pohoda.
Údržba databáze Pohody
Před instalací konektoru doporučujeme provést údržbu databáze účetního systému Pohoda. Postup pro údržbu naleznete v oficiálním návodu, který vydává společnost Stormware, výrobce programu Pohoda. Řiďte se instrukcemi uvedenými v tomto návodu.
Kontrola fakturačních údajů firmy
Pro zajištění správného párování dat je důležité zkontrolovat, zda identifikační číslo organizace (IČO) uvedené v nastavení vašeho Upgates e-shopu odpovídá IČO nastavenému v příslušné účetní jednotce v programu Pohoda.
V administraci e-shopu Upgates přejděte do sekce v Nastavení / Základní / Nastavení obchodu / Fakturační údaje. Zkontrolujte, zda se IČO (u hlavního jazyka) přesně shoduje s IČO ve vaší Pohodě, včetně případných mezer mezi číslicemi. Je nezbytné, aby obě hodnoty byly identické.
V administraci e-shopu:
A v Pohodě:
Instalace konektoru
1. Stažení konektoru: Stáhněte si instalační soubor Upgates konektoru kliknutím na tento odkaz: Upgates konektor. Nebo konektor vyhledejte v administraci vašeho Upgates e-shopu v sekci věnované propojení s Pohodou.
2. Spuštění instalace: Po stažení souboru jej spusťte. V zobrazeném okně s upozorněním potvrďte, že si přejete instalační soubor spustit.
Poté proveďte instalaci dle průvodce.
3. Spuštění konektoru poprvé: Po úspěšné instalaci vyhledejte na ploše vašeho počítače/serveru zástupce s názvem Upgates konektor. Klikněte na něj pravým tlačítkem myši a z kontextového menu vyberte možnost Spustit jako správce. Toto je důležité pro zajištění správných oprávnění konektoru.
4. Nastavení cesty k Pohodě: Při prvním spuštění konektoru se zobrazí okno s výzvou k nastavení cesty k souboru Pohoda.exe. Klikněte na pole pro zadání cesty a vyhledejte soubor Pohoda.exe ve vašem počítači nebo serveru. Obvykle se nachází v adresáři Počítač / "název disku" / Program Files / STORMWARE / Pohoda / Pohoda.exe. Je však možné, že se cesta na vašem systému bude lišit. Po nalezení souboru jej vyberte a potvrďte.
5. Vytvoření nového propojení: Po úspěšném nastavení cesty k Pohodě se otevře nové okno s nabídkou Vytvoření a editace propojení. Pro zahájení konfigurace propojení klikněte na tlačítko Přidat propojení.
6. Pojmenování propojení: Zobrazí se okno Přidat propojení, ve kterém můžete nově vytvářené propojení libovolně pojmenovat. Tato funkce je užitečná, pokud spravujete více Upgates e-shopů a potřebujete pro každý z nich samostatné propojení s Pohodou. Můžete si takto vytvořit neomezený počet propojení.
Nastavení nového propojení
Po kliknutí na tlačítko Přidat propojení se otevře okno s detailním nastavením vašeho nového propojení mezi Upgates a Pohodou. Pro správnou funkčnost je nutné pečlivě vyplnit všechny potřebné údaje. Okno je rozděleno do několika sekcí: Hlavní, E-shop, a Pohoda.
Sekce Hlavní
- ID propojení: Unikátní kód tohoto propojení, který je generován automaticky systémem. Toto pole nemůžete editovat.
- Název propojení: Zde zadejte název, pod kterým chcete toto propojení v konektoru identifikovat (např. "Propojení s hlavním e-shopem").
- Aktivní: Zaškrtnutím tohoto políčka aktivujete nebo deaktivujete toto konkrétní propojení. Pokud je políčko zaškrtnuté, propojení je aktivní a může probíhat synchronizace dat.
- Automaticky exportovat data (z Pohody do e-shopu): Zaškrtněte toto políčko, pokud si přejete automaticky exportovat produkty z účetního systému Pohoda do vašeho e-shopu v pravidelných časových intervalech. I s touto možností aktivní můžete nadále využívat ruční export produktů pomocí tlačítka Přenést data z Pohody. Důležité: Pro export budou vybrány pouze produkty, které mají v Pohodě zaškrtnuté pole "internet".
- Automaticky importovat objednávky (z e-shopu do Pohody): Zaškrtněte toto políčko, pokud si přejete automaticky přenést nové objednávky z vašeho e-shopu do účetního systému Pohoda v pravidelných časových intervalech. I s touto aktivní možností můžete nadále využívat ruční import objednávek pomocí tlačítka Přenést objednávky do Pohody.
- Dodatečné parametry propojení: Toto pole je určeno výhradně pro technickou podporu společnosti Upgates. Při běžném nastavení jej ponechte prázdné.
- Exportovat objednávky od: Standardně konektor přenáší objednávky z e-shopu do Pohody podle času od posledního úspěšného přenosu. Pomocí tohoto nastavení můžete definovat vlastní počáteční datum, od kterého se mají objednávky začít přenášet. Upozornění: Změna tohoto data může způsobit duplicitní přenos již existujících objednávek.
- Vyexportovat všechna data (z Pohody do e-shopu): Konektor běžně odesílá do e-shopu pouze ta data z Pohody, která se změnila od posledního exportu. Pokud potřebujete znovu exportovat všechna data (např. při prvním spuštění nebo po rozsáhlých změnách), zaškrtněte toto políčko.
- Vyexportovat všechny obrázky a soubory (z Pohody do e-shopu): Konektor si pamatuje, které obrázky a soubory již do e-shopu odeslal, a při dalších exportech je znovu neposílá. Pokud chcete vynutit opětovné odeslání všech obrázků a souborů z Pohody do e-shopu, zaškrtněte toto políčko.
Sekce E-shop
Než budete moci vyplnit údaje v této sekci, je potřeba v administraci vašeho Upgates e-shopu aktivovat doplněk Pohoda. Postupujte následovně:
- V administraci e-shopu přejděte do sekce Doplňky / Pohoda - pokud zde vidíte oddíl Instalace, pokračujte bodem 3.
- Pokud oddíl Instalace není k dispozici, přejděte do sekce Doplňky / + Seznam doplňků.
- Vyhledejte v seznamu doplněk s názvem Pohoda - Ekonomický systém a klikněte na tlačítko Aktivovat.
Po aktivaci doplňku se vraťte do nastavení konektoru a vyplňte následující údaje:
- Název projektu: Zde vyplňte název vašeho Upgates projektu (e-shopu). Tento název obvykle naleznete v horní části administrace vašeho e-shopu.
- API klíč: Překopírujte unikátní kód API klíče pro identifikaci vašeho e-shopu. Tento klíč naleznete v administraci e-shopu v sekci Doplňky / Pohoda v oddíle Instalace.
Aktivace importu produktů a kategorií (volitelné placené funkce):
Pokud chcete využívat automatický import produktů a kategorií do vašeho e-shopu z Pohody (tato funkce může být zpoplatněna), postupujte následovně:
- V administraci e-shopu přejděte do sekce Doplňky / Pohoda.
- U importu produktů a/nebo importu kategorií zaškrtněte políčko Aktivní.
- Klikněte na tlačítko Uložit v dolní části stránky.
- Po uložení se zobrazí vyskakovací okno s podrobným nastavením daného importu (produktů nebo kategorií). Proveďte konfiguraci podle vašich požadavků (např. mapování polí, nastavení aktualizací) a klikněte na tlačítko Uložit v tomto okně.
Sekce Pohoda
- Uživatel: Zadejte uživatelské jméno, pod kterým se přihlašujete do programu Pohoda. Ve výchozím nastavení je to obvykle uživatel s názvem Admin.
- Heslo: Zadejte heslo k vašemu uživatelskému účtu v programu Pohoda. Pokud heslo nepoužíváte, ponechte toto pole prázdné.
- Název databáze účetní jednotky: Pro zjištění přesného názvu databáze vaší účetní jednotky otevřete program Pohoda a přejděte do menu Soubor / Účetní jednotky.
- V zobrazeném seznamu účetních jednotek naleznete ve sloupci Datový soubor přesný název souboru vaší aktuálně používané účetní jednotky (včetně přípony). Tento celý název souboru přepište do pole Název databáze účetní jednotky v nastavení konektoru. Ujistěte se, že vybíráte datový soubor aktuálního účetního období.
- IČO účetní jednotky: Zde zadejte identifikační číslo organizace (IČO), které je zapsáno v programu Pohoda a zároveň ve vašem Upgates e-shopu (v sekci Nastavení / Základní / Nastavení obchodu / Fakturační údaje pro hlavní jazykovou mutaci).
- Složka dokumentů firmy: Vyberte složku, ve které se nacházejí podsložky s obrázky a souvisejícími soubory, které chcete exportovat z Pohody do e-shopu. Pro zjištění této složky v programu Pohoda přejděte do menu Nastavení / Globální nastavení.
- V zobrazeném okně vyberte z levého menu možnost Adresář a poté v pravé části okna sekci Dokumenty. Zkontrolujte, zda je zaškrtnuta možnost Používat složku dokumentů firmy. V poli Složka dokumentů je uvedena cesta k této složce. Tuto cestu pak zadejte do nastavení konektoru pomocí tlačítka Procházet.
- Filtr skladů pro export (z Pohody do e-shopu): Pokud si přejete omezit přenos produktů do e-shopu pouze z určitého skladu v Pohodě, zadejte zde cestu k tomuto skladu ve formátu Sklad/Větev1/Větev2/.../VětevX. Důležité: Na konci zadané cesty nesmí být znak středníku (;), aby nedošlo k duplicitnímu odeslání obsahu skladu. V konektoru je možné nastavit filtr pouze pro jeden sklad.
Po vyplnění všech potřebných údajů v sekcích Hlavní, E-shop, a Pohoda klikněte na tlačítko Uložit v dolní části okna nastavení propojení. Tímto uložíte konfiguraci vašeho propojení.
Detail propojení a tlačítka v konektoru
- Přenést objednávky do Pohody (všechny): Kliknutím na toto tlačítko spustíte okamžitý export všech nejnovějších objednávek z vašeho Upgates e-shopu do účetního systému Pohoda. Tato funkce je užitečná, pokud nemáte nastavený automatický export objednávek nebo nechcete čekat na další plánovaný cyklus automatické synchronizace. Do Pohody budou exportovány pouze objednávky, které byly vytvořeny nebo upraveny od posledního úspěšného exportu.
- Přenést objednávky do Pohody (vybrané): Tato funkce umožňuje exportovat do Pohody pouze specifické objednávky. Po kliknutí na tlačítko se zobrazí okno, do kterého můžete zadat kódy jednotlivých objednávek, které si přejete exportovat. Pozor! Pokud objednávka s daným kódem již v Pohodě existuje, může dojít k její duplikaci. Tuto funkci používejte s opatrností.
- Přenést data z Pohody: Kliknutím na toto tlačítko spustíte ruční přenos dat z účetního systému Pohoda do vašeho Upgates e-shopu. Tuto funkci využijete, pokud nemáte aktivní automatický import dat do e-shopu z Pohody. Samotné zpracování dat odeslaných z Pohody probíhá přibližně jednou za hodinu, takže se změny ve vaší administraci e-shopu nemusí projevit okamžitě. Importovány budou pouze změny, které jste v Pohodě provedli od posledního úspěšného importu. Důležité: Pro import budou vybrány pouze produkty, které mají v Pohodě zaškrtnuté pole "internet".
Import ceníků a prvotní načtení produktů
Pro správné fungování propojení a přenos cen je potřeba provést následující nastavení ceníků:
- V administraci vašeho Upgates e-shopu vytvořte nebo upravte existující ceníky tak, aby jejich názvy přesně odpovídaly názvům ceníků, které používáte v účetním systému Pohoda. Dbejte na přesnou shodu diakritiky a velikosti písmen. Název ceníku by neměl být delší než 10 znaků (toto omezení je dáno systémem Pohoda).
- Výchozí ceník, který je standardně vytvořen v administraci Upgates, přejmenujte na "Prodejní". Tento název je totiž v Pohodě používán pro standardní prodejní ceník.
- Ujistěte se, že ceny jsou ukládány stejným způsobem jak v Pohodě, tak v Upgates e-shopu (buď s DPH, nebo bez DPH). Pro více informací si přečtěte tento článek.
- Pohoda umožňuje přiřadit zákazníkovi specifický ceník. Pokud v Upgates e-shopu vytvoříte ceník se stejným názvem, jako má zákazník přiřazený v Pohodě, a následně tento ceník přiřadíte danému zákazníkovi i v detailu jeho účtu v e-shopu, budou se ceny pro tohoto zákazníka přenášet z Pohody.
- Pohoda řeší varianty produktů jako samostatné produkty s vlastním kódem. Proto je nutné ručně vytvořit varianty produktů i v administraci Upgates e-shopu, a to pod stejnými kódy, jaké mají tyto varianty v Pohodě. Následně bude docházet k párování produktů na tyto varianty na základě kódu produktu. Data z Pohody se budou přenášet na související položku v e-shopu se stejným kódem.
- V Pohodě je nezbytné, aby produkty a jejich varianty měly vyplněné stejné parametry (např. barva, velikost) jako odpovídající produkty v e-shopu. V opačném případě takové produkty a varianty nemusí být během importu do e-shopu z Pohody zpracovány.
Alternativně můžete v nastavení importu produktů/variant vypnout zpracování parametrů. Více informací naleznete zde. - Popis produktu a soubory určené pro zobrazení v e-shopu je nutné zadat v Pohodě na kartě hlavního produktu. Není možné je zadávat na kartách jednotlivých variant daného produktu.
- Informace o dostupnosti produktu z Pohody se naimportuje do administrace e-shopu v přesném tvaru, jak je zadán v Pohodě. Nicméně, pokud máte v Upgates aktivní funkci "Dostupnost dle stavu zásob" (více informací zde), bude se dostupnost z Pohody brát v úvahu pouze v případě, že u daného produktu nebude v Upgates zadán konkrétní stav skladu. Pokud má produkt v Upgates zadanou skladovou zásobu, bude se pro zobrazení dostupnosti v e-shopu používat tato hodnota.
Import obrázků
Import obrázků do Upgates z účetního systému Pohoda funguje na principu zadání URL adresy, na které je daný obrázek dostupný. Během importu dat do systému Upgates se obrázek z této URL adresy automaticky stáhne a uloží na hosting vašeho e-shopu. Systém si u každého importovaného obrázku pamatuje původní URL adresu. Pokud se zdrojový obrázek nebo soubor na dané URL adrese změní, ale URL adresa zůstane stejná, systém jej při dalším importu znovu nestáhne.
Přenos objednávek do Pohody
Import objednávek do účetního systému Pohoda z Upgates je možný pouze za předpokladu, že máte nainstalovaný a správně nastavený konektor Upgates. Více informací o instalaci naleznete zde. Automatický přenos objednávek v pravidelných časových intervalech je nutné povolit v nastavení konkrétního propojení v konektoru. Jedná se o zaškrtnutí možnosti.
Automatický přenos objednávek v přednastavených časových intervalech je potřeba povolit v konektoru pro konkrétní propojení. Jedná se o nsatavení Automaticky importovat objednávky - Více informací o tomto nastavení naleznete zde.
Možnosti přenosu objednávek
Přenos objednávek z Upgates do Pohody pomocí konektoru má následující specifika:
- Objednávky se do Pohody přenášejí s číselnou řadou, která je nastavena ve vašem Upgates e-shopu. Toto nastavení nelze změnit.
- Údaje o pobočce pro osobní odběr objednávky se do Pohody přenášejí ve formátu: ID pobočky - XXXXX. Tento formát nelze uživatelsky upravit.
- Do Pohody se následně nepřenáší informace o tom, zda byla objednávka již zaplacena (např. platební kartou). Tuto informaci je nutné v Pohodě případně doplnit ručně nebo jiným způsobem.
- Čísla zásilek (tracking numbers) u objednávek není možné importovat do Pohody prostřednictvím tohoto propojení.
- Propojením pomocí Upgates konektoru není možné importovat data do volitelných parametrů v Pohodě.
- Do Pohody se přenášejí všechny objednávky, které splňují nastavená kritéria pro export. Není možné nastavit filtr tak, aby se přenášely pouze zaplacené nebo vyřízené objednávky.
Ruční vytváření objednávky v administraci Upgates
Při ručním vytváření nové objednávky v administraci vašeho Upgates e-shopu může dojít k situaci, kdy se souběžně spustí automatický přenos objednávek do Pohody. V takovém případě mohou v objednávce, která se přenese do Pohody, chybět některé údaje, které jste ještě nestihli v administraci e-shopu vyplnit. Pokud k takové situaci dojde, je doporučeno nejprve tuto nekompletní objednávku smazat z Pohody. Následně ji můžete ručně přenést do Pohody pomocí funkce Přenést objednávky do Pohody (vybrané) v Upgates konektoru.
Párování zákazníků v objednávkách
Párování zákazníků mezi Upgates a Pohodou probíhá na základě shodné e-mailové adresy. Při importu objednávky do Pohody se zkontroluje, zda v adresáři Pohody již existuje zákazník s danou e-mailovou adresou. Pokud ano, objednávka se přiřadí k tomuto existujícímu zákazníkovi. V opačném případě se v Pohodě automaticky založí nový kontakt s údaji zákazníka z objednávky. Tento způsob přenosu zákaznických dat není možné změnit.
Přenos faktur z objednávek
Faktury k objednávkám je možné do Pohody přenést ručně pomocí jednorázového exportu ve formátu XML. Více informací o tomto postupu naleznete zde.
Sada produktů v objednávce
Pokud zákazník objedná sadu produktů, do účetního systému Pohoda se prostřednictvím konektoru přenese pouze informace o samotném produktu, který je definován jako sada. Jednotlivé součásti této sady (komponenty) se samostatně nepřenášejí. Například pokud je v e-shopu definován "Produkt A" jako sada, která se skládá z "Produktu B" a "Produktu C", do Pohody se v rámci objednávky přenese pouze informace o "Produktu A". Pokud máte v Pohodě nastavenou položkovou zásobu se stejným kódem, jaký má "Produkt A", pak si Pohoda automaticky načte informace o produktech, ze kterých se tato zásoba skládá. Více informací ohledně typů zásob naleznete na stránkách podpory programu Pohoda.
Odstranění produktu v Pohodě
Standardně Pohoda exportuje do e-shopu pouze informace o produktech, u kterých došlo ke změně. Pokud produkt v Pohodě odstraníte, tato informace se do e-shopu automaticky nepřenese a produkt v e-shopu zůstane beze změny. Pokud si přejete, aby se odstranění produktu v Pohodě projevilo i ve vašem e-shopu, je nutné postupovat následovně:
- V nastavení importu produktů do e-shopu z Pohody aktivujte možnost, aby se produkty, které nemají zaškrtnutý příznak "internet" v Pohodě, automaticky deaktivovaly nebo archivovaly ve vašem e-shopu. Pozor! Toto nastavení se nevztahuje na varianty produktů v Upgates, protože ty nejsou vedeny jako samostatné položky.
- U produktů v Pohodě, které chcete odstranit z e-shopu, odeberte zaškrtnutí příznaku Internet na jejich kartě.
- Při dalším automatickém nebo manuálním importu produktů do e-shopu z Pohody budou produkty bez příznaku Internet zpracovány podle vašeho nastavení (deaktivovány nebo archivovány).
- Případně můžete po importu v administraci e-shopu vyfiltrovat tyto deaktivované/archivované produkty a trvale je smazat.
- Samotné produkty můžete následně odstranit i z databáze Pohody.
Párování dopravy a platby
Při importu objednávek do Pohody z e-shopu je možné spárovat typy dopravy a platby dvěma způsoby:
- Podle názvu: Toto je standardní metoda párování.
- Podle ID: Tato metoda standardně není aktivní a vyžaduje dodatečné nastavení v administraci e-shopu.
Párování podle názvu
Pro úspěšné spárování musí být název typu dopravy nebo platby v e-shopu naprosto identický s názvem v účetním systému Pohoda. Ukázka pro typ platby Dobírka:
Název platby v e-shopu:
Název platby v Pohodě:
Pokud byste měli například v e-shopu název "Dobírka", ale v Pohodě "Dobírkou", ke spárování nedojde.
Párování podle ID
Tento způsob párování má vyšší prioritu než párování podle názvu, ale vyžaduje dodatečnou konfiguraci v administraci vašeho e-shopu.
V programu Pohoda si zobrazte sloupec ID u typů dopravy a plateb. Tento sloupec obvykle není zobrazen standardně, takže si jej budete muset přidat v nastavení zobrazení sloupců. Níže ukázka sloupce ID pro platby v Pohodě:
Hodnoty z tohoto sloupce (číselné identifikátory) se budou zapisovat ke konkrétnímu typu platby v administraci e-shopu. Obdobně funguje také ID pro dopravy v Pohodě.
Postup v administraci
- V administraci e-shopu přejděte do sekce Nastavení / Objednávky / Doprava (pro nastavení dopravy) nebo Nastavení / Objednávky / Platba (pro nastavení plateb).
- U konkrétního typu dopravy nebo platby, pro který chcete aktivovat párování podle ID, přidejte vlastní pole. Pro dopravu přidejte předdefinované pole s názvem ID dopravy v Pohodě a pro platbu pole s názvem ID platby v Pohodě. Pokud tato předdefinovaná pole v seznamu nenacházíte, je třeba je nejprve přidat v sekci Nastavení / Vlastní pole. Více informací naleznete zde: [sem vložte odkaz, pokud je k dispozici].
- Otevřete detail konkrétní dopravy nebo platby. V sekci Vlastní pole zadejte hodnotu ID, kterou jste si zobrazili v programu Pohoda, do příslušného pole (ID dopravy v Pohodě nebo ID platby v Pohodě).
- Proveďte uložení provedených změn.
Po tomto nastavení bude při přenosu objednávek probíhat párování plateb a doprav podle jejich ID, bez ohledu na jejich název. Toto nastavení je nutné provést individuálně pro všechny typy doprav a plateb, u kterých si přejete párování podle ID aktivovat.
Nastavení pro druh dodání OSS
V administraci vašeho Upgates e-shopu můžete u produktů a dalších položek v objednávce (doprava, platba, sleva) nastavit druh dodání OSS (One-Stop Shop) podle členění používaného v programu Pohoda. Toto nastavení je důležité pro správné vykazování DPH při prodeji do jiných zemí EU.
Postup v administracijděte do sekce Doplňky / Pohoda.
- Přejděte do sekce Doplňky / Pohoda.
- V oddílu Hlavní naleznete dvě rozbalovací nabídky:
- Druh dodání OSS (produkty, sleva)
- Druh dodání OSS (doprava, platba)
- Klikněte na tlačítko Uložit pro uložení provedených změn.
Problémy s propojením
Chybové hlášky konektoru
V případě problémů s propojením mezi Upgates a Pohodou se mohou v konektoru zobrazovat různé chybové hlášky. Níže naleznete popis nejčastějších z nich a doporučená řešení:
- Pohoda vrátila neošetřený chybový kód (-5) nebo (-6) apod.: Tato chyba obvykle znamená, že v programu Pohoda čeká na instalaci aktualizace. Před dalším pokusem o přenos dat je nutné nejprve dokončit instalaci této aktualizace.
- Nepodařilo se najít projekt s názvem (název vašeho projektu). Zkontrolujte zda je název projektu správně nastavený.: Tato hláška je obecného charakteru a může znamenat některou z následujích chyb:
- Zadaný název projektu v nastavení konektoru je chybný. Zkontrolujte jeho správnost. Název projektu naleznete v administraci e-shopu v sekci Nastavení / Propojení / Pohoda v oddíle Instalace nebo v URL adrese vašeho e-shopu (část před ".upgates.cz").
- Došlo k dočasnému problému s propojením na serverech Upgates. Zkuste přenos dat opakovat později.
- Váš počítač nebo server, na kterém je spuštěna Pohoda, nemusí podporovat aktuální způsoby šifrování přenosu dat (verze TLS 1.2 a/nebo .NET Framework využívané konektorem). Ověřte, zda máte tyto prvky ve vašem systému povolené a aktualizované na nejnovější verzi.
V případě opakovaných pádů konektoru za běhu nebo při spuštění: Může se jednat o poškozené soubory konektoru. V takovém případě doporučujeme na počítači, kde je konektor nainstalován, smazat složku UpgatesConnector, která obsahuje uložená data konektoru. Tuto složku naleznete ve složce C:\ProgramData
. Pozor! Tímto krokem se smažou všechna nastavení konektoru, takže po opětovném spuštění bude nutné jej znovu nakonfigurovat pro propojení s vaším e-shopem.
Exportování všech dat z Pohody (řešení problémů):
Pohoda aktuálně exportuje do e-shopu pouze změny u existujících produktů. Pokud máte problémy s přenosem dat (např. neaktualizují se produkty, nezakládají se nové produkty, nebo dochází k nesprávné aktivaci/deaktivaci produktů), můžete zkusit ručně vynutit export všech produktů z Pohody.
Postup v konektoru
- V hlavním okně konektoru vyberte konkrétní propojení.
- Klikněte na tlačítko Detail propojení.
- V okně Detail propojení klikněte na tlačítko Nastavení.
- V okně Nastavení propojení zaškrtněte políčko Vyexportovat všechna data.
- Klikněte na tlačítko Uložit.
- Poté spusťte ruční přenos z Pohody pomocí tlačítka Přenést data z Pohody.
1. Nastavení propojení konektoru
1.1. Špatný název projektu
Zkontrolujte, zda jste v nastavení konektoru zadali správný název vašeho Upgates projektu. Můžete jej ověřit v administraci e-shopu v sekci Nastavení / Propojení / Pohoda oddíl Instalace, nebo z URL adresy vašeho e-shopu (nazev-projektu.upgates.com část nezadáváte).
1.2. Špatný název databáze účetní jednotky
Nesprávně zadaný název databáze účetní jednotky v Pohodě může způsobovat problémy se stahováním objednávek. K této chybě často dochází při přechodu na nové účetní období, kdy je potřeba název databáze v konektoru aktualizovat.
1.3. Špatné IČO účetní jednotky
IČO zadané v programu Pohoda (v sekci Účetní jednotky / IČ) se musí přesně shodovat s IČO vyplněným v administraci vašeho e-shopu v sekci Nastavení / Základní / Nastavení obchodu / Fakturační údaje. Zkontrolujte i případné mezery mezi číslicemi.
1.4. Více relací Pohody
Systém je navržen pro provoz jednoho konektoru na jednu spuštěnou instanci programu Pohoda (1 program = 1 konektor). Pokud je Pohoda spuštěná na serveru pro více uživatelů, není možné, aby každý uživatel měl nainstalovaný vlastní konektor.
2. Aktualizace Pohody
2.1. Po zapnutí Pohody vyskakuje okno pro aktualizaci programu
Pokud se po spuštění programu Pohoda zobrazí okno s informací o dostupné aktualizaci, je nutné tuto aktualizaci provést. Bez aktualizace nemusí konektor správně fungovat. To platí i pro případy, kdy je Pohoda spouštěna automaticky na vzdáleném serveru.
2.2. Pohoda je již aktualizována, ale konektor stále nefunguje
Pokud jste Pohodu aktualizovali, ale konektor stále nefunguje, doporučuje se restartovat počítač nebo server, na kterém Pohoda běží.
3. Verze Konektoru
Pravidelně kontrolujte, zda používáte aktuální verzi Upgates konektoru. Verzi nainstalovaného konektoru naleznete v záhlaví spuštěného programu. Tato verze by měla odpovídat aktuální verzi uvedené v administraci vašeho e-shopu v sekci Doplňky / Pohoda. V případě potřeby konektor přeinstalujte (během přeinstalace musí být konektor vypnutý). Vaše stávající nastavení by mělo být zachováno.
Zkontrolujte si, zda máte aktuální verzi konektoru. Verzi konektoru vidíte v hlavičce spuštěného programu:
Tato verze musí odpovídat aktuální verzi konektoru v administraci. Ta je uvedená v sekci Doplňky / Pohoda:
Konektor pouze přeinstalujte, není nutné provádět znovu nastavení. Konektor musí být v průběhu přeinstalace vypnutý.
4. Nenaimportovaly se produkty z Pohody
4.1. Produkty nemají povolen příznak "Internet"
V programu Pohoda musí mít produkty, které chcete exportovat do e-shopu, zaškrtnuté pole Internet na své kartě. Produkty bez tohoto příznaku se nepřenášejí.
4.2. Nenaimportovaly se vám obrázky nebo soubory
Zkontrolujte cestu ke složce dokumentů firmy v nastavení Pohody (menu Nastavení / Globální nastavení, v levém sloupci sekce Dokumenty).
Ujistěte se, že:
- je zaškrtnuta možnost Používat složku dokumentů firmy,
- zadaná cesta je úplná včetně názvu vaší firmy,
- nachází se na lokálním úložišti (nesmí se jednat o síťový disk).
Správně:
např. C:\Users\pohoda_data\Dokumenty\Novák
Špatně:
C:\Users\pohoda_data\Dokumenty\ Cesta k dokumentům je neúplná, neobsahuje totiž firmu.
4.3. Nenaimportovaly se mi ceny do e-shopu z Pohody
Ceny z Pohody se párují s ceníky v e-shopu na základě přesného shody jejich názvů. Zkontrolujte názvy ceníků v administraci e-shopu (sekce Nastavení / Produkty / Ceníky) a ujistěte se, že odpovídají názvům ceníků a slev v Pohodě.
U slev se z Pohody přenáší pouze výsledná cena produktu po slevě, kterou si lze nasměrovat do konkrétního ceníku v e-shopu. Nepřenáší se ale samotná výše slevy na produkt.
Pokud jste v e-shopu změnili název ceníku, je nutné v nastavení konektoru zaškrtnout možnost Vyexportovat všechna data a následně provést ruční import dat do e-shopu z Pohody, čímž dojde ke správnému přenesení cen u produktů.
Poikud se provede změna názvu ceníku v Pohodě, přenese se informace do e-shopu automaticky.
4.4. Neaktualizují se ceny produktů v e-shopu
Pokud se ceny z Pohody nepřenáší do e-shopu, pak si ověřte následující:
- Ověřte, zda máte v nastavení konektoru správně zadaný název databáze účetní jednotky, kterou aktuálně používáte v Pohodě. Pokud si v Pohodě založíte novou účetní jednotku, pak je potřeba její název ručně zadat do nastavení konektoru. Poté si proveďte exportování všech dat z Pohody, aby se odeslala aktuální data.
- Pokud si do Pohody přenášíte automaticky data z externího systému (od dodavatele apod.), pak toto napojení zřejmě neprovádí správnou aktualizaci datumu změny u konkrétního produktu v Pohodě. Konektor poté nepozná, že u produktu došlo ke změně. Ověřte si u všech svých automatizovaných napojení, jestli provádí správnou aktualizaci dat.
4.5 Kategorie u produktů
Z Pohody se do e-shopu přenáší všechny kategorie, do kterých je produkt / zásoba zařazen v Pohodě. Pokud nedochází k přenosu informací ohledně kategorií, proveďte si exportování všech dat z Pohody. Více zde.
Pokud ani poté nedojde k přenesení dat ohledně kategorií u produktu, zašlete naší technické podpoře ladící informace konektoru (více zde). Přiložte také snímek obrazovky, jaké kategorie má daná zásoba přiřazené v Pohodě.
4.6 Zaokrouhlování
Zaokrouhlování nejde přizpůsobit při přenosu dat z Pohody do e-shopu.
5. Objednávky
5.1. Nepárují se mi produkty zasílané v objednávce s těmi v Pohodě
Objednávka z e-shopu se přenese do Pohody, ale její produkty se nespárují s těmi, které máte v databázi Pohody? V podstatě se položky objednávky přenesou jako textové? Párování produktů v objednávce probíhá na základě kódu produktu.
5.2. Chci přenášet pouze objednávky do Pohody
Pokud chcete přenášet z e-shopu do Pohody pouze objednávky a produkty nikoliv, v sekci Import produktů / Konfigurace nastavte všechna datová pole na nezpracovávat.
5.3 Objednané produkty se hned neodečtou ze skladu Pohody
Po importu objednávek do Pohody se automaticky neodečtou skladové zásoby produktů v Pohodě. Je třeba objednávku v Pohodě zpracovat nebo udělat výdejku apod.
Tuto situaci lze vyřešit rezervací produktů. V administraci e-shopu v sekci Propojení / Pohoda zaškrtnete volbu Exportovat produkty jako rezervované:
Poté se produkty z importovaných objednávek rezervují na skladě Pohody. Tím se hned sníží počet skladového množství, takže je k dispozici jen skutečný počet produktů. Rezervované produkty v Pohodě lze vyřídit vystavením prodejního dokladu, faktury nebo výdejky.
5.4 Pohoda hlásí chybu a nepřenáší se objednávky/produkty
Během přenosu objednávek z e-shopu Pohoda vrátila chybu, zobrazenou v Upgates konektoru: Tento balíček není určen pro tuto jednotku.
Jedná se o nesrovnalost u zadaného IČO v Pohodě a e-shopu. Zkontrolujte si nastavení svého propojení v Upgates konektoru. Více zde.
5.5 Nastavení měny a konverzních kurzů
Konverzní kurz je navázaný na výchozí měnu v Pohodě. Tu si můžete nastavit v administraci e-shopu v sekci Propojení / Pohoda, pole Výchozí měna v Pohodě.
5.6 Pohoda nerozlišuje u objednávek z e-shopu stav s neprovedenou platbou
Tuto situaci lze řešit dvěma způsoby:
- V administraci e-shopu si nastavte, aby se exportovaly pouze vyřešené (vyřízené) objednávky.
- V sekci Objednávky / Export (pravidelný) v části Nastavení u položky Exportovat pouze vyřízené nastavte na Ano.
- Poté si u každé objednávky pro export z e-shpu do Pohody nastavte příznak vyřešeno. Více zde.
- V sekci Objednávky / Export (pravidelný) v části Nastavení u položky Exportovat pouze vyřízené nastavte na Ano.
- Přenášejte z e-shopu objednávky do Pohody jako dosud. K tomu si do Pohody importujte data z platební brány nebo banky v některém z formátu podporovaných Pohodou. Pomocí těchto dat si párujte platby a následně zpracovávat objednávky.
5.7 Pohoda odečítá produkty v objednávce ze špatného skladu
Pokud si vedete v Pohodě více skladů a v každém z nich máte produkt se stejným kódem, pak může dojít v Pohodě k odečtení produktu ze špatného skladu. Konektor v objednávce nepodporuje přenášení údajů o skladu, ze kterého se má produkt odečíst. Možným řešením je omezení přístupu k ostatním skladům pro uživatelský účet, který přenáší objednávky z e-shopu. Ohledně tohoto nastavení v Pohodě kontaktujte technickou podporu Pohody.
6. Zaslání ladících informací konektoru
Pokud vám žádná z výše uvedených možností nepomohla a přenos dat stále nefunguje, vygenerujte ladící informace z Pohody. Poté je zašlete na naši technickou podporu prostřednictvím formuláře v administraci. Více zde.
Soubory větší než 15MB nám zašlete pomocí některého z online úložišť, např. https://www.uschovna.cz/.
Jestli jste provedli exportování všech dat z Pohody (více zde), vyčkejte s vygenerováním ladících informací až po následující celé hodině. Např. když provedete exportování všech dat v 13:30 hod., pak vygenerujte ladící informace až po 14 hod.
6.1. Kde vygenerovat ladící informace?
Ladící informace lze vygenerovat v konektoru ve vámi vytvořeném propojení:
- V úvodním okně konektoru vyberte konkrétní propojení.
- Klikněte na tlačítko Detail propojení.
- Klikněte na tlačítko Nastavení.
- Ve vyskakovacím okně klikněte na text Vygenerovat ladící informace.
- Vyberte složku, do které se uloží ZIP soubor s vygenerovanými ladícími informacemi.
- Klikněte na tlačítko Uložit.
- Tento soubor ladících informací přiložte do tiketu nebo využijte některou ze služeb pro online sdílení obsahu (viz výše).