Правила заполнения xml файла
Для всех значений данных в XML должно использоваться маскирование. Для самого файла должна использоваться кодировка UTF-8.
Требования к фиду
1. Фид должен содержать только актуальные объявления.
2. В данных не допускается присутствие HTML-тегов.
3. URL фида должен быть постоянным и доступным по протоколу HTTP.
4. Объявления, поступающие от Партнёров через фиды, должны обновляться, а не удаляться и создаваться заново.
Маскирование символов
Для фида должна использоваться кодировка UTF-8. Как это принято для всех файлов XML, все значения данных (включая URL) должны использовать маскирование сущностей для символов, перечисленных в таблице ниже.
| Символ | Маскирование | |
| Амперсанд | & | & |
| Одинарные кавычки | ' | ' |
| Двойные кавычки | " | " |
| Больше | > | > |
| Меньше | < | < |
Описание тегов и возможных значений для заполнения xml файла:
Заголовок документа (XML header)
<?xml version='1.0' encoding='UTF-8'?>
Заголовок должен начинаться с первой строки, с нулевого символа.
Документ должен содержать корневой элемент realities.
В корневом элементе обязательно должен присутствовать аттрибут date-create содержащий информацию о дате и времени создания данного файла
<?xml version="1.0" encoding="UTF-8"?>
<realities date-create="2017-12-21T23:39:15+03:00">
...
</realities>
Формат даты
Формат даты YYYY-MM-DDTHH:mm:ss+03:00. Стандартный формат ISO 8601
Дата и время создания файла на стороне доски объявлений.
YYYY — год
MM — месяц
DD — день
HH — час
mm — минута
ss — секунда
+ 03:00 — указание часового пояса (в данном случае — для Киева).
Также элемент realities должен содержать хотя-бы один элемент reality, описывающий содержимое объявления. Каждому элементу reality соответствует одно объявление в базе партнера.
Описание тегов:
<realities>
Корневой контейнер c датой создания xml
<reality>
Контейнер одного объявления
<local_reality_id>
Ваш идентефикатор объявления, только цыфры
</local_reality_id>
<state>
АР Крым, Винницкая, Волынская, Днепропетровская, Донецкая, Житомирская, Закарпатская, Запорожская, Ивано-Франковская, Киевская, Кировоградская, Луганская, Львовская, Николаевская, Одесская, Полтавская, Ровенская, Сумская, Тернопольская, Харьковская, Херсонская, Хмельницкая, Черкасская, Черниговская, Черновицкая, Польша, Словакия, Венгрия, Молдова, Чехия, Румыния, Эстония, Германия, Испания, Литва, Италия
</state>
<city>
Город с заглавной буквы, например, Житомир
</city>
<category>
Категория со всеми уровнями через "/", например Оборудование/Металлоискатели
</category>
<title>
Заголовок, должен быть от 3 до 70 символов
</title>
<description>
Описание, должно быть от 16 до 2000 тысяч символов
</description>
<telephone>
Телефон, до 5 штук через запятую, от 6 цыфр за телефон
</telephone>
<photos_urls>
<loc>
Ссылка на фотографию должна быть https, не более 10 штук, должны быть вложены в <photos_urls>
</loc>
<no>
Если у вас нет фото оставляет только теги <photos_urls> </photos_urls>
</no>
</photos_urls>
<characteristics>
Контейнер для свойств категории
</characteristics>
<hash>
hash объявления для отслеживания изминения
</hash>
<image_hash>
hash изображений объявления для отслеживания изминения
</image_hash>
<paid_services>
Блок который содержит в себе платьные услуги
<top>
</top>
<type>
</type>
<attention>
</attention>
<original_text>
</original_text>
</paid_services>
</reality>
</realities>
Выберите город и категорию для показа правил заполнения тега
<characteristics>
<characteristics>
</characteristics>
Выберите конечную категорию!