Skip to main content
Version: LIFE POS 5.0

Торговые точки

Торговая точка в системе 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

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

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