rofflexor/atol-v4

Библиотека для работы с API АТОЛ Онлайн (облачные ККТ для приёма платежей по 54-ФЗ)

1.0.4 2025-08-31 17:33 UTC

Requires

• php: >=8.1
• ext-json: *
• ext-mbstring: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.13
• phpunit/phpunit: ^9.5
• psalm/plugin-phpunit: ^0.18
• squizlabs/php_codesniffer: ^3.7
• vimeo/psalm: ^4.30

MIT

• Rudolf Medvedev

• api
• payment
• e-commerce
• payment system
• atol
• atol-online
• fiscalization
• atol online
• атол
• атол онлайн
• фискализация
• чек
• атол-онлайн

README

Основано на axenov/atol-online от Anthony Axenov

Данная библиотека является форком/модификацией оригинальной библиотеки, распространяемой под лицензией MIT.

Библиотека для фискализации чеков по 54-ФЗ через облачные ККТ АТОЛ.

Документация

Текущие поддерживаемые версии АТОЛ Онлайн:

Протокол	API	ФФД	Статус
v4	5.10	1.05	Поддерживается
v5	3.0	1.2	В планах

Поддерживаемые возможности:

• Мониторинг ККТ и ФН
• Фискализация документов на облачной ККТ
• Валидация данных до отправки документа на ККТ (насколько это возможно, согласно схеме)
• Расчёты денег в копейках
• PSR-4 автозагрузка, покрытие настоящими тестами, fluent-setters, докблоки

Системные требования

• php v8.1 и выше
• php-json
• php-mbstring
• composer

Для использования на php8.0 используйте версии библиотеки до 1.0.2 включительно.

Начало работы

Подключение библиотеки

1. Подключить пакет к проекту:

   composer require axenov/atol-online

2. В нужном месте проекта подключить автозагрузчик composer-зависимостей, если это не сделано ранее:

   require($project_root . '/vendor/autoload.php');

   где $project_root — абсолютный путь к корневой директории вашего проекта.

   При использовании фреймворков это обычно не требуется.

Использование библиотеки

Вы имеете право использовать и распространять код на условиях лицензии MIT.

Дополнительная информация может быть найдена здесь:

1. Документации к библиотеке
2. Документация АТОЛ Онлайн
3. Исходный код, докблоки
4. Тесты

Тестирование кода библиотеки

Файлы тестов находятся в директории /tests корня репозитория.

Для запуска тестов необходимо перейти в корень репозитория и выполнить одну из команд:

composer psalm    # статический анализ
composer phpcs    # синтаксический анализ
composer test     # полное тестирование без покрытия
composer coverage # полное тестирование с покрытием

После тестирования с покрытием в корне репозитория создаётся отчёт, который сохраняется в директории .coverage. Для тестирования с покрытием необходим php-xdebug с параметром xdebug.mode = coverage,....