Готов класс оплаты Payment для будущей поддержки оплат в документе

Также переименованы исключения о слишком высоких цене и сумме предмета расчёта, чтобы избежать конфликтов с другими

src/Constants/Constraints.php

@@ -147,6 +147,11 @@ final class Constraints
      */
     const CORRECTION_DATE_FORMAT = 'd.m.Y';
 
+    /**
+     * Максимальная сумма одной оплаты
+     */
+    const MAX_COUNT_PAYMENT_SUM = 99999.999;
+
     /**
      * Регулярное выражение для валидации строки ИНН
      *

src/Entities/Item.php

@@ -25,9 +25,9 @@ use AtolOnline\Exceptions\{
     NegativeItemExciseException,
     NegativeItemPriceException,
     NegativeItemQuantityException,
+    TooHighItemPriceException,
     TooHighItemQuantityException,
-    TooHighPriceException,
-    TooHighSumException,
+    TooHighItemSumException,
     TooLongItemCodeException,
     TooLongItemNameException,
     TooLongMeasurementUnitException,
@@ -124,7 +124,7 @@ final class Item extends Entity
      * @param float|null $price Цена за одну единицу
      * @param float|null $quantity Количество
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -184,21 +184,22 @@ final class Item extends Entity
     /**
      * Устанавливает цену в рублях
      *
-     * @param float $rubles
+     * @param float $price
      * @return $this
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
-     * @throws TooHighSumException
+     * @throws TooHighItemPriceException
+     * @throws TooHighItemSumException
      */
