Если файл автозагрузки обработан, а нужного объявления нет или в нём старая цена, начните с одной позиции. Сохраните её идентификатор, версию файла и результат обработки. Затем пройдите путь от исходных данных до страницы объявления. Так можно установить участок сбоя, не меняя весь каталог вслепую.
Результатом будет журнал диагностики: что ожидалось, что фактически находится в источнике, что попало в XML и что сообщает Авито. Для первой проверки нужны доступ к своему каталогу и отчёту, ссылка на используемый файл и одна проблемная позиция. Изменять расписание, публиковать весь ассортимент заново или подключать API ради этого не требуется.
Разделите четыре независимых результата
Фидом называют файл, который передаёт данные объявлений. XML задаёт структуру этих данных. Корректная структура позволяет программе прочитать файл, но ещё не подтверждает соответствие конкретной категории и правилам размещения.
| Результат | Подтверждение | Следующий вопрос |
|---|---|---|
| XML читается | Проверка синтаксиса | Подходят ли данные категории? |
| Файл обработан | Результат нужной загрузки | Что с отдельной позицией? |
| Объявление опубликовано | Статус и страница | Верны ли условия? |
| Пришло обращение | Запись обращения | Чем закончилась работа? |
Записывайте эти результаты отдельно. Формулировка «выгрузка работает» слишком широка для приёмки: файл может читаться, но передавать цену другой комплектации. Опубликованные объявления также не подтверждают обращения или продажи. Для них нужен собственный учёт.
Сохраните исходное состояние
Выберите одну проблемную позицию и одну исправную из той же категории. Выпишите внутренний артикул, Id из файла и номер объявления на Авито, если он уже есть. Это разные идентификаторы: один относится к вашей системе, другой используется для связи записи фида, третий обозначает объявление площадки.
Сохраните время проблемной загрузки, полный текст сообщения, адрес файла и дату его формирования. У времени укажите часовой пояс. Сделайте копию проверяемого файла до изменений, чтобы сравнивать именно те данные, которые могли участвовать в загрузке. Не прикладывайте файл целиком к публичному обсуждению: в нём могут быть служебные сведения.
Запишите, когда впервые заметили сбой и что менялось перед этим: структура каталога, экспорт, категория, изображения, домен файлового хранилища. Совпадение по времени помогает выбрать проверку, но само по себе не доказывает причину.
Проверьте точную ссылку из настроек
Скопируйте адрес, который фактически используется автозагрузкой, и откройте его без входа в свою систему. Убедитесь, что получаете файл с ожидаемыми данными, а не страницу авторизации, сообщение сервера или пустой ответ. Не заменяйте ссылку предположительно правильной до фиксации исходного результата.
Найдите в полученном файле выбранный Id и сравните цену, название и изображения с источником. Если исходная карточка уже обновлена, а файл содержит прежние сведения, разбираться нужно в формировании фида. Возможные участки проверки: отбор товаров, расписание генерации, сохранённая копия и кеш файлового сервера.
Успешное открытие файла в вашем браузере не доказывает, что Авито получил его в нужный момент. Если отчёт сообщает проблему получения, попросите технического исполнителя сопоставить время запроса и ответ вашего сервера. Проверьте ограничения доступа и перенаправления, сохраняя служебные ключи закрытыми.
Отделите синтаксис XML от правил категории
Проверка синтаксиса относится к записи элементов: открывающие и закрывающие теги, допустимые символы, кодировка. Если проверка указывает строку и столбец, начните с этого места и соседних данных. Ошибка в одном незакрытом элементе может мешать чтению последующей части файла.
Например, обычный знак амперсанда в текстовом значении XML требуется записать как &, чтобы он прочитался как символ текста. Правила записи специальных символов и структуры описаны в спецификации XML. Исправлять экранирование лучше в генераторе, иначе следующая выгрузка снова запишет исходный проблемный символ.
Не применяйте замену символов ко всему файлу без разбора: уже корректно записанные значения можно испортить повторным экранированием. Если файлы формирует программа, поручите разработчику проверку средствами XML, а не набором текстовых замен. Для ручной подготовки сохраняйте исходную копию и проверяйте результат после каждого небольшого изменения.
Далее откройте актуальные требования своей категории в документации, доступной из Авито. Проверьте обязательные поля, допустимые значения и описание изображений. Инструкция соседней категории может не подходить. В официальном материале «Авито для бизнеса» об автозагрузке XML рассматривается подготовка файла; опубликованный в 2024 году ролик не заменяет текущие требования полей.
Сверьте товар по одному полю
- Категория. Убедитесь, что выбранная категория соответствует предмету объявления. Сопоставьте обязательные поля с её текущим шаблоном.
- Модель. Сравните артикул и комплектацию. Похожее название может скрывать другой размер или вариант.
- Цена. Сверьте источник, XML и объявление. Уточните единицу продажи: штука, комплект или иная допустимая единица.
- Наличие. Проверьте источник и условия продажи. Запишите, как компания обрабатывает закончившиеся позиции по правилам своей категории.
- Изображения. Откройте ссылки без авторизации, затем сравните сами фотографии с моделью.
- Описание. Проверьте соответствие реальному товару, цену и условия внутри текста, если они повторяются там.
В журнале указывайте точное расхождение: «в источнике комплект из двух предметов, в описании указана цена за один». Запись «неверные данные» вынуждает исполнителя повторять диагностику. Если одно поле берётся из нескольких источников, назначьте главный и определите правило обновления.
Проверьте сохранность Id между двумя версиями файла. Существующая позиция не должна получать случайный новый идентификатор при каждой генерации. Не меняйте Id только ради повторной попытки исправления: сначала выясните, какую связь вы нарушите. При переносе в другую систему подготовьте таблицу соответствий и согласуйте порядок обработки существующих объявлений.
Читайте сообщение по конкретной позиции
В результате обработки найдите именно выбранный Id. Сверьте время и версию: легко принять старую ошибку за результат уже исправленного файла. Сохраните полный текст сообщения вместе с названием поля и переданным значением. Короткая пометка «ошибка категории» может скрывать разные причины у разных товаров.
Если сообщение описывает недопустимое значение, сравните его с текущим перечнем для категории. Если речь об изображении, проверьте получение файла и сам снимок. Если затронуты условия размещения, исправный XML проблему не решит: нужно разобраться в требовании, не подменяя товар или описание для обхода проверки.
Не запускайте повторные загрузки подряд, пока неизвестно, какая версия обрабатывается. Дождитесь понятного результата в действующем порядке работы. Если остаётся вопрос к площадке, подготовьте одну карточку диагностики вместо длинного сообщения о том, что «не работает весь XML».
Учебный пример: цена исправляется только на один день
Источник: цена указана за комплект. В файле после ночной генерации снова появляется цена отдельной единицы. Вручную исправленный файл отображает комплект правильно до следующего обновления. Гипотеза: экспорт берёт значение из другого поля. Проверка: сравнить правила сопоставления и две последовательные версии фида. Исправление принимается после новой штатной генерации, когда выбранный Id сохраняется, а цена и единица соответствуют источнику.
Все данные в этом примере учебные. Он показывает, почему ручное исправление опубликованного значения может не устранить причину. Длительность проверки определяется очередным согласованным обновлением, а не обещанием «всё готово» сразу после сохранения настройки.
Как принять исправление
Сначала подтвердите изменение в источнике или генераторе. Затем проверьте новую версию файла, результат её обработки и конкретную страницу объявления. Сравните цену, комплектность, фотографии и условия. Рядом сохраните прежнее сообщение и новое состояние.
Добавьте исправную контрольную позицию: исправление общего шаблона не должно испортить её данные. Если меняли экспорт нескольких категорий, нужен хотя бы один согласованный пример каждого затронутого правила. Повторите сверку после очередного штатного обновления, чтобы убедиться, что правка сохраняется.
Короткое задание исполнителю может звучать так: «Для указанных Id установить источник цены, исправить сопоставление, сохранить идентификаторы, показать файл до и после, проверить результат обработки и видимую цену. Не включать в работу другие категории без отдельного списка».
Когда новая интеграция не нужна
Если проблема ограничена одной неверной характеристикой, начните с её источника и правил экспорта. Новый сервис не исправит неправильную товарную карточку автоматически. Если ошибка возникает только у устаревшей ссылки на фото, оцените исправление хранилища до замены всей схемы загрузки.
Отдельная разработка оправдана, когда действующий процесс не умеет поддерживать нужные данные, сохранять связи или показывать результаты обработки. До покупки сформулируйте эти ограничения на конкретных позициях и договоритесь о проверке. Публичный пример работы с каталогом и автозагрузкой помогает обсудить состав такой задачи без обещаний продаж.
Словарь
- Фид: файл с данными для передачи площадке.
- XML: формат структурированной записи данных.
- Id: идентификатор позиции в файле; храните его связь с товаром.
- Генератор: программа, которая собирает файл из источников.
- Сопоставление полей: правило, откуда берётся каждое значение.
Если участок сбоя не удалось установить, можно обсудить диагностику автозагрузки. Для начала подготовьте обезличенный фрагмент, Id, время, полное сообщение и ожидаемое значение.
Применить к своей задаче
Найти участок расхождения на одной позиции и подготовить проверяемое задание без бесконтрольной повторной выгрузки.
Журнал диагностики одной позиции автозагрузки: открыть рабочий материал · Скачать CSV для заполнения. Доступ свободный, без регистрации. Можно использовать самостоятельно или передать своему исполнителю.