FoodSoul теперь можно подключить к любой вашей системе

Мы добавили токены доступа к API. Это значит, что FoodSoul можно напрямую связать с вашей учётной программой, 1С, складом, аналитикой, ботом или собственной разработкой. Выгружать и переносить данные вручную больше не нужно.

Раньше подключиться можно было только к готовым интеграциям из нашего списка. Теперь вы можете сделать свою.

Для чего нужны токены доступа к API FoodSoul?

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

Например, у токена с ролью “Оператор” будут такие права:

✅ Можно: изменять товары, категории, стоп-листы, складские остатки, заказы, отзывы и адреса, работать с платежами.
❌ Нельзя: смотреть бухгалтерские отчёты и контрагентов.

Такой токен подойдёт, например, для программы складского учёта, которая сама обновляет остатки и стоп-листы. Для каждой интеграции выбирайте роль, в которой есть только нужные ей права: чем меньше прав у токена, тем безопаснее.

Для участников партнёрской программы есть отдельные запросы: подключённые компании, отчёты и вывод средств.

Как подключиться?

1. В CRM откройте раздел “Токены доступа к API” и создайте токен. Токен — это ключ, по которому ваша система будет заходить в FoodSoul. Ей не нужен ни логин, ни пароль сотрудника.

2. Выберите для токена роль. Токен получит права этой роли, но не больше, чем есть у вас самих.

3. Если нужно, задайте ограничения:

• доступ только к одной сети или ко всем сетям аккаунта;
• срок действия: временный или бессрочный;
• список IP-адресов, с которых разрешены запросы. С остальных адресов запросы будут отклоняться.

4. Добавьте токен в каждый запрос вашей системы:
Authorization: Bearer fs_api_...
Если токен не привязан к одной сети, укажите нужную в заголовке:
Chain: chain_id

Настройки токена можно менять в любой момент, сам токен при этом остаётся прежним. Его также можно заблокировать, разблокировать или удалить.

❗️ Важно о безопасности

• Полный токен показывается только один раз, при создании. Сразу сохраните его. Мы храним токен в зашифрованном виде без возможности восстановления, поэтому потерянный токен вернуть нельзя. Придётся создать новый и заменить его в интеграции.
• Для каждой интеграции заводите отдельный токен. Тогда при необходимости вы отключите одну интеграцию, а остальные продолжат работать.

Где почитать подробнее:

📖 Инструкция по настройке в WIKI: https://wiki.foodsoul.ru/ru/public/api
📄 Описание всех методов (спецификацию OpenAPI) можно запросить в технической поддержке. Скоро появится портал разработчика.

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