Документация: https://online.atol.ru/files/API_service_information.pdf

В версии 0.* есть функционал декодирования json-стркои в объект класса AtolOnline\Entities\Document. За это отвечает метод AtolOnline\Entities\Document::fromRaw().

Он было написан для одного конкретного проекта, где на тот момент уже использовалась библиотека, и использовать этот fromRaw() там было удобно.

Но написание этого метода было ошибкой. Мало того, что он написан отвратительно, так теперь я не понимаю нужен ли он принципиально -- какие в реальности у него могут быть юзкейсы.

Поэтому этот метод -- кандидат на удаление, пока не будет ясно обратное.

Использовать psr/http-client вместо guzzlehttp/guzzle

Добрый день.

Неправильно считается НДС20, да и с остальными проблема по идее.
Класс Vat:

switch ($type) {
            case VatTypes::NONE:
            case VatTypes::VAT0:
                return 0;
            case VatTypes::VAT10:
                //return $kopeks * 10 / 100;
            case VatTypes::VAT110:
                return $kopeks * 10 / 110;
            case VatTypes::VAT18:
                //return $kopeks * 18 / 100;
            case VatTypes::VAT118:
                return $kopeks * 18 / 118;
            case VatTypes::VAT20:
---->>>     //return $kopeks * 20 / 100;
            case VatTypes::VAT120:
                return $kopeks * 20 / 120;
        }
        return 0;

Себе поправил, но после этого заметил - неправильно происходит округление налога при подсчете:
Вывод $doc->jsonSerialize(); перед отправкой.

    array(8) {
      ["name"]=>
      string(52) "Тест"
      ["price"]=>
      float(252.43)
      ["quantity"]=>
      float(1)
      ["sum"]=>
      float(252.43)
      ["measurement_unit"]=>
      string(4) "шт"
      ["payment_method"]=>
      string(12) "full_payment"
      ["payment_object"]=>
      string(7) "service"
      ["vat"]=>
      array(2) {
        ["type"]=>
        string(5) "vat20"
        ["sum"]=>
        float(50.48)
      }
    }

Хотя по правилам должно быть 252.43 * 20 / 100 = 50.486 (50.49)

Актуальная версия v5.6: https://online.atol.ru/files/API_atol_online_v4.pdf

5.2: из чека коррекции удалён base_name (схема):

https://github.com/anthonyaxenov/atol-online/blob/v0.3.5-b/src/AtolOnline/Entities/CorrectionInfo.php#L37

5.4: удалён предмет расчётов composite и добавлены новые (схема):

award
deposit
expense
pension_insurance_ip
pension_insurance
medical_insurance_ip
medical_insurance
social_insurance
casino_payment

https://github.com/anthonyaxenov/atol-online/blob/v0.3.5-b/src/AtolOnline/Constants/PaymentObjects.php

Логировать каждый чих через psr/log

Судя по логам, кеш сохраняется, но при новых билдах зависимости качаются заново. Из-за этого общее время билда (php8.0 + php8.1) стремится к минуте.

Пример: https://github.com/anthonyaxenov/atol-online/runs/4427685193?check_suite_focus=true

Основная поддержка php версии 7.4 заканчивается 28.11.2021.
Для себя я не вижу смысла продолжать писать основную кодовую базу для этой версии.

Минимальная версия php будет повышена до >=8.0, соответственно и зависимости. Поэтому следующий релиз будет мажорным v1.0.0 и обратно несовместимым с v0.*

Для php 7.4 я буду поддерживать этот пакет только засчёт ваших PR.

В JSON операции чека коррекции прихода, в отличие от чека прихода, обязательно наличие массива vats.
https://online.atol.ru/files/API_atol_online_v4.pdf
В классе Vats, метод calculator для НДС none и vat0 возвращается значение 0.
Для чека коррекции необходимо, чтобы возвращалась сумма платежей без НДС или с НДС 0 процентов.
НО: для чека прихода/возврата прихода необходимо, чтобы возвращалось 0, иначе выйдет ошибка "Несоответствие НДС сумме платежей"

Пример - сумма без НДС 100 рублей
В JSON чека коррекции должно быть:

"vats":[
 {
 "type":"none",
 "sum":100
 },
]

А в чеке прихода:

"vats":[
 {
 "type":"none",
 "sum":0
 },
]

Или как-то так.

Чек коррекции с некорректной суммой без НДС, пробитый через реп

https://github.com/anthonyaxenov/atol-online/runs/4574920879?check_suite_focus=true

Кешировать как минимум авторизационные токены и список ККТ от мониторинга через psr/cache

Документация: https://online.atol.ru/files/API_atol_online_v5.pdf

Данные для подключения к тестовой среде: https://online.atol.ru/files/ffd/test_sreda.txt

Эмитировать события:

• регистрация документов: перед отправкой запроса
• регистрация документов: после получения ответа
• мониторинг: перед отправкой запроса
• мониторинг: после получения ответа
• ...