Stock batches

Получить остатки по партиям со сроками

Остатки по партиям (ERP-1788): строка — партия × склад × юрлицо × состояние с ненулевым остатком регистра stock на дату as_of. Срок, серия и выпуск — из карточки партии. ОСГ — доля остаточного срока годности: (до − дата ОСГ) / (до − от) × 100 по основанию кабинета (по дням или по месяцам), округление до 0,1, границы 0..100; без даты выпуска — null. Дата ОСГ — shelf_as_of, по умолчанию as_of: остаток — на as_of, ОСГ, дни до срока и shelf — на shelf_as_of (ERP-2182, плановая дата отгрузки документа). shelf: none — без срока, expired — годен до раньше даты ОСГ, critical / warning / ok — по градациям кабинета (grades, настройки склада; по умолчанию ОСГ < 30, 30–70, от 70; без ОСГ — по дням до срока: ≤ 30, ≤ 90). С порогом min_remaining_pct / min_remaining_days строка называет shelf_life_reason — почему подбор партий проведения её не возьмёт на дату ОСГ. Сортировка fefo — порядок, в котором «Авто» спишет партии. Только чтение: запретов отгрузки здесь нет.

get/api/v1/stock/batch-stock

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/stock/batch-stock
  • 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

Query parameters

product_idstring uuid
warehouse_idstring uuid

Склад вместе с его зонами

warehouse_idsstring

Несколько складов через запятую (узел дерева с поддеревом)

company_idstring uuid
business_idstring uuid
condition_idstring

Состояние: не задано — все, main — «Основное», иначе id состояния

searchstring

Название или SKU товара, серия

shelfstring

Состояния срока через запятую: expired, critical, warning, ok, none

expires_within_daysinteger

Годен до не позже as_of + N дней (просроченные входят)

osg_belownumber

ОСГ меньше N процентов; партии без ОСГ не входят

as_ofstring date

Дата остатка и срока; по умолчанию сегодня по календарю кабинета

shelf_as_ofstring date

Дата, на которую считаются ОСГ, дни до срока, shelf и shelf_life_reason (ERP-2182): плановая дата отгрузки. По умолчанию as_of; остаток всегда на as_of

min_remaining_pctstring

Порог остаточного срока, %: строка получает shelf_life_reason по правилу проведения. Десятичная запись больше 0 и не больше 100

min_remaining_daysinteger

Порог остаточного срока в днях до «годен до» для shelf_life_reason

seriesstring

Строки одной серии (ERP-2199): номер серии без учёта регистра и пробелов

group'series'

series — строка на серию товара в месте хранения (склад × юрлицо × состояние, ERP-2199): партии серии сложены, series_batch_count — сколько их; срок, ОСГ и полоса — у партии, которую «Авто» возьмёт первой; цена — средняя по серии. Партия без серии — своя строка

sort'fefo' | 'expires_at' | 'osg' | 'product' | 'warehouse' | 'qty' | 'amount' | 'received_at' | 'batch_code'
direction'asc' | 'desc'
limitinteger
offsetinteger
min_remaining_scalestring

Порог шкалой по общему сроку (ERP-2182) для shelf_life_reason: JSON-массив ступеней {up_to_months, min_remaining_pct, min_remaining_days}; задан — min_remaining_pct и min_remaining_days не читаются

unavailable_onlyboolean

Только брак, карантин и просрочка вне транзита; включает товар без партии (нулевой batch_id)

without_companyboolean

Только остаток без юрлица

Headers

X-Tenantstring required

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

Response

Страница остатков по партиям

countinteger required
limitinteger required
offsetinteger required
as_ofstring date required
shelf_as_ofstring date required

Дата ОСГ и градаций (ERP-2182)

Changes

No recorded changes to this operation across all 1 revision of this API.