# /api/lite/purchase_orders

### Запрос списка поставок на склад (заказов поставщиков)

/api/lite/purchase\_orders

Метод возвращает список заказов с заданной фильтрацией.

Можно использовать как для получения списка, так и единичного заказа.

#### **Фильтрация**

Для фильтрации есть следующие возможности:

- id - по номеру заказа
- filter\_states - по статусам заказов (можно указывать несколько через зяпятую)
- filter\_external\_id, filter\_external\_id\_2, filter\_external\_id\_3, filter\_external\_id\_4, filter\_external\_id\_5 - по внешним идентификаторам
- date\_from - по дате заказа, от. формат: <span style="color: #505050;">2020-02-19T12:35:31</span>
- date\_to - по дате заказа, до
- <span style="color: #505050;">updated\_from - по дате/времени изменения. </span>формат: <span style="color: #505050;">2020-02-19T12:35:31. Не суммируется с другими параметрами фильтрации</span>
- supllier\_id - по id поставщика
- consignor\_id - по id грузоотправителя
- date\_of\_accept\_from - по фактической дате приемки, от. формат <span style="color: #505050;">2020-02-19T12:35:31</span>
- date\_of\_accept\_to - по фактической дате приемки, до. формат <span style="color: #505050;">2020-02-19T12:35:31</span>
- arrival\_date\_from - по фактической дате прибытия поставки на склад, от. формат <span style="color: #505050;">2020-02-19T12:35:31</span>
- arrival\_date\_to - по фактической дате прибытия поставки на склад, до. формат <span style="color: #505050;">2020-02-19T12:35:31</span>
- statuses - список статусов поставки через запятую

#### **Пейджинация**

Для пейджинации используются параметры page и size: size - записей на странице, page - номер страницы.

Пример: `/api/lite/orders?page=0&size=200`

Если параметры не переданы, то дефолтные значения page=0&amp;size=100

Также для отображение пейджинации следует анализировать параметр recordsTotal, возвращающий общее количество записей (с учетом примененной фильтрации, если она есть).

#### **Сортировка**

Для сортировки задается параметр order, принимающий код поля для сортировки и направление сортировки (asc, desc), отделенное символом плюса.

Пример сортировки по дате (**возрастание**): `/api/lite/orders?order=date+<strong>asc</strong>`

Пример сортировки по дате (**убывание**): `/api/lite/orders?order=date+<strong>desc</strong>`

Доступные коды сортировки:

- **date** (дата заказа)
- **id** (номер заказа)

По умолчанию используется сортировка по дате заказа по убыванию.

Полный комплект данных по заказам будет передан только если в запросе будет параметр full\_info=true

Точечное описание некоторых полей, которые возвращает запрос по поставкам

<table border="1" id="bkmrk-purchasearrivaldate-" style="border-collapse: collapse; width: 100%; height: 290px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">purchaseArrivalDate формат 2021-04-02 15:50:48.032</td><td style="width: 50%; height: 29px;">фактическая дата прихода поставки на склад</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">finishlDate формат 2021-04-02 15:50:48.032 </td><td style="width: 50%; height: 29px;">фактическая дата закрытия поставки</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">date формат 2021-04-02 15:50:48.032 </td><td style="width: 50%; height: 29px;">дата создания поставки в лк Кактус</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">status</td><td style="width: 50%; height: 29px;">статус поставки</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">supplier</td><td style="width: 50%; height: 29px;">объект, содержит информацию о поставщике</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">consignor</td><td style="width: 50%; height: 29px;">объект, содержит информацию о грузоотправителе</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">files</td><td style="width: 50%; height: 29px;">список объектов, содержит информацию о файлах в поставке</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">warehouseName </td><td style="width: 50%; height: 29px;">название склада</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">warehouseCode</td><td style="width: 50%; height: 29px;">код склада</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">comment</td><td style="width: 50%; height: 29px;">комментарий к поставке</td></tr></tbody></table>

####  

##### Пример запроса по одному заказу и полными данными:

