Ошибка unexpected token in JSON на Wildberries: причины и решение

Если вы занимаетесь автоматизацией процессов на маркетплейсе Wildberries, то рано или поздно можете столкнуться с техническими сбоями при обмене данными. Особенно неприятно, когда работа встает из-за непонятного сообщения об ошибке, которое не дает ни загрузить остатки, ни обновить цены. Одной из самых распространенных и пугающих новичков проблем является сообщение unexpected token in json at position 2. Эта ошибка часто возникает при попытке выгрузки отчетов, настройке API или работе со сторонними сервисами аналитики.

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

На практике эта ошибка говорит о том, что программа, которая читает файл или ответ от сервера, ожидает увидеть строго определенную структуру данных (формат JSON), но натыкается на символ, который там быть не должен. Позиция 2 означает, что проблема находится практически в самом начале строки. Это критически важно для диагностики, так как сужает круг поиска до первых символов вашего файла или запроса.

Где искать источник ошибки в интерфейсе и логах

Если хотите точно определить, где именно возник сбой, нужно внимательно проанализировать контекст появления сообщения. Чаще всего эта ошибка всплывает в двух основных сценариях: при ручной загрузке файлов через личный кабинет продавца или при настройке автоматического обмена данными через API. В первом случае вы просто видите красное уведомление после нажатия кнопки «Загрузить». Во втором — ошибка может быть скрыта в логах вашей ERP-системы или сервиса аналитики.

Важный момент: если вы используете сторонние сервисы для управления продажами, ошибка может приходить не от Wildberries напрямую, а от вашего сервиса-посредника. В таком случае нужно проверить, правильно ли сформирован запрос к API маркетплейса. Часто бывает, что сервис пытается отправить данные, а сервер WB возвращает ошибку, которую программа-клиент интерпретирует как сбой JSON-парсера.

При работе в личном кабинете Wildberries обратите внимание на формат файла, который вы пытаетесь загрузить. Система ожидает чистый JSON или XML (в зависимости от раздела), но часто пользователи случайно копируют текст вместе с лишними символами из буфера обмена или текстовых редакторов. Даже один лишний символ в начале файла приведет к тому, что парсер «споткнется» на второй позиции.

Анализ логов API и ответов сервера

