2.0

Обновление 2.0

Author: c01nd01r

BUILD.MD

@@ -2,38 +2,37 @@
 
 ## Подготовка к сборке перед публикацией
 
-### Composer
-Если в проекте были установлены новые модули Composer, перед сборкой для публикации необходимо выполнить команду:
-```
-composer install --no-dev --optimize-autoloader
-```
-*  `--no-dev` пропускает установку зависимостей для разработки (например, библиотек для тестирования).  
-*  `--optimize-autoloader` выполняет оптимизацию автозагрузчика (подробнее в [документации Composer](https://getcomposer.org/doc/articles/autoloader-optimization.md))
-
 ### Кодировка языковых файлов
+
 Языковые файлы, раположеные в папке `/armax.umkaonline/lang/ru`, должны быть в кодировке `Windows-1251`. При установке из 1C-Bitrix Marketplace на сайт пользователя, они будут преобразованы к кодировке, которая используется на сайте пользователя.  
 Так же, при разработке, следует придерживаться использования модуля локализации (см. `Bitrix\Main\Localization\Loc`);
 
 ### Описание обновления
+
 При подготовке модуля к публикации необходимо создать файл `description.ru` в кодировке `Windows-1251` с описанием обновления.
 
 ### Обновление номера версии модуля
+
 При подготовке модуля к публикации необходимо обновить версию и дату разрабатываемого модуля в файле `armax.umkaonline/install/version.php`
 
 ## Файловая структура для публикации
+
 Обновление модуля состоит только из измененных файлов.  
 Посмотреть, какие именно файлы были изменены можно с помощью команды:
+
 ```
 git diff --name-only TAG|HASH TAG|HASH
 ```
 
 ### Структура файлов
-  1. Создать папку с номером версии модуля по semver. (например, 1.2.3)
-  2. Добавить файл `1.2.3/install/version.php`
-  3. Добавить файл описания обновления `1.2.3/description.ru`
-  4. Добавить обновленные файлы `1.2.3/lib/UmkaOnline.php`
+
+1. Создать папку с номером версии модуля по semver. (например, 1.2.3)
+2. Добавить файл `1.2.3/install/version.php`
+3. Добавить файл описания обновления `1.2.3/description.ru`
+4. Добавить обновленные файлы `1.2.3/lib/UmkaOnline.php`
 
 Пример получившейся структуры файлов:
+
 ```
 1.2.3/
 ├── description.ru
@@ -45,11 +44,11 @@ git diff --name-only TAG|HASH TAG|HASH
 
 Данную папку необходимо заархивировать и назвать номером версии (например, `1.2.3.zip`)
 
-* Руководство по обновлению: https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=101&LESSON_ID=3218&LESSON_PATH=8781.4793.3218
+- Руководство по обновлению: https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=101&LESSON_ID=3218&LESSON_PATH=8781.4793.3218
 
 ## Публикация модуля
 
 Публикация модуля проиходит в личном кабинете партнера Маркетплейс 1С-Битрикс.
 Раздел для управления версиями модулей и загрузки обновлений: https://partners.1c-bitrix.ru/personal/modules/update_module.php?ID=armax.umkaonline
 
-После загрузки обновления рекомендуется установить тип обновления "Бета" для тестовой установки из 1C-Bitrix Marketplace на локальной версии сайта и/или bitrixlabs.ru
+После загрузки обновления рекомендуется установить тип обновления "Бета" для тестовой установки из 1C-Bitrix Marketplace на локальной версии сайта и/или bitrixlabs.ru

CHANGELOG.md

@@ -0,0 +1,7 @@
+# История обновлений
+
+## 2.0.0
+
+- Модуль обновлен до поддержи PHP 8.1
+- Актуализировано API для работы с кассой в актуальной версии 1С Битрикс
+- Удален кастомный логгер в пользу стандартного

README.md

@@ -1,27 +1,28 @@
 # Umka.Online 1C-Bitrix Integration
+
 Модуль CMS 1С-Битрикс для интеграции с сервисом онлайн-касс [Умка.Онлайн](https://umka365.ru/)
 
 ## Оглавление
 
-* Установка модуля
-  * 1C-Bitrix Marketplace (на модерации)
-  * Ручная установка
-* Настройка модуля
-  * Добавление новой кассы
-  * Настройка онлайн-кассы
-  * Внешний идентификатор кассы
-* Логирование ошибок
-* Поддержка
+- Установка модуля
+  - 1C-Bitrix Marketplace (на модерации)
+  - Ручная установка
+- Настройка модуля
+  - Добавление новой кассы
+  - Настройка онлайн-кассы
+  - Внешний идентификатор кассы
+- Логирование ошибок
+- Поддержка
 
 ## Установка модуля
 
-Установить модуль в 1С-Битрикс можно вручную, закачав папку с модулем в директорию `/bitrix/modules`, 
+Установить модуль в 1С-Битрикс можно вручную, закачав папку с модулем в директорию `/bitrix/modules`,
 либо из магазина модулей 1C-Bitrix Marketplace.  
 Установка из магазина модулей предпочтительнее, т.к. позволит в будущем получать автоматические обновления.
 
 ### 1C-Bitrix Marketplace
 
-На данный момент, модуль проходит модерацию в каталог 1C-Bitrix Marketplace 
+На данный момент, модуль проходит модерацию в каталог 1C-Bitrix Marketplace
 и будет доступен к автоматической установке позднее.
 
 В данный момент, модуль можно установить из Marketplace c помощью ссылки:  
@@ -34,7 +35,6 @@
 3. Через интерфейс администратора, установить модуль в разделе **Marketplace** / **Установленные решения**.
 4. В таблице **Доступные решения**, у строки **"Umka365 Онлайн Касса (armax.umkaonline)"** нажать на кнопку меню и выбрать пункт **"Установить"**.
 
-
 ## Настройка модуля
 
 На данном этапе у вас уже должна быть настроена и готова к работе онлайн-касса в сервисе [Умка.Онлайн](https://umka365.ru/).
@@ -45,93 +45,99 @@
 В интефейсе администратора перейти в **Магазин** / **Кассы ККМ** / **Список касс**.
 В открывшейся странице нажать зеленую кнопку "**Добавить кассу**".
 Откроется окно добавление кассы.  
-В поле "**Обработчик:**" выбрать пункт **Умка Онлайн ФФД 1.05** 
+В поле "**Обработчик:**" выбрать пункт **Умка Онлайн ФФД 1.05**
 и нажать кнопку "Применить"
 
 ### Настройка онлайн-кассы
 
 В разделе **Магазин** / **Кассы ККМ** / **Список касс** выберите выберите нужную кассу для настроки.
 Двойной клик по названию кассы или выбор соответствующего пункта в меню строки откроют страницу с четырьмя вкладками:
-* Параметры кассы
-* Ограничения
-* Настройки ККМ
-* Настройки ОФД
+
+- Параметры кассы
+- Ограничения
+- Настройки ККМ
+- Настройки ОФД
 
 #### Параметры кассы
 
 В данной вкладке содержатся следующие поля:
 
-* ID - номер кассы в системе 1С-Битрикс. 
-* Активность - Использование кассы системой 1С-Битрикс. Галочка должна быть установлена.
-* Обработчик - Название обработчика. Должно быть установлено **Умка Онлайн ФФД 1.05**.
-* ОФД - Используемый сервис ОФД.
-* Название - Название кассы в системе 1С-Битрикс. Может быть любое.
-* Внешний идентификатор кассы - Идентификатор кассы в системе [Умка.Онлайн](https://umka365.ru/). Подробнее в разделе "Внешний идентификатор кассы".
-* Используется оффлайн - Не применяется. Галочка должна быть снята.
-* Email - Email на которой будут приходить сообщения об ошибках печати чеков.
+- ID - номер кассы в системе 1С-Битрикс.
+- Активность - Использование кассы системой 1С-Битрикс. Галочка должна быть установлена.
+- Обработчик - Название обработчика. Должно быть установлено **Умка Онлайн ФФД 1.05**.
+- ОФД - Используемый сервис ОФД.
+- Название - Название кассы в системе 1С-Битрикс. Может быть любое.
+- Внешний идентификатор кассы - Идентификатор кассы в системе [Умка.Онлайн](https://umka365.ru/). Подробнее в разделе "Внешний идентификатор кассы".
+- Используется оффлайн - Не применяется. Галочка должна быть снята.
+- Email - Email на которой будут приходить сообщения об ошибках печати чеков.
 
 #### Ограничения для кассы
 
-В данном разделе можно добавить ограничения (условия) для использования кассы, такие как 
-использование кассы для определенных компаний в системе 1С-Битрикс или использования определенных платежных систем. 
-
+В данном разделе можно добавить ограничения (условия) для использования кассы, такие как
+использование кассы для определенных компаний в системе 1С-Битрикс или использования определенных платежных систем.
 
 #### Настройки ККМ
 
 **Настройки авторизации**
 
-* Логин кассира - Логин кассира из сервиса Умка.Онлайн.
-* Пароль кассира - Пароль кассира из сервиса Умка.Онлайн.
+- Логин кассира - Логин кассира из сервиса Умка.Онлайн.
+- Пароль кассира - Пароль кассира из сервиса Умка.Онлайн.
 
 **Информация об организации**
 
-* Email организации - Указывается в чеке как "Адрес электронной почты отправителя чека".
-* ИНН организации - ИНН организации. Должен совпадать с ИНН какой-либо организации присутствующих в сервисе  Умка.Онлайн.
-* Адрес интернет-магазина(url) - Адрес интернет-магазина.
+- Email организации - Указывается в чеке как "Адрес электронной почты отправителя чека".
+- ИНН организации - ИНН организации. Должен совпадать с ИНН какой-либо организации присутствующих в сервисе Умка.Онлайн.
+- Адрес интернет-магазина(url) - Адрес интернет-магазина.
 
 **Настройки ставок НДС**
 
 В данном разделе отображаются ставки НДС добавленные в систему 1С-Битрикс.
-Значения в полях отображаемых ставок должны соответствовать определенным значениям 
+Значения в полях отображаемых ставок должны соответствовать определенным значениям
 в соотвествии с форматом передачи данных в сервис Умка.Онлайн.
 
-Обратите внимание, если вы не являетесь плательщиком НДС, 
+Обратите внимание, если вы не являетесь плательщиком НДС,
 то значение ставки "Без НДС [0%]" должно совпадать со значением "Без НДС [по умолчанию]"
 
 Значения полей для НДС:
 
-* Без НДС [по умолчанию]: **none**
-* Без НДС [0%]:	**vat0**
-* НДС 10% [10%]: **vat10**
-* НДС 20% [20%]: **vat20**
-
+- Без НДС [по умолчанию]: **none**
+- Без НДС [0%]: **vat0**
+- НДС 10% [10%]: **vat10**
+- НДС 18% [18%]: **vat18**
+- НДС 10/110 [10/110]: **vat110**
+- НДС 18/118 [18/118]: **vat118**
+- НДС 20% [20%]: **vat20**
+- НДС 20% [20/120]: **vat120**
+- НДС 5% [5%]: **vat5**
+- НДС 7% [7%]: **vat7**
+- НДС 5/105 [5/105]: **vat105**
+- НДС 7/107 [7/107]: **vat107**
 
 **Система налогообложения**
 
-* Система налогообложения - Выберите вашу систему налогооблажения.
+- Система налогообложения - Выберите вашу систему налогооблажения.
 
 ### Внешний идентификатор кассы
 
 Этот параметр отвечает за выбор кассы в сервисе Умка.Онлайн. Может принимать следующие значения:
 
-* **any** - Выбирает случайную кассу и случайный терминал(рабочее место) из доступных на момент запроса к сервису Умка.Онлайн. 
-Обеспечивает равномерную нагрузку при наличии нескольких касс.
+- **any** - Выбирает случайную кассу и случайный терминал(рабочее место) из доступных на момент запроса к сервису Умка.Онлайн.
+  Обеспечивает равномерную нагрузку при наличии нескольких касс.
 
-* **Шестнадцетизначное число** - используется как регистрационный номер кассы. 
-Если номер регистрационный номер меньше 16 цифр, добавте нулей по левому краю.
+- **Шестнадцетизначное число** - используется как регистрационный номер кассы.
+  Если номер регистрационный номер меньше 16 цифр, добавте нулей по левому краю.
 
-* **Строка меньше 16 символов** - используется как номер терминала(рабочего места).
+- **Строка меньше 16 символов** - используется как номер терминала(рабочего места).
 
-* **Шестнадцетизначное число_Строка меньше 16 символов**  - чек будет отправлен на на конкретную кассу, с конкретного терминала(рабочего места).
+- **Шестнадцетизначное число_Строка меньше 16 символов** - чек будет отправлен на на конкретную кассу, с конкретного терминала(рабочего места).
 
 ## Логирование ошибок
 
-При установке модуля, в корне сайта создается папка `umkaonline`, в которой, 
-в случае возникновении ошибок работы с онлайн-кассой, появляется log-файл вида `errors-cashbox-id-1.log`, 
-в названии которого указывается `id` вашей кассы в системе 1С-Битрикс вашего сайта.  
+При установке модуля, в корне сайта создается папка `umkaonline`, в которой,
+в случае возникновении ошибок работы с онлайн-кассой, появляется log-файл вида `errors-cashbox-id-1.log`,
+в названии которого указывается `id` вашей кассы в системе 1С-Битрикс вашего сайта.
 
 Так же, при возникновении ошибок печати чека,
 1С-Битрикс может оправлять сообщения на электронную почту, указанную в настройках кассы.
 
-
 При обращении в службу поддержки рекомендуем прикладывать log-файлы и сообщения о неуспешной печати чеков из Email.