Категории товаров и услуг
С товарами на кассе проще работать, когда они не свалены в кучу, а разложены по полочкам. В LIFE POS тоже есть полочки — категории: Первые блюда, Вторые блюда, Холодные закуски, Горячие закуски, Напитки и т. д. Чтобы пробить товар, кассиру не нужно листать весь каталог — достаточно выбрать категорию. Рассказываем, как настроить категории товаров через API LIFE POS.
Добавить категорию
Чтобы добавить новую категорию товаров, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories
base_url — адрес сервиса. Возможные значения:
https://api-dev.life-pos.ru— тестовый API,https://api.life-pos.ru— рабочий API.
Иногда одной категории мало, хочется разбить товары более дробно — на подкатегории. Например, сервис доставки еды может выделить в категории Молочные продукты несколько подкатегорий: Молоко и сливки, Кисломолочные продукты, Йогурты и творожки и т. д.
Чтобы создать подкатегорию, добавьте обычную категорию и задайте ей родителя. Для этого укажите идентификатор родительской категории в параметре parent_category. Идентификатор можете получить из общего списка категорий.
Получить данные категории
Чтобы получить список товарных категорий, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories
Данные выводятся постранично, по 20 записей на страницу. Если нужно получить данные второй страницы, возьмите из ответа значение параметра next_page_token и отправьте новый запрос, передав это значение в параметре page_token. Продолжайте до тех пор, пока параметр next_page_token не придёт пустым.
Например, вы запросили данные о сотрудниках и получили такой ответ:
“next_page_token”: “OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”,
“page_number”: 1,
“pages_total”: 2,
“items_per_page”: 20,
“items_total”: 27,
В ответе представлены только записи 1–20. Чтобы посмотреть записи с 21 по 27, отправьте новый GET-запрос, указав page_token=“OdDEFa2CzpYdp1CmlO9s9mjBn4NkUZB3CXKOtNfQWM0”.
В запросе есть необязательный параметр selection. Это фильтр категорий по их статусу. Если параметр не передан, по умолчанию используется значение alive_only, то есть в ответе придут только данные категорий, не перенесённых в архив. Чтобы посмотреть весь список категорий или только архивные данные, укажите значение all или archived_only соответственно.
Если нужны данные конкретной категории, отправьте GET-запрос по другому адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories/{category_guid}
category_guid— идентификатор категории. Если не зададите его при создании, LIFE POS создаст его сам и пришлёт в ответе. Также идентификатор можно запросить в списке категорий.
Наконец, если нужен список подкатегорий, отправьте GET-запрос по следующему адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories/{category_guid}/subcategories
Изменить категорию
Чтобы изменить данные категории, отправьте PATCH-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories/{category_guid}
category_guid— идентификатор категории. Если не зададите его при создании, LIFE POS создаст его сам и пришлёт в ответе. Также идентификатор можно запросить в списке категорий.
Удалить и восстановить категорию
В LIFE POS нельзя удалить категорию товаров, но можно отправить её в архив. Она исчезнет из интерфейса, но сохранится на сервере LIFE POS. Вместе с категорией в архив отправятся входящие в неё подкатегории и товары. Чтобы заархивировать категорию, отправьте DELETE-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories/{category_guid}
category_guid— идентификатор категории. Если не зададите его при создании, LIFE POS создаст его сам и пришлёт в ответе. Также идентификатор можно запросить в списке категорий.
Вместе с категорией в архив отправятся все её подкатегории и товары.
Вы можете заархивировать сразу все товарные категории. Для этого отправьте DELETE-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories
Чтобы восстановить товарную категорию из архива, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods-categories/{category_guid}:unarchive
Вместе с категорией будут восстановлены входящие в неё товары и подкатегории, но только те, которые не находились в архиве на момент архивации категории.
Вот и всё про категории товаров. В следующей статье поговорим о фискализации продаж.