Мы постоянно работаем над новыми интеграциями, чтобы вы могли создать экосистему бизнес-инструментов и максимально автоматизировать рутинные процессы. С этой же целью мы выпустили ряд улучшений Публичного API, который позволяет вам самостоятельно интегрировать RO App со сторонними сервисами. Сегодня мы хотим представить вам как совершенно новые методы API, так и улучшения существующих.
Обращения
Теперь метод для получения списка обращений поддерживает параметры запроса:
modified_at – фильтр по дате обновления обращений.
closed_at – фильтр по дате закрытия обращений.
Также в ответе для каждого обращения возвращаются все данные:
created_at – дата создания обращения.
modified_at – дата обновления обращения.
closed_at – дата закрытия обращения.
rel_obj – объект, связанный с обращением (заказ, продажа).
Создать заказ
Теперь метод для создания заказа поддерживает параметр asset_id (опционально).
Получить заказы
Метод для получения списка заказов теперь возвращает объект uom (единица измерения) для товаров и услуг: id, title (сокращенное название единицы измерения) и description (полное название единицы измерения).
Новый метод “Получить заказ по идентификатору”
С помощью этого метода вы можете получить данные конкретного заказа по его ID.
Теперь метод для получения списка продаж компании поддерживает параметр запроса created_at, который позволяет фильтровать список по дате создания продажи. Также метод возвращает объект uom (единица измерения) для товаров и услуг: id, title (сокращенное название единицы измерения) и description (полное название единицы измерения).
Новый метод “Создать платеж”
С помощью этого метода вы можете автоматизировать создание платежей в RO App, если проводите оплаты в других сервисах.
Новый метод “Получить статьи движения денежных средств”
Если вы используете статьи движения денежных средств, теперь с помощью этого метода можно получить их список.
Получить кассовые транзакции
Запрос на получение кассовых транзакций теперь возвращает параметр cashflow_item (название статьи и тип: доход или расход). Также метод возвращает client_id (ID клиента, если он указан в платеже) и related_document (связанный документ, если платеж связан с заказом, продажей или компенсацией).
Метод для получения списка счетов компании теперь также возвращает параметры code (код) и article (артикул) товаров.
Если вам нужно работать с изделиями (устройствами, транспортными средствами и др.) в других системах, мы подготовили для этого набор новых методов Публичного API.
Получить изделия
Используйте этот метод, чтобы получить список изделий в вашем аккаунте с их данными, включая ID, серийный номер/VIN/IMEI, данные группы, бренда, модели, владельца и др.
Получить изделие по идентификатору
С помощью этого метода можно получить данные конкретного изделия по его ID.
Получить пользовательские поля изделия
Метод позволяет получить список пользовательских полей изделий со страницы “Настройки > Редактор форм > Изделия”.
Создать изделие
С помощью этого метода можно создать новые изделия в вашем аккаунте. Убедитесь, что заполнены все обязательные поля, отмеченные в разделе “Настройки > Редактор форм > Изделия”.
Обновить изделие
Этот метод позволяет обновлять данные изделий, такие как серийный номер, владелец, группа, бренд, модель и др.
Переместить изделие
С помощью этого метода можно перемещать изделия на другие склады.
Получить значения справочника изделий
Метод возвращает все элементы иерархического справочника Группа-Бренд-Модель-Модификация изделий вместе с их ID.
В этом разделе мы добавили новые методы и улучшили существующие, в том числе исправили работу с пользовательскими полями клиентов.
Новый метод “Получить клиента по идентификатору”
Этот метод позволяет получить все доступные данные конкретного клиента по его ID.
Новый метод “Объединить клиентов”
Используйте этот метод, чтобы объединить дубликаты клиентов, указав их ID и ID клиента, в которого они должны быть объединены.
Создать клиента и Обновить клиента
Теперь эти методы поддерживают параметры first_name (имя) и last_name (фамилия), что позволяет создавать и обновлять клиентов более точно.
Получить клиентов
Этот метод теперь поддерживает параметр ids[], что позволяет получить данные конкретных клиентов по их ID.
Мы подготовили четыре новых метода для работы с номенклатурой товаров компании.
Получить товары
Метод для получения списка товаров компании на странице “Моя компания > Товары”.
Получить товар по идентификатору
Метод для получения данных конкретного товара по его ID.
Создать товар
С помощью этого метода можно добавлять новые товары в номенклатуру. Обратите внимание, что этот метод не задает остатки товара, а только создает его профиль на странице “Моя компания > Товары”.
Обновить товар
Метод для обновления данных товара (категории, названия, описания, цен и др.).
Для услуг мы также добавили четыре новых метода.
Получить категории услуг
С помощью этого метода можно получить список категорий услуг компании с их названиями и ID, которые затем можно использовать для создания и обновления услуг.
Получить услуги
Метод для получения списка услуг, включая их категории, единицы измерения, данные о гарантии, цены и др.
Создать услугу
С помощью этого метода можно создавать новые услуги в вашем аккаунте.
Обновить услугу
Метод для обновления данных услуг компании, таких как названия, цены, категории, единицы измерения и др.
Следующие улучшения Публичного API RO App
Мы уже работаем над новыми методами API, которые позволят работать с расчетами, добавлять услуги и товары в заказы с или без списания со склада, а также настраивать интеграции с интернет-магазинами и маркетплейсами.
В скором времени вы также сможете создавать, редактировать, закрывать задачи и получать их список через API.
Если у вас есть вопросы, пожелания или комментарии по поводу Публичного API RO App, пожалуйста, обратитесь в чат Службы поддержки.