**<span style="color: #999999;">GET api/lite/purchase\_orders?id=1001&amp;full\_info=true</span>**

**Пример результата запроса**

```JSON
{
    "purchaseOrders": [
        {
            "confirmStatus": "APPROVED",
            "currency": "RUB",
            "date": "2025-11-24 12:28:52",
            "factItems": [
                {
                    "article": "dvn",
                    "barcode": "127351263",
                    "batchAccountingAttributes": {
                        "batchAccountingNumber": "1-4",
                        "expirationDate": "2025-10-01",
                        "productionDate": "2022-10-02",
                        "useBatchAccounting": true,
                        "useExpiration": true
                    },
                    "factBatchAccountingAttributes": [
                        {
                            "batchAccountingNumber": "1-4",
                            "expirationDate": "2025-10-01",
                            "productionDate": "2022-10-02",
                            "useBatchAccounting": true,
                            "useExpiration": true
                        }
                    ],
                    "name": "Маска для волос Davines",
                    "num": 1,
                    "productId": "1256636009",
                    "quantity": 0,
                    "quantityDefective": 0,
                    "quantityFact": 20,
                    "quantityRaw": 20,
                    "skuType": "SKU",
                    "sum": 0,
                    "variantId": "566335809"
                }
            ],
            "files": [
                {
                    "fileExt": "pdf",
                    "fileName": "mx1.pdf",
                    "fileSource": "FULFILLMENT",
                    "fileType": "PDF",
                    "id": "e65bdeb6-a966-d0fd-3765-441334a536d9",
                    "success": true,
                    "url": "https://storage.yandexcloud.net/cactuswms/3b808083-7b6c-43ae-aa3e-48f5c161240d.pdf"
                },
                {
                    "fileExt": "pdf",
                    "fileName": "torg2.pdf",
                    "fileSource": "FULFILLMENT",
                    "fileType": "PDF",
                    "id": "19f46185-8fe7-f352-660e-b65aae210ad6",
                    "success": true,
                    "url": "https://storage.yandexcloud.net/cactuswms/c04781b1-4127-4a33-905f-5efe98d816f3.pdf"
                }
            ],
            "finishDate": "2025-11-24 12:31:54",
            "hasLinkedOrders": false,
            "id": "1006896419",
            "isTakeInDiff": true,
            "items": [
                {
                    "article": "dvn",
                    "barcode": "127351263",
                    "batchAccountingAttributes": {
                        "batchAccountingNumber": "1-4",
                        "expirationDate": "2025-10-01",
                        "productionDate": "2022-10-02",
                        "useBatchAccounting": true,
                        "useExpiration": true
                    },
                    "factBatchAccountingAttributes": [
                        {
                            "batchAccountingNumber": "1-4",
                            "expirationDate": "2025-10-01",
                            "productionDate": "2022-10-02",
                            "useBatchAccounting": true,
                            "useExpiration": true
                        }
                    ],
                    "name": "Маска для волос Davines",
                    "num": 1,
                    "productId": "1256636009",
                    "quantity": 0,
                    "quantityDefective": 0,
                    "quantityFact": 20,
                    "quantityRaw": 20,
                    "skuType": "SKU",
                    "sum": 0,
                    "variantId": "566335809",
                    "tag": "ROZNECHNIE_SETY"
                }
            ],
            "planItems": [
                {
                    "article": "dvn",
                    "barcode": "876543",
                    "factBatchAccountingAttributes": [],
                    "multiplicity": 10,
                    "name": "Маска для волос Davines (Квант 10 шт)",
                    "num": 1,
                    "optionsUsed": [],
                    "price": 2000.00,
                    "productId": "1256636009",
                    "quantity": 20,
                    "quantityDefective": 0,
                    "quantityFact": 0,
                    "quantityRaw": 0,
                    "skuType": "SKU",
                    "sum": 400000.00,
                    "variantId": "566335810",
                    "vatRate": "NO_VAT",
                    "tag": "ROZNECHNIE_SETY"
                }
            ],
            "purchaseArrivalDate": "2025-11-24 12:29:50",
            "status": "COMPLETED_WITH_DIFFERENCE",
            "supplier": {
                "id": "096e2fba-3cf9-2df1-f83c-50f51f1ffef4",
                "name": "Романова Виктория",
                "person": {
                    "address": {
                        "area": "",
                        "block": "",
                        "building": "",
                        "city": "",
                        "country": "Россия",
                        "countryCode": "RU",
                        "flat": "",
                        "house": "",
                        "region": "",
                        "settlement": "",
                        "street": "",
                        "zip": ""
                    },
                    "alternativePhone": "",
                    "fullName": "Романова Виктория",
                    "name": "Виктория",
                    "passport": {},
                    "phone": "79999999999",
                    "surname": "Романова"
                },
                "type": "PERSON"
            },
            "takeInType": "STANDARD",
            "totalFactOrderSum": 0,
            "totalFactQuantity": 20,
            "totalFactVATSum": 0,
            "totalOrderSum": 400000.00,
            "totalQuantity": 200,
            "totalVATSum": 0.00,
            "updateTs": "2025-11-24 12:32:33.610",
            "warehouseCode": "21ad85be-09a9-c4f8-72e1-4976f9d5bda6",
            "warehouseFFExportError": false,
            "warehouseFFExported": true,
            "warehouseFFSync": true,
            "warehouseFFSyncDate": "2025-11-24 12:28:55",
            "warehouseName": "NEW WMS!"
        }
    ],
    "recordsTotal": 1,
    "success": true
}
```

