Návody

Nastavení pro e-shop Upgates

Aktualizováno 15.08.2026
Kategorie: E-shopy a platformy
Štítky: Upgates

Tento návod platí pro e-shopy na platformě Upgates. Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

ShopSync komunikuje s Upgates výhradně přes Upgates API (jméno a heslo API uživatele). Databáze, FTP ani PHP můstek se nepoužívají.

Přenáší se: produkty (ceny, zásoby), objednávky, faktury (jen čtení), zákazníci. Kategorie a obrázky se do Upgates přenášejí přes XML importy Upgates (kvůli limitům počtu API požadavků). Ceny se čtou z výchozího ceníku („Výchozí", pricelist id 1). Párovacím klíčem produktů je kód produktu – kódy v účetním systému a v Upgates si musí odpovídat.

Co si připravte předem

  1. API přístup v administraci Upgates – v sekci Doplňky → API vytvořte nový API přístup. Získáte tři údaje:

    • adresu API ve tvaru https://NAZEV.admin.sX.upgates.com/api/v2,
    • API uživatele (přihlašovací jméno – pozor, není to vaše jméno do administrace),
    • API klíč (heslo) – zobrazí se jen jednou, uložte si ho.

  2. Oprávnění API uživatele – povolte přístup k produktům, objednávkám, fakturám, zákazníkům, dopravám (shipments) a platbám (payments).

  3. Tarif Upgates – API má denní a hodinové limity počtu požadavků podle tarifu; u velkých katalogů může být potřeba vyšší tarif nebo balíček požadavků navíc. Probereme při nasazení.

  4. Kód hlavního jazyka e-shopu – záleží na nastavení konkrétního e-shopu, obvykle cs. Špatný kód se projeví tak, že se nenačtou názvy produktů.

  5. Kódy produktů bez diakritiky a speciálních znaků (povolena písmena, čísla, _ / - .).

Pole na záložce „Připojení k eshopu"

Pole Co vyplnit u Upgates
Databáze Nepoužívá se – nechte prázdné.
FTP Nepoužívá se – nechte prázdné.
URL eshopu Adresa e-shopu (informativně).
PHP můstek / Bezpečnostní klíč Nepoužívá se – nechte vypnuté.

Sekce Základní nastavení

  • ID vých. jazyka – kód jazyka hlavní mutace (např. cs; viz upozornění výše).
  • Domácí měna – např. CZK; přenášejí se ceny v této měně.

Záložka Nastavení

Sekce 8. Ostatní – přístup k API (vytvoří se při inicializaci, hodnoty doplňte):

Položka Co vyplnit
api_url Adresa API včetně /api/v2, bez lomítka na konci, např. https://mujeshop.admin.s1.upgates.com/api/v2.
api_uzivatel Přihlašovací jméno API uživatele.
api_heslo API klíč (heslo).
debug Podrobnost logu – jen při řešení problémů.

Postup: nejdřív spusťte inicializaci nastavení (vytvoří tyto tři položky), vyplňte je, uložte – a spusťte inicializaci znovu. Teprve napodruhé se z Upgates načtou seznamy doprav a plateb.

Sekce 2. Způsoby platby / 3. Způsoby dopravy – po (druhé) inicializaci se načtou platby a dopravy z Upgates; ke každé doplňte označení v účetním systému. Stačí i část názvu – páruje se „obsahuje", bez ohledu na velikost písmen.

Sekce 1. Objednávky (společné volby): ceny_s_dani (1 = ceny včetně DPH), zaokrouhleni_polozek, oss + oss_hlavni_zeme (prodej do EU).

Sekce 4. Produkty: produkt_s_nulovou_cenou (1 = přenášet i zboží s nulovou cenou). Sekce 7. Importy: importovat_ceny_s_dph (1 = při stahování produktů z Upgates brát ceny s DPH).

Časté problémy

  • HTTP 403 / zablokovaný přístup – 5 chybných přihlášení za hodinu přístup na hodinu zablokuje; zkontrolujte přesné znění API klíče.
  • Nenačetly se dopravy/platby – API údaje nebyly vyplněné před inicializací, nebo je špatný kód jazyka.
  • Přenos velkého katalogu je pomalý / neprojde – narážíte na limity API daného tarifu Upgates.