Návody

Nastavení pro platformu base / base.com (dříve BaseLinker)

Aktualizováno 15.08.2026
Kategorie: E-shopy a platformy
Štítky: base.com

Tento návod platí pro napojení na base (base.com; starší název BaseLinker). Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

ShopSync komunikuje s base výhradně přes base API pomocí API tokenu. Databáze ani PHP můstek se nepoužívají; FTP jen v případě přenosu obrázků (obrázky se base předávají jako veřejné odkazy).

Co je dobré vědět o base:

  • Zboží je v base uložené v katalogu (inventory) – účet jich může mít víc. Uvnitř katalogu jsou sklady a cenové skupiny (ceníky). ShopSync potřebuje znát čísla těch, se kterými má pracovat.
  • ShopSync stahuje jen potvrzené objednávky – objednávka se do účetního systému dostane až poté, co ji base potvrdí.
  • Produkty se párují podle SKU – kódy v účetním systému a v base si musí odpovídat.

Co si připravte předem

  1. API token – vygenerujete ve svém účtu base.com po přihlášení, a to dvěma způsoby: buď přes přidání integrace (po přidání integrace se API klíč zobrazí), nebo kliknutím na profil vpravo nahoře → Nastavení → API (tam lze API klíč i deaktivovat). Token má váhu hesla – předejte nám ho bezpečnou cestou.
  2. Čísla z base (najdeme společně při nasazení – lze vyčíst i přes API):
    • číslo katalogu produktů (inventory), se kterým se má synchronizovat,
    • číslo skladu pro zápis zásob (pozor: do skladů automaticky vytvořených napojenými e-shopy zapisovat nelze),
    • číslo cenové skupiny, do které se zapisují ceny (každá má svou měnu).
  3. Zkontrolovaný seznam statusů objednávek a způsobů platby a dopravy v base.
  4. Pokud se mají přenášet obrázky: FTP/webové úložiště, kam se obrázky nahrají, a jeho veřejná adresa (vyplní se jako URL eshopu).

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

Pole Co vyplnit u base
Databáze Nepoužívá se – nechte prázdné.
FTP Jen při přenosu obrázků – úložiště, kam se obrázky nahrávají.
URL eshopu Jen při přenosu obrázků – veřejná adresa tohoto úložiště.
PHP můstek / Bezpečnostní klíč Nepoužívá se – nechte vypnuté.

Záložka Nastavení

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

Položka Co vyplnit
bl_api_token API token z base – bez něj nic nefunguje.
bl_inventory_id Číslo katalogu produktů (např. 307).
bl_warehouse_id Identifikátor skladu ve tvaru bl_číslo (např. bl_205).
bl_pricelist_id Číslo cenové skupiny (např. 105).
debug Podrobnost logu – 1 doporučeno při prvním párování.

Postup: nejdřív spusťte inicializaci (vytvoří položky bl_*), vyplňte token a čísla, uložte – a spusťte inicializaci znovu. Teprve pak se načtou seznamy plateb a doprav z posledních objednávek.

Sekce 2. Způsoby platby / 3. Způsoby dopravy – ke každé platbě/dopravě z base doplňte označení v účetním systému. Páruje se i na část názvu; pokud se některá metoda v seznamu neobjevila (např. zatím nebyla použita), přidejte řádek ručně.

Sekce 1. Objednávky – společné volby (ceny_s_dani, zaokrouhlení, oss…) popsané v návodu vašeho účetního systému.

U cizoměnových objednávek se měnové kurzy načítají z účetního systému. Jazyk textů dokladů lze v případě potřeby nastavit v přenosovém skriptu.

Časté problémy

  • „Nelze stáhnout seznam produktů" – špatný token nebo špatné číslo katalogu (bl_inventory_id).
  • Zásoby se nezapisují – bl_warehouse_id ukazuje na sklad napojeného e-shopu/velkoobchodu, do kterého base zápis nepovoluje – použijte vlastní sklad base.
  • Objednávka se nestáhla – v base ještě není potvrzená.
  • Obrázky se nepřenášejí – nejdřív musí proběhnout přenos produktů; poté zkontrolujte FTP a URL úložiště.