####  

Ниже — **официальное дополнение к текущей инструкции**.  
Текст оформлен так, чтобы его можно было **напрямую вставить** в существующий документ (рекомендуемое место — после раздела *«Точечное описание некоторых полей»* или перед примерами ответов).

---

# Дополнение. Плановые и фактические позиции поставки (planItems, factItems)

В ответе метода  
**GET /api/lite/purchase\_orders**  
(при использовании параметра `full_info=true`) для поставки могут возвращаться дополнительные наборы товарных строк:

- `planItems`
- `factItems`

Данные поля предназначены для разделения **плановых данных клиента** и **фактических данных складской приемки**.

---

## Общая схема данных поставки

Для одной поставки система может возвращать до трёх наборов товарных позиций:

<table id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-planit"><thead><tr><th>Поле</th><th>Описание</th></tr></thead><tbody><tr><td>`planItems`</td><td>План поставки — данные, переданные клиентом</td></tr><tr><td>`factItems`</td><td>Фактическая приемка — данные, зафиксированные складом</td></tr><tr><td>`items`</td><td>Текущее агрегированное состояние поставки</td></tr></tbody></table>

---

## planItems — план поставки

`planItems` содержит **плановые позиции поставки**, сформированные на основании данных, переданных клиентом при создании или редактировании заказа поставщику (`POST /api/lite/purchase_orders`).

### Характеристики planItems

- Формируются **только из данных клиента**
- Не изменяются складом
- Фиксируют исходные плановые количества и цены
- Используются как эталон для сравнения с фактической приемкой
- До начала приемки:
    
    
    - `quantityFact = 0`
    - `quantityRaw = 0`

### Назначение

- Анализ плановых поставок
- Сравнение план / факт
- Выявление расхождений при приемке

### Пример planItems

```json
"planItems": [
  {
    "num": 1,
    "variantId": "566335837",
    "productId": "1256636029",
    "barcode": "25704_1",
    "name": "Плакат 25704",
    "quantity": 2000,
    "price": 5.00,
    "vatRate": "NO_VAT",
    "quantityFact": 0,
    "quantityRaw": 0,
    "quantityDefective": 0,
    "sum": 10000.00,
    "skuType": "PACKING_MATERIAL_OTHER",
    "factBatchAccountingAttributes": [],
    "optionsUsed": [],
    "tag": "ROZNECHNIE_SETY"
  }
]

```

---

## factItems — факт приемки поставки

