2024-11-22 17:24:33 +00:00
14 changed files with 38 additions and 259 deletions
--- a/README.md
+++ b/README.md
@ -84,9 +84,9 @@ composer test

 ## Дополнительные ресурсы

-* **[Документация к библиотеке](/docs/readme.md)**
+* [Документация АТОЛ](https://online.atol.ru/lib/)
+  **[Документация к библиотеке](/docs/readme.md)**
 * Telegram-канал: [@atolonline_php](https://t.me/atolonline_php)
-* [Документация АТОЛ Онлайн](https://online.atol.ru/lib/)
 * Функционал, находящийся в разработке: [ROADMAP.md](ROADMAP.md)

 ## Лицензия
--- a/phpunit.xml
+++ b/phpunit.xml
@ -9,8 +9,15 @@

 <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
+         backupGlobals="false"
+         backupStaticAttributes="false"
         bootstrap="vendor/autoload.php"
-         colors="true">
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
 	<testsuites>
 		<testsuite name="All">
 			<directory suffix="Test.php">./tests</directory>
@ -22,4 +29,4 @@
 			<directory suffix=".php">src</directory>
 		</include>
 	</coverage>
-</phpunit>
+</phpunit>
--- a/src/Constants/Ffd105Tags.php
+++ b/src/Constants/Ffd105Tags.php
@ -39,21 +39,11 @@ final class Ffd105Tags
     */
    const COMPANY_INN = 1008;

-    /**
-     * Применяемая система налогообложения
-     */
-    const COMPANY_SNO = 1055;
-
    /**
     * Место расчётов
     */
    const COMPANY_PADDRESS = 1187;

-    /**
-     * Признак агента по предмету расчёта
-     */
-    const AGENT_TYPE = 1222;
-
    /**
     * Телефон оператора по приёму платежей
     */
@ -142,7 +132,7 @@ final class Ffd105Tags
    /**
     * Сумма акциза с учётом копеек, включённая в стоимость предмета расчёта
     */
-    const ITEM_EXCISE = 1229;
+    const ITEM_PAYMENT_EXSICE = 1229;

    /**
     * Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира
@ -156,69 +146,4 @@ final class Ffd105Tags
     * Номер таможенной декларации (в соотв. с приказом ФНС России от 24.03.2016 N ММВ-7-15/155)
     */
    const ITEM_DECLARATION_NUMBER = 1231;
-
-    /**
-     * Тип коррекции
-     */
-    const CORRECTION_TYPE = 1173;
-
-    /**
-     * Сумма по чеку (БСО) наличными
-     */
-    const PAYMENT_TYPE_CASH = 1031;
-
-    /**
-     * Сумма по чеку безналичными
-     */
-    const PAYMENT_TYPE_ELECTRON = 1081;
-
-    /**
-     * Сумма по чеку предоплатой
-     */
-    const PAYMENT_TYPE_PREPAID = 1215;
-
-    /**
-     * Сумма по чеку постоплатой
-     */
-    const PAYMENT_TYPE_CREDIT = 1216;
-
-    /**
-     * Сумма по чеку встречным представлением
-     */
-    const PAYMENT_TYPE_OTHER = 1217;
-
-    /**
-     * Ставка НДС
-     */
-    const ITEM_VAT_TYPE = 1199;
-
-    /**
-     * Сумма расчета по чеку без НДС
-     */
-    const DOC_VAT_TYPE_NONE = 1105;
-
-    /**
-     * Сумма расчета по чеку с НДС по ставке 0%
-     */
-    const DOC_VAT_TYPE_VAT0 = 1104;
-
-    /**
-     * Сумма НДС чека по ставке 10%
-     */
-    const DOC_VAT_TYPE_VAT10 = 1103;
-
-    /**
-     * Сумма НДС чека по ставке 20%
-     */
-    const DOC_VAT_TYPE_VAT20 = 1102;
-
-    /**
-     * Сумма НДС чека по расч. ставке 10/110
-     */
-    const DOC_VAT_TYPE_VAT110 = 1107;
-
-    /**
-     * Сумма НДС чека по расч. ставке 20/120
-     */
-    const DOC_VAT_TYPE_VAT120 = 1106;
 }
--- a/src/Entities/Item.php
+++ b/src/Entities/Item.php
@ -20,7 +20,6 @@ use AtolOnline\{
    Exceptions\InvalidDeclarationNumberException,
    Exceptions\InvalidEnumValueException,
    Exceptions\InvalidOKSMCodeException,
-    Exceptions\NegativeItemExciseException,
    Exceptions\NegativeItemPriceException,
    Exceptions\NegativeItemQuantityException,
    Exceptions\TooHighItemQuantityException,
@ -29,8 +28,7 @@ use AtolOnline\{
    Exceptions\TooLongItemNameException,
    Exceptions\TooLongMeasurementUnitException,
    Exceptions\TooLongUserdataException,
-    Exceptions\TooManyException
-};
+    Exceptions\TooManyException};

 /**
 * Предмет расчёта (товар, услуга)
@ -94,11 +92,6 @@ class Item extends Entity
     */
    protected ?string $user_data = null;

-    /**
-     * @var float|null Сумма акциза, включенная в стоимость (1229)
-     */
-    protected ?float $excise = null;
-
    /**
     * @var string|null Цифровой код страны происхождения товара (1230)
     */
@ -221,14 +214,14 @@ class Item extends Entity
    }

    /**
-     * Возвращает стоимость (цена * количество + акциз)
+     * Возвращает стоимость
     *
     * @return float
     * @throws TooHighSumException
     */
    public function getSum(): float
    {
-        $sum = $this->getPrice() * $this->getQuantity() + (float)$this->getExcise();
+        $sum = $this->price * $this->quantity;
        if ($sum > Constraints::MAX_COUNT_ITEM_PRICE) {
            throw new TooHighSumException($this->getName(), $sum);
        }
@ -328,19 +321,16 @@ class Item extends Entity
     * @param Vat|string|null $vat Объект ставки, одно из значений VatTypes или null для удаления ставки
     * @return $this
     * @throws TooHighSumException
-     * @throws InvalidEnumValueException
     */
    public function setVat(Vat|string|null $vat): self
    {
        if (is_string($vat)) {
            $vat = trim($vat);
-            empty($vat)
-                ? $this->vat = null
-                : VatTypes::isValid($vat) && $this->vat = new Vat($vat, $this->getSum());
+            VatTypes::isValid($vat) && $vat = new Vat($vat, $this->getSum());
        } elseif ($vat instanceof Vat) {
            $vat->setSum($this->getSum());
-            $this->vat = $vat;
        }
+        $this->vat = $vat ?: null;
        return $this;
    }

@ -415,32 +405,6 @@ class Item extends Entity
        return $this;
    }

-    /**
-     * Возвращает установленную сумму акциза
-     *
-     * @return float|null
-     */
-    public function getExcise(): ?float
-    {
-        return $this->excise;
-    }
-
-    /**
-     * Устанавливает сумму акциза
-     *
-     * @param float|null $excise
-     * @return Item
-     * @throws NegativeItemExciseException
-     */
-    public function setExcise(?float $excise): Item
-    {
-        if ($excise < 0) {
-            throw new NegativeItemExciseException($this->getName(), $excise);
-        }
-        $this->excise = $excise;
-        return $this;
-    }
-
    /**
     * Возвращает установленный код страны происхождения товара
     *
@ -535,16 +499,16 @@ class Item extends Entity
            'quantity' => $this->getQuantity(),
            'sum' => $this->getSum(),
        ];
-        !is_null($this->getMeasurementUnit()) && $json['measurement_unit'] = $this->getMeasurementUnit();
-        !is_null($this->getPaymentMethod()) && $json['payment_method'] = $this->getPaymentMethod();
-        !is_null($this->getPaymentObject()) && $json['payment_object'] = $this->getPaymentObject();
-        !is_null($this->getDeclarationNumber()) && $json['declaration_number'] = $this->getDeclarationNumber();
+        $this->getMeasurementUnit() && $json['measurement_unit'] = $this->getMeasurementUnit();
+        $this->getPaymentMethod() && $json['payment_method'] = $this->getPaymentMethod();
+        $this->getPaymentObject() && $json['payment_object'] = $this->getPaymentObject();
+        $this->getDeclarationNumber() && $json['declaration_number'] = $this->getDeclarationNumber();
        $this->getVat()?->jsonSerialize() && $json['vat'] = $this->getVat()->jsonSerialize();
        $this->getAgentInfo()?->jsonSerialize() && $json['agent_info'] = $this->getAgentInfo()->jsonSerialize();
        $this->getSupplier()?->jsonSerialize() && $json['supplier_info'] = $this->getSupplier()->jsonSerialize();
-        !is_null($this->getUserData()) && $json['user_data'] = $this->getUserData();
-        !is_null($this->getExcise()) && $json['excise'] = $this->getExcise();
-        !is_null($this->getCountryCode()) && $json['country_code'] = $this->getCountryCode();
+        $this->getUserData() && $json['user_data'] = $this->getUserData();
+        //TODO excise
+        $this->getCountryCode() && $json['country_code'] = $this->getCountryCode();
        //TODO nomenclature_code
        return $json;
    }
--- a/src/Entities/Vat.php
+++ b/src/Entities/Vat.php
@ -12,7 +12,6 @@ declare(strict_types = 1);
 namespace AtolOnline\Entities;

 use AtolOnline\Enums\VatTypes;
-use AtolOnline\Exceptions\InvalidEnumValueException;
 use AtolOnline\Helpers;

 /**
@ -49,7 +48,6 @@ class Vat extends Entity
     *
     * @param string $type Тип ставки НДС
     * @return $this
-     * @throws InvalidEnumValueException
     */
    public function setType(string $type): self
    {
--- a/src/Enums/AgentTypes.php
+++ b/src/Enums/AgentTypes.php
@ -11,12 +11,10 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие типы агента
 *
- * @see https://online.atol.ru/files/API_atol_online_v4.pdf Документация, стр 18, 26
+ * @see https://online.atol.ru/files/API_atol_online_v4.pdf Документация, стр 18
 */
 final class AgentTypes extends Enum
 {
@ -60,6 +58,6 @@ final class AgentTypes extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [Ffd105Tags::AGENT_TYPE];
+        return [1057];
    }
 }
--- a/src/Enums/CorrectionTypes.php
+++ b/src/Enums/CorrectionTypes.php
@ -11,8 +11,6 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие типы документов коррекции
 *
@ -35,6 +33,6 @@ final class CorrectionTypes extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [Ffd105Tags::CORRECTION_TYPE];
+        return [1173];
    }
 }
