← autokiz.ru

Памятка: подключение и работа с сервисом

Подключение — два шага и минут десять. Ставить ничего не нужно: всё происходит в чате с ботом @autokiz_bot и на странице подписи в вашем браузере.

Шаг 1. Токен Wildberries

Один раз при подключении. Токен создаёт владелец кабинета продавца WB — у сотрудников этого раздела нет.

  1. Кабинет продавца Wildberries → Настройки → Доступ к API → Создать токен.
  2. Отметьте шесть категорий: «Маркетплейс» и «Возвраты покупателями» (заказы и невыкупы), «Контент» (из карточки видно, каким товарам код маркировки нужен, а каким нет — без неё сервис выясняет это по каждому заказу и иногда ошибается), «Аналитика» (разбор спорных кодов), «Статистика» (сверка цены в документе с фактической суммой продажи) и «Финансы» (отчёт реализации: по нему видно коды, которые при сборке не отсканировали, и поздние возвраты).
  3. Галочку «Только на чтение» не ставьте — без записи не подтверждаются статусы заказов.
  4. Напишите боту @autokiz_bot команду /start в личные сообщения и пришлите токен.

Что дальше сделает бот

  • Удалит сообщение с токеном из переписки сразу после проверки — в истории чата он не останется.
  • Сам достанет ИНН и название организации и покажет их на подтверждение — руками вводить ничего не нужно.
  • Если у вас несколько юрлиц — токен второго кабинета присылается так же, в личку; все кабинеты живут в одном чате.

Шаг 2. Одна подпись в браузере

Бот пришлёт кнопку «Открыть страницу». Откройте её на том компьютере, где ваша электронная подпись и КриптоПро — том же, с которого входите в личный кабинет Честного знака. Работает на Windows и macOS.

  1. Откройте страницу по кнопке из бота.
  2. КриптоПро при первом использовании спросит разрешение для сайта — ответьте «Да».
  3. Выберите свой сертификат и подпишите вход. Ключ остаётся у вас: сервер получает только результат подписи.

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

Подпись у другого человека?

Ссылку на страницу можно переслать тому, кто подписывает, — без электронной подписи она бесполезна. В открытые чаты и каналы пересылать нельзя.

Дальше — минута в день

1

Раз в день — подпись входа

Кнопка «✍️ Подписать и подать» в боте (или команда /sign) даёт ссылку на страницу. Одна подпись — окно на день открыто.

2

«Подать всё» одним нажатием

Бот сам приходит с готовой очередью: выводы по продажам и возвраты по невыкупам. Проверяете сводку — и подаёте одной кнопкой.

Первое время документы только готовятся и показываются: в Честный знак ничего не уходит без вашей кнопки. Полный автопилот включаете вы сами, а команда /pause в любой момент останавливает всё.

Команды бота

КомандаЧто делает
/signссылка на страницу подписи (она же — кнопка «✍️ Подписать и подать»)
/таблицаExcel-план по каждому заказу: что делать, почему, какой срок
/xlsxготовые файлы «Вывод из оборота» — если хотите загрузить в свой ЛК ЧЗ руками
/возвратфайл возврата в оборот для ЛК ЧЗ
/pendingчто сейчас ждёт подачи
/allowдать доступ коллеге: ответом на его сообщение, по @username или id
/брендыкабинет бренда по агентскому договору: /бренды @username Бренд1; Бренд2 (см. раздел ниже)
/deny @username -снять доступ у человека (и у человека бренда — во всех его кабинетах бренда)
/agentпрограмма автоподачи на компьютер с подписью — по желанию, для режима «совсем без участия» (Windows)
/pause и /resumeостановить работу и вернуть обратно

Кабинет бренда (агентский договор)

