Проверка YML-фида

YML-фид — XML-документ с данными магазина, категориями и товарными предложениями. Начните с реальной выгрузки, которую получает Маркет: локальный файл может отличаться от опубликованного. Инструмент проверяет XML-синтаксис, корневой yml_catalog, секцию shop, offers и повторяющиеся offer id. Для предложений он также отмечает отсутствие базовых полей цены, валюты и категории. Такой результат помогает быстро поймать ошибки сборки файла до отправки в кабинет площадки.

Если повторяется offer id, найдите источник идентификатора в каталоге. Часто он берётся из символьного кода или внешнего ID, который был скопирован при создании варианта товара. Исправление только готового XML бесполезно, если следующий экспорт снова создаст дубль. Проверьте, что categoryId действительно соответствует существующей категории, валюта объявлена в currencies, а цена имеет формат, допустимый для вашего типа размещения. Эта локальная проверка не делает сетевых запросов к изображениям и товарным URL.

Вставьте YML или загрузите XML-файл. Проверка покажет отсутствующие секции и дубли offer id.

Начните с кнопки «Вставить пример», чтобы увидеть ожидаемый формат ввода. Затем замените демонстрационные значения своими данными в полях «Исходные данные». Нажмите «Получить результат». Если формат неверный, инструмент покажет ошибку на русском языке; исправьте исходные данные и повторите действие.

Готовый результат можно скопировать одной кнопкой или скачать в файл yml-report.txt. Проверьте итог перед публикацией на рабочем сайте: инструмент видит только переданные ему данные и не знает особенностей вашего проекта. Для больших выгрузок удобно сначала обработать небольшой фрагмент и убедиться, что структура результата подходит дальнейшему процессу.

Повтор offer id="sku-1" будет отмечен как конфликт идентификатора.

<?xml version="1.0"?><yml_catalog date="2026-11-04T12:00+03:00"><shop><name>Магазин</name><company>ООО Пример</company><url>https://example.com</url><currencies><currency id="RUB" rate="1"/></currencies><categories><category id="1">Каталог</category></categories><offers><offer id="sku-1"><name>Товар</name><price>100</price><currencyId>RUB</currencyId><categoryId>1</categoryId></offer></offers></shop></yml_catalog>

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

Это структурная диагностика. Она не заменяет импорт в кабинет Маркета и не проверяет актуальность цен или наличие изображений по сети.

Технически корректный результат ещё не означает, что он подходит бизнес-логике сайта. Например, URL может быть синтаксически верным, но вести на удалённую страницу; XML может быть хорошо сформированным, но не соответствовать настройкам конкретной площадки. После автоматической проверки откройте итог в целевой системе или браузере и сравните его с ожидаемым поведением.

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

У Маркета есть собственные правила для разных схем размещения и категорий товара, поэтому структурно корректный файл всё равно может получить ошибки импорта. После локальной проверки загрузите его в соответствующий кабинет и разберите сообщения площадки. При больших выгрузках полезно сохранять исходный файл, время генерации и список изменений относительно предыдущей версии. Если магазин связан с 1С или ERP, следите за согласованностью SKU, остатков и цен: проблема может возникать на этапе обмена задолго до формирования YML.

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

Для YML особенно важна стабильность offer id. Площадка связывает обновления товара с этим идентификатором; если он меняется при каждом экспорте, обновления могут восприниматься как новые записи. Сравните несколько выгрузок и убедитесь, что идентификатор сохраняется для одного SKU. Затем проверьте, что цены и остатки соответствуют учётной системе на момент формирования файла. Локальный анализатор структуры не знает актуальных данных магазина, поэтому контрольные товары нужно сверять вручную или автоматическим мониторингом. При ошибке категории проверьте обе стороны ссылки: categoryId предложения и id в списке categories.

Отдельно разберите кодировку файла. Фид может объявлять Windows-1251 или UTF-8; браузерный загрузчик учитывает XML-декларацию и BOM. Если текст товара выглядит искажённым, проверьте, не перепутал ли источник кодировку при записи байтов. Не вставляйте исправленную руками копию как доказательство, что опубликованный URL тоже корректен. Скачайте ответ того адреса, который указан в кабинете Маркета, и проверьте его после очередной автоматической выгрузки. Для крупных магазинов полезен журнал времени генерации, объёма файла и числа предложений.

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

Поля этого инструмента обрабатываются в вашем браузере. Содержимое не отправляется на сервер Pugofka, а локальный файл читается только после вашего выбора. Для XML определяется кодировка из объявления или BOM; при отсутствии подсказки сначала пробуется UTF-8, затем Windows-1251. Виджет скрыт от записи содержимого в Вебвизоре; в Яндекс Метрику передаются slug инструмента и тип действия — открытие, первое взаимодействие, запуск, получение результата, копирование или скачивание.

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

Используйте результат как рабочий черновик: вставьте его в конфигурацию, страницу или документ и повторно проверьте там, где он будет применяться. Если вы меняете индексируемые страницы, обновите связанные ссылки и карту сайта. Для миграции URL дополнительно запустите сетевую проверку редиректов, чтобы увидеть фактические HTTP-ответы после публикации.

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