Мы продолжаем расширять возможности публичного API v2 в RO App. Теперь через API можно управлять задачами сотрудников, настраивать минимальные и максимальные остатки товаров на складах, а также точнее связывать счета с заказами. Это поможет синхронизировать данные с другими системами и не вносить их вручную. Кроме того, появились новые вебхуки для задач.
Задачи через API
В публичном API v2 появились эндпоинты для работы с задачами. Они поддерживают статусы и приоритет задач, поэтому данные в API совпадают с тем, что вы видите в RO App.
Теперь вы можете:
получать список задач или отдельную задачу – с названием, описанием, статусом, приоритетом, автором, исполнителями, крайним сроком и привязанной записью;
создавать, редактировать и удалять задачи;
изменять статус задачи и добавлять к ней комментарии;
получать список статусов задач.
Задачи можно фильтровать по статусам, приоритету, автору, исполнителям, дате создания и крайнему сроку. Также есть отдельные фильтры для просроченных задач и задач без исполнителя. Сортировать список можно по дате создания, дате изменения, крайнему сроку или приоритету.
Обратите внимание: новая задача всегда создается в начальном статусе, а изменить его можно отдельным запросом. Через API можно установить только тот статус, который доступен роли сотрудника, как и в веб-версии. Изменение статуса через API фиксируется в задаче так же, как и изменение вручную.
Также мы добавили новые вебхуки для задач – на изменение статуса и приоритета. Так другие системы сразу узнают об этом, без регулярных запросов к API. Чтобы подключить их, при настройке вебхука выберите события "Статус изменен" и "Приоритет изменен" в блоке "Задачи".
Подробнее – в документации эндпоинтов для задач.
Минимальные и максимальные остатки товаров
Теперь минимальные и максимальные остатки товаров можно настраивать через API – для каждого склада отдельно. Вы можете:
получать минимальные и максимальные остатки товара на всех складах или на конкретном складе;
устанавливать и изменять их для склада;
убирать их для склада, если они больше не нужны.
Товары с остатком ниже минимального появляются на странице "Товары для пополнения остатков". Если вы планируете закупки в другой системе, эти настройки можно передавать из нее автоматически, а не заполнять карточки товаров вручную.
Счета и заказы
Мы также улучшили эндпоинты для работы со счетами, чтобы вам было проще связывать счета с заказами. Теперь:
позиции счета содержат ID заказа, из которого их добавили;
список счетов можно фильтровать по заказу – вы получите все счета, в которых есть хотя бы одна позиция из этого заказа;
с помощью нового эндпоинта в счет можно добавлять позиции из заказов.
Как новые эндпоинты помогут вашему бизнесу
Например, с ними можно:
синхронизировать задачи с таск-трекерами и календарями сотрудников;
автоматически создавать задачи по событиям в других системах – например, напоминание перезвонить клиенту;
создавать собственные отчеты о выполнении и просрочке задач;
одновременно обновлять минимальные и максимальные остатки для многих товаров и складов – например, перед сезоном;
автоматически выставлять счета на позиции из заказов и проверять, все ли уже выставлено клиенту.
Доступ к эндпоинтам
API-ключ принадлежит конкретному сотруднику RO App и имеет те же права доступа, что и он. Например, чтобы работать с задачами через API, сотруднику нужны соответствующие права в роли: на просмотр, создание, редактирование или удаление задач.
Если у вас есть вопросы, предложения или комментарии по публичному API и вебхукам RO App, обратитесь к нам в чат поддержки.