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