Изменения в API RemOnline
В недавнем обновлении RemOnline были внесены изменения в работу API. В этой статье мы расскажем о них.
Получение остатка товаров на складе
Теперь вы можете отфильтровать товары с нулевым остатком при помощи аргумента exclude_zero_residue=True
Пример:
curl -G https://api.remonline.ua/warehouse/goods/1 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "exclude_zero_residue=True"
API RemOnline вернет список только тех товаров, остаток которых больше нуля:
{
"count": 1,
"data": [
{
"id": 1,
"title": "Product Title",
"image": "https://storage.remonline.ru/path/image.png",
"code": "",
"price": {
"1": 799,
"2": 999
},
"article": "A123",
"residue": 8,
"description": "Product Description",
"category": {
"id": 2,
"title": "Product Category",
"parent_id": 1
}
}
],
"page": 1,
"success": true
}
Направление сортировки транзакций по кассе
Передайте атрибут sort_dir в метод https://api.remonline.ua/cashbox/report/<cashbox_id>, чтобы задать направление сортировки.
Пример:
curl -G https://api.remonline.ua/cashbox/report/6 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "sort_dir=desc"
Результат:
API RemOnline вернет список транзакций, отсортированный в обратном порядке.
Направление сортировки Заказов
Передайте аттрибут sort_dir в метод https://api.remonline.ua/order/, чтобы задать направление сортировки.
Пример:
curl -G https://api.remonline.ua/order/ \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "sort_dir=desc"
Результат:
API RemOnline вернет список заказов, отсортированный в обратном порядке.
Новые методы работы со справочниками
В недавнем обновлении в RemOnline появилась возможность создавать пользовательские справочники. В связи с этим мы добавили в API новые методы для работы с этими справочниками.
Для получения списка справочников используйте метод https://api.remonline.ua/book/list/
Пример:
curl -G https://api.remonline.ua/book/list/ \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a"
Ответ:
{
"data": [
{
"id": 1,
"title": "Модели"
},
{
"id": 2,
"title": "Неисправности"
}
],
"page": 1,
"count": 2,
"success": true
}
Чтобы получить список значений интересующего вас справочника, используйте метод https://api.remonline.ua/book-item/list/<book_id>
Пример:
url -G https://api.remonline.ua/book-item/list/1 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a"
Ответ:
{
"data": [
{
"id": 1933222,
"title": "Виснет на заставке"
},
{
"id": 1933224,
"title": "Выключается"
},
{
"id": 1933226,
"title": "Не включается"
}
],
"page": 1,
"count": 3,
"success": true
}
Обратите внимание: метод API для получения списка моделей https://api.remonline.ua/books/models/<branch_id> считается устаревшим и будет поддерживаться до 1 мая 2019 года. После этой даты поддержка метода будет прекращена.
Напоследок, оставляем ссылку на полную документацию API RemOnline, где вы найдете подробное описание каждого метода с примерами использования.