МойСклад

Track stock, profit and purchasing in MoySklad right in the chat

Connect MoySklad to the AI agent: products, counterparties, orders and stock. The agent computes reorder points, finds dead stock and reconciles marketplaces.

How the agent works with МойСклад

The agent connects to MoySklad with an employee API token and works with the whole account: sales and profit, stock and warehouses, counterparties, money in the accounts, documents. The agent's permissions equal those of the employee whose token is connected — the role decides which sections of the JSON API 1.2 the agent sees at all. Related entities it pulls in with the expand parameter, one request instead of a dozen, so going through documents never turns into walking card by card. The connection itself is verified with a request for the list of organizations, so an invalid or revoked token shows up immediately instead of surfacing in the middle of the first report.

The agent counts sales properly: revenue for a period adds up from wholesale shipments and retail sales, while profit and margin per product are calculated from the FIFO cost price. If there are no permissions for cost prices, the agent switches to the purchase price on its own and says so explicitly. Daily sales dynamics, money in the accounts, receivables and payables, the buyers of a specific product with their phone numbers — all straight from the account, with no manual exports. The agent detects the accounting currency automatically, be it rubles, tenge or another one, and never confuses kopecks with rubles: MoySklad returns amounts in kopecks, and that is accounted for everywhere.

Stock comes as a single overview: units and money, a breakdown by warehouse, zero and negative positions as separate counters. The most useful part for purchasing is the positions below the minimum stock level, and there is a trap here that is not visible in the API at first glance: MoySklad does not return per-warehouse thresholds in ordinary requests, so a naive check decides that no minimum is configured while dozens of positions sit below it. The agent uses the proper server-side filter and finds them all — including cases where the balance is positive but still below the threshold of that particular warehouse.

For the shortages it finds the agent prepares documents: a draft internal order to replenish a warehouse, or draft purchase orders grouped by the supplier from the product card, with demand forecast based on sales velocity and lead time. Documents are created in the account only after your explicit yes: the agent shows exactly what it is about to create and waits for confirmation. Products with no supplier in the card are listed as a separate line instead of being silently skipped.

The agent paces its own requests: no more than seven calls per second to the API and no more than three per second to the heavy stock reports, so the account does not hit the limits while the agent collects data. If the role lacks permissions, the agent names the missing section right in the chat and asks you to extend the employee role — instead of a cryptic 403 error in the middle of a report. The data itself comes straight from the API directories, entity metadata and report slices rather than from a pre-exported copy, so the numbers in the chat match what is in the account right now.

Integration scenarios

Stock levels and reorder points

The agent checks stock across warehouses, compares it with sales velocity and shows what it is time to reorder from your supplier.

Turnover and dead stock

The agent calculates turnover per product, finds the dead stock frozen in your warehouse balances and estimates the cash tied up in it.

Reconcile sales with marketplaces

The agent reconciles MoySklad shipments with Ozon and WB orders and finds quantity discrepancies and sales missing from the books.

Order profitability report

The agent builds a profit report using cost prices from MoySklad, broken down by product, counterparty and period.

Purchase orders as drafts

The agent gathers the shortages, groups them by the supplier from each product card, forecasts demand from sales velocity and creates the drafts only after your yes.

Cash, receivables and payables

The agent brings the money in your accounts together with receivables and payables and shows in one picture how much cash you hold, who owes you and whom you owe.

МойСклад examples

МойСклад
Frozen chats — click a question
Что у нас просело ниже неснижаемого остатка?

Ниже неснижаемого остатка 38 позиций, дефицит на 1,24 млн ₽.

  • «Профметалл» — 14 позиций на 520 тыс ₽
  • «Крепёж-Юг» — 11 позиций на 310 тыс ₽
  • «Сибтекстиль» — 9 позиций на 280 тыс ₽
  • Ещё 4 позиции на 130 тыс ₽ без поставщика в карточке — вынес отдельной строкой, а не пропустил молча

Пороги по складам МойСклад обычным запросом не отдаёт: наивная проверка решила бы, что неснижаемый остаток не настроен. Брал серверным фильтром, поэтому в список попали и позиции с положительным остатком, но ниже порога своего склада.

Дефицит по поставщикам

Document · XLSX

How to connect

Before you connect

  • A role with access to products, orders, shipments, stock and reports
  • Permission for cost prices if you need FIFO margin
  • Write permission if the agent creates orders and transfers
  1. 1

    Create a separate robot employee

    «Меню пользователя» → «Настройки» → «Сотрудники» → «+Сотрудник» (Settings → Employees): last name, login, e-mail. Keep «Разрешить вход в систему» (allow sign-in) ticked.

  2. 2

    Limit what that employee may see

    In his card: «Системные роли» → «Пользователь» → «Настроить права» (System roles → User → Configure rights). Only «Профессиональный» and «Корпоративный» plans.

  3. 3

    Turn on «Доступ по API» (API access)

    Without the «Доступ по API» (API access) flag the API rejects his requests. Only a user with the «Администратор» (admin) role can switch it on.

  4. 4

    Request the access_token from the API

    POST https://api.moysklad.ru/api/remap/1.2/security/token with that employee's Basic auth returns the “access_token” field. A new token revokes earlier ones.

FAQ

With an employee API token: create a dedicated robot employee under User menu, Settings, Employees, switch on API access for them and get the key with a POST /security/token request. Token permissions inherit the employee role, so the robot role is what defines what the agent will see.

Products, counterparties, orders, shipments, stock and reports of the JSON API 1.2, within the role of the employee whose token is connected.

It can, creating purchase orders or internal transfers for example, if the role allows writing. By default the agent works in read and analytics mode.

The agent tells you right in the chat which section is missing and asks you to extend the employee role, with no cryptic 403 errors.

Skills for МойСклад

Related integrations

Connection
API key
Documentation
МойСклад

Connect МойСклад

Connecting takes a couple of minutes, and your data stays in your own systems.

Connect