mirror of
https://github.com/anthonyaxenov/atol-online.git
synced 2024-12-05 08:42:02 +00:00
4.3 KiB
4.3 KiB
АТОЛ Онлайн
Библиотека для фискализации чеков по 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 включительно.
Начало работы
Подключение библиотеки
- Подключить пакет к проекту:
composer require axenov/atol-online
- В нужном месте проекта подключить автозагрузчик composer-зависимостей, если это не сделано ранее:
гдеrequire($project_root . '/vendor/autoload.php');
$project_root
— абсолютный путь к корневой директории вашего проекта.При использовании фреймворков это обычно не требуется.
Использование библиотеки
Вы имеете право использовать и распространять код на условиях лицензии MIT.
Дополнительная информация может быть найдена здесь:
Тестирование кода библиотеки
Файлы тестов находятся в директории /tests
корня репозитория.
Для запуска тестов необходимо перейти в корень репозитория и выполнить одну из команд:
composer psalm # статический анализ
composer phpcs # синтаксический анализ
composer test # полное тестирование без покрытия
composer coverage # полное тестирование с покрытием
После тестирования с покрытием в корне репозитория создаётся отчёт, который сохраняется в директории .coverage
.
Для тестирования с покрытием необходим php-xdebug
с параметром xdebug.mode = coverage,...
.