---
title: "Состояние сессии загрузки склада"
method: GET
path: "/api/v1/stock/upload-sessions/{id}"
tags: ["Stock imports"]
---

# Состояние сессии загрузки склада

`GET /api/v1/stock/upload-sessions/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/upload-sessions/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Сессию видит только её автор. status=pending — байты ждём или завершение можно повторить; attached — прогон заведён, published_ref — номер прогона импорта; failed — причина в failure. Адрес для байтов здесь не повторяется: он выдаётся один раз при открытии сессии.

## Response `200`

Состояние сессии

- TransferSession: Сессия загрузки файла по подписанному адресу хранилища. Ключи хранилища наружу не отдаются.
  - `id` string, uuid, required
  - `owner_type` string, required
  - `owner_id` string
  - `name` string, required
  - `mime_type` string, required
  - `size_bytes` integer, required
  - `sha256` string
  - `attributes` object
  - `status` 'pending' | 'processing' | 'attached' | 'failed' | 'expired', required
  - `failure` 'infected' | 'size' | 'checksum' | 'storage' | 'owner' | 'aborted' | 'expired'
  - `failure_detail` string
  - `scan_status` 'pending' | 'clean' | 'infected' | 'skipped'
  - `scan_verdict` string
  - `published_ref` string: Номер строки, заведённой по файлу; у почты — id загрузки для upload_ids
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time
  - `upload` TransferInstructions: Как передать байты. Выдаётся один раз, при открытии сессии.
    - `mode` 'post' | 'parts' | 'api', required: post — один multipart POST; parts — PUT каждой части; api — PUT через этот API с авторизацией
    - `url` string
    - `method` string
    - `fields` object: Поля формы для POST; файл идёт после них последним полем
    - `file_field` string: Имя поля формы для файла
    - `headers` object
    - `part_bytes` integer
    - `part_count` integer
    - `direct_urls` object: Подписанный адрес каждой части по её номеру, начиная с 1
    - `requires_authorization` boolean, required: true — адрес требует токен API, агенту по MCP этот путь недоступен
    - `max_bytes` integer, required
    - `expires_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)