Торговые точки
Торговая точка в системе LIFE POS соответствует вашему магазину. Создать точку полезно, если вы хотите отдельно следить за продажами каждого магазина или применить к разным магазинам разные настройки. Рассказываем, как управлять торговыми точками.
СБП, облачная фискализация и права
В описании торговой точки есть параметр extensions, отвечающий за подключение и настройку расширений. С помощью расширений вы можете подключить СБП или облачную фискализацию, настроить гибкие права курьерам и кассирам.
Подробнее про расширения
У каждого объекта в LIFE POS есть базовый набор полей. Их достаточно для простых операций, таких как продажа товара по безналичному расчёту или возврат денежных средств. Чтобы сделать более сложную логику, понадобятся дополнительные параметры или даже объекты.
К любому объекту в LIFE POS можно добавить дополнительные поля. Для этого используются расширения (extensions). Набор дополнительных полей у каждого расширения отличается. Вы можете выбрать подходящее и использовать только нужные параметры.
Например, рассмотрим объект «Торговая точка». Его основные параметры без расширений: название, адрес, юридический статус и название компании. С помощью расширения payment_methods можно добавить параметр «Доступные методы оплаты». Это позволит указывать какие способы оплаты доступны на каждой торговой точке. Например, таким способом можно запретить курьерам принимать наличные.
Расширения позволяют использовать для интеграции только нужные поля. Таким образом, для каждой интеграции формируется уникальный набор расширений.
В текущей версии LIFE POS невозможно создавать пользовательские расширения и работать с ними. В интеграции можно использовать только готовые расширения от LIFE PAY. Они доступны всем пользователям с платной подпиской по тарифу «Бизнес». Такая подписка даёт доступ к работе с API сервера LIFE POS и ко всем расширениям. Подробное описание всех тарифов см. на нашем сайте.
| Имя | Описание |
|---|---|
| payment_methods | Доступные методы оплаты |
| discounts | Скидка на позицию и на чек. Как работать со скидками |
| retail_app | Доступные операции на точке, со сделкой или с позициями. Как управлять доступными операциями |
| lifepay_auth | Быстрая аутентификация в LIFE PAY |
| lifepay_cloud_fiscalization | Облачная фискализация для торговой точки |
| lifepay_quick_payments | Платежи через СБП на торговой точке |
| notification_service | Сервис webhook-уведомлений |
| external_discount_calculator | Внешний калькулятор скидок и подарков |
| nadex_soft_pos | SoftPOS от Nadex |
| ckt_soft_pos | SoftPOS от ЦКТ |
Добавить торговую точку
Чтобы добавить торговую точку, отправьте POST-запрос по адресу:
{base_url}/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}/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}/orgs/{org_guid}/outlets/{outlet_guid}
outlet_guid — идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на з апрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Изменить торговую точку
Чтобы изменить данные торговой точки, отправьте PATCH-запрос по адресу:
{base_url}/orgs/{org_guid}/outlets/{outlet_guid}
outlet_guid— идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на запрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Удалить или восстановить торговую точку
Полностью удалить торговую точку нельзя, но можно отправить её в архив. Точка исчезнет из интерфейса, но её данные останутся на сервере LIFE POS. Чтобы архивировать торговую точку, отправьте DEL-запрос по адресу:
{base_url}/orgs/{org_guid}/outlets/{outlet_guid}
outlet_guid— идентификатор торговой точки. Можете указать его при добавлении точки. Если не укажете, LIFE POS создаст его сам и пришлёт в ответе на запрос. Кроме того, идентификаторы точек можно получить, запросив их список.
Чтобы восстановить торговую точку из архива, отправьте POST-запрос по адресу:
{base_url}/orgs/{org_guid}/outlets/{outlet_guid}:unarchive
Вот и всё, что касается торговых точек. В следующей статье поговорим о настройках организации.