`factItems` содержит **фактически принятые складом товарные позиции**.

### Характеристики factItems

- Формируются **автоматически складской системой**
- Наполняются **в процессе приемки**, по мере сканирования и учета товара
- Могут отличаться от `planItems` по количеству
- Используются для расчета фактических итогов и расхождений

### Поведение factItems во времени

<table id="bkmrk-%D0%AD%D1%82%D0%B0%D0%BF-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BA%D0%B8-%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F"><thead><tr><th>Этап поставки</th><th>Состояние factItems</th></tr></thead><tbody><tr><td>До начала приемки</td><td>Отсутствуют или пустые</td></tr><tr><td>Приемка в процессе</td><td>Частично заполнены</td></tr><tr><td>Приемка завершена</td><td>Полностью отражают фактически принятый товар</td></tr></tbody></table>

### Пример factItems

```json
"factItems": [
  {
    "num": 1,
    "variantId": "566335837",
    "productId": "1256636029",
    "barcode": "25704_1",
    "name": "Плакат 25704",
    "quantity": 2000,
    "quantityFact": 2000,
    "quantityRaw": 2000,
    "quantityDefective": 0,
    "price": 5.00,
    "vatRate": "NO_VAT",
    "sum": 10000.00,
    "skuType": "PACKING_MATERIAL_OTHER",
    "tag": "ROZNECHNIE_SETY"
  }
]

```

---

## items — текущее состояние поставки

Поле `items` отражает **текущее агрегированное состояние** товарных строк поставки.

### Правила формирования

- До начала приемки — соответствует `planItems`
- В процессе приемки — отражает частично принятые данные
- После завершения приемки — как правило совпадает с `factItems`

### Рекомендации

- Для отображения текущего состояния поставки использовать `items`
- Для анализа и контроля расхождений использовать `planItems` и `factItems`

---

## Связь с статусами поставки

<table id="bkmrk-%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BA%D0%B8-plan"><thead><tr><th>Статус поставки</th><th>planItems</th><th>factItems</th></tr></thead><tbody><tr><td>`NEW`</td><td>Есть</td><td>Нет</td></tr><tr><td>`READY_TO_TAKE_IN`</td><td>Есть</td><td>Нет</td></tr><tr><td>`TAKE_IN_PROCESS`</td><td>Есть</td><td>Заполняются</td></tr><tr><td>`COMPLETED`</td><td>Есть</td><td>Есть</td></tr><tr><td>`COMPLETED_WITH_DIFFERENCE`</td><td>Есть</td><td>Есть (есть расхождения)</td></tr><tr><td>`DIFFERENCE`</td><td>Есть</td><td>Есть</td></tr><tr><td>`CANCELED`</td><td>Есть</td><td>Нет</td></tr></tbody></table>

#### **Пример запроса по списку поставок:**

<span style="color: #999999;">**GET /api/lite/purchase\_orders**</span>

**Пример результата запроса:**

