# api/lite/export/order

## Инструкция по получению экспорта товаров в заказе

### 1. Назначение метода

Метод предназначен для получения файла экспорта товаров по конкретному заказу.  
В результате выполнения запроса возвращается ссылка на сформированный файл (например, `.xls`) и информация о результате операции.

---

### 2. Endpoint

**URL:**

```
GET https://app.kak2c.ru/api/lite/export/order/now

```

---

### 3. Метод запроса

```
GET

```

---

### 4. Параметры запроса

<table id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td>`id`</td><td>string</td><td>Да</td><td>Идентификатор заказа</td></tr></tbody></table>

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

```
GET https://app.kak2c.ru/api/lite/export/order/now?id=4466-34568645

```

---

### 5. Пример ответа

```json
{
    "exportResults": [
        {
            "fileID": "export_order_5669-323434395",
            "fileUrl": "https://storage.yandexcloud.net/items-export-kak2c/export_orders_test@new-wms.ru_27.02.2026_09-00-31.xls",
            "rowsTotal": 1,
            "success": true
        }
    ],
    "recordsTotal": 1,
    "success": true
}

```

https://storage.yandexcloud.net/items-export-kak2c/export\_orders\_test@new-wms.ru\_27.02.2026\_11-22-49.xls

---

### 6. Описание полей ответа

#### Корневой объект

<table id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-ex"><thead><tr><th>Поле</th><th>Тип</th><th>Описание</th></tr></thead><tbody><tr><td>`exportResults`</td><td>array</td><td>Массив результатов экспорта</td></tr><tr><td>`recordsTotal`</td><td>integer</td><td>Общее количество сформированных экспортов</td></tr><tr><td>`success`</td><td>boolean</td><td>Статус выполнения запроса</td></tr></tbody></table>

---

#### Объект `exportResults`

<table id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-fi"><thead><tr><th>Поле</th><th>Тип</th><th>Описание</th></tr></thead><tbody><tr><td>`fileID`</td><td>string</td><td>Уникальный идентификатор файла экспорта</td></tr><tr><td>`fileUrl`</td><td>string</td><td>Прямая ссылка на скачивание файла</td></tr><tr><td>`rowsTotal`</td><td>integer</td><td>Количество строк (товаров) в экспортированном файле</td></tr><tr><td>`success`</td><td>boolean</td><td>Статус формирования конкретного файла</td></tr></tbody></table>

---

### 7. Логика работы

1. Клиент отправляет GET-запрос с параметром `id`.
2. Система формирует экспорт товаров по указанному заказу.
3. В случае успешного формирования:
    
    
    - возвращается `success: true`
    - в `fileUrl` передаётся ссылка на файл
4. Клиент может скачать файл по полученной ссылке.

---

### 8. Возможные сценарии

#### Успешный экспорт

- `success: true`
- `exportResults[0].success: true`
- `fileUrl` содержит корректную ссылку

#### Ошибка формирования

- `success: false`
- либо `exportResults[0].success: false`
- ссылка на файл отсутствует или невалидна

---

### 9. Особенности

- Экспорт формируется в момент выполнения запроса (`/now`).
- Формат файла — `.xls`.
- Ссылка `fileUrl` ведёт на внешний файловый storage.