Zpět na články

Upgates verze 37: co je nového v API a co to znamená pro vaše integrace

P Pavel
17. 11. 2026
4 min čtení
Upgates verze 37: co je nového v API a co to znamená pro vaše integrace

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 /vouchers přijímá nové pole voucher_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 /statistics na /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_code pro 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.

Zdroj: Aktualizace systému – verze 37, Upgates

Pomáháme značkám prodávat na Upgates víc

Domluvte si s námi online schůzku, kde probereme možnosti naší spolupráce.