Руководство по ТОВАРНО

ТОВАРНО объединяет панель магазина, документы поставщиков и журнал обработки. Работать можно в Telegram или браузере компьютера. Учётные документы прямых отгрузок передаются в МойСклад после проверки таблицы и сопоставления товаров.

Быстрый запуск

1. Откройте бота ТОВАРНО и нажмите «Старт».
2. Нажмите «Открыть ТОВАРНО», чтобы перейти в приложение. На телефоне разделы находятся в нижней панели Fluid, на компьютере — в боковом меню.
3. Для передачи документа выберите «Загрузить документы», затем «Я поставщик» или «Я сотрудник».
4. Прикрепите файл XLSX/CSV или перешлите его из рабочего чата.
5. Откройте журнал и проверьте статус. При неоднозначности бот пришлёт вопрос для уточнения.

В клавиатуре Telegram остаётся одна кнопка «Старт». Она снова открывает сообщение с основными действиями. Кнопки приложения, входа по ссылке, API, загрузки и журнала находятся непосредственно под сообщением бота.

Вход на компьютере

В боте нажмите «Вход по ссылке», затем откройте персональную ссылку или скопируйте её в браузер компьютера. Подтвердите вход на странице. Ссылка действует 10 минут и используется один раз. Сессия браузера действует 12 часов. Для другого браузера или повторного входа запросите новую ссылку.

По завершении работы на чужом компьютере нажмите «Выйти из кабинета». Персональная ссылка даёт вход с вашими правами, поэтому сохраняйте её только для собственного использования.

Светлая и тёмная темы переключаются в шапке приложения. Выбранная тема сохраняется в этом браузере.

Роли и доступ

Пользователь определяется постоянным Telegram ID. К нему относятся профиль, API-ключи, сообщения, файлы, голосовые пояснения и браузерные сессии. Название роли фиксируется при загрузке документа.

Выбор «Поставщик» или «Сотрудник» обозначает автора отправки. Права просмотра определяются серверной настройкой. Обычно пользователю доступны его собственные загрузки. Для текущего группового тестирования 44 участникам предоставлен доступ к общему журналу. В нём они видят документы других участников и могут назначать понятные имена отправителям. Владельцу проекта следует учитывать этот общий доступ при выборе документов для демонстрации.

API-ключ агента даёт доступ к загрузкам своего пользователя. Даже ключ участника с доступом к общему журналу через REST работает в пределах собственных записей.

Загрузка документов

На странице сайта выберите файл и нажмите «Загрузить». Индикатор показывает передачу, после неё сервер сохраняет документ. Можно отменить текущую загрузку. При обрыве связи сначала проверьте журнал, затем повторяйте отправку.

Приём большого файла и автоматическое проведение имеют разные пределы. Сервер хранит документы до 100 МиБ. Текущий импорт прямых отгрузок полностью проверяет таблицу до 20 строк данных. Более крупная таблица попадёт в журнал и потребует проверки.

Подготовка Excel или CSV

Для автоматической прямой отгрузки используйте таблицу с заголовками в первой строке. В XLSX обработчик читает первый доступный лист. Даты удобно записывать текстом в формате ГГГГ-ММ-ДД. Для CSV используйте UTF-8 с BOM и разделитель ;.

Количество и цены должны быть числами. Используйте готовые значения ячеек. Формулы обработчик оставляет для проверки. Сумма строки рассчитывается как количество × цена за единицу.

Скачать демо-таблицу с 12 позициями. В ней вымышленные отгрузки на 30 единиц товара, закупка 41 000 ₽, продажи 65 600 ₽ и разница 24 600 ₽ до комиссий, доставки и налогов. Артикулы и названия соответствуют каталогу демонстрационного аккаунта. Загрузка этого файла запускает реальные операции в подключённом аккаунте МоегоСклада.

Автоматическая обработка и МойСклад

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

Для прямых отгрузок используется отдельный склад «ТОВАРНО | Прямая отгрузка поставщика». На каждый заказ создаётся приёмка от поставщика, затем отгрузка покупателю. В корректно завершённой паре количество поступившего и отгруженного товара совпадает.

Приёмка образует обязательство перед поставщиком. Отгрузка отражает продажу и задолженность покупателя. Фактические поступления и выплаты учитываются отдельными платёжными операциями. Фраза поставщика «жду оплату» остаётся пояснением к документу.

Повторное проведение использует устойчивую комбинацию даты, площадки и номера заказа. Уже созданные документы переиспользуются. Изменение ранее проведённого заказа требует проверки. Если приёмка создалась, а отгрузка прервалась из-за ошибки API, сохранённые документы используются при повторной обработке.

В журнале доступны проверка для МоегоСклада и проведение с подтверждением. Они помогают повторить обработку после исправления проблемы. Участники с общим доступом могут выполнять эти действия в текущей тестовой конфигурации.

Названия, сокращения и сленг поставщика

Обработчик сопоставляет товар по артикулу или коду каталога, затем по уникальному точному названию. Отличающееся название при найденном артикуле тоже может потребовать подтверждения. Для незнакомых слов предлагаются похожие позиции, из которых человек подтверждает нужную.

Чтобы уточнить товар, отправьте боту сообщение по образцу Уточнить 42: термос север = A2S-DEMO-P001. Число 42 замените номером записи журнала, обозначение — текстом из файла, а код — артикулом нужного товара.

