PHPackages it-quasar/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. [Utility & Helpers](/categories/utility) 4. / 5. it-quasar/atol-online ActiveLibrary[Utility & Helpers](/categories/utility) it-quasar/atol-online ===================== Библиотека для работы с АТОЛ Онлайн 4.1.0(4y ago)119.4k8[1 PRs](https://github.com/0x6368656174/atol-online/pulls)GPL-3.0-or-laterPHPPHP >=7.1.0CI failing Since Jul 24Pushed 2y ago1 watchersCompare [ Source](https://github.com/0x6368656174/atol-online)[ Packagist](https://packagist.org/packages/it-quasar/atol-online)[ RSS](/packages/it-quasar-atol-online/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (9)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 36 — LowBetter than 82% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity33 Limited adoption so far Community13 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 97.4% 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 ~153 days Recently: every ~268 days Total 8 Last Release 1777d ago Major Versions 1.0.10 → 4.0.02019-02-08 ### Community Maintainers ![](https://www.gravatar.com/avatar/95970a357ff7e889877a199d07de386608fd98338066f106d78ffd8e710fb936?d=identicon)[0x6368656174](/maintainers/0x6368656174) --- Top Contributors [![0x6368656174](https://avatars.githubusercontent.com/u/4064875?v=4)](https://github.com/0x6368656174 "0x6368656174 (37 commits)")[![vhar](https://avatars.githubusercontent.com/u/5484416?v=4)](https://github.com/vhar "vhar (1 commits)") --- Tags atolphpreceipts ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/it-quasar-atol-online/health.svg) ``` [![Health](https://phpackages.com/badges/it-quasar-atol-online/health.svg)](https://phpackages.com/packages/it-quasar-atol-online) ``` ### Alternatives [j0k3r/php-readability Automatic article extraction from HTML 186808.8k6](/packages/j0k3r-php-readability)[api-platform/metadata API Resource-oriented metadata attributes and factories 223.5M96](/packages/api-platform-metadata)[oat-sa/lib-lti1p3-core OAT LTI 1.3 Core Library 36341.9k10](/packages/oat-sa-lib-lti1p3-core)[spomky-labs/pwa-bundle Progressive Web App Manifest Generator Bundle for Symfony. 6144.4k1](/packages/spomky-labs-pwa-bundle)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)