Большие доработки по фискилизации

- у `AtolClient` теперь возможно получить последний отправленный запрос `getLastRequest()` - у `AtolClient::auth()` удалены аргументы за ненадобностью - улучшен `Client::jsonSerialize()` - исправлен `Receipt::jsonSerialize()` - у `Receipt` и `Correction` появились методы фискализации, вкусный сахарок - удалён енам `DocumentTypes` за ненадобностью - исправлены тесты монитора и документов - рабочий фискализатор с получением результатов и покрытием
2021-12-18 14:45:00 +08:00
parent b4cc0fec53
commit 71d1f2900c
33 changed files with 969 additions and 336 deletions
--- a/src/Entities/Client.php
+++ b/src/Entities/Client.php
@@ -132,10 +132,10 @@ final class Client extends Entity
    public function jsonSerialize(): array
    {
        $json = [];
-        $this->getName() && $json['name'] = $this->getName();
-        $this->getEmail() && $json['email'] = $this->getEmail();
-        $this->getPhone() && $json['phone'] = $this->getPhone();
-        $this->getInn() && $json['inn'] = $this->getInn();
+        !is_null($this->getName()) && $json['name'] = $this->getName();
+        !is_null($this->getEmail()) && $json['email'] = $this->getEmail();
+        !is_null($this->getPhone()) && $json['phone'] = $this->getPhone();
+        !is_null($this->getInn()) && $json['inn'] = $this->getInn();
        return $json;
    }
 }
--- a/src/Entities/Correction.php
+++ b/src/Entities/Correction.php
@@ -10,13 +10,22 @@
 namespace AtolOnline\Entities;

 use AtolOnline\{
+    Api\KktFiscalizer,
+    Api\KktResponse,
    Collections\Payments,
    Collections\Vats,
    Constants\Constraints};
 use AtolOnline\Exceptions\{
+    AuthFailedException,
+    EmptyLoginException,
+    EmptyPasswordException,
    InvalidEntityInCollectionException,
-    TooLongCashierException};
+    InvalidInnLengthException,
+    InvalidPaymentAddressException,
+    TooLongCashierException,
+    TooLongPaymentAddressException};
 use Exception;
+use GuzzleHttp\Exception\GuzzleException;
 use JetBrains\PhpStorm\ArrayShape;

 /**
@@ -26,6 +35,11 @@ use JetBrains\PhpStorm\ArrayShape;
 */
 class Correction extends Entity
 {
+    /**
+     * Тип документа
+     */
+    public const DOC_TYPE = 'correction';
+
    /**
     * @var Company Продавец
     */
@@ -194,6 +208,46 @@ class Correction extends Entity
        return $this;
    }

+    /**
+     * Регистрирует коррекцию прихода по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function sellCorrect(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->sellCorrect($this, $external_id);
+    }
+
+    /**
+     * Регистрирует коррекцию расхода по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function buyCorrect(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->buyCorrect($this, $external_id);
+    }
+
    /**
     * @inheritDoc
     * @throws InvalidEntityInCollectionException
--- a/src/Entities/Entity.php
+++ b/src/Entities/Entity.php
@@ -16,6 +16,7 @@ namespace AtolOnline\Entities;
 use ArrayAccess;
 use BadMethodCallException;
 use Illuminate\Contracts\Support\Arrayable;
+use JetBrains\PhpStorm\ArrayShape;
 use JsonSerializable;
 use Stringable;

@@ -32,6 +33,13 @@ abstract class Entity implements JsonSerializable, Stringable, Arrayable, ArrayA
    /**
     * @inheritDoc
     */
