20.11.2026, 07:43

Důležité: integrace na User API přestanou fungovat od 1. ledna 2027

Deaktivujeme User API — staré API FoodSoul, přes které se dříve měnily stavy objednávek, aktualizovaly ceny a doručovací oblasti, spravovali kurýři. Již dlouho se neaktualizuje: všechny nové funkce přidáváme do CRM API. 
 

Pokud vaše integrace funguje přes User API, je třeba ji převést na CRM API do 1. ledna. Jinak po tomto datu bude FoodSoul na všechny její požadavky odpovídat chybou. Jak se na přechod připravit, popisujeme níže.
 

Jak zkontrolovat integraci
 

Zkontrolovat, zda vaše integrace funguje přes User API, může vývojář. Taková integrace odesílá požadavky na adresy tohoto typu:

  • https://foodsoul.ru/api/user/v1/ (a také by.) — první verze;
  • https://foodsoul.ru/api/user/v2/ (a také by.) — druhá verze.

Pokud si nejste jisti, zeptejte se toho, kdo vaši integraci spravuje, nebo napište na podporu.
 

Co přináší přechod
 

CRM API umí mnohem více než User API: umožňuje pracovat s objednávkami a jejich kartami, menu, stop-listem a zásobami, zákazníky, akcemi a reporty.
 

Samostatně stojí za zmínku webhooky. Díky nim CRM sama informuje váš systém o událostech — například o nové objednávce nebo změně stavu — a integrace nemusí neustále dotazovat API.
 

Další výhodou jsou samostatné přístupové tokeny. Každé integraci lze vydat vlastní token s potřebnými právy a v případě potřeby jej kdykoliv zablokovat nebo odstranit.
 

Jak přejít

  1. Vytvořte API token v CRM: „Integrace“ → „Přístupové tokeny k API“. Token si ihned uložte: zobrazí se pouze jednou, při vytvoření.
  2. Předávejte token a odkaz na dokumentaci CRM API vašemu vývojáři.
  3. Vývojář převede integraci na CRM API. Samotná změna adresy nestačí: akce je nyní uvedena v URL požadavku a seznam polí v požadavcích a odpovědích se změnil.
     

Připomínáme, že toto je třeba provést do 1. ledna 2027.
 

Kompletní dokumentace CRM API je na portálu FoodSoul: docs.foodsoul.ru. Pokud potřebujete pomoc s přechodem, napište na podporu.



S pozdravem, tým FoodSoul! Pracujeme pro Vás!