# API загрузки уникальных номеров номенклатуры в Кактус

### Загрузка уникальных номеров через json файл

/api/lite/products/load/unique\_number/json

#### **Пример вызова:**

```JSON
{
  "items" : [
    
	{ 
      "variantId" : "1000",//variant_id номенклатуры
	  "uniqueNumbers" : [
        {
	     "uniqueNumber" : "1232344456777",//уникальный номер
		 "type" : "UIT"// пока только UIT
        }
	  ]
	}
  ]
}
```

#### **Пример успешного ответа**

```JSON
{
    "success": true
}
```

### Загрузка уникальных номеров через excel файл

/api/lite/products/load/unique\_number/excel

Эксель файл должен быть в формате xls, в первой колонке varian\_id номенклатуры, вторая колонка уникальный номер, третья тип уникального номера. Например 1000, njkjnw9i98, UIT.

upFile - файл excel в formData.

Файл эксель:[![imei.png](https://wiki.kak2c.ru/uploads/images/gallery/2023-06/scaled-1680-/imei.png)](https://wiki.kak2c.ru/uploads/images/gallery/2023-06/imei.png)

#### **Пример успешного ответа**

```JSON
{
    "success": true
}
```

### Получить список загруженных уникальных номеров номенклатуры

**<span style="color: #212121; font-family: Inter, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', Helvetica, Arial, sans-serif; font-size: 12px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; letter-spacing: normal; text-align: left; text-indent: 0px; text-transform: none; white-space: pre-wrap; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">/api/lite/products/unique\_numbers/list?variantId=1000&amp;isUsed=false&amp;page=0&amp;size=10</span>**

####  

variantId - ид варианта номенклатуры

isUsed - использованный/не использованные уникальные номенклатуры

page и size - для пагинации

#### **Пример успешного ответа**

```JSON
{
    "success": true,
    "uniqueNumbers": [
        {
            "disabled": false,
            "isReserved": false,
            "physicalSet": "",
            "purchaseOrder": "",
            "uniqueNumber": "0104064211748539215%HefMSHYlegL9100BE92IlF/M3RjtFd4KI5xnWnri5ZHCNIlndYdSVKLoG2VvWg3BZ3dPM1EnijDoPSuNJmVI63clfwHgXLVy3vDCXKvnw==",
            "type": "UIT"
        },
        {
            "disabled": false,
            "isReserved": false,
            "physicalSet": "",
            "purchaseOrder": "",
            "uniqueNumber": "0104064211296115217>dGPovOMpiDH␝918093␝92gbLYtaYLYnFIUsQilCOiicPOKJZMiuKKUeAIvO3R9wgWoEip5FjubkxPpXsOuCr9N4nMGXuD6VgS8oK/jkfvJw==␝",
            "type": "UIT"
        }
    ]
}
```

### Получить уникальный номер для номенклатуры, поставке или комплектации

/api/lite/products/unique\_number

Данный метод возвращает уникальный номер, и ставит галку что данный уникальный номер зарезервирован.

variant\_id - ид варианта номенклатуры

type\_unique\_number - тип уникального номера

id(необязательный) - номер документа(поставки, комплектации)

doc\_type - тип документа (PURCHASE\_ORDER, PHYSICAL\_SET\_ORDER)

#### **Пример успешного ответа**

```JSON
{
    "success" : true,
    "variantId" : "1000",
    "uniqueNumber" : "mlkmkjnjkmkjnjk"
}
```

### Проставить флаг использования уникальному номеру

/api/lite/products/unique\_number/used

#### **Пример вызова:**

```JSON
{ 
  "variantId" : "1000",	
  "uniqueNumber" : "njkdhbjcs"
}
```

Данный метод ставит флаг что данный уникальный номер использован.

#### **Пример успешного ответа**

```JSON
{
    "success": true
}
```