wrdev / atol-v4-client

1.0.0 2026-10-01 12:46 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.5
• jms/serializer: ^3.31
• symfony/property-access: ^7.0
• symfony/property-info: ^7.0
• symfony/validator: ^7.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^11.4

MIT

• Vlad G.

• php
• receipt
• atol
• ofd
• atol-online
• kkt
• fiscalization

Published on Packagist.org on 2026-10-01 12:57 UTC

README

PHP-клиент для API сервиса онлайн-фискализации платежей АТОЛ.Онлайн (ФФД 1.05)

Текущая версия документа: 5.24

• Документация АТОЛ: https://atol.online/library/?tab=devs
• Поддерживаемая версия PHP: 8.2+

Установка

composer require wrdev/atol-v4-client

Пример использования

Подробный пример (включая настройку токена) вынесен в docs/usage.md:

• Как использовать пакет

Поддерживаемые операции

• sell(RegisterRequest): RegisterResponse
• sellRefund(RegisterRequest): RegisterResponse
• sellCorrection(CorrectionRequest): CorrectionResponse
• sellCorrectionRefund(CorrectionRequest): CorrectionResponse
• report(string $uuid): ReportResponse
• checkStatus(string $uuid): ReportResponse (alias report)

Обработка ошибок

Пакет выбрасывает типизированные исключения:

• WrDev\AtolV4Client\Common\BadRequestException - валидация данных клиента или DTO.
• WrDev\AtolV4Client\Common\AuthenticationException - ошибка получения токена.
• WrDev\AtolV4Client\Common\TransportException - сетевые/транспортные проблемы.
• WrDev\AtolV4Client\Common\ApiException - API-ошибка АТОЛ (включая детали ответа).