PHPackages                             djjerry85/atol-online - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. djjerry85/atol-online

ActiveLibrary

djjerry85/atol-online
=====================

Библиотека для работы с АТОЛ Онлайн. Fork it-quasar/atol-online

v4.2.0(4mo ago)045GPL-3.0-or-laterPHPPHP &gt;=7.3

Since Jul 24Pushed 4mo agoCompare

[ Source](https://github.com/djjerry85/atol-online)[ Packagist](https://packagist.org/packages/djjerry85/atol-online)[ RSS](/packages/djjerry85-atol-online/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (4)Versions (11)Used By (0)

it-quasar/atol-online
=====================

[](#it-quasaratol-online)

Библиотека на PHP для работы с [АТОЛ Онлайн v4](https://online.atol.ru/).

Библиотека содержит набор классов на PHP для формирования запросов в АТОЛ Онлайн и обработки ответов из АТОЛ Онлайн. Все классы сделаны таким образом, чтоб их названия и свойства максимально соответствовали [официальной документации АТОЛ Онлайн v4](https://raw.githubusercontent.com/0x6368656174/atol-online/master/api/atol-online-v4.6.pdf).

Требования
----------

[](#требования)

- PHP 7.1 или выше
- PHP расширение для работы с cURL (ext-curl)
- PHP расширение для работы с JSON (ext-json)

Библиотека использует в своей работы стандартный PSR-совместимый кеш (см. ) для хранения временного ключа доступа к API АТОЛ Онлайн.

Поддерживается любой PSR-совместимый кеш, например, можно использовать файловый кеш (). Для этого его необходимо установить при помощи Composer:

```
$ composer require cache/filesystem-adapter
```

Установка
---------

[](#установка)

Пакет доступен для установки при помощи пакетного менеджера Composer:

```
$ composer require it-quasar/atol-online
```

Использование
-------------

[](#использование)

Для регистрации документа в ККТ необходимо выполнить следующий код:

```
setDate(2017, 05, 29)
  ->setTime(17, 56, 18);

// Создадим запрос на продажу
// Параметры запроса соответствуют параметрам запроса, описанным в
// https://raw.githubusercontent.com/0x6368656174/atol-online/master/api/atol-online-v4.6.pdf
$request = new Sell();
$request
  ->setExternalId('17052917561851307')
  ->setTimestamp($timestamp);

// Создадим чек
$receipt = new Receipt();
$receipt->setTotal(7612);

// Установми чек для запроса
$request->setReceipt($receipt);

// Создадим атрибуты клиента
$client = new Client();
$client->setEmail('client@example.com');

// Установим атрибуты клиента для чека
$receipt->setClient($client);

// Создадим атрибуты компании
$company = new Company();
$company
  ->setEmail('shop@example.com')
  ->setSno(SnoSystem::OSN)
  ->setInn('331122667723')
  ->setPaymentAddress('http://example.com');

// Установим атрибуты компании для чека
$receipt->setCompany($company);

// Создадим атрибут налога под 20% НДС
$vat20 = new Vat();
$vat20->setType(VatType::VAT20);

// Создадим первую позицию
$item1 = new Item('Название товара 1');
$item1
  ->setPrice(5000)
  ->setQuantity(1)
  ->setSum(5000)
  ->setVat($vat20)
  ->setPaymentObject(PaymentObject::COMMODITY)
  ->setPaymentMethod(PaymentMethod::FULL_PAYMENT);

// Добавим в чек первую позицию
$receipt->addItem($item1);

// Создадим вторую позицию
$item2 = new Item('Название товара 2');
$item2
  ->setPrice(1456.21)
  ->setQuantity(2)
  ->setVat($vat20)
  ->setPaymentObject(PaymentObject::COMMODITY)
  ->setPaymentMethod(PaymentMethod::FULL_PAYMENT)
  ->setMeasurementUnit('кг');

// Добавим в чек вторую позицию
$receipt->addItem($item2);

// Создадим оплату
$payment = new Payment();
$payment
  ->setSum(7612)
  ->setType(Payment::TYPE_ELECTRONIC);

// Добавим в чек оплату
$receipt->addPayment($payment);

// Создадим служебный раздел
$service = new Service();
$service->setCallbackUrl('http://example.com/payment-result');

// Установим служебный раздел для запроса на продажу
$request->setService($service);

// PSR-совместимый интерфейс кеширования, см. http://www.php-cache.com
// В данном случае используется Filesystem кеш, настроим его пул и получим итем для кеширования
$filesystemAdapter = new Local(__DIR__.'/');
$filesystem = new Filesystem($filesystemAdapter);
$pool = new FilesystemCachePool($filesystem);
$cache = $pool->getItem('atol');

// PSR-совместимый логгер (опциональный параметр)
$logger = null;

// Логин, пароль и код группы можно найти в "Настройках интергатора", скачиваемых с
// личного кабинета АТОЛ Онлайн в ноде
$login = 'netletest';
$passwor = 'v2AfscRjr';
$groupCode = 'netletest_8491';

// Создадим клиент
$client = new AtolClient($login, $password, $groupCode, $cache, $logger);

// Отравим запрос
// $uuid будет содержать UUID документа в системе АТОЛ Онлайн
$uuid = $client->send($request);
```

Доступные запросы:

- `ItQuasar/AtolOnline/Sell` - чек «Приход»;
- `ItQuasar/AtolOnline/SellRefund` - чек «Возврат прихода»;
- `ItQuasar/AtolOnline/SellCorrection` - чек «Коррекция прихода»;
- `ItQuasar/AtolOnline/Buy` - чек «Расход»;
- `ItQuasar/AtolOnline/BuyRefund` - чек «Возврат расхода»;
- `ItQuasar/AtolOnline/BuyCorrection` - чек «Коррекция расхода».

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

```
getItem('atol');

// PSR-совместимый логгер (опциональный параметр)
$logger = null;

// Логин, пароль и код группы можно найти в "Настройках интергатора", скачиваемых с
// личного кабинета АТОЛ Онлайн в ноде
$login = 'netletest';
$passwor = 'v2AfscRjr';
$groupCode = 'netletest_8491';

// Создадим клиент
$client = new AtolClient($login, $password, $groupCode, $cache, $logger);

// UUID документа, полученный при регистрации документа в системе АТОЛ Онлайн
$uuid = '...';

// Отравим запрос на получение статуса обработки.
// $report будет содержать ItQuasar/AtolOnline/Report,
// который соответствует структуре описанной в
// https://raw.githubusercontent.com/0x6368656174/atol-online/master/api/atol-online-v4.6.pdf
$report = $client->getReport($uuid);
```

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance74

Regular maintenance activity

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 89.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~301 days

Recently: every ~677 days

Total

10

Last Release

140d ago

Major Versions

1.0.10 → 4.0.02019-02-08

PHP version history (2 changes)1.0.1PHP &gt;=7.1.0

v4.2.0PHP &gt;=7.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/e62dd27b16e155d1fd04a27f4a3a1fc7fcc07156ae0ecc38c5a2e175de0d3542?d=identicon)[djjerry\_85](/maintainers/djjerry_85)

---

Top Contributors

[![0x6368656174](https://avatars.githubusercontent.com/u/4064875?v=4)](https://github.com/0x6368656174 "0x6368656174 (35 commits)")[![djjerry85](https://avatars.githubusercontent.com/u/6782325?v=4)](https://github.com/djjerry85 "djjerry85 (4 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/djjerry85-atol-online/health.svg)

```
[![Health](https://phpackages.com/badges/djjerry85-atol-online/health.svg)](https://phpackages.com/packages/djjerry85-atol-online)
```

###  Alternatives

[symfony/cache

Provides extended PSR-6, PSR-16 (and tags) implementations

4.2k348.9M2.5k](/packages/symfony-cache)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[nelmio/api-doc-bundle

Generates documentation for your REST API from attributes

2.3k63.6M233](/packages/nelmio-api-doc-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[api-platform/metadata

API Resource-oriented metadata attributes and factories

223.5M96](/packages/api-platform-metadata)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
