Быстрый старт

Перед началом работы в личном кабинете (ЛК) LIFE POS нужно сделать несколько обязательных действий:

• создать учетную запись владельца (зарегистрироваться в ЛК);
• добавить юридическое лицо. Этот пункт выполняется при регистрации в ЛК;
• активировать рабочее место: Android-смартфон или кассу;
• добавить товары в каталог;
• добавить сотрудников помимо владельца. Рассказываем, как это сделать.

Если у вас возникают вопросы по работе в ЛК, нажмите кнопку . Она показывает краткую справку по текущему разделу.

Скачайте приложение

Если собираетесь использовать приложение, скачайте его на рабочее место кассира:

• Для смартфона на Android — из Play Market;
• Смарт-терминала — из магазина приложений вашего устройства.

Скачать тестовый APK

Войдите в личный кабинет

Если у вас нет аккаунта

1. Перейдите на my.life-pos.ru и нажмите Заведите аккаунт. Чтобы создать тестовый ЛК, перейдите на my-dev.life-pos.ru
2. Укажите номер телефона для входа и нажмите Отправить код.
3. Введите Код из SMS, Ваши имя и фамилию и укажите желаемый Пароль.
4. Нажмите Создать личный кабинет.
5. Укажите ИНН или название компании. Личный кабинет сам заполнит доступную юридическую информацию.
6. Укажите Email руководителя и нажмите Продолжить.
7. Если у вас ещё нет компании, то нажмите Пропустить. Личный кабинет автоматически создаст пробную компанию. Вы сможете изменить её позже в разделе Структура бизнеса → Юридические лица.
8. Личный кабинет предложит активировать LIFE POS на смартфоне или на кассе. Это можно сделать позже. Когда активируете или решите пропустить шаг, нажмите Продолжить.
9. Личный кабинет откроет Мастер настройки и предложит выполнить начальную настройку.

Если аккаунт уже есть

1. Перейдите в личный кабинет LIFE POS: my.life-pos.ru или в тестовый ЛК: my-dev.life-pos.ru
2. Введите Номер телефона, Пароль и нажмите Войти в личный кабинет.

Выполните начальную настройку

Настройте каталог товаров

1. Перейдите в Мастер настройки.
2. Загрузите каталог из файла формата .xlsx (электронные таблицы) или Добавьте первый товар вручную.
3. Если добавляете вручную, то укажите параметры товара:
   • Наименование;
   • Описание;
   • Цена;
   • Единица измерения;
   • НДС;
   • Категория;
   • Предмет расчёта.
4. Если загружаете каталог из файла, то Скачайте шаблон и заполните таблицу по нему. Также укажите Условия импорта и способ Сопоставления товара.
5. Добавленные товары отображаются в разделе Каталог → Товары и услуги. Там же вы можете редактировать их, добавлять новые или удалять старые позиции.

Добавьте сотрудников

1. Перейдите в Мастер настройки и нажмите Добавить сотрудника.
2. Укажите данные о сотруднике:
   • Фамилия, Имя, Отчество;
   • Логин;
   • Телефон;
   • Роль;
   • Email.
3. Добавленные сотрудники отображаются в разделе Структура бизнеса → Сотрудники. Там же вы можете редактировать их, добавлять и удалять.

Активируйте рабочее место

Пропустите этот шаг, если активировали рабочее место при регистрации в ЛК LIFE POS.

1. Перейдите в Мастер настройки и найдите раздел «Активируйте бесплатное рабочее место».
2. Если у вас нет кассы, то скачайте приложение LIFE POS на смартфон с Android. В разделе есть QR-код для скачивания.
3. Если используете кассу, то нажмите Получить пин-код и введите его в приложении LIFE POS на кассе.

Авторизуйтесь в API

Скопируйте API-ключ. Для этого авторизуйтесь в личном кабинете и откройте панель разработчика. Откройте вкладку Application. В Local Storage выберите https://my.life-pos.ru/. Скопируйте значение поля token. Для тестового API копируйте ключ из тестового кабинета, для рабочего — из рабочего.

Передавайте API-ключ в формате JWT в заголовке Authorization.

Проведите тестовую продажу

API: api.life-pos.ru
Тестовый API: api-dev.life-pos.ru

 Чтобы выполнить тестовую продажу, отправьте POST-запрос по адресу:

https://api-dev.life-pos.ru/v5/orgs/{org_guid}/deals/sales

Вместо {org_guid} подставьте идентификатор компании.

Можете скопировать запрос в cURL:

curl -i -X POST \
   -H "Authorization:07tNh3hyp9EnRLMYkFAkkKAIV-PXV4Ay_ZpuvOabhazD" \
   -H "Accept-Language:ru-RU" \
   -H "X-LP-Client-Type:Unknown" \
   -d \
'{
  "outlet": {
    "guid": "00000000-0000-0000-0000-000000000000",
    "type_of": "Outlet"
  },
  "opened_by": {
    "guid": "00000000-0000-0000-0000-000000000000",
    "type_of": "Employee"
  },
  "opened_at": "2023-06-20T07:56:27.4149672Z",
  "number": "1",
  "comment": "Положить в бумажный пакет",
  "status": "Opened",
  "total_sum": {
    "value": 5000,
    "currency": "RUB",
    "type_of": "Money"
  },
  "positions": [
    {
      "settlement_subject": "Product",
      "name": "Конфеты",
      "uom" : {
        "guid": "ee6a7af7-650d-499b-8e32-58a52ffdb7bc",
        "type_of": "Uom"
      },
      "tax": "Tax20",
      "sale_price": {
        "value": 1000,
        "currency": "RUB",
        "type_of": "Money"
      },
      "quantity": 5,
      "total_sum": {
        "value": 5000,
        "currency": "RUB",
        "type_of": "Money"
      }
    }
  ]
}' \

Параметры заголовка (знаком * отмечены обязательные):

• Accept-Language * — Язык ответов. Например, ru-RU.
• X-LP-Client-Type * — Тип клиента. Варианты: Unknown, App, WebApp, Service.

Параметры тела запроса (знаком * отмечены обязательные):

• outlet * — Торговая точка.
• opened_by * — Сотрудник, открывший продажу.
• opened_at * — Время открытия продажи.
• number * — Номер операции. Не более 36 знаков.
• comment — Комментарий. Не более 256 знаков.
• status * — Статус продажи. Варианты перечисления см. в описании продажи.
• total_sum * — Общая сумма.
• value — Сумма.
• currency * — Валюта. Варианты перечисления см. в описании продажи.
• positions — Проданные позиции.
• settlement_subject * — Предмет расчёта. Варианты перечисления см. в описании продажи.
• name * — Название позиции. Не более 128 символов.
• uom * — Единица измерения.
• tax * — Налоговая ставка. Варианты перечисления см. в описании продажи.
• sale_price * — Цена.
• quantity * — Количество.

С продажей можно работать не только методом POST, но и методами GET, PATCH и DELETE. Логику использования методов, принципы выбора необязательных полей запроса и жизненный цикл продажи разберём в отдельной статье.

Посмотрите, что получилось. Откройте Личный кабинет → Журнал продаж. В списке должна появиться продажа, которую вы передали по API.

Готово! Вы совершили тестовую продажу. Почитайте подробное описание продажи — там показаны различные необязательные параметры, такие как marking_attributes для работы с маркированными товарами, и раскрыта логика их использования.