---
title: "Получить отправки на склады с приёмкой"
method: GET
path: "/api/v1/stock/transit-shipments"
tags: ["Stock documents"]
---

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

`GET /api/v1/stock/transit-shipments`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/transit-shipments`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Перемещение с приёмкой (ERP-2179): проведённые перемещения на склад
«В пути на <склад>» (`inbound_mode = transfer_transit`) — отправки на
склады с настройкой «Приход перемещением — с приёмкой» — и что с ними
стало по документам на их основании: принято, излишек, списано,
возвращено, оприходовано, ещё в пути. Состояние `state`: `in_transit` —
приёмок нет, `partial` — принята частью, `discrepancy` — приёмка
закончена (или в пути ноль) с недостачей или неоприходованным излишком,
`done` — закрыта; отбор `awaiting` — «ждут приёмки»: `in_transit` и
`partial`; незнакомое значение state — 400. Без строк; строки —
в карточке отправки, в том числе строка товара, которого в отправке не
было, а приёмка его приняла (отправлено 0, всё — излишек). Отправки
сужаются областью складов сотрудника. Новые сверху.

## Query parameters

- `warehouse_id` string, uuid
- `company_id` string, uuid
- `state` 'open' | 'awaiting' | 'done' | 'in_transit' | 'partial' | 'discrepancy' | 'all'
- `date_from` string, date
- `date_to` string, date
- `limit` integer
- `offset` integer
- `number` string
- `states` string
- `warehouse_from_ids` string

## Headers

- `X-Tenant` string, required

## Response `200`

Отправки

- StockTransitShipmentPage
  - `count` integer, required
  - `results` StockTransitShipment[], required
    - `document_id` string, uuid, required
    - `number` string, required
    - `date` string, date, required
    - `company_id` string, uuid, required
    - `from_warehouse_id` string, uuid, required
    - `from_warehouse_name` string, required
    - `transit_warehouse_id` string, uuid, required
    - `to_warehouse_id` string, uuid, required
    - `to_warehouse_name` string, required
    - `external` boolean, required: Получатель — склад внешней стороны (площадка без API)
    - `can_receive` boolean: Принимать отправку вправе запрос: у роли «Склады: свои» (ERP-1978) — только получатель, склад «в пути» на свой склад
    - `state` 'in_transit' | 'partial' | 'discrepancy' | 'done', required
    - `shipped` string, required
    - `received` string, required
    - `surplus` string, required
    - `surplus_open` string, required
    - `written_off` string, required
    - `returned` string, required
    - `capitalized` string, required
    - `in_transit` string, required
    - `amount` string, required: Себестоимость отправки
    - `in_transit_amount` string, required: Себестоимость того, что ещё в пути
    - `series_mismatches` integer, required: Частей приёмки с серией не той, что ожидали
    - `comment` string
    - `lines` StockTransitShipmentLine[]: Только в карточке
      - `line_id` string, uuid, required
      - `product_id` string, uuid, required
      - `product_sku` string, required
      - `product_name` string, required
      - `shipped` string, required: Отправлено в базовой единице
      - `received` string, required
      - `surplus` string, required: Принято сверх отправленного
      - `surplus_open` string, required: Излишек, ещё не оприходованный
      - `written_off` string, required
      - `returned` string, required
      - `capitalized` string, required: Оприходовано излишка
      - `in_transit` string, required: Ещё на складе «в пути» по этой строке
      - `unit_cost` string, required: Цена единицы отправки в валюте учёта
      - `amount` string, required: Себестоимость строки отправки
      - `expected_batch_code` string
      - `expected_produced_at` string, date
      - `expected_expires_at` string, date
      - `receipts` StockTransitReceivedPart[], required
        - `document_id` string, uuid, required
        - `number` string, required
        - `date` string, date, required
        - `auto` boolean, required: Приёмку провела сама отгрузка из пути
        - `qty` string, required: Принято из пути, decimal string
        - `surplus_qty` string: Принято сверх того, что было в пути
        - `batch_code` string, required: Серия по факту; пусто — партии отправки как есть
        - `produced_at` string, date
        - `expires_at` string, date
        - `condition_id` string, uuid
        - `batch_id` string, uuid
        - `series_mismatch` boolean, required: Серия не совпала с ожидаемой
      - `series_mismatch` boolean, required
      - `pending` integer, required: Черновиков приёмки или решения по строке
      - `pending_document_ids` UUID[], required: Черновики приёмки или решения по строке — их id
      - `resolved_document_ids` UUID[], required: Проведённые решения по строке: списание, претензия, возврат, оприходование излишка
    - `documents` StockTransitDocument[]: Только в карточке
      - `document_id` string, uuid, required
      - `number` string, required
      - `type_key` string, required
      - `kind` 'receipt' | 'auto_receipt' | 'shortage_writeoff' | 'shortage_claim' | 'return' | 'surplus_receipt' | 'regrade', required: Вид для человека: приёмка, автоприёмка, списание недостачи, претензия, возврат, оприходование излишка, пересортица «Принят другой товар»
      - `date` string, date, required
      - `status` string, required
      - `qty` string, required
      - `receipt_for` string, uuid

## Other responses

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

---

[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/a99574d597cc?raw)
