Инструменты и поддержка
Служебные инструменты помогают выполнять массовые операции, печатать специальные этикетки, работать с маркировкой, контролировать импорты, устройства и обращения в поддержку.
Как передать проблему с понятным контекстом
Инструменты помогают проверить загрузку данных, печать и состояние системы, а поддержка — разобрать ошибку конкретной операции. Хорошее обращение позволяет найти причину без повторного запроса всех деталей.
Например, файл загрузился, но часть строк не появилась. Сначала откройте результат импорта: там может быть точная строка и причина. Повторная загрузка всего файла без проверки уже созданных записей может дать дубли.
Укажите адрес своей WMS, номер документа, время, выполненное действие, ожидаемый результат и точный текст ошибки. Пароли, токены и лишние персональные данные в обращение не включайте.
Разделы инструментов
| Управление импортами | Контроль загрузок товаров, заказов, остатков и других файлов. |
|---|---|
| Печать спец. этикеток | Печать нестандартных этикеток для складских задач. |
| Разнесение доставки | Служебная операция для распределения стоимости или параметров доставки. |
| Честный знак | Работа с кодами маркировки, агрегациями и проверкой DataMatrix. |
| Аккаунты | Служебное управление аккаунтами и доступами. |
| Логи OpenClaw | Журнал работы AI-поддержки OpenClaw. Обмен WB/Ozon проверяется в соответствующей интеграции. |
| Диагностика сервера | CPU, память, диски, база данных, очереди, источники нагрузки и история состояния. |
| Принтеры | Настройка устройств печати. |
| Тикетная система | Обращения пользователей в поддержку. |
| Трансляции экранов | Помощь пользователю через просмотр рабочего экрана. |
Управление импортами
- Откройте
Инструменты -> Управление импортами. - Найдите импорт по типу, пользователю, дате, статусу или файлу.
- Откройте детали импорта.
- Проверьте количество строк: всего, успешно, с ошибками, пропущено.
- Изучите сообщения об ошибках.
- Исправьте файл или данные в системе.
- Запустите повторную загрузку, если процесс это допускает.
| Ошибка сопоставления | В файле указано значение, которого нет в NWMS: товар, склад, магазин, статус, доставка. |
|---|---|
| Ошибка формата | Неверная дата, число, кодировка, обязательная колонка или тип файла. |
| Дубликат | Строка уже была загружена или внешний ID не уникален. |
| Частичная загрузка | Часть строк прошла, часть требует исправления. Перед повторной загрузкой проверьте, не появятся ли дубли. |
Печать специальных этикеток
- Откройте
Инструменты -> Печать спец. этикеток. - Выберите тип этикетки.
- Укажите количество экземпляров.
- Выберите принтер и шаблон.
- Распечатайте тестовый экземпляр.
- Проверьте читаемость штрихкода сканером.
- Запустите основную печать.
Для этикеток с кодами всегда проверяйте сканирование после печати. Визуально похожий штрихкод может не читаться из-за масштаба, качества печати или неверного шаблона.
Честный знак и DataMatrix
Раздел используется для контроля маркированной продукции и кодов DataMatrix. В процессах приемки, сборки и отгрузки коды должны быть связаны с товаром, партией, упаковкой или монокоробом, если это предусмотрено правилами клиента.
| Приемка | Сканируйте DataMatrix при поступлении маркированного товара или импортируйте список кодов. |
|---|---|
| Хранение | Код должен оставаться связанным с товаром, местом или упаковочной единицей. |
| Кванты | Если маркированные товары находятся внутри монокороба, фиксируйте связь кода с упаковкой согласно процессу внедрения. |
| Отгрузка | Перед передачей заказа проверьте, что нужные коды списаны или переданы в документ отгрузки. |
| Ошибки | Если код уже использован, не найден или не соответствует товару, заказ лучше перевести в проблемный статус до разбирательства. |
Принтеры
Путь: Устройства -> Принтеры.
- Откройте список принтеров.
- Создайте устройство или откройте существующее.
- Укажите название, тип, подключение и рабочее место.
- Свяжите принтер с нужным складом или столом, если это используется.
- Распечатайте тестовую страницу.
- Проверьте печать реальной этикетки из заказа или упаковочного стола.
| Не печатает | Проверьте доступность устройства, выбранный принтер, очередь печати и права пользователя. |
|---|---|
| Съехала этикетка | Проверьте размер шаблона, размер бумаги и настройки принтера. |
| Не читается штрихкод | Проверьте масштаб, качество печати, тип штрихкода и контраст. |
Логи и техническая диагностика
| Логи OpenClaw | Помогают разбирать работу AI-поддержки. Для складского обмена откройте журнал нужного подключения. |
|---|---|
| Логи заказов | Показывают действия с конкретным заказом. |
| Логи складских документов | Помогают понять, кто создал, изменил или провел документ. |
| Журнал изменений остатков | Показывает движения товаров по складу и внешние выгрузки изменений. |
- Сначала найдите объект проблемы: заказ, товар, приемку, место, интеграцию или пользователя.
- Откройте лог самого объекта.
- Проверьте время ошибки.
- Сравните с техническими логами интеграции.
- Если ошибка повторяется, создайте тикет с точным временем, ID объекта и скриншотом.
Диагностика сервера
Путь: Инструменты -> Диагностика сервера. Раздел доступен администратору или роли с отдельным правом platform.tools.system-health.
| Обзор | Общая оценка состояния, текущие узкие места, CPU и Load Average. |
|---|---|
| Система и диски | RAM, Swap, заполнение дисков, задержки I/O и скорость чтения/записи. |
| База данных | Подключения, активные запросы, блокировки, размер базы и интенсивность SQL. |
| Очереди и приложение | Ожидающие и упавшие задания, возраст старейшего задания и состояние приложения. |
| Источники нагрузки | Процессы и компоненты, которые создают основную нагрузку. |
| Доступность метрик | Показывает, какие показатели удалось собрать на этом сервере и почему часть данных может отсутствовать. |
- Выберите хост и период: 1 час, 6 часов, 24 часа, 7 или 30 дней.
- Проверьте общую оценку и предупреждения об узких местах.
- Сопоставьте время проблемы с графиками базы данных и очередей.
- При необходимости нажмите «Обновить сейчас», чтобы собрать свежий снимок.
- Для технического обращения выгрузите временный JSON, не публикуя его в открытом канале.
Диагностический JSON содержит технические сведения об окружении и действует ограниченное время. Передавайте его только уполномоченной поддержке.
Диагностические сессии поддержки
- Создайте сессию для конкретного обращения и укажите проблемный процесс.
- Соберите снимок состояния и воспроизведите проблему, сохранив точное время, ID документа и correlation/request ID.
- Передайте поддержке ID сессии; не копируйте токены, пароли или персональные данные в комментарий.
- После расследования закройте сессию и убедитесь, что временный расширенный сбор остановлен.
Snapshot — неизменяемый срез на конкретный момент. Он помогает сравнить состояние очередей, планировщика и подключений, даже если ошибка позже исчезла.
Тикетная система
- Откройте
Поддержка -> Тикетная система. - Создайте обращение или откройте существующее.
- Укажите тему, приоритет, раздел системы и описание проблемы.
- Добавьте ID заказа, товара, приемки, склада или другого объекта.
- Приложите скриншот или файл, если он помогает разобраться.
- Отслеживайте ответы поддержки в карточке тикета.
Хороший тикет содержит три вещи: что сделали, что ожидали увидеть и что получили фактически. Без этого поддержке придется задавать уточняющие вопросы.
Трансляции экранов
Раздел нужен, когда поддержку нельзя оказать только по описанию. Пользователь показывает экран, а специалист помогает найти ошибку в интерфейсе или процессе.
- Создайте или откройте обращение в поддержку.
- Запустите трансляцию экрана по инструкции специалиста.
- Покажите проблемный раздел и воспроизведите действие.
- Не открывайте вкладки с паролями, токенами и конфиденциальными данными без необходимости.
- После завершения проверьте, что доступ или трансляция остановлены.
Клиентские скрипты
В меню могут быть отдельные скрипты для конкретных клиентов, например загрузки или специальные обработки. Такие разделы обычно имеют узкое назначение и используются только ответственными пользователями.
| Перед запуском | Проверьте клиента, период, файл и ожидаемый результат. |
|---|---|
| Во время запуска | Не закрывайте страницу, если процесс требует ожидания результата. |
| После запуска | Проверьте лог, количество обработанных строк и результат в основном разделе системы. |
Операционные экспорты и журналы
| Задания Wildberries | Экспортируйте выбранный набор задач в XLSX для сверки идентификаторов, статусов и состава. Экспорт не меняет задания и не заменяет синхронизацию. |
|---|---|
| DataMatrix | Большой экспорт формируется в фоне. Не запускайте одинаковую выгрузку многократно: дождитесь завершения задания и скачайте готовый файл. |
| Маркировка WB | JSON-экспорт журнала сохраняет отфильтрованные события для диагностики без копирования секретов интеграции. |
| Батч-сборка | Журнал сканов показывает сотрудника, место, товар, количество и результат — прикладывайте его при системном расхождении батча. |
| Приёмка | XLSX содержит товар, артикул/SKU, партию, даты, штрихкод, ожидаемое/принятое/размещённое количество и закупочную цену, если она доступна роли. |
Перед передачей файла в поддержку удалите персональные данные и коммерчески чувствительные столбцы, если они не нужны для расследования. Токены и API-ключи не должны попадать ни в экспорт, ни на скриншот.
Как описать проблему, чтобы её можно было проверить
- Укажите адрес своей WMS и точный номер документа: заказ, приёмка, накладная, батч или операция.
- Напишите время возникновения с часовым поясом и рабочий этап.
- Опишите последнее действие, ожидаемый результат и фактическое сообщение.
- Сообщите масштаб: один объект или сколько однотипных документов затронуто.
- Приложите снимок нужной области без паролей, API-ключей и лишних данных покупателей.
- Укажите уже выполненные повторы, чтобы поддержка не запустила ту же операцию ещё раз.
Условный пример: «В 14:20 по времени склада запустили закрытие накладной №… в кабинете …; ожидали завершения, получили no_postings. В документе … отправлений, повтор не выполняли». Такой текст полезнее сообщения «ничего не работает».
Новости системы объясняют изменения установленной версии. Карта этой редакции связывает новые возможности с подробными инструкциями.
Как проверить результат и продолжить
Убедитесь, что импорт или печать завершились с ожидаемым составом. Для обращения сохраните номер тикета и подтверждённый результат исправления.
Если что-то пошло не так
| Ситуация | Что сделать |
|---|---|
| Файл принят, записей нет | Проверьте статус и ошибки задания импорта. |
| Поддержка просит контекст | Передайте конкретный объект и время, а не полный дамп базы или секреты. |