Download the PHP package beeralex/beeralex.marking without Composer
On this page you can find all versions of the php package beeralex/beeralex.marking. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package beeralex.marking
beeralex.marking
Модуль интеграции с API «Честный ЗНАК» для валидации кодов маркировки товаров в Bitrix.
Требования
- PHP 8.2+
- Bitrix Framework 25.0+ (рекомендуемая для php 8.2)
beeralex.coreмодуль
Установка
Добавьте в composer.json настройку для установки в local/modules:
Установите пакеты:
Настройка
- Установите модули через админку Bitrix
- Получите документ, подписанный УКЭП (усиленной квалифицированной электронной подписью)
- Заполните настройки модуля:
- OAUTH_KEY - документ, подписанный УКЭП в base64
- TOKEN - токен из личного кабинета (используется, если OAUTH_KEY пустой)
- Fiscal Drive Number - номер фискального накопителя
- Тестовый режим - включение sandbox окружения
Основные возможности
✅ Валидация кодов маркировки
- Проверка кодов через API Честного ЗНАКа
- Автоматическое переключение между CDN хостами
- Retry механизм при ошибках
- Сохранение результатов в БД
🔄 Работа с CDN
- Автоматическое получение списка CDN хостов
- Кэширование хостов
- Fallback на резервные хосты при недоступности
🔐 Авторизация
- Через УКЭП (OAUTH_KEY)
- Через токен из личного кабинета
- Автоматическое обновление токена
📦 Интеграция с кассами
- Настройки на уровне обработчика кассы
- Разные токены для разных касс
- Trait для добавления настроек в кассу
📝 Логирование
- Включение через настройки модуля
Быстрый старт
Базовая проверка кодов
Работа через фабрику
Интеграция с кассами
Для использования разных токенов/настроек для каждой кассы:
1. Добавьте trait в обработчик кассы
Это добавит в настройки кассы поля:
MARKING_OAUTH_KEYMARKING_TOKENMARKING_FISCAL_DRIVE_NUMBER
2. Используйте через фабрику
Архитектура
Сервисы
CodesCheckService
Основной сервис для проверки кодов маркировки.
CdnService
Получение и кэширование списка CDN хостов.
AuthService
Авторизация и получение токенов.
Сущности
CodesCheckResult
Результат проверки кодов.
Code
Информация о проверенном коде.
Репозитории
CodeCheckRepository
Сохранение результатов проверки в БД.
Настройки модуля
Через админку Bitrix → Модули → beeralex.marking:
| Параметр | Описание |
|---|---|
MARKING_OAUTH_KEY |
Документ, подписанный УКЭП в base64 |
MARKING_TOKEN |
Токен из личного кабинета (если нет OAUTH_KEY) |
MARKING_DEFAULT_FISKAL_DRIVE_NUMBER |
Номер фискального накопителя по умолчанию |
MARKING_BASE_TEST_URL |
URL тестового API |
MARKING_BASE_PROD_URL |
URL продакшн API |
MARKING_TEST |
Включить тестовый режим |
MARKING_LOGS |
Включить логирование |
Обработка ошибок
Типы исключений
Логирование
При включенном MARKING_LOGS все ошибки логируются:
Примеры использования
Проверка с кастомным Fiscal Drive Number
Получение детальной информации о кодах
Проверка доступности трансграничного сервиса
API Reference
Подробная документация API
Зависимости
beeralex.core- базовые классы и сервисыfirebase/php-jwt- работа с JWT токенами (транзитивная зависимость)
Лицензия
MIT