Upgates vydal 11. 11. 2026 aktualizaci systému verze 37. Kromě novinek pro obchodníky přináší i jedno z největších rozšíření API za poslední dobu: devět nových oblastí, které lze spravovat přes API, webhooky ke všem z nich a možnost zakládat slevové kupóny s vlastním kódem. Shrnuli jsme, co se změnilo, k čemu se to hodí a na co se při vývoji připravit.
Devět nových oblastí v API
Nejvýraznější změnou je zpřístupnění sekcí, které se doteď daly spravovat jen ručně v administraci. Nově s nimi můžete pracovat přímo přes API a ke každé z nich jsou k dispozici webhooky.
|
Oblast |
Dostupné operace |
Webhooky |
|---|---|---|
|
Překlady |
GET, POST, PUT, DELETE |
ano |
|
Recyklační poplatky |
GET, POST, PUT, DELETE |
ano |
|
Dodavatelé |
GET, POST, PUT, DELETE |
ano |
|
Rádce |
POST, PUT, DELETE |
ano |
|
Cenové vzorce |
GET, POST, PUT, DELETE |
ano |
|
Benefity |
GET, POST, PUT, DELETE |
ano |
|
Šablony slevových kupónů |
GET, POST, PUT, DELETE |
ano |
|
Aktuality |
POST, PUT, DELETE |
ano |
|
Systémové e-maily |
GET, POST, PUT, DELETE |
ano |
K čemu se nové endpointy hodí
- Překlady – automatizace lokalizace obchodu, napojení na překladové nástroje a hromadná správa jazykových mutací bez ručního klikání.
- Dodavatelé – synchronizace dodavatelů s ERP nebo skladovým systémem, takže údaje v e-shopu zůstávají aktuální.
- Cenové vzorce – řízení cenotvorby z externího systému, například podle nákupních cen nebo marží.
- Recyklační poplatky – správa poplatků centrálně a bez rizika, že se zapomenou aktualizovat.
- Systémové e-maily – jednotná správa šablon napříč více obchody, verzování obsahu a rychlé hromadné úpravy.
- Benefity, Rádce a Aktuality – obsah, který lze plnit a aktualizovat z jiných systémů, třeba z centrálního CMS.
- Šablony slevových kupónů – příprava kampaní předem a jejich nasazení přes API ve správný čas.
Slevové kupóny: vlastní kód a úpravy přes API
Oblast slevových kupónů dostala dvě důležitá vylepšení:
- Úprava kupónů (PUT) a webhooky – existující kupóny lze nově upravovat přes API a reagovat na jejich změny.
- Vlastní kód při vytvoření – endpoint
POST /voucherspřijímá nové polevoucher_code. Kupón tak nemusí mít jen náhodně vygenerovaný kód, ale můžete mu dát vlastní, zapamatovatelný název kampaně.
Zjednodušená ukázka nového pole v požadavku:
{
"voucher_code": "VANOCE"
}
Pro marketing to znamená snadnější kampaně typu „zadejte kód VANOCE“ řízené přímo z vašeho systému nebo z automatizace. Kompletní strukturu požadavku najdete v dokumentaci Upgates API.
Verze 37 zároveň rozšiřuje samotné kupóny v administraci – o omezení na kategorie, produkty, výrobce a jazykovou mutaci, o limity použití (celkem i na zákazníka) a o nové filtry. Pokud kupóny spravujete přes API, vyplatí se sledovat, jak se tyto možnosti propíšou do datové struktury.
Webhooky místo neustálého dotazování
Webhooky ke všem novým entitám jsou pro integrace možná ještě důležitější než samotné endpointy. Místo pravidelného dotazování (pollingu), jestli se něco nezměnilo, vám Upgates sám pošle notifikaci ve chvíli, kdy ke změně dojde. Výsledkem je rychlejší synchronizace, menší zátěž serverů a méně spotřebovaných API požadavků.
Pozor na změnu adresy MCP serveru
Pokud používáte MCP server Upgates (například pro napojení AI asistentů), čeká vás jedna povinná úprava. MCP server má nově vlastní adresu ve tvaru /mcp místo dosavadní /statistics. Původní adresa přestane fungovat, takže je potřeba konfiguraci aktualizovat. Zároveň se rozšířila správa objednávek, produktů, kategorií, kupónů a dalších sekcí, které přes MCP server zvládnete.
Co si zkontrolovat ve svých integracích
- Projděte si také oficiální changelog Upgates API – obsahuje i další drobnější změny, které v přehledu aktualizace nejsou.
- Pokud používáte MCP server, přepište adresu z
/statisticsna/mcp. - Zvažte, které procesy dnes řešíte ručně nebo pollingem a dají se nově automatizovat přes nové endpointy a webhooky.
- Pokud generujete slevové kupóny, využijte pole
voucher_codepro vlastní kódy kampaní.
Naše PHP SDK pro Upgates API: změny právě zapracováváme
Pokud pro práci s Upgates API využíváte naše PHP SDK, máme dobrou zprávu: všechny změny z verze 37 do něj momentálně zapracováváme. Připravujeme podporu nových endpointů – překladů, dodavatelů, cenových vzorců, recyklačních poplatků, benefitů, šablon slevových kupónů, systémových e-mailů, Rádce a aktualit – včetně webhooků i nového pole voucher_code u slevových kupónů.
Jakmile bude nová verze SDK k dispozici, dáme vám vědět. Pokud máte s integrací Upgates otázky nebo potřebujete pomoct s implementací nových funkcí, ozvěte se nám.