Ми постійно працюємо над новими інтеграціями, аби ви могли створити для себе екосистему бізнес-інструментів та максимально автоматизувати рутинні процеси. З цією ж метою ми також випустили ряд поліпшень Публічного API, завдяки якому ви можете інтегрувати RemOnline зі сторонніми сервісами своїми силами. Тож сьогодні хочемо представити вам як зовсім нові методи 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 (повну назву одиниці виміру).
Новий метод “Створити платіж”
За допомогою цього метода ви можете автоматизувати створення платежів у RemOnline, якщо проводите оплати у інших сервісах.
Новий метод “Отримати статті руху грошових коштів”
Якщо ви використовуєте статті руху грошових коштів, то тепер за допомогою цього метода можете отримати їхній перелік.
Отримати касові транзакції
Оскільки API RemOnline тепер працює із статтями руху грошових коштів, то запит на отримання касових транзакцій тепер повертає параметр 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, які потім можна використовувати для створення та оновлення послуг.
Отримати послуги
Використовуйте цей метод для отримання переліку послуг включно з їхніми категоріями, одиницями виміру, даними про гарантію, цінами та ін.
Створити послугу
За допомогою цього метода ви можете створювати нові послуги у вашому акаунті.
Оновити послугу
Використовуйте цей метод, щоб оновлювати дані послуг вашої компанії, як от назви, ціни, категорії, одиниці виміру та ін.
Отримати залишки товарів
Тепер цей метод підтримує параметри запиту:
warehouse_id — id складу (обов’язково)
ids[] — масив id товарів (опційно)
category_ids[] – масив id категорій товарів (опційно)
title — найменування товару (опційно)
articles[] — масив артикулів (опційно)
barcodes[] — масив штрихкодів (опційно)
exclude_zero_residue:bool — виключити товари з нульовим залишком (опційно)
Також є зміни у відповіді на запит:
об’єкт price повертає лише поточні ціни на товар
запит повертає масив штрихкодів
замість uom_id (ідентифікатора одиниці вимірювання) повертається об’єкт uom: id, скорочена та повна назва одиниці вимірювання
у товару з’явився параметр is_serial: bool зі значенням true, якщо товар серійний
Отримати оприбуткування
Тепер у відповіді на запит для кожного товару повертаються:
id кожного товару
uom: id, скорочена та повна назва одиниці вимірювання
параметр is_serial: bool зі значенням true, якщо товар серійний
Отримати списання та Отримати переміщення
Обидва методи тепер повертаються об’єкт product, що відповідає за табличну частину документа і містить id, назву, одиницю виміру, ознаку серійності, код, артикул, та кількість товарів у документі
Наступні поліпшення Публічного API RemOnline
Ми вже працюємо над новими методами API, що дозволять працювати з розрахунками, додавати послуги та товари до замовлень зі списання зі складу і без, що в свою чергу дозволить нам з вами налаштовувати нові інтеграції з інтернет-магазинами та маркетплейсами.
Також скоро ви зможете за допомогою API створювати, редагувати, закривати задачі та отримувати їх перелік.
Якщо у вас є запитання, побажання чи будь-які коментарі стосовно Публічного API RemOnline, будь ласка, зверніться в чат Служби підтримки.