Shoptet s ERP propojujte podle konkrétních datových toků: objednávek, zásob, cen a stavů vyřízení. Nejdřív ověřte, zda potřebný proces pokryje hotový doplněk. U vlastního řešení zkontrolujte dostupnost API na obou stranách a určete, který systém o každém údaji rozhoduje.
Tento průvodce pomůže připravit zadání integrace. Pro kontrolu již běžícího napojení navazuje postup správy e-shopu přes API. Podmínky Shoptet API jsme ověřili v dokumentaci k 5. listopadu 2026.
Kdy stačí doplněk a kdy dává smysl vlastní API integrace?
Doplněk je vhodný tehdy, když podporuje vaše systémy a skutečný způsob práce. Nestačí shoda názvu ERP. Prověřte verzi, varianty produktů, více skladů, ceníky, daňové údaje a zpracování storen. Zjistěte také, kdo řeší chybu přenosu a jak uvidíte její stav.
Shoptet rozlišuje přístup přes partnerské doplňky a přímý privátní přístup pro Premium. Doplněk může zajistit propojení i bez vlastního privátního API. U řešení na míru pro Premium se přístup spravuje pomocí privátních tokenů. Viz režimy přístupu do Shoptet API a dokumentace privátního API.
Vývoj na míru zvažte, pokud hotová integrace nepokrývá zásadní proces: například pravidla rezervací, vlastní schvalování objednávek nebo specifické B2B ceníky. Nejdřív ale ověřte, že potřebné operace podporují rozhraní obou systémů. Existence API sama o sobě neznamená, že přes něj lze upravit všechno.
Který systém má řídit cenu, sklad a objednávku?
U každého údaje určete hlavní zdroj a povolený směr změn. Jinak může ruční oprava v e-shopu zmizet při dalším přenosu nebo se dva systémy začnou navzájem přepisovat.
Následující tabulka je model zadání, nikoli popis konkrétní klientské integrace. Ve vašem provozu může být rozdělení jiné.
| Údaj | Příklad hlavního zdroje | Co vyjasnit před vývojem |
|---|---|---|
| Prodejní cena | ERP | Ceník, měna, DPH, akce a platnost ceny |
| Dostupné množství | Skladový systém | Fyzický stav, rezervace a prodejná zásoba |
| Nová objednávka | Shoptet | Identifikátor, položky, doprava a způsob platby |
| Stav expedice | ERP nebo sklad | Převod stavů a případné rozdělení zásilky |
| Produktový obsah | Shoptet nebo PIM | Kdo spravuje popisy, parametry a varianty |
Rozlišujte produkt a jeho konkrétní variantu. Při párování používejte dohodnuté stabilní identifikátory; samotný název se může měnit. U skladu se ptejte, zda přenášíte počet kusů na regálu, nebo počet dostupný k prodeji po odečtení rezervací.
Jak připravit zadání pro napojení ERP?
Popište běžný průchod objednávky i odchylky, které musí integrace zvládnout. Dodavatel pak může ověřit proveditelnost a rozsah, místo aby odhadoval význam požadavku „obousměrná synchronizace“.
Připravte:
- Systémy a odpovědné osoby. Název, verzi, dostupnou dokumentaci a kontakt na správce ERP, skladu a e-shopu.
- Datové toky. Co se čte, co zapisuje, kdo údaj vlastní a jak poznáte úspěšný přenos.
- Potřebnou aktuálnost. Jinou toleranci má popis kategorie, jinou rezervace posledního kusu. Požadavek vyjádřete měřitelně podle provozu.
- Vzorek dat. Anonymizovanou objednávku, produkt s variantami, storno, slevu a další používané situace. Přístupové údaje do vzorku nepatří.
- Odpovědnost po spuštění. Kdo sleduje chyby, kdo může opravit data a jak se bezpečně obnoví přenos po výpadku.
U přechodu ze starého propojení určete, kdy končí původní zápisy a odkud začíná nové zpracování. Dvě souběžné integrace mohou stejnou objednávku založit dvakrát. Rozsah a návaznosti řešíme v rámci napojení ERP a e-shopu.
Jak ověřit integraci před ostrým spuštěním?
Přejímka má prokázat správná data v cílovém systému, ne jen úspěšnou odpověď API. Nestačí, že požadavek skončil bez chyby. Zkontrolujte, zda vznikla správná objednávka, sedí částky a sklad se změnil u správné varianty.
Použijte kontrolní scénáře přizpůsobené vašemu obchodu:
- běžná objednávka, sleva, různé sazby DPH a podporované měny;
- storno před expedicí a změna už přenesené objednávky;
- opakované doručení stejné události bez duplicitního dokladu;
- výpadek ERP a následné doplnění čekajících přenosů;
- produkt s variantami, nulová dostupnost a rezervace zásoby;
- odebrané oprávnění a srozumitelné upozornění správci.
Před přepnutím si odsouhlaste výchozí stav dat a postup návratu. Testovací prostředí a testovací objednávky používejte tam, kde je systémy podporují; v ostrém provozu musí být ověřovací zásahy předem domluvené.
Co API vyřeší a co je potřeba navrhnout zvlášť?
API poskytuje operace nad daty; spolehlivost zajišťuje až celé napojení. Je potřeba navrhnout kontroly, obnovu po chybě a pravidelné porovnání systémů. Přesná cena a dostupnost se pak mohou promítnout i do feedů a veřejných produktových stránek. Jejich shodu řeší průvodce SEO a produktovými daty pro Shoptet.
Datové API také není automaticky řešením nového vzhledu e-shopu. Shoptet výslovně uvádí, že jeho API není určené pro přímé použití veřejným frontendem. Uživatelské rozhraní a datovou integraci je proto potřeba řešit jako samostatné části projektu. Viz doporučení ke správnému používání API.
Časté otázky
Potřebuji pro propojení Shoptetu s ERP vždy Premium?
Ne. Nejprve ověřte dostupný doplněk pro váš ERP systém a požadované datové toky. Přímý privátní přístup do Shoptet API je určený pro Shoptet Premium; není jedinou cestou k propojení systémů.
Co připravit pro zadání API integrace?
Seznam systémů a jejich verzí, přenášené údaje, směr přenosu, hlavní zdroj každého údaje, potřebnou aktuálnost a anonymizované příklady včetně chybových situací. Přístupy předávejte odděleně bezpečnou cestou.
Zajistí API okamžitou shodu skladu a objednávek?
Samotné API ne. Aktuálnost závisí na dostupných událostech, plánování přenosů, limitech obou systémů a zpracování chyb. Požadované zpoždění a způsob kontroly je potřeba dohodnout a otestovat.
Řešíte konkrétní propojení? Popište systémy a proces v poptávce napojení ERP. Pokud se mění také samotný e-shop, navazuje Shoptet na míru.
