Проброс external_id на регистрацию документа

Убрал схему Атола валидации количества НДС, оплат и предметов
Удалена перезапись компании в тестовом режиме. Новый метод Kkt::setAuthToken()
2020-06-01 04:12:23 +08:00 · 2020-06-01 03:58:31 +08:00 · 2020-06-01 03:26:25 +08:00 · 2020-05-30 04:29:44 +08:00 · 2020-05-30 03:45:06 +08:00 · 2020-05-30 01:59:24 +08:00
5 changed files with 80 additions and 48 deletions
--- a/src/AtolOnline/Api/Kkt.php
+++ b/src/AtolOnline/Api/Kkt.php
@@ -172,7 +172,7 @@ class Kkt extends Client
     */
    public function setCallbackUrl(string $url)
    {
-        $this->kkt_config['prod']['callback_url'] = $url;
+        $this->kkt_config[$this->isTestMode() ? 'test' : 'prod']['callback_url'] = $url;
        return $this;
    }
    
@@ -222,104 +222,115 @@ class Kkt extends Client
     * Регистрирует документ прихода
     *
     * @param \AtolOnline\Entities\Document $document
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе есть данные коррекции
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    public function sell(Document $document)
+    public function sell(Document $document, ?string $external_id = null)
    {
        if ($document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException('Некорректная операция над документом коррекции');
        }
-        return $this->registerDocument('sell', 'receipt', $document);
+        return $this->registerDocument('sell', 'receipt', $document, $external_id);
    }
    
    /**
     * Регистрирует документ возврата прихода
     *
     * @param \AtolOnline\Entities\Document $document
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolPriceTooHighException Слишком большая сумма
     * @throws \AtolOnline\Exceptions\AtolTooManyVatsException Слишком много ставок НДС
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе есть данные коррекции
     */
-    public function sellRefund(Document $document)
+    public function sellRefund(Document $document, ?string $external_id = null)
    {
        if ($document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException('Некорректная операция над документом коррекции');
        }
-        return $this->registerDocument('sell_refund', 'receipt', $document->clearVats());
+        return $this->registerDocument('sell_refund', 'receipt', $document->clearVats(), $external_id);
    }
    
    /**
     * Регистрирует документ коррекции прихода
     *
     * @param \AtolOnline\Entities\Document $document
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе отсутствуют данные коррекции
     * @throws \AtolOnline\Exceptions\AtolTooManyItemsException Слишком много предметов расчёта
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    public function sellCorrection(Document $document)
+    public function sellCorrection(Document $document, ?string $external_id = null)
    {
        if (!$document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException();
        }
        $document->setClient(null)->setItems([]);
-        return $this->registerDocument('sell_correction', 'correction', $document);
+        return $this->registerDocument('sell_correction', 'correction', $document, $external_id);
    }
    
    /**
     * Регистрирует документ расхода
     *
     * @param \AtolOnline\Entities\Document $document
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе есть данные коррекции
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    public function buy(Document $document)
+    public function buy(Document $document, ?string $external_id = null)
    {
        if ($document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException('Некорректная операция над документом коррекции');
        }
-        return $this->registerDocument('buy', 'receipt', $document);
+        return $this->registerDocument('buy', 'receipt', $document, $external_id);
    }
    
    /**
     * Регистрирует документ возврата расхода
     *
     * @param \AtolOnline\Entities\Document $document
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolPriceTooHighException Слишком большая сумма
     * @throws \AtolOnline\Exceptions\AtolTooManyVatsException Слишком много ставок НДС
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе есть данные коррекции
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    public function buyRefund(Document $document)
+    public function buyRefund(Document $document, ?string $external_id = null)
    {
        if ($document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException('Некорректная операция над документом коррекции');
        }
-        return $this->registerDocument('buy_refund', 'receipt', $document->clearVats());
+        return $this->registerDocument('buy_refund', 'receipt', $document->clearVats(), $external_id);
    }
    
    /**
     * Регистрирует документ коррекции расхода
     *
-     * @param Document $document
+     * @param Document    $document
+     * @param string|null $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
     * @throws \AtolOnline\Exceptions\AtolCorrectionInfoException В документе отсутствуют данные коррекции
     * @throws \AtolOnline\Exceptions\AtolTooManyItemsException Слишком много предметов расчёта
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    public function buyCorrection(Document $document)
+    public function buyCorrection(Document $document, ?string $external_id = null)
    {
        if (!$document->getCorrectionInfo()) {
            throw new AtolCorrectionInfoException();
        }
        $document->setClient(null)->setItems([]);
-        return $this->registerDocument('buy_correction', 'correction', $document);
+        return $this->registerDocument('buy_correction', 'correction', $document, $external_id);
    }
    
    /**
@@ -364,6 +375,28 @@ class Kkt extends Client
        return $response;
    }
    
+    /**
+     * Возвращает текущий токен авторизации
+     *
+     * @return string
+     */
+    public function getAuthToken(): ?string
+    {
+        return $this->auth_token;
+    }
+    
+    /**
+     * Устанавливает заранее известный токен авторизации
+     *
+     * @param string|null $auth_token
+     * @return $this
+     */
+    public function setAuthToken(?string $auth_token)
+    {
+        $this->auth_token = $auth_token;
+        return $this;
+    }
+    
    /**
     * Сбрасывает настройки ККТ по умолчанию
     */
