legendcity / legendcity-1c Goto Github PK

При первой попытки открытия настройки модуля выдается ошибка
Значение не является значением объектного типа (ТаблицаИдентификаторТерминала)

На странице "Настройки интеграцнии"

1. Сделать поле "Адрес сервиса" не редактируемым
   В этой же строчке добавить кнопку Тест соеденинения. Делается запрос на https://api.legendcity.ru/v4/health-check, выходит сообщения:
   • ✅ Успешно соединение с сервером
   • ⛔️ Неуспешноe соединение с сервером
2. Рядом с полем "Ключ АПИ" добавить кнопку Тест ключа. По нажатию делается запрос на /cards?limit=1. Так же выводится сообщения:
   • ✅ Верный Ключ АПИ
   • ⛔️ Неверный Ключ АПИ
3. В списке магазинов, в колонке "Идентификатор терминала" добавить кноку "Информация", делается запрос на /config/[pos-id] и отображается подобная информация (пример на скриншоте с низу из iiko плагина интеграции)

• Разработать поддержку конфигурации 1С:Управление нашей фирмой 8
• Добавить документацию по настройке и работе с модулем

Сейчас идентификатора терминала не зависит от магазина.

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

• Нужно сделать возможность указывать каждому магазину свой идентификатор терминала.
• Должен быть идентификатор терминала по умолчанию.
• Форма этой настройки должна быть там где же и сейчас, на странице настройки интеграции, только место одного поля идентификатора, должна быть таблица "магазин - идентификатор".

Для системы лояльность "Накопительная" и "Накопительная +" пороговые значения создаются в личном кабинете https://company.legendcity.ru

Получить инофмацию о порогах можно по адресу https://api.legendcity.ru/v4/config/[posId].

Для расчета порогового значения берется текущая потраченная сумма по карте за период https://api.legendcity.ru/v4/cards/[cardCode], параметр currentSpend.

Если стоит параметр "Получать бонусный баланс онлайн" #17 , то для применения скидки или начисления бонусов нужно высчитывать пороговое значение.

Примеры запросов:

GET https://api.legendcity.ru/v4/cards/536112 HTTP/1.1
User-Agent: vscode-restclient
x-api-key: ...
accept-encoding: gzip, deflate



HTTP/1.1 200 OK
x-powered-by: Express
access-control-allow-origin: *
access-control-allow-methods: GET, POST, OPTIONS, DELETE
access-control-allow-headers: Origin, User-Agent, Cache-Control, Content-Type, Accept, Authorization, token
content-type: application/json; charset=utf-8
content-length: 290
date: Fri, 17 May 2024 18:10:54 GMT
keep-alive: timeout=5
connection: close

{
  "total": 1,
  "offset": 0,
  "limit": 20,
  "count": 1,
  "items": [
    {
      "cardCode": 536112,
      "cardHolderName": "Тест",
      "bonuses": 11000,
      "points": 0,
      "currentSpend": 20000,
      "attached": false
    }
  ]
}

GET https://api.legendcity.ru/v4/config/100100 HTTP/1.1
User-Agent: vscode-restclient
x-api-key: ...
accept-encoding: gzip, deflate



HTTP/1.1 200 OK
x-powered-by: Express
access-control-allow-origin: *
access-control-allow-methods: GET, POST, OPTIONS, DELETE
access-control-allow-headers: Origin, User-Agent, Cache-Control, Content-Type, Accept, Authorization, token
content-type: application/json; charset=utf-8
content-length: 292
date: Fri, 17 May 2024 18:11:47 GMT
keep-alive: timeout=5
connection: close

{
  "companyName": "Тест 1С модуль",
  "filialName": "",
  "discountPaymentPercents": [
    {
      "start": 0,
      "value": 0
    }
  ],
  "maxBonusPaymentPercent": 30,
  "maxPointsPaymentPercent": 0,
  "bonusAddPercents": [
    {
      "start": 0,
      "value": 5
    },
    {
      "start": 100000,
      "value": 10
    },
    {
      "start": 300000,
      "value": 15
    },
    {
      "start": 500000,
      "value": 20
    }
  ]
}

1C (8.3.13.1690) Розница 2.2.12. Установлен модуль legendcity-1.0.0.cfe [Снимок экрана 2022-01-25 в 12 43 36] (https://user-images.githubusercontent.com/98328035/150954577-7756057a-19f1-4eae-bce2-3987371b49ff.png)

При совершении покупки на карту LegendCity покупка не попадет в личный кабинет CRM компании и не отображает в мобильном приложении клиента.

Выгрузка бонусных баллов не работает.
Это сейчас так [ photo_2022-01-24 17 09 33] (https://user-images.githubusercontent.com/98328035/150798456-252494c2-5862-4a32-8f5c-0eef9ad85991.jpeg)

Так было раньше Снимок экрана 2022-01-25 в 12 58 39

Для установки модуля в 1С:Предприятие удобнее использовать один *.cfe файл. Модуль расширения конфигурации Legendcity хранится как исходный код в GitHub как множество файлов.

Нужно создать GitHub Action который будет собирать и публиковать в GitHub Releases legendcity-[version].cfe файл.

• Разработать поддержку конфигурации 1С:Управление торговлей 8
• Добавить документацию по настройке и работе с модулем

Поддержка конфигурации 1С:Розница 8, редакция 2.3

• Разработать поддержку конфигурации 1С:Розница 8, редакция 2.2
• Разработать поддержку конфигурации 1С:Розница 8, редакция 2.3 #6
• Добавить документацию по настройке и работе с модулем

Когда приходит покупатель с картой Легенда в новый магазин в базе 1С дисконтной карты еще нет. Ее можно создать в разделе дисонтные карты, но на кассе это будет не удобно.

Нужно добавить возможость создавать дисконтную карту в режиме РМК, в разделе подора карты или отдельной кнопкой в меню РМК. Для создания нужно использовать только номер карты.

В настройки добавить галочку "Получать бонусный баланс онлайн"

Перед покупкой делать запрос и получать bonuses из https://api.legendcity.ru/v4/#tag/Cards/operation/cards.get

Так же нужно задать таймаут запроса, для всех запросов к апи 2 минуты (просто в коде записать).

Запрос не должен блокировать интерфейс кассира, запрос должен быть асинхронным.

Сценарии использования

• кассир пробивает карту,
• делается запрос по апи,
• кассир пробивает товары.

Когда кассир закончил добавлять товары:

1. Бонусный баланс загрузился и доступен.
2. Бонусный бланас не успел загрузиться, и прошло меньше двух минут, кассир может подождать или продолжить без списания бонусов.
3. Бонусный бланас не загрузился, так как прошло больше двух минут, кассир продолжает без списания бонусов.
4. Бонусный бланас не загрузился, так как была ошибка запроса, кассир продолжает без списания бонусов.

Возможный вариант:

Во время продажи, если стоит "Получать бонусный баланс онлайн", то перед получением баланса из базы 1с делайть запрос на апи, и обновлять значение в 1с.