Для нескольких неизвестных обозначений отправляйте уточнения последовательно. Промежуточные соответствия сохраняются для данной записи. После полной проверки документ проводится, а подтверждённые соответствия запоминаются для этого поставщика. Уточнение может отправить автор документа или участник с соответствующим доступом к журналу.

В кабинете можно открыть карточку файла, нажать «Проверить для МоегоСклада», указать соответствия и повторить проверку перед проведением.

Журнал загрузок

Журнал открывается кнопкой бота или пунктом кабинета. В каждой записи отображаются документ или сообщение, роль, имя, Telegram ID, время, источник и статус обработки.

Фильтр позволяет выбрать отправителя среди последних 100 записей. Владелец общего доступа может назначить Telegram ID понятное имя или название компании. Назначенное имя отображается вместе с ID, исходное имя при загрузке сохраняется в истории.

У файла доступны «Скачать оригинал» и «Посмотреть и получить резюме». Резюме сообщает число строк, колонок и распознанные итоги. Предпросмотр показывает первые 20 строк. Для слишком большой или неподдерживаемой таблицы интерфейс объясняет ограничение, оригинал остаётся доступным для скачивания.

Источником пересылки служат сведения, доступные в Telegram. При скрытом исходном авторе журнал всё равно фиксирует пользователя, который передал документ боту.

Голосовые пояснения

Отправьте поставщицкий файл, затем запишите голосовое. Для точной связи ответьте голосовым на исходное сообщение с файлом. Если ответа нет, бот связывает аудио с последним файлом этого отправителя за 30 минут.

Оригинал сохраняется отдельно от таблицы. На сервере распознаётся русская речь, текст добавляется в журнал и отправляется сообщением в бот. В карточке виден номер связанного документа. Аудио можно скачать.

Распознавание может ошибаться в именах, артикулах и сленге. Проверьте полученный текст. Уточнение товара задаётся явным соответствием в кабинете или командой «Уточнить» в боте. Для важных цен и количеств источником проведения служат проверенные строки таблицы.

Работа с панелью

В «Сводке» и «Финансах» базовые показатели отражают сохранённый снимок учебного аккаунта МоегоСклада на 10 ноября 2026 года. Общая панель использует эту историческую выборку. Новые проведённые импорты показаны отдельным блоком «Прямые отгрузки поставщиков» с количеством, продажами, долгом поставщикам, дебиторской задолженностью и валовой прибылью.

Блок прямых отгрузок агрегирует проведённые через ТОВАРНО импорты. Последующие оплаты в МоёмСкладе требуют отдельного учёта и синхронизации для обновления этих показателей. Валовая прибыль в этом блоке рассчитана до комиссий и налогов.

Разделы маркетинга и площадок содержат демонстрационные графики. Подключение кабинетов Ozon и Wildberries для загрузки реальных заказов ещё предстоит настроить. Сценарий FBS в панели моделирует резерв, отгрузку и отмену в локальном интерфейсе. Он помогает показать поведение остатков.

Подключение своего агента

1. Выберите роль в боте.
2. Откройте кабинет и раздел «API для агента».
3. Задайте ключу понятное название, например «Агент склада».
4. Сохраните полное значение ключа в секретах своей системы. Оно показывается один раз.
5. Подключите запрос загрузки и опрос статуса по REST API.
6. При прекращении интеграции отзовите ключ в кабинете.

Агент загружает исходные байты XLSX/CSV, передаёт имя файла, SHA-256 и идентификатор отправки. Повтор одного запроса с тем же файлом возвращает ту же запись. Агент получает только документы пользователя, которому принадлежит ключ.

Открыть документацию REST API. В ней приведены заголовки, примеры запросов, ответы, статусы и ошибки.

Частые вопросы

Я нажал «Старт», но вижу старые кнопки

Отправьте /start ещё раз. Бот пришлёт актуальное сообщение с действиями и обновит клавиатуру.

Ссылка для входа перестала работать

Запросите новую через бота. Ссылка одноразовая и действует 10 минут. Для входа на компьютере скопируйте новую ссылку именно в нужный браузер.

Файл загрузился, но показатели ещё не изменились

Откройте журнал и проверьте статус. «Получено» означает сохранение, «Требует уточнения» — необходимость проверки. После статуса «Проведено» результат появится в отдельном блоке прямых отгрузок. Базовая историческая сводка относится к указанному на ней периоду.

Поставщик написал товар своим названием

Посмотрите предложенные варианты в журнале или уведомлении бота и подтвердите наш артикул. Подтверждённое соответствие будет использоваться для этого поставщика при следующих загрузках.

Можно отправить большой Excel

Сайт и API принимают файл до 100 МиБ. Для автоматического проведения используйте текущий шаблон до 20 строк данных. Более крупные таблицы остаются в журнале для проверки.

Я случайно отправил документ повторно

Проверьте номера заказов и статус. Telegram-сообщения защищены от повторной обработки по ID сообщения, а учётные документы — по устойчивому ключу заказа. Отдельная повторная загрузка может создать новую запись журнала, при этом уже проведённые учётные документы переиспользуются. Для агента дополнительно предусмотрен Idempotency-Key.

Голосовое неправильно распознало артикул

Пришлите точный артикул текстом или подтвердите его в кабинете. Транскрипт остаётся пояснением к исходному аудио.

Кто видит загруженный документ

Пользователь видит собственные загрузки. Общий журнал доступен участникам, которым владелец предоставил соответствующие права. В текущей групповой демонстрации общий доступ выдан 44 участникам. API-ключ ограничен документами своего пользователя.