---
title: "Получить поставки площадки"
method: GET
path: "/api/v1/marketplace/{platform}/supply-receipts"
tags: ["Marketplace supplies"]
---

# Получить поставки площадки

`GET /api/v1/marketplace/{platform}/supply-receipts`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marketplace/{platform}/supply-receipts`
- 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

Поставки площадки из базы сборщика (вкладка «Поставки» экрана «Склады
маркетплейсов»): номер, склад площадки, даты создания, отправки и
приёмки, состояние для учёта и состав по позициям — заявлено и
принято, сопоставленный товар номенклатуры. Поставка с нашей
отгрузкой несёт dispatch_document_id и номер; принятая нашим
документом — document_id. По supply_key заводят отгрузку
(POST …/supply-shipments) и приходуют приёмку.

## Path parameters

- `platform` 'ozon' | 'wildberries', required

## Query parameters

- `store_id` string, uuid
- `company_id` string, uuid
- `q` string

## Headers

- `X-Tenant` string, required

## Response `200`

Поставки

- MarketplaceSupplyReceiptView
  - `platform` string, required
  - `supplies` MarketplaceSupplyReceipt[], required
    - `store_id` string, uuid, required
    - `store_name` string, required
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `supply_key` string, required: Ключ поставки: supply:<номер> или preorder:<номер заказа>
    - `number` string, required: Номер поставки у площадки
    - `warehouse` string, required: Склад площадки
    - `accepted_at` string, date-time, nullable, required
    - `created_at` string, date-time, nullable, required
    - `dispatched_at` string, date-time, nullable, required
    - `lines` MarketplaceSupplyReceiptLine[], required
      - `product_id` string, uuid, required
      - `product_sku` string, required
      - `product_name` string, required
      - `external_id` string, required: Штрихкод (Wildberries) или SKU (Ozon)
      - `external_name` string, required
      - `declared` integer, required: Заявлено площадке
      - `accepted` integer, required: Принято площадкой
      - `discrepancy` integer, required
      - `unit_cost` string, nullable, required
      - `value` string, nullable, required
      - `currency` string
      - `cost_version_id` string, uuid, required
      - `state` string, required: ready, missing_cost, stock_cost_required или unmatched_product
    - `total_accepted` integer, required
    - `total_declared` integer, required
    - `total_value` string, required
    - `missing_cost` integer, required
    - `unmatched` integer, required: Позиций без сопоставления
    - `document_id` string, uuid, required
    - `document_number` string
    - `dispatch_document_id` string, uuid, required
    - `dispatch_document_number` string
    - `dispatch_document_date` string, date: Дата нашей отгрузки — «Ушло от нас» на экране. Пусто без отгрузки
    - `dispatch_qty` string
    - `dispatch_pending` boolean: Отгрузка найдена по номеру поставки, выбранному в документе, но связь ещё не записана: её запишут обход или приёмка. Поставка уже считается нашей
    - `virtual` boolean, required
    - `opening_at` string, date-time
    - `state` 'ready' | 'not_ready' | 'received' | 'empty' | 'in_transit' | 'before_opening' | 'virtual', required
  - `ready` integer, required
  - `not_ready` integer, required
  - `received` integer, required
  - `in_transit` integer, required
  - `before_opening` integer, required

## Other responses

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

---

[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)