```JSON
{
  "success": true,
  "recordsTotal": 2,
  "purchaseOrders": [
    {
      "id": "1001",
      "externalId": "extId",
      "externalId2": "extId2",
      "externalId3": "extId3",
      "externalId4": "extId4",
      "externalId5": "extId5",
      "date": "2021-04-02 15:50:41",
      "updateTs": "2021-04-02 15:50:48.032",
      "status": "COMPLETED",
      "totalOrderSum": 0,
      "comment": "",
      "totalQuantity": 100,
      "supplier": {
        "id": "da1686cf-0551-db1d-57b9-c04120309fae",
        "type": "PERSON",
        "role": null,
        "name": "Розничный покупатель",
        "organization": null,
        "person": {
          "name": "",
          "surname": "",
          "patronymic": "",
          "fullName": "Розничный Покупатель",
          "phone": "",
          "rawPhone": null,
          "alternativePhone": "",
          "email": null,
          "post": null,
          "personType": null,
          "address": {
            "country": null,
            "countryCode": null,
            "region": null,
            "area": null,
            "city": null,
            "settlement": null,
            "street": null,
            "house": null,
            "block": null,
            "building": null,
            "flat": null,
            "fullAddress": null,
            "fullCity": null,
            "rawData": null,
            "zip": null,
            "regionFias": null,
            "areaFias": null,
            "cityFias": null,
            "settlementFias": null
          }
        }
      },
      "items": [
        {
          "num": 1,
          "variantId": "1001",
          "productId": "1001",
          "name": "товар тест 3",
          "quantity": 100,
          "quantityFact": 100,
          "quantityRaw": 100,
          "quantityDefective": 0,
          "vatRate": "NO_VAT",
          "price": 0,
          "img": "https://storage.yandexcloud.net/images-k2c/05d7a992-1c61-4f39-87c6-1401405055e2.jpg",
          "skuType": "SKU",
          "barcode": "",
          "orderDocId": "5703-1013",
          "tag": "ROZNECHNIE_SETY"
        }
      ],
      "files": [
                {
                    "id": "43f79bac-0d82-2d82-f11d-abd1a53b26a0",
                    "fileType": "PDF",
                  	"fileSource": "FULFILLMENT", //ESHOP | USER
                    "fileName": "МХ1",
                    "fileExt": "pdf",
                    "url": "https://yadi.sk/d/BzKXkRigQZtVnB",
                    "printWhenPacking": true,
                    "copiesQty": 1
                }
           	 ],
      "warehouseName": "Свой склад",
      "warehouseCode": "373b1e28-a6d7-545f-9303-65af3a652d48",
      "confirmStatus": "APPROVED",
      "warehouseFFExported": false,
      "warehouseFFSync": false,
      "currency": "RUB"
    },
    
    {
      "id": "1002",
      "date": "2021-04-03 15:50:41",
      "updateTs": "2021-04-02 15:50:48.032",
      "status": "COMPLETED",
      "totalOrderSum": 0,
      "comment": "",
      "totalQuantity": 100,
      "supplier": {
        "id": "da1686cf-0551-db1d-57b9-c04120309fae",
        "type": "PERSON",
        "role": null,
        "name": "Розничный покупатель",
        "organization": null,
        "person": {
          "name": "",
          "surname": "",
          "patronymic": "",
          "fullName": "Розничный Покупатель",
          "phone": "",
          "rawPhone": null,
          "alternativePhone": "",
          "email": null,
          "post": null,
          "personType": null,
          "address": {
            "country": null,
            "countryCode": null,
            "region": null,
            "area": null,
            "city": null,
            "settlement": null,
            "street": null,
            "house": null,
            "block": null,
            "building": null,
            "flat": null,
            "fullAddress": null,
            "fullCity": null,
            "rawData": null,
            "zip": null,
            "regionFias": null,
            "areaFias": null,
            "cityFias": null,
            "settlementFias": null
          }
        }
      },
      "items": [
        {
          "num": 1,
          "variantId": "1001",
          "productId": "1001",
          "name": "товар тест 3",
          "quantity": 100,
          "quantityFact": 100,
          "quantityRaw": 100,
          "quantityDefective": 0,
          "vatRate": "NO_VAT",
          "price": 0,
          "img": "https://storage.yandexcloud.net/images-k2c/05d7a992-1c61-4f39-87c6-1401405055e2.jpg",
          "skuType": "SKU",
          "barcode": "",
          "tag": "ROZNECHNIE_SETY"
        }
      ],
      "files": [
                {
                    "id": "43f79bac-0d82-2d82-f11d-abd1a53b26a0",
                    "fileType": "PDF",
                  	"fileSource": "FULFILLMENT", //ESHOP | USER
                    "fileName": "МХ1",
                    "fileExt": "pdf",
                    "url": "https://yadi.sk/d/BzKXkRigQZtVnB",
                    "printWhenPacking": true,
                    "copiesQty": 1
                }
           	 ],
      "warehouseName": "Свой склад",
      "warehouseCode": "373b1e28-a6d7-545f-9303-65af3a652d48",
      "confirmStatus": "APPROVED",
      "warehouseFFExported": false,
      "warehouseFFSync": false,
      "currency": "RUB"
    }
  ]
}
```

