Update README.md

README.md

-# Triada_Site_Bx24
+# Интеграция формы сайта с Битрикс24 
 
+Интеграция формы сайта в Битрикс24 для учета заказов в Лидах с добавлением товаров которых нет в Битрикс24
+
+#### Шаги действия:
+ 1. Создать продукт и получения ID продукта(ов)
+ 2. Создать лид и получения ID лида
+ 3. Прикрепить продукты в виде массива с их ID указав ID лида в запросе
+
+## 1. Создание продукта в Bitrix24
+
+Для создания продукта в Битрикс24 нужно в rest метод передать параметры продукта в переменном `fields`:
+- при необходимости можно указать раздел для продукта в каталоге товаров Битрикса в переменном `iblockSectionId`
+- кроме этого можно передавать значения пользовательских полей если это нужно в полях типа `property<ID поля>`, например `property123` - где 123 - это ID пользовательского поля в Битрикс24.
+
+### catalog.product.add
+
+`Method` : POST
+`URL` : `https://triada.sedo.uz/rest/2/umd00zwy1noiupw4/catalog.product.add.json`
+
+`Params` : 
+```js
+{
+    "fields": {
+        "active":"Y",
+		"canBuyZero":"Y",
+		"code":"t-shirt", // короткий код товара (только на латынице и уникальный)
+		"createdBy":"1",
+		"dateActiveFrom":"2019-06-04T19:36:00+03:00",
+		"dateActiveTo":"2019-06-05T19:57:00+03:00",
+		"dateCreate":"2018-10-22T11:31:15+03:00",
+		"detailText":"Подробное описание товара 1",
+		"detailTextType":"html",
+		"iblockId":"13", // ID каталога в Битрикс24
+		"measure":"5", // ID единицы измерения. 5 - штука
+		"name":"Наименование товара 1",
+		"previewText":"Короткое описание товара 1",
+		"previewTextType":"text",
+		"purchasingCurrency":"UZS",
+		"purchasingPrice":"1000", // Закупочная цена
+		"quantity":"100", // Количество товара при создании (не обязательно)
+		"sort":"340", // сортировка при выводе (не обязательно)
+		"xmlId":"bx123123", //ID товара во внешней системе, не обязательно
+	}
+}
+```
+### Response Success: 
+```js
+{
+  "result": 3456,
+  "time": {
+    "start": 1714725919.108458,
+    "finish": 1714725919.306497,
+    "duration": 0.19803905487060547,
+    "processing": 0.1816730499267578,
+    "date_start": "2024-05-03T13:45:19+05:00",
+    "date_finish": "2024-05-03T13:45:19+05:00"
+  }
+}
+```
+
+## 1.2. Цена товара
+
+При необходимости можно установить Розничную цену на товар следующим методом:
+
+### AddLead
+
+`Method` : POST
+`URL` : `https://triada.sedo.uz/rest/1/w5wcseycj8jlzv5l/catalog.price.add.json`
+
+`Params` : 
+```js
+{
+    "fields": {
+        "catalogGroupId": 1, // ID цены в Битрикс24, 1-по умолчанию
+        "currency": "UZS",
+        "price": 2000,
+        "productId": 21742 // ID товара созданного методом выше
+    }
+}
+```
+`Response Success`: 
+```js
+{
+  "result": 3456,
+  "time": {
+    "start": 1714725919.108458,
+    "finish": 1714725919.306497,
+    "duration": 0.19803905487060547,
+    "processing": 0.1816730499267578,
+    "date_start": "2024-05-03T13:45:19+05:00",
+    "date_finish": "2024-05-03T13:45:19+05:00"
+  }
+}
+```
+
+## 2. Создание лида с продуктами
+
+Для создания лида в Битрикс24 с продуктами выполняются 2 метода:
+
+### AddLead
+
+`Method` : POST
+`URL` : `https://triada.sedo.uz/rest/1/w5wcseycj8jlzv5l/crm.lead.add.json`
+
+`Params` : 
+```js
+{
+    "fields": {
+        "TITLE": "TestLead_1",
+        "NAME": "LeadName-1",
+        "COMMENTS":"TestComment-1",
+        "ADDRESS":"TestAddress-1",
+        "SOURCE_DESCRIPTION":"Test Payment Method-1",
+        "SOURCE_ID": "WEB",
+        "EMAIL": [
+            {"VALUE":"testemail@mail.uz"}
+        ],
+        "PHONE": [
+            {"VALUE":"+998999999999"}
+        ]
+    }
+}
+```
+`Response Success`: 
+```js
+{
+  "result": 3456,
+  "time": {
+    "start": 1714725919.108458,
+    "finish": 1714725919.306497,
+    "duration": 0.19803905487060547,
+    "processing": 0.1816730499267578,
+    "date_start": "2024-05-03T13:45:19+05:00",
+    "date_finish": "2024-05-03T13:45:19+05:00"
+  }
+}
+```
+
+## 3. Добавление продуктов в Лид по ID
+
+Для прикрепления продуктов в лид нужно в тело запроса указать id лида и массив продуктов с полями товаров:
+
+### ProductRows
+
+`Method` : POST
+`URL` : `https://triada.sedo.uz/rest/1/w5wcseycj8jlzv5l/crm.lead.productrows.set.json`
+
+`Params` : 
+```js
+```json
+{
+    "id":false,
+    "rows": [
+        { "PRODUCT_ID": 1383, "PRICE": 2500, "QUANTITY": 2 },
+        { "PRODUCT_ID": 1392, "PRICE": 1300, "QUANTITY": 1 }
+    ]
+}
+```
+```
+`Response Success`: 
+```js
+{
+  "result": true,
+  "time": {
+    "start": 1714725930.333073,
+    "finish": 1714725930.40473,
+    "duration": 0.07165718078613281,
+    "processing": 0.054405927658081055,
+    "date_start": "2024-05-03T13:45:30+05:00",
+    "date_finish": "2024-05-03T13:45:30+05:00"
+  }
+}
+```