Marketplace accounting

Оценить начальный остаток склада площадки

Снимок площадки на складе, в пути к покупателю и от покупателя, собранный по позициям и оценённый на дату ввода выбранным источником цены: stock — себестоимость товара на своих складах юрлица (средняя или средневзвешенная по слоям FIFO, без остатка — последний приход, у набора без остатка и прихода — по составу действующей спецификации), manual — цена строки, rates — ставка маркетплейса. Пустой cost_source — по учётной политике магазина. Количества собирает сервер; lines только выбирают источник и ручную цену позиции. Позицию без сопоставления закрывают по её card_ref: marketplaceLinkCatalogMatches к существующему товару или marketplaceCreateCatalogMatchProducts новым. Ввод на прошлую дату: у Wildberries без суточного снимка на неё остаток считается от ближайшего более позднего снимка по движениям (snapshot_source = movements): + продано и − вернулось по дате продажи, − принято поставками; минус — строка negative на разбор; отчёт, не дошедший до дня снимка, — not_covered. Поставки, бывшие на дату в пути, — transit. Это чтение: документа не создаёт.

post/api/v1/marketplace/{platform}/opening-stock/preview

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/marketplace/{platform}/opening-stock/preview
  • 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

Path parameters

platform'ozon' | 'wildberries' required

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

company_idstring uuid
store_idstring uuid
as_ofstring date

Дата ввода — дата запуска склада: с неё у магазина действует себестоимость со склада; нет — она же, а у магазина без неё — день снимка площадки по Москве

qstring

Поиск сужает только строки ответа; итоги — по всему срезу

cost_source'stock' | 'manual' | 'rates'

Источник цены документа; нет — по учётной политике магазина

transit_suppliesstring[]

Ключи поставок (supply_key), которые на дату ввода были в пути на площадку. Поля нет — по правилу: дошла до ворот площадки до даты ввода, заведена не раньше окна transit_window_days, не принята до даты ввода, нашей отгрузки нет; пустой список — в пути ничего

transit_window_daysinteger

Окно правила «в пути» по умолчанию: поставка заведена не раньше чем за столько дней до даты ввода; 0 или нет поля — 30

Response

Оценённый начальный остаток

platformstring required
snapshot_atstring date-time nullable
snapshot_source'current' | 'history' | 'movements'

Откуда количества: current — текущий снимок остатков площадки; history — суточный снимок из истории остатков сборщика на дату ввода (as_of раньше дня текущего снимка); movements — у Wildberries снимка на дату нет, остаток посчитан от ближайшего более позднего снимка по движениям. У Ozon снимка на дату нет — 409 marketplace.opening.history_missing

as_ofstring date
cost_sourcestring
default_cost_source'stock' | 'rates' required
total_qtyinteger required
total_valuestring required
missing_costinteger required
unmatchedinteger required
skippedinteger
readyboolean
computed_fromstring date

Расчёт по движениям: дата снимка, от которого посчитано

coverage_throughstring date

Расчёт по движениям: по какой день загружен отчёт реализации площадки

not_coveredboolean

Отчёт площадки не дошёл до дня перед снимком: продажи между датой ввода и снимком известны не все, ввод не готов

negativeinteger

Строк с минусом расчёта — на разбор, в документ не входят

unknown_operationsstring[]

Незнакомые виды строк отчёта: пока они есть, расчёт не готов

unmapped_movementsinteger

Штук в строках отчёта и поставок без размера каталога: расчёт по ним неполон

ledger_fromstring date

Дата начала книги бизнеса юрлица, если задана: склад площадки запускают с неё же

Changes

No recorded changes to this operation across all 2 revisions of this API.