Класс Supplier обзавёлся name + inn и допокрыт тестами

src/Entities/Supplier.php

@@ -12,6 +12,7 @@ declare(strict_types = 1);
 namespace AtolOnline\Entities;
 
 use AtolOnline\Constants\Constraints;
+use AtolOnline\Exceptions\InvalidInnLengthException;
 use AtolOnline\Exceptions\InvalidPhoneException;
 use Illuminate\Support\Collection;
 
@@ -23,22 +24,62 @@ use Illuminate\Support\Collection;
 class Supplier extends Entity
 {
     /**
-     * @var Collection Телефоны платёжного агента (1073)
+     * @var string|null Наименование (1225)
+     */
+    protected ?string $name = null;
+
+    /**
+     * @var string|null ИНН (1226)
+     */
+    protected ?string $inn = null;
+
+    /**
+     * @var Collection Телефоны (1171)
      */
     protected Collection $phones;
 
     /**
      * Конструктор
      *
-     * @param array|Collection|null $phones Телефон оператора по приёму платежей (1074)
+     * @param string|null $name Наименование поставщика (1225)
+     * @param string|null $inn ИНН (1226)
+     * @param array|Collection|null $phones Телефоны поставщика (1171)
+     * @throws InvalidInnLengthException
      * @throws InvalidPhoneException
      */
     public function __construct(
+        ?string $name = null,
+        ?string $inn = null,
         array|Collection|null $phones = null,
     ) {
+        !is_null($name) && $this->setName($name);
+        !is_null($inn) && $this->setInn($inn);
         $this->setPhones($phones);
     }
 
+    /**
+     * Возвращает установленное наименование поставщика
+     *
+     * @return string|null
+     */
+    public function getName(): ?string
+    {
+        return $this->name;
+    }
+
+    /**
+     * Устанавливает наименование поставщика
+     *
+     * @param string|null $name
+     * @return Supplier
+     */
+    public function setName(?string $name): self
+    {
+        // критерии к длине строки не описаны ни в схеме, ни в документации
+        $this->name = trim($name) ?: null;
+        return $this;
+    }
+
     /**
      * Возвращает установленные номера телефонов
      *
@@ -73,12 +114,43 @@ class Supplier extends Entity
         return $this;
     }
 
+    /**
+     * Возвращает установленный ИНН
+     *
+     * @return string|null
+     */
+    public function getInn(): ?string
+    {
+        return $this->inn;
+    }
+
+    /**
+     * Устанавливает ИНН
+     *
+     * @param string|null $inn
+     * @return $this
+     * @throws InvalidInnLengthException Некорректная длина ИНН
+     */
+    public function setInn(?string $inn): self
+    {
+        if (is_string($inn)) {
+            $inn = preg_replace('/[^\d]/', '', trim($inn));
+            if (preg_match_all(Constraints::PATTERN_INN, $inn) === 0) {
+                throw new InvalidInnLengthException($inn);
+            }
+        }
+        $this->inn = empty($inn) ? null : $inn;
+        return $this;
+    }
+
     /**
      * @inheritDoc
      */
     public function jsonSerialize(): array
     {
         $json = [];
+        $this->getName() && $json['name'] = $this->getName();
+        $this->getInn() && $json['inn'] = $this->getInn();
         !$this->getPhones()->isEmpty() && $json['phones'] = $this->getPhones()->toArray();
         return $json;
     }