Skip to main content
Version: LIFE POS 5.0

Работа с расширениями

Что такое расширения

У каждого объекта в LIFE POS есть базовый набор полей. Их достаточно для простых операций, таких как продажа товара по безналичному расчёту или возврат денежных средств. Чтобы сделать более сложную логику, понадобятся дополнительные параметры или даже объекты.

К любому объекту в LIFE POS можно добавить дополнительные поля. Для этого используются расширения (extensions). Набор дополнительных полей у каждого расширения отличается. Вы можете выбрать подходящее и использовать только нужные параметры.

Например, рассмотрим объект «Торговая точка». Его основные параметры без расширений: название, адрес, юридический статус и название компании. С помощью расширения payment_methods можно добавить параметр «Доступные методы оплаты». Это позволит указывать какие способы оплаты доступны на каждой торговой точке. Например, таким способом можно запретить курьерам принимать наличные.

Как работать с расширениями

Чтобы начать работу с расширениями, достаточно сообщить API LIFE POS какие расширения будет использовать интеграция. Для этого в каждом запросе передавайте список нужных расширений в параметре заголовка X-LP-Client-Extensions, например:

Получить информацию о сделке продажи с расширением payment_methods
curl -i -X GET \
-H "Authorization:eyJhbGciOiJI.eyJzdWIiOiIxMjM0NTY.SflKxwRJSMeKK" \
-H "Accept-Language:ru-RU" \
-H "X-LP-Client-Identifier:unique_id" \
-H "X-LP-Client-Type:App" \
-H "X-LP-Client-Extensions:payment_methods" \
'https://api.life-pos.ru/v4/orgs/123e4567-e89b-12d3-a456-123456780000/deals/sales'

В ответ на такие запросы API вернёт базовые и дополнительные поля, в соответствии с переданным списком расширений. При отправке POST-запросов указывайте значения дополнительных полей.

Расширения позволяют использовать для интеграции только нужные поля. Таким образом, для каждой интеграции формируется уникальный набор расширений.

В текущей версии LIFE POS невозможно создавать пользовательские расширения и работать с ними. В интеграции можно использовать только готовые расширения от LIFE PAY. Они доступны всем пользователям с платной подпиской по тарифу «Бизнес». Такая подписка даёт доступ к работе с API сервера LIFE POS и ко всем расширениям. Подробное описание всех тарифов см. на нашем сайте.