+    #[ArrayShape([
+        'company' => "\AtolOnline\Entities\Company",
+        'correction_info' => "\AtolOnline\Entities\CorrectionInfo",
+        'payments' => "array",
+        'vats' => "\AtolOnline\Collections\Vats|null",
+        'cashier' => "\null|string"
+    ])]
    public function toArray()
    {
        return $this->jsonSerialize();
--- a/src/Entities/Receipt.php
+++ b/src/Entities/Receipt.php
@@ -11,15 +11,24 @@ declare(strict_types = 1);

 namespace AtolOnline\Entities;

+use AtolOnline\Api\KktFiscalizer;
+use AtolOnline\Api\KktResponse;
 use AtolOnline\Collections\Items;
 use AtolOnline\Collections\Payments;
 use AtolOnline\Collections\Vats;
 use AtolOnline\Constants\Constraints;
+use AtolOnline\Exceptions\AuthFailedException;
 use AtolOnline\Exceptions\EmptyItemsException;
+use AtolOnline\Exceptions\EmptyLoginException;
+use AtolOnline\Exceptions\EmptyPasswordException;
 use AtolOnline\Exceptions\InvalidEntityInCollectionException;
+use AtolOnline\Exceptions\InvalidInnLengthException;
+use AtolOnline\Exceptions\InvalidPaymentAddressException;
 use AtolOnline\Exceptions\TooLongAddCheckPropException;
 use AtolOnline\Exceptions\TooLongCashierException;
+use AtolOnline\Exceptions\TooLongPaymentAddressException;
 use Exception;
+use GuzzleHttp\Exception\GuzzleException;

 /**
 * Класс, описывающий документ прихода, расхода, возврата прихода, возврата расхода
@@ -28,6 +37,11 @@ use Exception;
 */
 final class Receipt extends Entity
 {
+    /**
+     * Тип документа
+     */
+    public const DOC_TYPE = 'receipt';
+
    /**
     * @var Client Покупатель
     */
@@ -360,6 +374,86 @@ final class Receipt extends Entity
        return $this;
    }

+    /**
+     * Регистрирует приход по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function sell(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->sell($this, $external_id);
+    }
+
+    /**
+     * Регистрирует возврат прихода по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function sellRefund(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->sellRefund($this, $external_id);
+    }
+
+    /**
+     * Регистрирует расход по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function buy(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->buy($this, $external_id);
+    }
+
+    /**
+     * Регистрирует возврат расхода по текущему документу
+     *
+     * @param KktFiscalizer $fiscalizer Объект фискализатора
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан новый UUID)
+     * @return KktResponse|null
+     * @throws AuthFailedException
+     * @throws EmptyLoginException
+     * @throws EmptyPasswordException
+     * @throws GuzzleException
+     * @throws InvalidEntityInCollectionException
+     * @throws InvalidInnLengthException
+     * @throws InvalidPaymentAddressException
+     * @throws TooLongPaymentAddressException
+     */
+    public function buyRefund(KktFiscalizer $fiscalizer, ?string $external_id = null): ?KktResponse
+    {
+        return $fiscalizer->buyRefund($this, $external_id);
+    }
+
    /**
     * Возвращает массив для кодирования в json
     *
@@ -368,18 +462,19 @@ final class Receipt extends Entity
    public function jsonSerialize(): array
    {
        $json = [
-            'client' => $this->getClient(),
-            'company' => $this->getCompany(),
+            'client' => $this->getClient()->jsonSerialize(),
+            'company' => $this->getCompany()->jsonSerialize(),
            'items' => $this->getItems()->jsonSerialize(),
            'total' => $this->getTotal(),
            'payments' => $this->getPayments()->jsonSerialize(),
        ];
-        $this->getAgentInfo()?->jsonSerialize() && $json['agent_info'] = $this->getAgentInfo();
-        $this->getSupplier()?->jsonSerialize() && $json['supplier_info'] = $this->getSupplier();
+        $this->getAgentInfo()?->jsonSerialize() && $json['agent_info'] = $this->getAgentInfo()->jsonSerialize();
+        $this->getSupplier()?->jsonSerialize() && $json['supplier_info'] = $this->getSupplier()->jsonSerialize();
        $this->getVats()?->isNotEmpty() && $json['vats'] = $this->getVats();
        !is_null($this->getAddCheckProps()) && $json['additional_check_props'] = $this->getAddCheckProps();
        !is_null($this->getCashier()) && $json['cashier'] = $this->getCashier();
-        $this->getAddUserProps()?->jsonSerialize() && $json['additional_user_props'] = $this->getAddUserProps();
+        $this->getAddUserProps()?->jsonSerialize() &&
+        $json['additional_user_props'] = $this->getAddUserProps()->jsonSerialize();
        return $json;
    }
 }