###  

Возможные статусы заказа:  
NEW  
READY\_TO\_TAKE\_IN  
TAKE\_IN\_PROCESS  
COMPLETED  
COMPLETED\_WITH\_DIFFERENCE  
DIFFERENCE  
CANCELED

### Создание/редактирование поставки (заказа поставщику)

/api/lite/purchase\_orders

Создание/редактирование заказа для кабинета.

Если указан параметр id - то система будет пробовать найти заказ с указанным номером и отредактировать его, иначе - создаст новый с указанным id.

Если параметр id не указан - система создаст новый заказ и присвоит внутренний номер.

####  

<table border="1" id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B" style="border-collapse: collapse; width: 100%; height: 899px;"><tbody><tr style="height: 29px;"><td style="width: 25%; height: 29px;">**Поле**</td><td style="width: 25%; height: 29px;">**Тип**</td><td style="width: 25%; height: 29px;">**Обязательный**</td><td style="width: 25%; height: 29px;">**Комментарий**</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">warehouseCode</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Код склада на который будет поставка, из справочника складов аккаунта</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">supplier</td><td style="width: 25%; height: 29px;">Объект</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Данные о поставщике из справочника контрагентов аккаунта</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">supplier.id</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Код контрагента-поставщика из справочника контрагентов аккаунта.  
<span style="color: #999999;">Также можно использовать внешний код контрагента. Для этого нужно передавать его в поле extId. В таком случае поле id можно уже не передавть.</span>

</td></tr><tr style="height: 63px;"><td style="width: 25%; height: 63px;">consignor</td><td style="width: 25%; height: 63px;">Объект</td><td style="width: 25%; height: 63px;">нет</td><td style="width: 25%; height: 63px;">Данные о грузоотправителе из справочника контрагентов аккаунта</td></tr><tr style="height: 80px;"><td style="width: 25%; height: 80px;">consignor.id</td><td style="width: 25%; height: 80px;">string</td><td style="width: 25%; height: 80px;">нет</td><td style="width: 25%; height: 80px;">Код контрагента-грузоотправителя из справочника контрагентов аккаунта</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items

</td><td style="width: 25%; height: 29px;">Объект</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Текущее агрегированное состояние поставки</td></tr><tr data-end="784" data-start="765"><th class="align-left" data-col-size="sm" data-end="772" data-start="765" style="width: 25%;">planItems</th><th class="align-left" data-col-size="md" data-end="784" data-start="772" style="width: 25%;">Объект</th><td style="width: 25%; height: 35px;">да</td><td style="width: 25%; height: 35px;">План поставки — данные, переданные клиентом</td></tr><tr data-end="856" data-start="795"><td data-col-size="sm" data-end="809" data-start="795" style="width: 25%;">factItems</td><td style="width: 25%;">Объект</td><td style="width: 25%;">да</td><td style="width: 25%;">Фактическая приемка — данные, зафиксированные складом</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.num</td><td style="width: 25%; height: 29px;">integer</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Номер строки (последовательно с 1, без пропусков)</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.quantity</td><td style="width: 25%; height: 29px;">integer</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Количество товара (более 0)</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.price</td><td style="width: 25%; height: 29px;">money</td><td style="width: 25%; height: 29px;">да</td><td style="width: 25%; height: 29px;">Цена за шт</td></tr><tr style="height: 80px;"><td style="width: 25%; height: 80px;">items.vatRate</td><td style="width: 25%; height: 80px;">enum

Значения: NO\_VAT,

VAT\_0, VAT\_10, VAT\_20