@@ -390,7 +423,7 @@ class Kkt extends Client
    {
        $headers['Content-type'] = 'application/json; charset=utf-8';
        if ($this->getAuthToken()) {
-            $headers['Token'] = $this->auth_token;
+            $headers['Token'] = $this->getAuthToken();
        }
        return $headers;
    }
@@ -429,6 +462,7 @@ class Kkt extends Client
     * @param mixed      $data        Данные для передачи
     * @param array|null $options     Параметры Guzzle
     * @return \AtolOnline\Api\KktResponse
+     * @throws \GuzzleHttp\Exception\GuzzleException
     * @see https://guzzle.readthedocs.io/en/latest/request-options.html
     */
    protected function sendAtolRequest(string $http_method, string $api_method, $data = null, array $options = null)
@@ -449,6 +483,7 @@ class Kkt extends Client
     * Производит авторизацию на ККТ и получает токен доступа для дальнейших HTTP-запросов
     *
     * @return bool
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
    protected function auth()
    {
@@ -468,36 +503,27 @@ class Kkt extends Client
    /**
     * Отправляет документ на регистрацию
     *
-     * @param string                        $api_method Метод API
-     * @param string                        $type       Тип документа: receipt, correction
-     * @param \AtolOnline\Entities\Document $document   Объект документа
+     * @param string                        $api_method  Метод API
+     * @param string                        $type        Тип документа: receipt, correction
+     * @param \AtolOnline\Entities\Document $document    Объект документа
+     * @param string|null                   $external_id Уникальный код документа (если не указан, то будет создан UUID)
     * @return \AtolOnline\Api\KktResponse
-     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException Некорректный тип документа
-     * @throws \Exception
+     * @throws \AtolOnline\Exceptions\AtolWrongDocumentTypeException
+     * @throws \GuzzleHttp\Exception\GuzzleException
     */
-    protected function registerDocument(string $api_method, string $type, Document $document)
+    protected function registerDocument(string $api_method, string $type, Document $document, ?string $external_id = null)
    {
        $type = trim($type);
        if (!in_array($type, ['receipt', 'correction'])) {
            throw new AtolWrongDocumentTypeException($type);
        }
        $this->auth();
-        $data = [
-            'timestamp' => date('d.m.y H:i:s'),
-            'external_id' => Uuid::uuid4()->toString(),
-            'service' => ['callback_url' => $this->getCallbackUrl()],
-            $type => $document,
-        ];
+        $data['timestamp'] = date('d.m.y H:i:s');
+        $data['external_id'] = $external_id ?: Uuid::uuid4()->toString();
+        $data[$type] = $document;
+        if ($this->getCallbackUrl()) {
+            $data['service'] = ['callback_url' => $this->getCallbackUrl()];
+        }
        return $this->sendAtolRequest('POST', trim($api_method), $data);
    }
-    
-    /**
-     * Возвращает текущий токен авторизации
-     *
-     * @return string
-     */
-    protected function getAuthToken()
-    {
-        return $this->auth_token;
-    }
 }
--- a/src/AtolOnline/Entities/Document.php
+++ b/src/AtolOnline/Entities/Document.php
@@ -405,7 +405,7 @@ class Document extends Entity
            $json['company'] = $this->getCompany()->jsonSerialize(); // обязательно
        }
        if ($this->getPayments()) {
-            $json['payments'] = $this->getPayments()->jsonSerialize(); // обязательно
+            $json['payments'] = $this->payments->jsonSerialize(); // обязательно
        }
        if ($this->getCashier()) {
            $json['cashier'] = $this->getCashier();
@@ -417,7 +417,7 @@ class Document extends Entity
                $json['client'] = $this->getClient()->jsonSerialize(); // обязательно для некоррекционных
            }
            if ($this->getItems()) {
-                $json['items'] = $this->getItems()->jsonSerialize(); // обязательно для некоррекционных
+                $json['items'] = $this->items->jsonSerialize(); // обязательно для некоррекционных
            }
            $json['total'] = $this->calcTotal(); // обязательно для некоррекционных
        }
