20.11.2026, 07:43

Важно: интеграции на User API перестанут работать с 1 января 2027 года

Мы отключаем User API — старый API FoodSoul, через который раньше меняли статусы заказов, обновляли цены и районы доставки, управляли курьерами. Он давно не обновляется: все новые возможности мы добавляем в CRM API. 
 

Если ваша интеграция работает через User API, её нужно перевести на CRM API до 1 января. Иначе после этой даты FoodSoul будет отвечать ошибкой на все её запросы. Как подготовиться к переходу, рассказываем ниже.
 

Как проверить интеграцию
 

Проверить, работает ли ваша интеграция через User API, может разработчик. Такая интеграция отправляет запросы на адреса вида:

  • https://foodsoul.pro/api/user/v1/ (а также kz. и az.) — первая версия;
  • https://foodsoul.pro/api/user/v2/ (а также kz. и ua.) — вторая версия.

Если не уверены, спросите у того, кто обслуживает вашу интеграцию, или напишите в поддержку.
 

Что даёт переход
 

CRM API умеет гораздо больше, чем User API: в нём можно работать с заказами и их карточками, меню, стоп-листом и остатками, клиентами, акциями и отчётами.
 

Отдельно стоит сказать о вебхуках. С ними CRM сама сообщает вашей системе о событиях — например, о новом заказе или смене статуса, — и интеграции не нужно постоянно опрашивать API.
 

Ещё одно преимущество — отдельные токены доступа. Каждой интеграции можно выдать свой токен с нужными правами, а при необходимости в любой момент заблокировать или удалить его.
 

Как перейти

  1. Создайте API-токен в CRM: “Интеграции” → “Токены доступа к API”. Сразу сохраните его: токен показывается только один раз, при создании.
  2. Передайте токен и ссылку на документацию CRM API вашему разработчику.
  3. Разработчик перенесёт интеграцию на CRM API. Одной замены адреса недостаточно: действие теперь указывается в URL запроса, а список передаваемых полей в запросах и ответах изменился.
     

Напоминаем, что сделать это нужно до 1 января 2027 года.
 

Полная документация CRM API — на портале FoodSoul: docs.foodsoul.pro.  Если нужна помощь с переходом, напишите в поддержку.

С Уважением, команда FoodSoul! Мы работаем для Вас!