Для тех, кто работает с API, критически важно уметь читать сырые данные (raw data). Когда вы получаете ответ от сервера, он должен быть валидным JSON-объектом. Если вместо ожидаемой открывающей скобки { или [ на второй позиции стоит какой-то другой символ, парсер выдаст ошибку. Это может быть буква, цифра или даже невидимый символ кодировки.

Вот что нужно сделать: включите режим отладки в вашем софте или используйте инструменты вроде Postman для просмотра полного ответа сервера. Часто бывает так, что сервер вместо JSON-ответа возвращает HTML-страницу с ошибкой (например, страницу «502 Bad Gateway» или страницу авторизации), и парсер пытается прочитать HTML-тег как JSON, что и вызывает сбой.

Проверка загружаемых файлов остатков и цен

Если вы загружаете прайс-лист или файл с остатками, убедитесь, что он сохранен в правильной кодировке. Стандарт де-факто для веб-сервисов — это UTF-8 без BOM (Byte Order Mark). Наличие метки BOM в начале файла как раз может сместить позицию первого значимого символа и вызвать ошибку на второй позиции. Проверьте настройки вашего текстового редактора или Excel-плагина перед сохранением.

Пошаговая инструкция по устранению сбоя

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

Вот что нужно сделать:

1. Откройте файл, вызывающий ошибку, в текстовом редакторе, поддерживающем отображение скрытых символов (например, Notepad++, VS Code или Sublime Text). Не используйте стандартный «Блокнот» Windows, так как он может скрывать важные детали кодировки.
2. Внимательно посмотрите на самый начало файла. Первый символ должен быть открывающей фигурной скобкой { или квадратной [, если это массив. Если перед ними есть пробелы, переносы строк или другие символы — удалите их.
3. Проверьте кодировку файла. В меню редактора найдите пункт «Кодировки» (Encoding) и выберите «Преобразовать в UTF-8 без BOM» (Convert to UTF-8 without BOM).
4. Сохраните файл и попробуйте загрузить его снова. Если ошибка повторяется, проверьте содержимое на предмет нарушения синтаксиса JSON (например, отсутствие запятой между полями или лишняя запятая в конце).

Если вы работаете через API и видите ошибку в логах, попробуйте выполнить тот же запрос через браузер или Postman. Если в брауере вы видите корректные данные, а программа выдает ошибку, значит, проблема в том, как программа обрабатывает ответ. Возможно, она не умеет (правильно обрабатывать) сжатие данных (gzip) или получает пустой ответ.

Использование валидаторов JSON

Один из самых быстрых способов найти ошибку — использовать онлайн-валидаторы. Скопируйте содержимое вашего файла или ответа сервера и вставьте его в поле проверки. Сервис подсветит строку и символ, где структура нарушена. Это сэкономит вам часы всматривания в код.

Важный момент: если валидатор показывает, что JSON корректен, но Wildberries все равно выдает ошибку, возможно, нарушена структура полей внутри JSON. Убедитесь, что названия ключей (например, offerID, quantity) написаны точно так, как требует документация, с соблюдением регистра букв.

Нюансы работы с API и сторонними сервисами

При интеграции Wildberries с внешними системами часто возникают конфликты версий или настроек. Ошибка unexpected token может быть следствием того, что сервис отправляет данные в старом формате, который маркетплейс уже не поддерживает, или наоборот — пытается прочитать ответ в новом формате.

Если вы используете готовое решение (например, МойСклад, 1С или специализированные сервисы аналитики), первым делом обратитесь в их техподдержку. Скорее всего, у них уже есть готовое решение или обновление, так как они отслеживают изменения на стороне WB. Самостоятельное вмешательство в код интеграции без знаний программирования может только ухудшить ситуацию.

Проблемы с авторизацией и токенами

Иногда сервер вместо JSON-данных возвращает сообщение об ошибке авторизации в текстовом виде. Парсер ожидает JSON, видит текст «Unauthorized» или «Invalid Token», и так как первый символ не является скобкой, выдает ошибку токена на второй позиции. Проверьте актуальность вашего API-ключа в личном кабинете.

В таблице ниже приведены распространенные коды ответов и их влияние на формирование JSON:

Лимиты запросов и таймауты

Wildberries устанавливает строгие лимиты на количество запросов к API. Если ваш сервис пытается отправить слишком много запросов одновременно, сервер может отбросить часть из них или вернуть некорректный ответ. Это часто приводит к ошибкам парсинга.

Типичные ошибки и подводные камни

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

Вот список типичных ошибок, которые приводят к появлению unexpected token:

• Наличие BOM-маркера в начале файла при кодировке UTF-8. Это невидимый символ, который многие редакторы добавляют по умолчанию, но серверы его не любят.
• Использование одинарных кавычек вместо двойных для ключей и строк в JSON. Стандарт JSON допускает только двойные кавычки.
• Наличие запятой после последнего элемента в массиве или объекте. В некоторых языках программирования это допустимо, но строгий JSON-парсер выдаст ошибку.
• Попытка загрузить файл Excel (.xlsx) там, где требуется CSV или JSON. Иногда пользователи просто меняют расширение файла, не конвертируя его содержимое.

Скрытые символы в названиях товаров

Иногда ошибка возникает не в структуре файла, а в содержании. Если в названии товара или артикуле есть спецсимволы (кавычки, обратный слэш), они могут ломать JSON-структуру при выгрузке. Используйте экранирование символов.

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

Ошибки в синтаксисе JSON

Помните, что JSON очень чувствителен к синтаксису. Ключи должны быть в кавычках, строковые значения тоже. Нельзя использовать комментарии внутри JSON-файла. Любое отклонение от строгой грамматики приведет к отказу сервера принять файл.

Профилактика и лучшие практики работы с данными

Чтобы ошибка unexpected token in json at position 2 перестала быть вашим постоянным спутником, стоит внедрить несколько правил работы с данными. Это касается как ручной загрузки, так и автоматических процессов.

Во-первых, всегда используйте специализированный софт для редактирования кода и данных, а не простые текстовые файлы. Во-вторых, настройте автоматическую валидацию файлов перед отправкой. Многие современные ERP-системы имеют встроенную проверку, но если вы формируете файлы вручную или через макросы Excel, добавьте шаг проверки через скрипт или онлайн-сервис.

Также важно следить за обновлениями документации Wildberries. Платформа постоянно развивается, и требования к форматам данных могут меняться. То, что работало полгода назад, сегодня может вызвать ошибку. Регулярно проверяйте разделы для разработчиков и новости для селлеров.

Если вы используете сторонние сервисы, убедитесь, что они обновлены до последней версии. Разработчики таких решений оперативно реагируют на изменения API маркетплейсов и выпускают патчи, устраняющие подобные баги.

Автоматизация проверки данных

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

Внедрение таких простых практик позволит вам тратить меньше времени на борьбу с техническими ошибками и больше — на развитие бизнеса и анализ продаж. Стабильность работы с данными — фундамент успешной торговли на маркетплейсе.

Что делать, если ничего не помогает

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

Вот что нужно сделать в таком случае: подождите 15-30 минут и попробуйте снова. Если ошибка persists (сохраняется), попробуйте выполнить действие с другого IP-адреса или устройства. Иногда помогает очистка кэша браузера или смена сети (например, переключение с Wi-Fi на мобильный интернет).

Если и это не помогло, остается только обратиться в техническую поддержку. При обращении обязательно приложите скриншот ошибки, пример файла (обезличенный) и точное время возникновения проблемы. Это ускорит процесс диагностики со стороны специалистов площадки.

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