--- a/src/AtolOnline/Entities/ItemArray.php
+++ b/src/AtolOnline/Entities/ItemArray.php
@@ -106,7 +106,7 @@ class ItemArray extends Entity
    protected function validateCount(?array $items = null): bool
    {
        if ((!empty($items) && count($items) >= self::MAX_COUNT) || count($this->items) >= self::MAX_COUNT) {
-            throw new AtolTooManyItemsException(self::MAX_COUNT);
+            throw new AtolTooManyItemsException(count($items), self::MAX_COUNT);
        }
        return true;
    }
--- a/src/AtolOnline/Entities/PaymentArray.php
+++ b/src/AtolOnline/Entities/PaymentArray.php
@@ -9,7 +9,6 @@

 namespace AtolOnline\Entities;

-use AtolOnline\Api\SellSchema;
 use AtolOnline\Exceptions\AtolTooManyPaymentsException;

 /**
@@ -19,6 +18,11 @@ use AtolOnline\Exceptions\AtolTooManyPaymentsException;
 */
 class PaymentArray extends Entity
 {
+    /**
+     * Максимальное количество элементов массива
+     */
+    public const MAX_COUNT = 10;
+    
    /**
     * @var Payment[] Массив оплат
     */
@@ -99,9 +103,8 @@ class PaymentArray extends Entity
     */
    protected function validateCount(?array $payments = null): bool
    {
-        $max_items = SellSchema::get()->properties->receipt->properties->payments->maxItems;
-        if ((!empty($payments) && count($payments) >= $max_items) || count($this->payments) >= $max_items) {
-            throw new AtolTooManyPaymentsException($max_items);
+        if ((!empty($payments) && count($payments) >= self::MAX_COUNT) || count($this->payments) >= self::MAX_COUNT) {
+            throw new AtolTooManyPaymentsException(count($payments), self::MAX_COUNT);
        }
        return true;
    }
--- a/src/AtolOnline/Entities/VatArray.php
+++ b/src/AtolOnline/Entities/VatArray.php
@@ -9,7 +9,6 @@

 namespace AtolOnline\Entities;

-use AtolOnline\Api\SellSchema;
 use AtolOnline\Exceptions\AtolTooManyVatsException;

 /**
@@ -19,6 +18,11 @@ use AtolOnline\Exceptions\AtolTooManyVatsException;
 */
 class VatArray extends Entity
 {
+    /**
+     * Максимальное количество элементов массива
+     */
+    public const MAX_COUNT = 6;
+    
    /**
     * @var Vat[] Массив ставок НДС
     */
@@ -103,9 +107,8 @@ class VatArray extends Entity
     */
    protected function validateCount(?array $vats = null): bool
    {
-        $max_items = SellSchema::get()->properties->receipt->properties->vats->maxItems;
-        if ((!empty($vats) && count($vats) >= $max_items) || count($this->vats) >= $max_items) {
-            throw new AtolTooManyVatsException(count($vats), $max_items);
+        if ((!empty($vats) && count($vats) >= self::MAX_COUNT) || count($this->vats) >= self::MAX_COUNT) {
+            throw new AtolTooManyVatsException(count($vats), self::MAX_COUNT);
        }
        return true;
    }
Author	SHA1	Message	Date
AnthonyAxenov	c14b680be4	Проброс external_id на регистрацию документа	2020-06-01 04:12:23 +08:00
AnthonyAxenov	7558cb6638	Убрал схему Атола валидации количества НДС, оплат и предметов	2020-06-01 03:58:31 +08:00
AnthonyAxenov	d3fe2cba9a	Удалена перезапись компании в тестовом режиме. Новый метод Kkt::setAuthToken()	2020-06-01 03:26:25 +08:00
AnthonyAxenov	e70a65fa44	Улучшен метод Kkt::registerDocument + теперь принимает любой собственного external_id, если пусто - сгенерирует uuid * исправлен недостаток полей компании в тестовом режиме * уточнения phpdoc	2020-05-30 04:29:44 +08:00
AnthonyAxenov	ba5166f2cf	Метод Kkt::getAuthToken() теперь открыт	2020-05-30 03:45:06 +08:00
AnthonyAxenov	93f5186b15	Перезапись компании в документе при тестовом режиме	2020-05-30 01:59:24 +08:00
AnthonyAxenov	f2b4952aa5	Установка адреса callback для тестового режима	2020-05-30 01:59:24 +08:00
AnthonyAxenov	7899daf421	Снова фикс ошибок при приведении документа к json-строке	2020-05-30 01:59:23 +08:00