Ми продовжуємо розширювати можливості публічного API v2 в RO App. Тепер через API можна керувати завданнями співробітників, налаштовувати мінімальні та максимальні залишки товарів на складах, а також точніше пов'язувати рахунки із замовленнями. Це допоможе синхронізувати дані з іншими системами та не вносити їх вручну. Крім того, з'явилися нові вебхуки для завдань.
Завдання через API
У публічному API v2 з'явилися ендпоінти для роботи із завданнями. Вони підтримують статуси та пріоритет завдань, тож дані в API збігаються з тим, що ви бачите в RO App.
Тепер ви можете:
отримувати список завдань або окреме завдання – з назвою, описом, статусом, пріоритетом, автором, виконавцями, кінцевим терміном і прив'язаним записом;
створювати, редагувати та видаляти завдання;
змінювати статус завдання та додавати до нього коментарі;
отримувати список статусів завдань.
Завдання можна фільтрувати за статусами, пріоритетом, автором, виконавцями, датою створення та кінцевим терміном. Також є окремі фільтри для прострочених завдань і завдань без виконавця. Сортувати список можна за датою створення, датою зміни, кінцевим терміном або пріоритетом.
Зверніть увагу: нове завдання завжди створюється в початковому статусі, а змінити його можна окремим запитом. Через API можна встановити лише той статус, який доступний ролі співробітника, як і у вебверсії. Зміна статусу через API фіксується в завданні так само, як і зміна вручну.
Також ми додали нові вебхуки для завдань – на зміну статусу та пріоритету. Так інші системи одразу дізнаються про це, без регулярних запитів до API. Щоб підключити їх, під час налаштування вебхука виберіть події "Статус змінено" і "Пріоритет змінено" у блоці "Завдання".
Детальніше – у документації ендпоінтів для завдань.
Мінімальні та максимальні залишки товарів
Тепер мінімальні та максимальні залишки товарів можна налаштовувати через API – для кожного складу окремо. Ви можете:
отримувати мінімальні та максимальні залишки товару на всіх складах або на конкретному складі;
встановлювати та змінювати їх для складу;
прибирати їх для складу, якщо вони більше не потрібні.
Товари із залишком нижче мінімального з'являються на сторінці "Товари для поповнення залишків". Якщо ви плануєте закупівлі в іншій системі, ці налаштування можна передавати з неї автоматично, а не заповнювати картки товарів вручну.
Детальніше – у документації ендпоінтів для мінімальних і максимальних залишків.
Рахунки та замовлення
Ми також покращили ендпоінти для роботи з рахунками, щоб вам було простіше пов'язувати рахунки із замовленнями. Тепер:
позиції рахунку містять ID замовлення, з якого їх додано;
список рахунків можна фільтрувати за замовленням – ви отримаєте всі рахунки, у яких є хоча б одна позиція з цього замовлення;
за допомогою нового ендпоінта до рахунку можна додавати позиції із замовлень.
Як нові ендпоінти допоможуть вашому бізнесу
Наприклад, з ними можна:
синхронізувати завдання з таск-трекерами та календарями співробітників;
автоматично створювати завдання за подіями в інших системах – наприклад, нагадування передзвонити клієнту;
створювати власні звіти про виконання та прострочення завдань;
одночасно оновлювати мінімальні та максимальні залишки для багатьох товарів і складів – наприклад, перед сезоном;
автоматично виставляти рахунки на позиції із замовлень і перевіряти, чи все вже виставлено клієнту.
Доступ до ендпоінтів
API-ключ належить конкретному співробітнику RO App і має ті самі права доступу, що й він. Наприклад, щоб працювати із завданнями через API, співробітнику потрібні відповідні права в ролі: на перегляд, створення, редагування чи видалення завдань.
Якщо у вас є запитання, пропозиції чи коментарі щодо публічного API та вебхуків RO App, зверніться до нас у чат підтримки.