-    public function setPrice(float $rubles): self
+    public function setPrice(float $price): self
     {
-        if ($rubles > Constraints::MAX_COUNT_ITEM_PRICE) {
-            throw new TooHighPriceException($this->getName(), $rubles);
+        $price = round($price, 2);
+        if ($price > Constraints::MAX_COUNT_ITEM_PRICE) {
+            throw new TooHighItemPriceException($this->getName(), $price);
         }
-        if ($rubles < 0) {
-            throw new NegativeItemPriceException($this->getName(), $rubles);
+        if ($price < 0) {
+            throw new NegativeItemPriceException($this->getName(), $price);
         }
-        $this->price = $rubles;
+        $this->price = $price;
         $this->getVat()?->setSum($this->getSum());
         return $this;
     }
@@ -220,7 +221,7 @@ final class Item extends Entity
      * @return $this
      * @throws TooHighItemQuantityException
      * @throws NegativeItemQuantityException
-     * @throws TooHighSumException
+     * @throws TooHighItemSumException
      */
     public function setQuantity(float $quantity): self
     {
@@ -240,13 +241,13 @@ final class Item extends Entity
      * Возвращает стоимость (цена * количество + акциз)
      *
      * @return float
-     * @throws TooHighSumException
+     * @throws TooHighItemSumException
      */
     public function getSum(): float
     {
         $sum = $this->getPrice() * $this->getQuantity() + (float)$this->getExcise();
         if ($sum > Constraints::MAX_COUNT_ITEM_SUM) {
-            throw new TooHighSumException($this->getName(), $sum);
+            throw new TooHighItemSumException($this->getName(), $sum);
         }
         return $sum;
     }
@@ -386,7 +387,7 @@ final class Item extends Entity
      *
      * @param Vat|string|null $vat Объект ставки, одно из значений VatTypes или null для удаления ставки
      * @return $this
-     * @throws TooHighSumException
+     * @throws TooHighItemSumException
      * @throws InvalidEnumValueException
      */
     public function setVat(Vat|string|null $vat): self
@@ -490,7 +491,7 @@ final class Item extends Entity
      * @param float|null $excise
      * @return Item
      * @throws NegativeItemExciseException
-     * @throws TooHighSumException
+     * @throws TooHighItemSumException
      */
     public function setExcise(?float $excise): self
     {
@@ -567,7 +568,7 @@ final class Item extends Entity
 
     /**
      * @inheritDoc
-     * @throws TooHighSumException
+     * @throws TooHighItemSumException
      */
     public function jsonSerialize(): array
     {

src/Entities/Payment.php

@@ -0,0 +1,119 @@
+<?php
+/*
+ * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
+ *
+ * This code is licensed under MIT.
+ * Этот код распространяется по лицензии MIT.
+ * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
+ */
+
+declare(strict_types = 1);
+
+namespace AtolOnline\Entities;
+
+use AtolOnline\Constants\Constraints;
+use AtolOnline\Enums\PaymentTypes;
+use AtolOnline\Exceptions\InvalidEnumValueException;
+use AtolOnline\Exceptions\NegativePaymentSumException;
+use AtolOnline\Exceptions\TooHighPaymentSumException;
+use JetBrains\PhpStorm\ArrayShape;
+use JetBrains\PhpStorm\Pure;
+
+/**
+ * Класс, описывающий оплату
+ *
+ * @see https://online.atol.ru/files/API_atol_online_v4.pdf Документация, стр 30
+ */
+class Payment extends Entity
+{
+    /**
+     * @var int Тип оплаты
+     */
+    protected int $type;
+
+    /**
+     * @var float Сумма оплаты (1031, 1081, 1215, 1216, 1217)
+     */
+    protected float $sum;
+
+    /**
+     * Конструктор
+     *
+     * @param int $type Тип оплаты
+     * @param float $sum Сумма оплаты
+     * @throws InvalidEnumValueException
+     * @throws NegativePaymentSumException
+     * @throws TooHighPaymentSumException
+     */
+    public function __construct(int $type, float $sum)
+    {
+        $this->setType($type)->setSum($sum);
+    }
+
+    /**
+     * Возвращает установленный тип оплаты
+     *
+     * @return int
+     */
+    public function getType(): int
+    {
+        return $this->type;
+    }
+
+    /**
+     * Устанавливает тип оплаты
+     *
+     * @param int $type
+     * @return $this
+     * @throws InvalidEnumValueException
+     */
+    public function setType(int $type): self
+    {
+        PaymentTypes::isValid($type) && $this->type = $type;
+        return $this;
+    }
+
+    /**
+     * Возвращает установленную сумму оплаты
+     *
+     * @return float
+     */
+    public function getSum(): float
+    {
+        return $this->sum;
+    }
+
+    /**
+     * Устанавливает сумму оплаты
+     *
+     * @param float $sum
+     * @return $this
+     * @throws TooHighPaymentSumException
+     * @throws NegativePaymentSumException
+     */
+    public function setSum(float $sum): self
+    {
+        $sum = round($sum, 2);
+        if ($sum > Constraints::MAX_COUNT_PAYMENT_SUM) {
+            throw new TooHighPaymentSumException($sum);
+        }
+        if ($sum < 0) {
+            throw new NegativePaymentSumException($sum);
+        }
+        $this->sum = $sum;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    #[Pure]
+    #[ArrayShape(['type' => 'int', 'sum' => 'float'])]
+    public function jsonSerialize(): array
+    {
+        return [
+            'type' => $this->getType(),
+            'sum' => $this->getSum(),
+        ];
+    }
+}

src/Entities/todo_Payment.php

@@ -1,99 +0,0 @@
-<?php
-/*
- * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
- *
- * This code is licensed under MIT.
- * Этот код распространяется по лицензии MIT.
- * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
- */
-
-declare(strict_types = 1);
-
-namespace AtolOnline\Entities;
-
-use AtolOnline\Enums\PaymentTypes;
-
-/**
- * Класс, описывающий оплату. Тег ФФД - 1031, 1081, 1215, 1216, 1217.
- *
- * @package AtolOnline\Entities
- */
-class todoPayment extends Entity
-{
-    /**
-     * @var int Тип оплаты
-     */
-    protected int $type;
-
-    /**
-     * @var float Сумма оплаты
-     */
-    protected float $sum;
-
-    /**
-     * todoPayment constructor.
-     *
-     * @param int $payment_type Тип оплаты
-     * @param float $sum Сумма оплаты
-     */
-    public function __construct(int $payment_type = PaymentTypes::ELECTRON, float $sum = 0.0)
-    {
-        $this->setType($payment_type);
-        $this->setSum($sum);
-    }
-
-    /**
-     * Возвращает тип оплаты. Тег ФФД - 1031, 1081, 1215, 1216, 1217.
-     *
-     * @return int
-     */
-    public function getType(): int
-    {
-        return $this->type;
-    }
-
-    /**
-     * Устанавливает тип оплаты. Тег ФФД - 1031, 1081, 1215, 1216, 1217.
-     *
-     * @param int $type
-     * @return $this
-     */
-    public function setType(int $type): todoPayment
-    {
-        $this->type = $type;
-        return $this;
-    }
-
-    /**
-     * Возвращает сумму оплаты
-     *
-     * @return float
-     */
-    public function getSum(): float
-    {
-        return $this->sum;
-    }
-
-    /**
-     * Устанавливает сумму оплаты
-     *
-     * @param float $sum
-     * @return $this
-     */
-    public function setSum(float $sum): todoPayment
-    {
-        $this->sum = $sum;
-        return $this;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function jsonSerialize()
-    {
-        return [
-            'type' => $this->getType(),
-            'sum' => $this->getSum(),
-        ];
-    }
-}

src/Exceptions/NegativePaymentSumException.php

@@ -0,0 +1,38 @@
+<?php
+/*
+ * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
+ *
+ * This code is licensed under MIT.
+ * Этот код распространяется по лицензии MIT.
+ * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
+ */
+
+declare(strict_types = 1);
+
+namespace AtolOnline\Exceptions;
+
+use AtolOnline\Constants\Ffd105Tags;
+
+/**
+ * Исключение, возникающее при попытке указать оплате отрицательную сумму
+ */
+class NegativePaymentSumException extends AtolException
+{
+    protected array $ffd_tags = [
+        Ffd105Tags::PAYMENT_TYPE_CASH,
+        Ffd105Tags::PAYMENT_TYPE_CREDIT,
+        Ffd105Tags::PAYMENT_TYPE_ELECTRON,
+        Ffd105Tags::PAYMENT_TYPE_PREPAID,
+        Ffd105Tags::PAYMENT_TYPE_OTHER,
+    ];
+
+    /**
+     * Конструктор
+     *
+     * @param float $sum
+     */
+    public function __construct(float $sum)
+    {
+        parent::__construct('Размер оплаты не может быть отрицательным: ' . $sum);
+    }
+}

src/Exceptions/TooHighItemPriceException.php

@@ -15,9 +15,9 @@ use AtolOnline\Constants\Constraints;
 use AtolOnline\Constants\Ffd105Tags;
 
 /**
- * Исключение, возникающее при попытке указать слишком высокую цену (сумму)
+ * Исключение, возникающее при попытке указать слишком высокую цену (сумму) предмета расчёта
  */
-class TooHighPriceException extends TooManyException
+class TooHighItemPriceException extends TooManyException
 {
     protected array $ffd_tags = [Ffd105Tags::ITEM_PRICE];
     protected float $max = Constraints::MAX_COUNT_ITEM_PRICE;

src/Exceptions/TooHighItemSumException.php

@@ -15,12 +15,12 @@ use AtolOnline\Constants\Constraints;
 use AtolOnline\Constants\Ffd105Tags;
 
 /**
- * Исключение, возникающее при попытке получеиня слишком высокой стоимости
+ * Исключение, возникающее при попытке получеиня слишком высокой стоимости предмета расчёта
  */
-class TooHighSumException extends TooManyException
+class TooHighItemSumException extends TooManyException
 {
     protected array $ffd_tags = [Ffd105Tags::ITEM_SUM];
-    protected float $max = Constraints::MAX_COUNT_ITEM_PRICE;
+    protected float $max = Constraints::MAX_COUNT_ITEM_SUM;
 
     /**
      * Конструктор

src/Exceptions/TooHighPaymentSumException.php

@@ -0,0 +1,31 @@
+<?php
+/*
+ * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
+ *
+ * This code is licensed under MIT.
+ * Этот код распространяется по лицензии MIT.
+ * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
+ */
+
+declare(strict_types = 1);
+
+namespace AtolOnline\Exceptions;
+
+use AtolOnline\Constants\Constraints;
+use AtolOnline\Constants\Ffd105Tags;
+
+/**
+ * Исключение, возникающее при попытке установки слишком большой суммы оплаты
+ */
+class TooHighPaymentSumException extends TooManyException
+{
+    protected $message = 'Слишком высокый размер оплаты';
+    protected array $ffd_tags = [
+        Ffd105Tags::PAYMENT_TYPE_CASH,
+        Ffd105Tags::PAYMENT_TYPE_CREDIT,
+        Ffd105Tags::PAYMENT_TYPE_ELECTRON,
+        Ffd105Tags::PAYMENT_TYPE_PREPAID,
+        Ffd105Tags::PAYMENT_TYPE_OTHER,
+    ];
+    protected float $max = Constraints::MAX_COUNT_PAYMENT_SUM;
+}

tests/AtolOnline/Tests/Entities/ItemTest.php

@@ -31,9 +31,9 @@ use AtolOnline\{
     Exceptions\NegativeItemExciseException,
     Exceptions\NegativeItemPriceException,
     Exceptions\NegativeItemQuantityException,
+    Exceptions\TooHighItemPriceException,
     Exceptions\TooHighItemQuantityException,
-    Exceptions\TooHighPriceException,
-    Exceptions\TooHighSumException,
+    Exceptions\TooHighItemSumException,
     Exceptions\TooLongItemCodeException,
     Exceptions\TooLongItemNameException,
     Exceptions\TooLongMeasurementUnitException,
@@ -62,7 +62,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::getSum
      * @covers \AtolOnline\Entities\Item::jsonSerialize
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -88,7 +88,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setName
      * @covers \AtolOnline\Exceptions\TooLongItemNameException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -107,7 +107,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setName
      * @covers \AtolOnline\Exceptions\EmptyItemNameException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -124,9 +124,9 @@ class ItemTest extends BasicTestCase
      *
      * @covers \AtolOnline\Entities\Item
      * @covers \AtolOnline\Entities\Item::setPrice
-     * @covers \AtolOnline\Exceptions\TooHighPriceException
+     * @covers \AtolOnline\Exceptions\TooHighItemPriceException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -134,7 +134,7 @@ class ItemTest extends BasicTestCase
      */
     public function testTooHighPriceException(): void
     {
-        $this->expectException(TooHighPriceException::class);
+        $this->expectException(TooHighItemPriceException::class);
         new Item('test', Constraints::MAX_COUNT_ITEM_PRICE + 0.1, 3);
     }
 
@@ -143,12 +143,12 @@ class ItemTest extends BasicTestCase
      *
      * @covers \AtolOnline\Entities\Item
      * @covers \AtolOnline\Entities\Item::setPrice
-     * @covers \AtolOnline\Exceptions\TooHighSumException
-     * @throws TooHighSumException
+     * @covers \AtolOnline\Exceptions\TooHighItemSumException
+     * @throws TooHighItemSumException
      */
     public function testTooHighSumException(): void
     {
-        $this->expectException(TooHighSumException::class);
+        $this->expectException(TooHighItemSumException::class);
         (new Item('test', Constraints::MAX_COUNT_ITEM_PRICE, Constraints::MAX_COUNT_ITEM_QUANTITY))->getSum();
     }
 
@@ -159,7 +159,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setPrice
      * @covers \AtolOnline\Exceptions\NegativeItemPriceException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -178,7 +178,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setQuantity
      * @covers \AtolOnline\Exceptions\TooHighItemQuantityException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -197,7 +197,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setQuantity
      * @covers \AtolOnline\Exceptions\NegativeItemQuantityException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -217,7 +217,7 @@ class ItemTest extends BasicTestCase
      * @covers       \AtolOnline\Entities\Item::getMeasurementUnit
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooLongMeasurementUnitException
      * @throws TooManyException
@@ -236,7 +236,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooLongMeasurementUnitException
      * @throws TooManyException
@@ -260,7 +260,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidEnumValueException
      * @throws TooManyException
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws NegativeItemQuantityException
      * @throws TooLongItemNameException
      */
@@ -294,7 +294,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidEnumValueException
      * @throws TooManyException
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws NegativeItemQuantityException
      * @throws TooLongItemNameException
      */
@@ -314,7 +314,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidEnumValueException
      * @throws TooManyException
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws NegativeItemQuantityException
      * @throws TooLongItemNameException
      */
@@ -334,7 +334,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      */
@@ -365,7 +365,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      */
@@ -399,7 +399,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      * @throws InvalidEnumValueException
@@ -422,7 +422,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidPhoneException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooLongPayingAgentOperationException
      * @throws TooManyException
@@ -450,7 +450,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidPhoneException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      */
@@ -485,7 +485,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooLongUserdataException
      * @throws TooManyException
@@ -514,7 +514,7 @@ class ItemTest extends BasicTestCase
      * @covers       \AtolOnline\Entities\Item::getUserData
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      * @throws NegativeItemQuantityException
@@ -534,7 +534,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooLongUserdataException
      * @throws TooManyException
@@ -555,7 +555,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidOKSMCodeException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      */
@@ -582,7 +582,7 @@ class ItemTest extends BasicTestCase
      * @throws InvalidOKSMCodeException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      */
@@ -601,7 +601,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      * @throws InvalidDeclarationNumberException
@@ -629,7 +629,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws InvalidDeclarationNumberException
      * @throws TooManyException
@@ -649,7 +649,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws InvalidDeclarationNumberException
      * @throws TooManyException
@@ -669,7 +669,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::getSum
      * @covers \AtolOnline\Entities\Item::jsonSerialize
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -696,7 +696,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setExcise
      * @covers \AtolOnline\Exceptions\NegativeItemExciseException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException
@@ -719,7 +719,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemNameException
      * @throws TooManyException
      * @throws TooLongItemCodeException
@@ -756,7 +756,7 @@ class ItemTest extends BasicTestCase
      * @throws EmptyItemNameException
      * @throws NegativeItemPriceException
      * @throws NegativeItemQuantityException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooLongItemCodeException
      * @throws TooLongItemNameException
      * @throws TooManyException
@@ -774,7 +774,7 @@ class ItemTest extends BasicTestCase
      * @covers \AtolOnline\Entities\Item::setCode
      * @covers \AtolOnline\Exceptions\TooLongItemCodeException
      * @throws TooLongItemNameException
-     * @throws TooHighPriceException
+     * @throws TooHighItemPriceException
      * @throws TooManyException
      * @throws NegativeItemPriceException
      * @throws EmptyItemNameException

tests/AtolOnline/Tests/Entities/PaymentTest.php

@@ -0,0 +1,105 @@
+<?php
+/*
+ * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
+ *
+ * This code is licensed under MIT.
+ * Этот код распространяется по лицензии MIT.
+ * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
+ */
+
+namespace AtolOnline\Tests\Entities;
+
+use AtolOnline\{
+    Constants\Constraints,
+    Entities\Payment,
+    Enums\PaymentTypes,
+    Tests\BasicTestCase
+};
+use AtolOnline\Exceptions\{
+    InvalidEnumValueException,
+    NegativePaymentSumException,
+    TooHighPaymentSumException,
+};
+
+/**
+ * Набор тестов для проверки работы класса оплаты
+ */
+class PaymentTest extends BasicTestCase
+{
+    /**
+     * Тестирует конструктор
+     *
+     * @covers \AtolOnline\Entities\Payment
+     * @covers \AtolOnline\Entities\Payment::setType
+     * @covers \AtolOnline\Entities\Payment::getType
+     * @covers \AtolOnline\Entities\Payment::setSum
+     * @covers \AtolOnline\Entities\Payment::getSum
+     * @covers \AtolOnline\Entities\Payment::jsonSerialize
+     * @return void
+     * @throws InvalidEnumValueException
+     * @throws NegativePaymentSumException
+     * @throws TooHighPaymentSumException
+     */
+    public function testConstructor(): void
+    {
+        $this->assertAtolable(
+            new Payment(PaymentTypes::ELECTRON, 123.456789),
+            [
+                'type' => PaymentTypes::ELECTRON,
+                'sum' => 123.46,
+            ]
+        );
+    }
+
+    /**
+     * Тестирует исключение при некорректном типе
+     *
+     * @covers \AtolOnline\Entities\Payment
+     * @covers \AtolOnline\Entities\Payment::setType
+     * @covers \AtolOnline\Enums\PaymentTypes::isValid
+     * @covers \AtolOnline\Exceptions\InvalidEnumValueException
+     * @return void
+     * @throws InvalidEnumValueException
+     * @throws NegativePaymentSumException
+     * @throws TooHighPaymentSumException
+     */
+    public function testInvalidEnumValueException(): void
+    {
+        $this->expectException(InvalidEnumValueException::class);
+        $this->expectExceptionMessage('Некорректное значение AtolOnline\Enums\PaymentTypes::123');
+        new Payment(123, 123.456789);
+    }
+
+    /**
+     * Тестирует исключение при слишком большой сумме
+     *
+     * @covers \AtolOnline\Entities\Payment
+     * @covers \AtolOnline\Entities\Payment::setSum
+     * @covers \AtolOnline\Exceptions\TooHighPaymentSumException
+     * @return void
+     * @throws InvalidEnumValueException
+     * @throws NegativePaymentSumException
+     */
+    public function testTooHighPaymentSumException(): void
+    {
+        $this->expectException(TooHighPaymentSumException::class);
+        new Payment(PaymentTypes::ELECTRON, Constraints::MAX_COUNT_PAYMENT_SUM + 1);
+    }
+
+    /**
+     * Тестирует исключение при отрицательной сумме
+     *
+     * @covers \AtolOnline\Entities\Payment
+     * @covers \AtolOnline\Entities\Payment::setSum
+     * @covers \AtolOnline\Exceptions\NegativePaymentSumException
+     * @return void
+     * @throws InvalidEnumValueException
+     * @throws NegativePaymentSumException
+     * @throws TooHighPaymentSumException
+     */
+    public function testNegativePaymentSumException(): void
+    {
+        $this->expectException(NegativePaymentSumException::class);
+        new Payment(PaymentTypes::ELECTRON, -1);
+    }
+}

tests/AtolOnline/Tests/Entities/VatTest.php

@@ -12,6 +12,7 @@ namespace AtolOnline\Tests\Entities;
 use AtolOnline\{
     Entities\Vat,
     Enums\VatTypes,
+    Exceptions\InvalidEnumValueException,
     Tests\BasicTestCase
 };
 
@@ -69,6 +70,7 @@ class VatTest extends BasicTestCase
      * @covers       \AtolOnline\Entities\Vat::getSum
      * @covers       \AtolOnline\Entities\Vat::getCalculated
      * @covers       \AtolOnline\Entities\Vat::jsonSerialize
+     * @throws InvalidEnumValueException
      */
     public function testConstructor(string $type, float $sum): void
     {
@@ -90,6 +92,7 @@ class VatTest extends BasicTestCase
      * @param float $after_minus Результат после -20р
      * @covers       \AtolOnline\Entities\Vat::addSum
      * @covers       \AtolOnline\Entities\Vat::getCalculated
+     * @throws InvalidEnumValueException
      */
     public function testVatAdd(string $type, float $after_plus, float $after_minus)
     {