--- a/src/Enums/PaymentMethods.php
+++ b/src/Enums/PaymentMethods.php
@ -11,8 +11,6 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие признаки способов расчёта
 *
@ -60,6 +58,6 @@ final class PaymentMethods extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [Ffd105Tags::ITEM_PAYMENT_METHOD];
+        return [1214];
    }
 }
--- a/src/Enums/PaymentObjects.php
+++ b/src/Enums/PaymentObjects.php
@ -11,8 +11,6 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие признаки предметов расчёта
 *
@ -162,6 +160,6 @@ final class PaymentObjects extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [Ffd105Tags::ITEM_PAYMENT_OBJECT];
+        return [1212];
    }
 }
--- a/src/Enums/PaymentTypes.php
+++ b/src/Enums/PaymentTypes.php
@ -11,8 +11,6 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие виды оплат
 *
@ -33,7 +31,7 @@ final class PaymentTypes extends Enum
    /**
     * Предварительная оплата (зачёт аванса)
     */
-    const PREPAID = 2;
+    const PRE_PAID = 2;

    /**
     * Предварительная оплата (кредит)
@ -80,12 +78,6 @@ final class PaymentTypes extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [
-            Ffd105Tags::PAYMENT_TYPE_CASH,
-            Ffd105Tags::PAYMENT_TYPE_ELECTRON,
-            Ffd105Tags::PAYMENT_TYPE_PREPAID,
-            Ffd105Tags::PAYMENT_TYPE_CREDIT,
-            Ffd105Tags::PAYMENT_TYPE_OTHER,
-        ];
+        return [1031, 1081, 1215, 1216, 1217];
    }
 }
--- a/src/Enums/SnoTypes.php
+++ b/src/Enums/SnoTypes.php
@ -11,8 +11,6 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
-
 /**
 * Константы, определяющие типы налогообложения
 *
@ -55,6 +53,6 @@ final class SnoTypes extends Enum
     */
    public static function getFfdTags(): array
    {
-        return [Ffd105Tags::COMPANY_SNO];
+        return [1055];
    }
 }
