1 мая 2026 года пилотная версия API для интеграции с мессенджером MAX будет отключена. Устаревший плагин верификации будет выведен из эксплуатации и принудительно удален из состава программного обеспечения Artix.

  • Начиная с версии кассового ПО Artix 4.6.301-4 реализована поддержка расширенного API для мессенджера MAX. Для работы необходима лицензия версии 5.0 с модулем maxservices. 
  • На период перехода интеграции с мессенджером MAX на расширенную версию API для лицензии версии 5 поддержана обратная совместимость с кассовым ПО версии 4.6.

Для перехода на расширенную версию API необходимо обновить версию кассового ПО, отключить старый плагин и настроить новый. Процесс отличается в зависимости от способа обновления конфигурации кассового ПО.

Обновление лицензии кассового ПО до версии 5

  • После загрузки на кассу файла лицензии версии 5 файл лицензии с более старой версией необходимо удалить.
  • При отсутствии возможности для обновления лицензии, пожалуйста, обратитесь к вашему персональному менеджеру.

Если в текущем файле лицензии кассового ПО указана версия 4.6 (значение параметра "version": "4.6"), то необходимо выполнить обновление лицензии до версии 5.0 с модулем maxservices.

Обновление конфигурации вручную

Для использования расширенной версии API необходимо выполнить следующие шаги в кассовом ПО:

  1. Обновить кассовое ПО вручную – до версии 4.6.301-4 или выше.

  2. Отключить плагин "Сервис верификации Max" в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/max.ini:

    Пример настройки
    [plugins]
; Сервис верификации Max
max = off

  3. Активировать и настроить плагин "Сервисы мессенджера Max" в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/maxservices.ini:

    Пример настройки
    [plugins]
; Плагин для работы с сервисами мессенджера Max
maxservices = on

[Max.Service.AgeVerification]
; Сервис верификации возраста покупателя

; Адрес сервера
; По умолчанию "http://localhost" 
serviceUrl = "<url сервера MAX>" 

; Таймаут запроса к серверу в секундах
; По умолчанию 30
;timeout = 30

; Ключ доступа к API-интерфейсу фронт-офиса сервера
; По умолчанию "" 
apiKey = "<ключ доступа для расширенной версии API>" 

; Маска для распознавания стенографического QR-кода из приложения клиента
; По умолчанию "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)" 
;mask = "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)"

    Ключ доступа (apiKey) от пилотной версии API несовместим с расширенной версией API. Ключ доступа (apiKey) от пилотной версии API несовместим с расширенным API. Получение актуального ключа доступа осуществляется на портале https://business.max.ru/self.

Централизованное обновление конфигураций

Для корректной работы необходимо обновить artixcs-puppet-objects (до версии 4.0.121 и выше) или кассовый сервер (до версии 4.0.37 и выше).

  1. Обновить КС или пакет artixcs-puppet-objects.
  2. Централизованно обновить кассовое ПО до версии 4.6.301-4.

  3. Отключить устаревшую версию плагина для работы с MAX, изменив соответствующий параметр конфигурационной метки.

    При изменении метки плагин будет отключен автоматически на всех кассах.

    Подробнее о работе с конфигурационными метками можно прочитать в статье "Конфигурационные метки".

  4. Активировать плагин "Сервисы мессенджера Max" в новой конфигурационной метке.

  5.  Настроить плагин "Сервисы мессенджера Max" в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/maxservices.ini:

    Пример настройки
    [plugins]
; Плагин для работы с сервисами мессенджера Max
maxservices = on

[Max.Service.AgeVerification]
; Сервис верификации возраста покупателя

; Адрес сервера
; По умолчанию "http://localhost" 
serviceUrl = "<url сервера MAX>" 

; Таймаут запроса к серверу в секундах
; По умолчанию 30
;timeout = 30

; Ключ доступа к API-интерфейсу фронт-офиса сервера
; По умолчанию "" 
apiKey = "<ключ доступа для расширенного API>" 

; Маска для распознавания стенографического QR-кода из приложения клиента
; По умолчанию "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)" 
;mask = "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)"

    Ключ доступа (apiKey) от пилотной версии API несовместим с расширенным API. Получение актуального ключа доступа осуществляется на портале https://business.max.ru/self.

  • No labels