Импорт товаров POST-запросом
Вы можете загрузить в LIFE POS свой каталог товаров и использовать его в торговле. Если у вас интернет-магазин, загрузка каталога вам не нужна — данные можно передавать в запросе на продажу.
Если же у вас обычный магазин со стационарной кассой, можете загрузить каталог POST-запросом или в таблице Excel. Так вам не придётся добавлять товары по одному через личный кабинет. В этой статье разберёмся, как загружать каталог POST-запросом.
Добавить товар или услугу
Чтобы добавить товар в каталог, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods
base_url— адрес сервиса. Возможные значения:https://api-dev.life-pos.ru— тестовый API,https://api.life-pos.ru— рабочий API.
goods— товары.
Если нужно добавить сразу много товаров, отправьте POST-запрос по другому адресу:
{base_url}/v5/orgs/{org_guid}/goods.batch
Если работаете с маркированными товарами, следите за тем, как передаёте код маркировки. Если передать его неправильно, он не будет читаться. Как передавать код маркировки
Получить данные товара
Чтобы получить весь список товаров, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods
goods— товары.
Данные выводятся постранично, по 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/{good_guid}
good_guid— идентификатор товара. Можете указать его, когда добавляете товар в каталог. Если не укажете, LIFE POS создаст идентификатор сам. В этом случае идентификаторы товаров можно взять из общего списка.
Изменить данные товара
Если данные товара нужно изменить, отправьте PATCH-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods/{good_guid}
goods— товары.good_guid— идентификатор товара. Можете указать его, когда добавляете товар в каталог. Если не укажете, LIFE POS создаст идентификатор сам. В этом случае идентификаторы товаров можно взять из общего списка.
Удалить или восстановить товар
Полностью удалить данные о товаре невозможно, но их можно отправить в архив. Он исчезнет из интерфейса, но сохранится на серв ере LIFE POS. Если нужно, вы сможете его восстановить. Чтобы архивировать товар, отправьте DEL-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods/{good_guid}
goods— товары.good_guid— идентификатор товара. Можете указать его, когда добавляете товар в каталог. Если не укажете, LIFE POS создаст идентификатор сам. В этом случае идентификаторы товаров можно взять из общего списка.
Вы можете также отправить DEL-запрос на удаление всех товаров:
{base_url}/v5/orgs/{org_guid}/goods
Чтобы восстановить товар, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/goods/{good_guid}:unarchive
Вот и всё, что касается передачи данных о товарах в теле запросов. В следующей статье поговорим о том, как загружать данные товаров из таблицы Excel.