</td><td style="width: 25%; height: 80px;">да</td><td style="width: 25%; height: 80px;">Ставка НДС</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.variantId</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">да (если настроен поиск по этому полю)</td><td style="width: 25%; height: 29px;">Код товара в аккаунте </td></tr><tr style="height: 46px;"><td style="width: 25%; height: 46px;">items.variantExtId</td><td style="width: 25%; height: 46px;">string</td><td style="width: 25%; height: 46px;">да (если настроен поиск по этому полю)</td><td style="width: 25%; height: 46px;">Внешний код товара в аккаунте </td></tr><tr style="height: 30px;"><td style="width: 25%; height: 30px;">items.tag</td><td style="width: 25%; height: 30px;">string</td><td style="width: 25%; height: 30px;">нет</td><td style="width: 25%; height: 30px;">Тег, присвоенный товару</td></tr><tr style="height: 130px;"><td style="width: 25%; height: 130px;">searchColumnType</td><td style="width: 25%; height: 130px;">enum:  
HUMANID - дефолтный, можно не передавать, если не требуется другой,  
EXTID,  
ARTICLE,  
BARCODE</td><td style="width: 25%; height: 130px;">Обязательный, если нужен поиск не по variantId</td><td style="width: 25%; height: 130px;"> </td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.orderDocId</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Для согласованных кроссдок поставок - номер привязанного заказа</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">items.batchAccountingAttributes</td><td style="width: 25%; height: 29px;">Объект</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Атрибуты партии для данного товара</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">confirmStatus</td><td style="width: 25%; height: 29px;">enum   
Значения: APPROVED, NEED\_CONFIRM,

CANCELED

</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Статус подтверждения. Только если статус = APPROVED - поставка выгружается на склад для приемки.</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">comment</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Комментарий к поставке для склада</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">dateOfDeliveryPlan</td><td style="width: 25%; height: 29px;">DateTime</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Ориентровочная дата поступления поставки</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">externalId - externalId5</td><td style="width: 25%; height: 29px;">string</td><td style="width: 25%; height: 29px;">нет</td><td style="width: 25%; height: 29px;">Внешние коды поставки из клиенстких систем</td></tr></tbody></table>

#### **Пример запроса:**

```JSON
{
  
  "id": "1006896489",
  "items": [
    {
      "article": "dvn",
      "barcode": "876543",
      "factBatchAccountingAttributes": [],
      "multiplicity": 10,
      "name": "Маска для волос Davines (Квант 10 шт)",
      "num": 1,
      "optionsUsed": [],
      "price": 2000,
      "productId": "1256636009",
      "quantity": 20,
      "quantityDefective": 0,
      "quantityFact": 0,
      "quantityRaw": 0,
      "skuType": "SKU",
      "sum": 400000,
      "variantId": "566335810",
      "vatRate": "NO_VAT",
      "tag": "ROZNECHNIE_SETY"
    }
  ],
  "paymentStatus": "NOT_PAID",
  "planItems": [
    {
      "num": 1,
      "variantId": "566335810",
      "productId": "1256636009",
      "name": "Маска для волос Davines ",
      "quantity": 20,
      "quantityRaw": 0,
      "price": 2000,
      "vatRate": "NO_VAT",
      "article": "dvn",
      "skuType": "SKU",
      "orderDocId": null,
      "shortName": "Маска для волос Davines",
      "tag": "ROZNECHNIE_SETY"
    },
    {
      "num": 2,
      "variantId": "121220209",
      "productId": "34563121212",
      "name": "Крем для волос Davines ",
      "quantity": 1,
      "quantityRaw": 0,
      "price": 3500,
      "vatRate": "NO_VAT",
      "article": "dvnwow6",
      "skuType": "SKU",
      "orderDocId": null,
      "shortName": "Крем для волос Davines",
      "tag": "ROZNECHNIE_SETY"
    }

```

####  

#### **В ответ возвращается:**

```JSON
{
    "success": true,
    "orderId": "111",
    "c": "2b92b631-7f1b-c52a-897e-30bc628f87e5"
}
```

####  

#### **Ошибка:** 

```JSON
{
"success": false,
"errors": [
 {
 "code": 0,
 "message": "Текст ошибки"
 }
]
}
```