Skip to main content

api/lite/export/order

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

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

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

2. Endpoint

URL:

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

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

GET

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

Параметр Тип Обязательный Описание
id string Да Идентификатор заказа

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

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

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

{
    "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. Описание полей ответа

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

Поле Тип Описание
exportResults array Массив результатов экспорта
recordsTotal integer Общее количество сформированных экспортов
success boolean Статус выполнения запроса

Объект exportResults

Поле Тип Описание
fileID string Уникальный идентификатор файла экспорта
fileUrl string Прямая ссылка на скачивание файла
rowsTotal integer Количество строк (товаров) в экспортированном файле
success boolean Статус формирования конкретного файла

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.

Наверх