2020-01-11 06:30:25 +00:00
# АТОЛ Онлайн
2021-12-19 14:58:47 +00:00
Библиотека для фискализации чеков по 54-ФЗ через [облачные К К Т ](https://online.atol.ru/ ).
2021-12-02 08:14:01 +00:00
2021-12-20 02:41:46 +00:00
[](https://github.com/anthonyaxenov/atol-online/actions/workflows/ci.yml)
[](https://codecov.io/gh/anthonyaxenov/atol-online)
[](https://packagist.org/packages/axenov/atol-online)
[](https://packagist.org/packages/axenov/atol-online)
[](LICENSE)
2021-12-02 08:14:01 +00:00
**[Документация](/docs/readme.md)**
2021-11-20 16:33:43 +00:00
2021-12-19 14:58:47 +00:00
Текущие поддерживаемые версии АТОЛ Онлайн:
2021-11-20 16:33:43 +00:00
2022-12-14 15:52:08 +00:00
| Протокол | API | ФФД | Статус |
|----------|------|------|----------------|
| v4 | 5.10 | 1.05 | Поддерживается |
| v5 | 3.0 | 1.2 | В
2020-05-27 17:14:53 +00:00
2022-12-14 15:52:08 +00:00
Поддерживаемые возможности:
2021-11-28 04:01:28 +00:00
* Мониторинг К К Т
2021-12-20 02:41:46 +00:00
* Фискализация документов на облачной К К Т
2021-11-28 04:01:28 +00:00
* Валидация данных до отправки документа на К К Т
* Расчёты денег в копейках
2021-12-20 02:41:46 +00:00
* PSR-4 автозагрузка, покрытие настоящими тестами, fluent-setters, докблоки
2021-11-28 04:01:28 +00:00
2020-01-11 06:30:25 +00:00
## Системные требования
2022-12-14 15:52:08 +00:00
* `php v8.1` и выше
2022-08-13 13:59:01 +00:00
* `php-json`
* `php-mbstring`
2021-11-28 04:01:28 +00:00
* [composer ](https://getcomposer.org/ )
2020-01-11 06:30:25 +00:00
## Начало работы
### Подключение библиотеки
2021-12-19 14:58:47 +00:00
1. Подключить пакет к проекту:
2020-01-11 06:30:25 +00:00
```bash
composer require axenov/atol-online
```
2021-11-28 04:01:28 +00:00
2. В
2020-01-11 06:30:25 +00:00
```php
2021-11-28 04:01:28 +00:00
require($project_root . '/vendor/autoload.php');
2020-01-11 06:30:25 +00:00
```
2020-01-11 07:57:39 +00:00
где `$project_root` — абсолютный путь к корневой директории вашего проекта.
2021-11-28 04:01:28 +00:00
> При использовании фреймворков это обычно не требуется.
2020-01-11 06:30:25 +00:00
2022-12-14 15:52:08 +00:00
### Использование библиотеки
Вы имеете право использовать и распространять код на условиях ** [лицензии MIT ](LICENSE )**.
Дополнительная информация может быть найдена здесь:
1. [Документации к библиотеке ](/docs )
2. [Документация АТОЛ Онлайн ](https://online.atol.ru/lib/ )
3. [Исходный код ](/src ), докблоки
4. [Тесты ](/tests/AtolOnline/Tests )
2020-01-11 06:30:25 +00:00
### Тестирование кода библиотеки
Файлы тестов находятся в директории `/tests` корня репозитория.
2021-12-02 06:34:21 +00:00
Для запуска тестов необходимо перейти в корень репозитория и выполнить одну из команд:
2020-01-11 06:30:25 +00:00
```bash
2021-12-02 06:34:21 +00:00
composer test # обычное тестирование
2021-12-19 14:58:47 +00:00
composer coverage # тестирование с
2020-01-11 06:30:25 +00:00
```
2022-12-14 15:52:08 +00:00
После тестирования с `.coverage` .
2022-01-30 15:00:48 +00:00
2022-12-14 16:30:40 +00:00
< a href = "https://www.buymeacoffee.com/axenov" target = "_blank" > < img src = "https://cdn.buymeacoffee.com/buttons/default-orange.png" alt = "Buy Me A Coffee" height = "41" width = "174" > < / a >
