Единицы измерения

В каталоге LIFE POS можно использовать любые единицы измерения, какие только вам удобны. Мы уже настроили килограммы, штуки и литры, плюс единицу Не определено. Вы можете добавить что угодно: ящики, упаковки, сеансы. Рассказываем, как это сделать.

Добавить единицу измерения

Чтобы добавить единицу измерения, отправьте POST-запрос по адресу:

{base_url}/v5/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}/v5/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}/v5/orgs/{org_guid}/uoms/{uom_guid}

• uom_guid — идентификатор единицы измерения. Присваивается при создании. Описание запроса

Изменить единицу измерения

Чтобы изменить данные единицы измерения, отправьте PATCH-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/uoms/{uom_guid}

Адреса сервиса

• uom_guid — идентификатор единицы измерения. Присваивается при создании. Описание запроса

Удалить и восстановить единицу измерения

Полностью удалить единицу измерения невозможно, но можно отправить её в архив. Единица измерения исчезнет из интерфейса, но сохранится на сервере LIFE POS. Чтобы заархивировать единицу измерения, отправьте DELETE-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/uoms/{uom_guid}

Адреса сервиса

• uom_guid — идентификатор единицы измерения. Присваивается при создании. Описание запроса

Если хотите заархивировать сразу все единицы измерения, отправьте DELETE-запрос по другому адресу:

{base_url}/v5/orgs/{org_guid}/uoms

Описание запроса

Метод отправит в архив в том числе единицы измерения, настроенные по умолчанию. Если вы хотели вернуться к настройкам по умолчанию, эти единицы придётся дополнительно восстановить.

Если нужно восстановить единицу измерения из архива, отправьте POST-запрос по адресу:

{base_url}/v5/orgs/{org_guid}/uoms/{uom_guid}:unarchive

Описание запроса

Вот и всё, что касается единиц измерения. В следующей статье поговорим о категориях товаров.