--- a/src/Enums/VatTypes.php
+++ b/src/Enums/VatTypes.php
@ -11,10 +11,12 @@ declare(strict_types = 1);

 namespace AtolOnline\Enums;

-use AtolOnline\Constants\Ffd105Tags;
+use MyCLabs\Enum\Enum;

 /**
 * Константы, определяющие типы ставок НДС
+ *
+ * Теги ФФД: 1199, 1105, 1104, 1103, 1102, 1107, 1106
 */
 final class VatTypes extends Enum
 {
@ -57,20 +59,4 @@ final class VatTypes extends Enum
     * НДС 20/120%
     */
    const VAT120 = 'vat120';
-
-    /**
-     * @inheritDoc
-     */
-    public static function getFfdTags(): array
-    {
-        return [
-            Ffd105Tags::ITEM_VAT_TYPE,
-            Ffd105Tags::DOC_VAT_TYPE_NONE,
-            Ffd105Tags::DOC_VAT_TYPE_VAT0,
-            Ffd105Tags::DOC_VAT_TYPE_VAT10,
-            Ffd105Tags::DOC_VAT_TYPE_VAT20,
-            Ffd105Tags::DOC_VAT_TYPE_VAT110,
-            Ffd105Tags::DOC_VAT_TYPE_VAT120,
-        ];
-    }
 }
