
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 statusy 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 posílá požadavky na adresy tohoto typu:
- https://foodsoul.pro/api/user/v1/ (a také kz. a az.) — první verze;
- https://foodsoul.pro/api/user/v2/ (a také kz. a ua.) — 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 skladovými 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ě statusu — 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 kdykoli zablokovat nebo odstranit.
Jak přejít
- 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í.
- Předávejte token a odkaz na dokumentaci CRM API vašemu vývojáři.
- Vývojář převede integraci na CRM API. Samotná změna adresy nestačí: akce se nyní uvádí 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.pro. Pokud potřebujete pomoc s přechodem, napište na podporu.
S pozdravem, tým FoodSoul! Pracujeme pro Vás!