Считайте остатки, прибыль и закупки МойСклад прямо в чате

Агент подключается к МойСклад по API-токену сотрудника и работает со всей учёткой: продажи и прибыль, остатки и склады, контрагенты, деньги на счетах, документы. Права агента равны правам сотрудника, чей токен подключён, — роль решает, какие разделы JSON API 1.2 он вообще увидит. Связанные сущности он подтягивает параметром expand, одним запросом вместо десятка, поэтому разбор документов не превращается в перебор карточек. Само подключение проверяется запросом к списку организаций, так что неверный или отозванный токен виден сразу, а не всплывает посреди первого отчёта.

Продажи агент считает по-настоящему: выручка за период складывается из оптовых отгрузок и розничных продаж, а прибыль и маржа по товарам считаются от себестоимости FIFO. Если прав на себестоимость нет, агент сам переключится на расчёт от закупочной цены и прямо скажет об этом. Динамика продаж по дням, деньги на счетах, дебиторка и кредиторка, покупатели конкретного товара с телефонами — всё из учётки, без ручных выгрузок. Валюту учёта агент определяет автоматически — рубли, тенге или другую — и не путает копейки с рублями: в МойСклад суммы приходят в копейках, и это учтено везде.

Остатки агент показывает единым обзором: штуки и рубли, разбивка по складам, нулевые и минусовые позиции отдельными счётчиками. Самое полезное для закупок — позиции ниже неснижаемого остатка, и здесь есть ловушка, которой не видно в API с первого взгляда: пороги по складам МойСклад в обычных запросах не отдаёт, и наивная проверка решает, что «неснижаемый не настроен», хотя под минимумом десятки позиций. Агент использует правильный серверный фильтр и находит их все — включая случаи, когда остаток положительный, но ниже порога конкретного склада.

По найденному дефициту агент готовит документы: черновик внутреннего заказа на пополнение склада или черновики заказов поставщикам, сгруппированные по поставщику из карточки товара, с прогнозом потребности по скорости продаж и сроку поставки. Создание документов в учётке — только после вашего явного «да»: агент показывает, что именно собирается создать, и ждёт подтверждения. Товары, у которых поставщик в карточке не указан, он выделит отдельной строкой, а не пропустит молча.

Темп запросов агент держит сам: не больше шести обращений в секунду к API и не больше двух в секунду к тяжёлым отчётам по остаткам, поэтому учётка не упирается в лимиты, пока агент собирает данные. Если роли не хватает прав, агент прямо в чате назовёт недостающий раздел и попросит расширить роль сотрудника — вместо загадочной ошибки 403 посреди отчёта. Данные при этом берутся напрямую из справочников, метаданных сущностей и срезов отчётов API, а не из заранее выгруженной копии, поэтому цифры в чате совпадают с тем, что в учётке прямо сейчас.