--- a/src/Exceptions/NegativeItemExciseException.php
+++ b/src/Exceptions/NegativeItemExciseException.php
@ -1,33 +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\Exceptions;
-
-use AtolOnline\Constants\Ffd105Tags;
-
-/**
- * Исключение, возникающее при попытке указать предмету расчёта отрицательный акциз
- */
-class NegativeItemExciseException extends AtolException
-{
-    protected array $ffd_tags = [Ffd105Tags::ITEM_EXCISE];
-
-    /**
-     * Конструктор
-     *
-     * @param string $name
-     * @param float $excise
-     */
-    public function __construct(string $name, float $excise)
-    {
-        parent::__construct("Предмет расчёта '$name' не может иметь отрицательный акциз $excise");
-    }
-}
--- a/tests/AtolOnline/Tests/Entities/ItemTest.php
+++ b/tests/AtolOnline/Tests/Entities/ItemTest.php
@ -28,7 +28,6 @@ use AtolOnline\{
    Exceptions\InvalidInnLengthException,
    Exceptions\InvalidOKSMCodeException,
    Exceptions\InvalidPhoneException,
-    Exceptions\NegativeItemExciseException,
    Exceptions\NegativeItemPriceException,
    Exceptions\NegativeItemQuantityException,
    Exceptions\TooHighItemQuantityException,
@ -391,16 +390,15 @@ class ItemTest extends BasicTestCase
     *
     * @param mixed $vat
     * @dataProvider providerNullableStrings
-     * @covers       \AtolOnline\Entities\Item::setVat
-     * @covers       \AtolOnline\Entities\Item::getVat
-     * @covers       \AtolOnline\Entities\Item::jsonSerialize
+     * @covers \AtolOnline\Entities\Item::setVat
+     * @covers \AtolOnline\Entities\Item::getVat
+     * @covers \AtolOnline\Entities\Item::jsonSerialize
     * @throws EmptyItemNameException
     * @throws NegativeItemPriceException
     * @throws NegativeItemQuantityException
     * @throws TooHighPriceException
     * @throws TooLongItemNameException
     * @throws TooManyException
-     * @throws InvalidEnumValueException
     */
    public function testNullableVatByString(mixed $vat): void
    {
@ -658,52 +656,4 @@ class ItemTest extends BasicTestCase
        (new Item('test item', 2, 3))
            ->setDeclarationNumber(Helpers::randomStr(Constraints::MAX_LENGTH_DECLARATION_NUMBER + 1));
    }
-
-    /**
-     * Тестирует установку акциза и расчёт суммы с его учётом
-     *
-     * @covers \AtolOnline\Entities\Item::setExcise
-     * @covers \AtolOnline\Entities\Item::getExcise
-     * @covers \AtolOnline\Entities\Item::getSum
-     * @covers \AtolOnline\Entities\Item::jsonSerialize
-     * @throws TooLongItemNameException
-     * @throws TooHighPriceException
-     * @throws TooManyException
-     * @throws NegativeItemPriceException
-     * @throws EmptyItemNameException
-     * @throws NegativeItemQuantityException
-     * @throws NegativeItemExciseException
-     */
-    public function testExcise(): void
-    {
-        $this->assertAtolable(
-            (new Item('test item', 2, 3))->setExcise(1),
-            [
-                'name' => 'test item',
-                'price' => 2,
-                'quantity' => 3,
-                'sum' => 7,
-                'excise' => 1,
-            ]
-        );
-    }
-
-    /**
-     * Тестирует установку акциза и расчёт суммы с его учётом
-     *
-     * @covers \AtolOnline\Entities\Item::setExcise
-     * @covers \AtolOnline\Exceptions\NegativeItemExciseException
-     * @throws TooLongItemNameException
-     * @throws TooHighPriceException
-     * @throws TooManyException
-     * @throws NegativeItemPriceException
-     * @throws EmptyItemNameException
-     * @throws NegativeItemQuantityException
-     * @throws NegativeItemExciseException
-     */
-    public function testNegativeItemExciseException(): void
-    {
-        $this->expectException(NegativeItemExciseException::class);
-        (new Item('test item', 2, 3))->setExcise(-1);
-    }
 }