[2026-04-16] - Sync content (24501328830) (#46)

> [!NOTE]
> This PR copies content from the source repo.
> Source repo commit
[b782410](shoptet/cms4@b782410)

**List of changes:**
- Introduction of new valueObject `TypeVatRateNullable` in the reqquest
body of `updatePricelist` endpoint

Co-authored-by: havlicekl <82386873+havlicekl@users.noreply.github.com>

Author: shoptet-deploy

init.php

@@ -342,6 +342,7 @@
 require_once __DIR__ . '/src/Component/ValueObject/TypeUnitRatio.php';
 require_once __DIR__ . '/src/Component/ValueObject/TypeVariantCodeRequest.php';
 require_once __DIR__ . '/src/Component/ValueObject/TypeVatRate.php';
+require_once __DIR__ . '/src/Component/ValueObject/TypeVatRateNullable.php';
 require_once __DIR__ . '/src/Component/ValueObject/TypeWeight.php';
 require_once __DIR__ . '/src/Component/ValueObject/TypeWeightRequest.php';
 require_once __DIR__ . '/src/Component/ValueObject/TypeWeightUnlimited.php';

src/Component/ValueObject/TypeVatRateNullable.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Shoptet\Api\Sdk\Php\Component\ValueObject;
+
+use Shoptet\Api\Sdk\Php\Exception\InvalidArgumentException;
+
+readonly class TypeVatRateNullable implements ValueObjectInterface
+{
+    public function __construct(
+        public ?string $typeVatRateNullable,
+    ) {
+        if ($this->typeVatRateNullable === null) {
+            return;
+        }
+        if (!preg_match('/^[0-9]+\.[0-9]{2}$/', $this->typeVatRateNullable)) {
+            throw new InvalidArgumentException(sprintf('Invalid %s "%s".', 'typeVatRateNullable', $this->typeVatRateNullable));
+        }
+    }
+
+    public function equals(self $typeVatRateNullable): bool
+    {
+        return $typeVatRateNullable->typeVatRateNullable === $this->typeVatRateNullable;
+    }
+
+    public function __toString(): string
+    {
+        return (string) $this->typeVatRateNullable;
+    }
+
+    public function jsonSerialize(): string
+    {
+        return $this->__toString();
+    }
+}

src/Endpoint/PriceLists/UpdatePricelistRequest/UpdatePricelistRequest/Data/Item.php

@@ -3,7 +3,7 @@
 namespace Shoptet\Api\Sdk\Php\Endpoint\PriceLists\UpdatePricelistRequest\UpdatePricelistRequest\Data;
 
 use Shoptet\Api\Sdk\Php\Component\Entity\Entity;
-use Shoptet\Api\Sdk\Php\Component\ValueObject\TypePriceNullable;
+use Shoptet\Api\Sdk\Php\Component\ValueObject\TypeVatRateNullable;
 use Shoptet\Api\Sdk\Php\Endpoint\PriceLists\UpdatePricelistRequest\UpdatePricelistRequest\Data\Item\OrderableAmount;
 use Shoptet\Api\Sdk\Php\Endpoint\PriceLists\UpdatePricelistRequest\UpdatePricelistRequest\Data\Item\Price;
 use Shoptet\Api\Sdk\Php\Endpoint\PriceLists\UpdatePricelistRequest\UpdatePricelistRequest\Data\Item\PriceWithVat;
@@ -15,7 +15,7 @@ class Item extends Entity
 {
     protected string $code;
     protected ?string $currencyCode;
-    protected ?TypePriceNullable $vatRate;
+    protected ?TypeVatRateNullable $vatRate;
     protected ?bool $includingVat;
     protected ?OrderableAmount $orderableAmount;
     protected ?Sales $sales;
@@ -46,12 +46,12 @@ public function setCurrencyCode(?string $currencyCode): static
         return $this;
     }
 
-    public function getVatRate(): ?TypePriceNullable
+    public function getVatRate(): ?TypeVatRateNullable
     {
         return $this->vatRate;
     }
 
-    public function setVatRate(?TypePriceNullable $vatRate): static
+    public function setVatRate(?TypeVatRateNullable $vatRate): static
     {
         $this->vatRate = $vatRate;
         return $this;

src/Endpoint/PriceLists/UpdatePricelistRequest/UpdatePricelistRequest/Data/Item/Prices/PurchasePrice.php

@@ -4,11 +4,12 @@
 
 use Shoptet\Api\Sdk\Php\Component\Entity\Entity;
 use Shoptet\Api\Sdk\Php\Component\ValueObject\TypePriceNullable;
+use Shoptet\Api\Sdk\Php\Component\ValueObject\TypeVatRateNullable;
 
 class PurchasePrice extends Entity
 {
     protected ?TypePriceNullable $price;
-    protected ?TypePriceNullable $vatRate;
+    protected ?TypeVatRateNullable $vatRate;
     protected ?bool $includingVat;
 
     public function getPrice(): ?TypePriceNullable
@@ -22,12 +23,12 @@ public function setPrice(?TypePriceNullable $price): static
         return $this;
     }
 
-    public function getVatRate(): ?TypePriceNullable
+    public function getVatRate(): ?TypeVatRateNullable
     {
         return $this->vatRate;
     }
 
-    public function setVatRate(?TypePriceNullable $vatRate): static
+    public function setVatRate(?TypeVatRateNullable $vatRate): static
     {
         $this->vatRate = $vatRate;
         return $this;