Торговые точки
Торговая точка в системе LIFE POS соответствует вашему магазину. Создать точку полезно, если вы хотите отдельно следить за продажами каждого магазина или применить к разным магазинам разные настройки. Рассказываем, как управлять торговыми точками.
СБП, облачная фискализация и права
В описании торговой точки есть параметр extensions, отвечающий за подключение и настройку расширений. С помощью расширений вы можете подключить СБП или облачную фискализацию, настроить гибкие права курьерам и к ассирам. Список расширений и их возможности
Добавить торговую точку
Чтобы добавить торговую точку, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/outlets
base_url — адрес сервиса. Возможные значения:
https://api-dev.life-pos.ru— тестовый API,https://api.life-pos.ru— рабочий API.
В теле запроса передайте настройки торговой точки:
name— название,address— адрес. Используется в реквизите чека «адрес и место расчётов»;legal_entity— юридическое лицо, которому принадлежит точка. Идентификатор юридического лица можно скопировать в личном кабинете LIFE POS;brand— не используется,permissions— не используется,extensions— список расширений и их настройки.
Получить данные торговой точки
Чтобы получить список торговых точек, отправьте GET-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/outlets
Данные выводятся постранично, по 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}/outlets/{outlet_guid}
outlet_guid — идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на запрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Изменить торговую точку
Чтобы изменить данные торговой точки, отправьте PATCH-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/outlets/{outlet_guid}
outlet_guid— идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на запрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Удалить или восстановить торговую точку
Полностью удалить торговую точку нельзя, но можно отправить её в архив. Точка исчезнет из интерфейса, но её данные останутся на сервере LIFE POS. Чтобы архивировать торговую точку, отправьте DEL-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/outlets/{outlet_guid}
outlet_guid— идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на запрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Чтобы восстановить торговую точку из архива, отправьте POST-запрос по адресу:
{base_url}/v5/orgs/{org_guid}/outlets/{outlet_guid}:unarchive
Вот и всё, что касается торговых точек. В следующей статье поговорим о настройках организации.