---
title: "Узнать порог остаточного срока годности документа"
method: GET
path: "/api/v1/stock/documents/{id}/shelf-life"
tags: ["Stock documents"]
---

# Узнать порог остаточного срока годности документа

`GET /api/v1/stock/documents/{id}/shelf-life`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/documents/{id}/shelf-life`
- 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-1821): задан в документе, у магазина площадки (в том числе у «Отгрузки на маркетплейс», заведённой руками), у покупателя или в настройках склада. Вместе с ним — плановая дата отгрузки, на которую оцениваются партии, и что будет с партией ниже порога, выбранной руками (ERP-2182). У черновика вычисляется по текущим настройкам, у проведённого документа берётся из снимка проведения.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Действующий порог и его источник

- StockDocumentShelfLifeView: Порог остаточного срока годности, действующий на документ, и его источник (ERP-1821); плановая дата отгрузки и режим ручного выбора (ERP-2182). Лестница: документ → магазин площадки (поставка обхода и «Отгрузка на маркетплейс» с marketplace_store) → контрагент (покупатель отгрузки; у перемещения — посредник склада назначения, ERP-2182) → кабинет.
  - `applies` boolean, required: Порог относится к документу: отгрузка покупателю (кроме недельной продажи площадки) или перемещение со своего склада на склад внешней стороны
  - `min_remaining_pct` string, nullable, required: Доля оставшегося срока, %; null — не задана
  - `min_remaining_days` integer, nullable, required: Дней до «годен до»; null — не задано
  - `scale` StockShelfLifeStep[]: Шкала порога остаточного срока по общему сроку годности партии (ERP-2182): ступени по возрастанию границы up_to_months, у последней границы нет. Общий срок ровно на границе — ступень этой границы. Общий срок не определить (нет даты изготовления и срока в карточке) — партия порог не проходит: no_production_date
    - `up_to_months` integer, nullable, required: Граница общего срока, месяцев, включительно; у последней ступени — null (всё, что длиннее предыдущей)
    - `min_remaining_pct` string, nullable, required: Доля оставшегося срока, %: десятичная строка больше 0 и не больше 100, не точнее сотых
    - `min_remaining_days` integer, nullable, required: Дней до «годен до»
  - `source` 'cabinet' | 'contact' | 'store' | 'manual' | 'none', required: Откуда порог: cabinet — настройки склада, contact — контрагент (покупатель отгрузки; у перемещения — посредник склада назначения, а склада площадки без посредника — контрагент её магазинов), store — требование контрагента магазина площадки (ERP-2619), manual — задан в документе, none — порога нет
  - `source_contact_name` string: Чьё это требование (ERP-2619): контрагент документа (contact) или контрагент магазина площадки (store). Поля нет — источник не контрагент
  - `from_posting` boolean, required: Значения взяты из снимка проведения: документ проведён, и смена настроек после проведения их не меняет
  - `ship_date` string, required: Плановая дата отгрузки (YYYY-MM-DD), на которую оцениваются партии; пустая строка — на дату документа. У проведённого — из снимка
  - `chosen_below_minimum` 'block' | 'warn', required: Что будет с выбранной руками партией ниже порога: block — отказ, warn — пометка. У проведённого — из снимка

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `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/a99574d597cc?raw)