Merge branch 'YP-1173_dobavit_pole_details_v_dokumentacziyu_i_php-api-client' into 'main'

Added field "details"

See merge request ypmn-public/php-api-client!11

Author: payuru

src/Details.php

@@ -56,7 +56,7 @@ public function toArray(): array
 
         if (is_string($this->getReceipts())) {
             $array += [
-                'receipts' => $this->getReceipts()
+                'receipts' => json_decode($this->getReceipts())
             ];
         } else {
             $array += ['receipts' => []];

src/Examples/getPaymentLink.php

@@ -14,6 +14,7 @@
 use Ypmn\PaymentPageOptions;
 use Ypmn\Product;
 use Ypmn\Std;
+use Ypmn\Details;
 
 // Подключим файл, в котором заданы параметры мерчанта
 include_once 'start.php';
@@ -72,6 +73,69 @@
 $delivery->setIdentityDocument(
     new IdentityDocument(123456, 'PERSONALID')
 );
+
+// (необязательно) Опишем поля для чеков
+$details = new Details;
+$details->setReceipts(<<<DETAILS
+[
+    {
+        "merchantCode": "{$merchant->getCode()}",
+        "receipt": {
+            "client": {
+                "email": "sales@romashka.ru"
+            },
+            "company": {
+                "email": "chek@romashka.ru",
+                "sno": "osn",
+                "inn": "1234567890",
+                "payment_address": "https://v4.online.atol.ru"
+            },
+            "items": [
+                {
+                    "name": "колбаса Клинский Брауншвейгская с/к в/с ",
+                    "price": 1000.00,
+                    "quantity": 0.3,
+                    "sum": 300.00,
+                    "measurement_unit": "кг",
+                    "payment_method": "full_payment",
+                    "payment_object": "commodity",
+                    "vat": {
+                        "type": "vat120"
+                    }
+                },
+                {
+                    "name": "яйцо Окское куриное С0 белое",
+                    "price": 100.00,
+                    "quantity": 1.0,
+                    "sum": 100.00,
+                    "measurement_unit": "Упаковка 10 шт.",
+                    "payment_method": "full_payment",
+                    "payment_object": "commodity",
+                    "vat": {
+                        "type": "vat120"
+                    }
+                }
+            ],
+            "payments": [
+                {
+                    "type": 1,
+                    "sum": 400.0
+                }
+            ],
+            "vats": [
+                {
+                    "type": "vat120"
+                },
+                {
+                    "type": "vat120"
+                }
+            ],
+            "total": 400.0
+        }
+    }
+]
+DETAILS);
+
 // Установим Код страны
 $delivery->setCountryCode('RU');
 // Установим Город
@@ -113,6 +177,8 @@
 $payment->addProduct($product2);
 // Установим валюту
 $payment->setCurrency('RUB');
+// Установим дополнительные поля
+$payment->setDetails($details);
 
 // Создадим запрос на  авторизацию платежа
 // Здесь первым параметром можно передать конкретный способ оплаты из справочника