Зеркало из GitHub. Библиотека для работы с АТОЛ Онлайн (облачная ККТ для приёма платежей по 54-ФЗ).
https://packagist.org/packages/axenov/atol-online
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
3 months ago | |
---|---|---|
.github | 4 months ago | |
docs | 4 months ago | |
src | 4 months ago | |
tests/AtolOnline/Tests | 4 months ago | |
.gitignore | 1 year ago | |
.php-cs-fixer.php | 4 months ago | |
LICENSE | 3 years ago | |
README.md | 3 months ago | |
composer.json | 4 months ago | |
composer.lock | 4 months ago | |
phpcs.xml | 4 months ago | |
phpunit.xml | 1 year ago | |
psalm.xml | 4 months ago |
README.md
АТОЛ Онлайн
Библиотека для фискализации чеков по 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,...
.