PHPackages                             beeralex/beeralex.marking - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. beeralex/beeralex.marking

ActiveBitrix-module

beeralex/beeralex.marking
=========================

My marking module

v1.2.0(3mo ago)031MITPHP

Since Oct 6Pushed 3mo agoCompare

[ Source](https://github.com/BkycHblu-6oPwuK/beeralex.marking)[ Packagist](https://packagist.org/packages/beeralex/beeralex.marking)[ RSS](/packages/beeralex-beeralexmarking/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

beeralex.marking
================

[](#beeralexmarking)

Модуль интеграции с API «Честный ЗНАК» для валидации кодов маркировки товаров в Bitrix.

Требования
----------

[](#требования)

- PHP 8.2+
- Bitrix Framework 25.0+ (рекомендуемая для php 8.2)
- `beeralex.core` модуль

Установка
---------

[](#установка)

Добавьте в `composer.json` настройку для установки в `local/modules`:

```
{
  "extra": {
    "installer-paths": {
      "local/modules/{$name}/": ["type:bitrix-module"]
    }
  }
}
```

Установите пакеты:

```
composer require beeralex/beeralex.core
composer require beeralex/beeralex.marking
```

### Настройка

[](#настройка)

1. Установите модули через админку Bitrix
2. Получите документ, подписанный УКЭП (усиленной квалифицированной электронной подписью)
3. Заполните настройки модуля:
    - **OAUTH\_KEY** - документ, подписанный УКЭП в base64
    - **TOKEN** - токен из личного кабинета (используется, если OAUTH\_KEY пустой)
    - **Fiscal Drive Number** - номер фискального накопителя
    - **Тестовый режим** - включение sandbox окружения

---

Основные возможности
--------------------

[](#основные-возможности)

### ✅ Валидация кодов маркировки

[](#-валидация-кодов-маркировки)

- Проверка кодов через API Честного ЗНАКа
- Автоматическое переключение между CDN хостами
- Retry механизм при ошибках
- Сохранение результатов в БД

### 🔄 Работа с CDN

[](#-работа-с-cdn)

- Автоматическое получение списка CDN хостов
- Кэширование хостов
- Fallback на резервные хосты при недоступности

### 🔐 Авторизация

[](#-авторизация)

- Через УКЭП (OAUTH\_KEY)
- Через токен из личного кабинета
- Автоматическое обновление токена

### 📦 Интеграция с кассами

[](#-интеграция-с-кассами)

- Настройки на уровне обработчика кассы
- Разные токены для разных касс
- Trait для добавления настроек в кассу

### 📝 Логирование

[](#-логирование)

- Включение через настройки модуля

---

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

[](#быстрый-старт)

### Базовая проверка кодов

[](#базовая-проверка-кодов)

```