Единицы измерения
В каталоге LIFE POS можно использовать любые единицы измерения, какие только вам удобны. Мы уже настроили килограммы, штуки и литры, плюс единицу Не определено. Вы можете добавить что угодно: ящики, упаковки, сеансы. Рассказываем, как это сделать.
Добавить единицу измерения
Чтобы добавить единицу измерения, отправьте POST-запрос по адресу:
{base_url}/orgs/{org_guid}/uoms
base_url — адрес сервиса. Возможные значения:
https://api-dev.life-pos.ru— тестовый API,https://api.life-pos.ru— рабочий API.
Параметры запроса (знаком * отмечены обязательные):
name *— название,symbol *— сокращение или символ для чека. Например, килограмм → кг;is_fractional— признак дробности,code_ru_okei— код по ОКЕИ,code_unece— код по международному классификатору UNECE,guid– идентификатор. Если не передан, LIFE POS создаст сам и пришлёт в ответе на запрос. Подробное описание запроса
Получить данные о единице измерения
Чтобы получить список единиц измерения, отправьте GET-запрос по адресу:
{base_url}/orgs/{org_guid}/uoms
Данные выводятся постранично, по 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}/orgs/{org_guid}/uoms/{uom_guid}
uom_guid— идентификатор единицы измерения. Присваивается при создании. Описание запроса
Изменить единицу измерения
Чтобы изменить данные единицы измерения, отправьте PATCH-запрос по адресу:
{base_url}/orgs/{org_guid}/uoms/{uom_guid}
uom_guid— идентификатор единицы измерения. Присваивается при создании. Описание запроса
Удалить и восстановить единицу измерения
Полностью удалить единицу измерения невозможно, но можно отправить её в архив. Единица измерения исчезнет из интерфейса, но сохранится на сервере LIFE POS. Чтобы заархивировать единицу измерения, отправьте DELETE-запрос по адресу:
{base_url}/orgs/{org_guid}/uoms/{uom_guid}
uom_guid— идентификатор единицы измерения. Присваивается при создании. Описание запроса
Если хотите заархивировать сразу все единицы измерения, отправьте DELETE-запрос по другому адресу:
{base_url}/orgs/{org_guid}/uoms
Метод отправит в архив в том числе единицы измерения, настроенные по умолчанию. Если вы хотели вернуться к настройкам по умолчанию, эти единицы придётся дополнительно восстановить.
Если нужно восстановить единицу измерения из архива, отправьте POST-запрос по адресу:
{base_url}/orgs/{org_guid}/uoms/{uom_guid}:unarchive
Вот и всё, что касается единиц измерения. В следующей статье поговорим о категориях товаров.