Для фулфилментов и агентов, которые продают в одном кабинете Wildberries товары нескольких юрлиц, где у каждого бренда своя электронная подпись и свой кабинет Честного знака. Коды принадлежат принципалу — и выводит их он, от своего ИНН. Кабинет бренда — это отдельный кабинет в боте: своя страница подписи, свои документы и сводки; заказы его брендов приходят из кабинета агента сами.

Владелец кабинета агента

  1. Убедитесь, что в токене Wildberries отмечена категория «Контент» — она входит в обычные шесть, и из неё сервис берёт список брендов (без неё — из «Статистики», но там лимит в несколько часов на запрос, и список может появиться не сразу).
  2. ⚙️ Кабинет → 👥 Команда и доступ → 🏷 Кабинет бренда. Отметьте бренды одного юрлица и нажмите Готово.
  3. На вопрос «Кому его отдать?» пришлите @username человека бренда в том же чате (он должен был хоть раз написать боту /start). Одной строкой: /бренды @username Бренд1; Бренд2.
  4. В общую группу его добавлять не нужно — он работает из своей лички. Снять доступ: /deny @username -. Оплата остаётся на вас.

Человек бренда

  1. Получает от бота сообщение «Вам открыт кабинет бренда …» с кнопкой «🔏 Открыть страницу подписи» и кнопками внизу.
  2. Открывает страницу подписи и входит своей подписью — ИНН подхватывается из сертификата, вводить ничего не нужно.
  3. Дальше обычная рутина: раз в день — подпись входа, «Подать всё» одним нажатием. Видит только свои заказы и документы; документы уходят от его юрлица.

Если что-то не получается

«Wildberries не принял этот токен»

Обычно не отмечены нужные категории или стоит галочка «Только на чтение». Перевыпустите токен: категории «Маркетплейс», «Возвраты покупателями», «Контент», «Аналитика», «Статистика» и «Финансы», без галочки «Только на чтение». Добавить категорию в готовый токен Wildberries нельзя — нужно создать новый и прислать его боту командой /settoken; бот сам поймёт, какому кабинету он принадлежит, и скажет, если чего-то не хватает.

В плане у всех заказов «нет кода»

Код закрепляется за заказом в момент сборки — когда вы или ваш фулфилмент сканируете DataMatrix с этикетки. Если при сборке коды не сканируются, в Wildberries они не попадают, и взять их сервису неоткуда.

  • Наладьте сканирование при сборке — дальше всё подхватится само.
  • Если коды ведутся отдельно (1С, WMS, таблица) — пришлите боту файл «заказ ↔ код»: xlsx или csv, две колонки — номер сборочного задания и полный код с этикетки.
  • Важно: нужна именно выгрузка из системы файлом. Копирование кодов руками через Excel их ломает — Excel режет служебные символы.

Подставить «любой код этого артикула» нельзя: маркировка поэкземплярная, и сервис такого не делает принципиально.

В плане «статус неизвестен»

Сервис ещё не сверялся с Честным знаком. Проще всего — войти на странице подписи (/sign): статусы подтвердятся сами в течение окна входа.

Документ пришёл без кнопки «Подать»

Не задано место осуществления деятельности (МОД) — обязательный реквизит документа. Оно заводится в ЛК Честного знака: Профиль → Места осуществления деятельности. После входа на странице подписи сервис берёт его из профиля сам; либо скопируйте оттуда идентификатор (ФИАС) и пришлите строкой в чат.

У меня macOS

Страница подписи работает: нужны КриптоПро CSP с действующей лицензией и браузерный плагин — те же, что для входа в ЛК Честного знака. Программа автоподачи (/agent) пока только для Windows.

Часть кодов уже выведена руками

Не страшно: перед каждой подачей сервис спрашивает у Честного знака статус кода и уже выведенные исключает. Дважды один код не уйдёт.

С кабинетом работает несколько человек

Владелец выдаёт доступ командой /allow — ответом на сообщение коллеги, по @username или id. Можно привязать закрытую рабочую группу: добавьте туда бота и напишите /привязать — сводки, алерты и кнопки переедут в неё.