Дилерам и их IT-партнёрам
Файл со складом
Выложите автомобили, которые у вас продаются, одним файлом XML или JSON по адресу https. Hooga читает его каждый час и приводит объявления в соответствие с ним. И размещение, и импорт бесплатны.
Как это работает
-
01
Выложите файл
Ваша складская система записывает все автомобили, которые продаются, в один файл XML или JSON по адресу https.
-
02
Добавьте адрес файла
Владелец профиля дилера добавляет адрес на вкладке «Импорт автомобилей». Мы сразу читаем файл и показываем, что в нём нашли: автомобили и замечания. Пока ничего не опубликовано.
-
03
Запустите импорт
После этого мы читаем файл каждый час: новые автомобили появляются, изменившиеся обновляются, а те, что исчезли из файла, снимаются с сайта.
Уже отправляете склад на другой портал?
Пришлите этот файл или его адрес на [email protected]. Если в нём есть всё, что нужно объявлению об автомобиле, мы добавим его формат, и на вашей стороне ничего менять не придётся.
Устройство файла
Одна запись на автомобиль. Названия полей и значения в обоих форматах одинаковые, формат мы определяем сами. Кодировка файла UTF-8.
-
JSON: документ со списком "cars" (просто список автомобилей тоже подойдёт).
{"cars": [{ ... }, { ... }]} -
XML: корневой элемент "cars", внутри по одному элементу "car" на автомобиль.
<cars><car> ... </car></cars>
В XML заголовок и описание повторяются для каждого языка с атрибутом lang, оснащение записывается списком элементов "item", а фотографии списком элементов "photo". Всё это видно в примере ниже.
Поля одного автомобиля
Обязательны ровно те поля, которые перед публикацией спрашивает и форма продажи автомобиля. Автомобиль, у которого нет одного из них, пропускается и называется в журнале. Остальной файл импортируется.
| Поле | Обязательно | Что в нём писать |
|---|---|---|
external_id |
да | Ваш собственный номер автомобиля, до 191 символа. Он не должен меняться, пока автомобиль есть в файле: по нему мы узнаём автомобиль. |
status |
нет | live (по умолчанию), paused или sold. Смотрите правила ниже. |
make |
да | Марка так, как она записана в нашем списке: "Volkswagen", "Škoda", "Mercedes-Benz". Написания "VW", "Skoda" и "Mercedes" мы тоже понимаем. Автомобиль марки, которой нет в списке, пропускается: напишите нам, и мы добавим марку. |
model |
да | Модель: "Golf". Если она есть в нашем списке, пишем её по-своему, иначе оставляем так, как написали вы. |
variant |
нет | Двигатель и комплектация так, как вы их называете: "1.5 TSI Style". До 80 символов. |
year |
да | Год первой регистрации. |
month |
нет | Месяц первой регистрации, от 1 до 12. Вместо года и месяца можно прислать поле first_registration, например "2019-03". |
mileage_km |
да | Показание одометра в километрах. |
price |
да | Цена, которую платит покупатель, в целых евро. |
vat_deductible |
нет | true, если цена включает НДС и покупатель получает счёт с НДС. Если поля нет, считается false. |
fuel |
да | Одно из значений ниже. |
gearbox |
да | manual или automatic. |
drive |
нет | front, rear или awd. |
body |
нет | Одно из значений ниже. |
power_kw |
нет | Мощность двигателя в киловаттах. Значение в лошадиных силах ("150 hp") пересчитывается. |
engine_cc |
нет | Объём двигателя в кубических сантиметрах. "1.5" читается как литры. |
color |
нет | Одно из значений ниже. Более длинное название цвета ("Tumehall metallik") приводится к ближайшему. |
doors |
нет | От 2 до 6. |
seats |
нет | От 1 до 9. |
owners |
нет | Сколько владельцев было у автомобиля. |
condition |
нет | Одно из значений ниже. |
service_history |
нет | Одно из значений ниже. |
inspection_until |
нет | Месяц, до которого действует техосмотр: "2027-03". |
imported_from |
нет | Двухбуквенный код страны, из которой привезён автомобиль. Не указывайте, если автомобиль продан новым в Эстонии. |
vin |
нет | 17 символов VIN. Хранится вместе с объявлением и никогда не показывается публично. |
plate |
нет | Регистрационный номер. Хранится вместе с объявлением и никогда не показывается публично. |
equipment |
нет | Список значений из перечня ниже. Чего в перечне нет, о том пишите в описании. |
county |
нет | Один из 15 уездов, как он записан ниже. Написание "Harjumaa" мы тоже понимаем. |
city |
да | Город или волость, где можно посмотреть автомобиль, по-эстонски: "Tallinn". |
headline |
да | Одна строка на язык (et, ru, en), до 80 символов. |
description |
да | Текст на язык (et, ru, en), до 3 000 символов. HTML превращается в обычный текст. Хотя бы на одном языке должны быть и заголовок, и описание. |
photos |
да | Адреса фотографий (https) в том порядке, в котором их показывать. Первая становится обложкой. Не меньше одной и не больше 50. |
video_url |
нет | Ссылка на YouTube. |
agent_email |
нет | E-mail для входа того сотрудника отдела продаж, который продаёт этот автомобиль: под объявлением стоит его имя, и сообщения приходят ему. Если поля нет или такого e-mail нет в вашей команде, автомобиль записывается на владельца профиля дилера. |
updated_at |
нет | Когда вы в последний раз меняли автомобиль. Необязательно и не используется: мы сравниваем само содержимое. |
Допустимые значения
Присылайте значения в точности так, как они здесь записаны.
status-
livepausedsold fuel-
petroldieselhybridplugin_hybridelectricgas gearbox-
manualautomatic drive-
frontrearawd body-
hatchbacksedanestatesuvcoupeconvertibleminivanpickupvan color-
whiteblackgreysilverblueredgreenbrownbeigeyelloworangeother condition-
excellentgoodfairneeds_work service_history-
full_dealerfull_independentpartialnone equipment-
led_headlightsadaptive_cruisecruise_controlheated_seatsheated_steering_wheelcarplaynavigationparking_sensorsparking_cameratow_barsunroofleatherkeylessdigital_cockpitclimate_controlparking_heaterwinter_tyresroof_rails imported_from-
DESEFILVLTPLNLBEFRITESATCHDKNOGBUSJPKR county-
Harju maakondHiiu maakondIda-Viru maakondJõgeva maakondJärva maakondLääne maakondLääne-Viru maakondPõlva maakondPärnu maakondRapla maakondSaare maakondTartu maakondValga maakondViljandi maakondVõru maakond
Мы читаем и другие привычные написания: заглавные буквы, эстонские, русские и английские слова ("Automaat", "diisel", "универсал"), числа с пробелами и единицами ("84 200 km", "110 kW"). Необязательное значение, которое не удалось понять, опускается и отмечается в журнале. Пропустить автомобиль можно только из-за обязательного поля.
Правила и ограничения
- Файл читается раз в час. Неудачное чтение ничего не меняет. После него мы ждём до следующей попытки дольше (1 h, 3 h, 12 h, 24 h), а после 3 неудач подряд владелец профиля получает одно письмо.
- Ничего не публикуется, пока владелец профиля дилера не посмотрит предпросмотр и не нажмёт «Начать импорт».
- Автомобили сопоставляются по external_id. Автомобиль, запись которого не изменилась, не трогается. У автомобилей, добавленных на сайте вручную, external_id нет, и импорт их не трогает.
- Автомобиль, которого нет в 2 успешных чтениях подряд, снимается с сайта. Когда он снова появляется в файле, он возвращается на ту же страницу.
- Новая цена попадает в историю цены автомобиля так же, как цена, изменённая вручную.
- Статус "paused" оставляет автомобиль в вашем кабинете, но убирает с сайта, "sold" отмечает его проданным. Изменению статуса в файле мы следуем один раз: то, что вы потом измените на сайте вручную, остаётся в силе, пока файл не скажет что-то новое.
- Фотографии: до 50 на автомобиль, только https, JPEG, PNG или WebP, каждая до 25 МБ. Мы скачиваем каждую фотографию один раз и храним свою копию без данных о месте съёмки и камере. Не скачавшуюся фотографию пробуем снова при следующем чтении, а автомобиль публикуется, как только пришла хотя бы одна фотография.
- Файл: до 20 МБ и 5 000 автомобилей, ответ за 20 секунд по публичному адресу https, не больше 3 перенаправлений. Входа по паролю нет: чтобы адрес оставался закрытым, вставьте в него длинную случайную часть.
- У дилера может быть до 5 файлов. Файл можно и один раз загрузить вручную: так импортируются его автомобили, и ни один не снимается.
- Содержимое файла не сверяется ни с какими внешними источниками, и к нему ничего не добавляется: на странице автомобиля написано то, что вы прислали.
Быстрее, чем раз в час
Система, которая знает, когда автомобиль меняется, может сразу отправить этот один автомобиль через API объявлений: те же поля, один автомобиль на запрос. Доступ включается для дилера по запросу.
API объявленийПолный пример
Три автомобиля: у первого заполнены все поля, у последнего только обязательные. В обоих файлах одни и те же автомобили.
<?xml version="1.0" encoding="UTF-8"?>
<cars>
<car>
<external_id>A-1041</external_id>
<status>live</status>
<make>Volkswagen</make>
<model>Golf</model>
<variant>1.5 TSI Style</variant>
<year>2019</year>
<month>3</month>
<mileage_km>84200</mileage_km>
<price>16900</price>
<vat_deductible>true</vat_deductible>
<fuel>petrol</fuel>
<gearbox>automatic</gearbox>
<drive>front</drive>
<body>hatchback</body>
<power_kw>110</power_kw>
<engine_cc>1498</engine_cc>
<color>grey</color>
<doors>5</doors>
<seats>5</seats>
<owners>1</owners>
<condition>good</condition>
<service_history>full_dealer</service_history>
<inspection_until>2027-03</inspection_until>
<imported_from>DE</imported_from>
<vin>WVWZZZCDZKW123456</vin>
<plate>123 ABC</plate>
<equipment>
<item>led_headlights</item>
<item>adaptive_cruise</item>
<item>heated_seats</item>
<item>carplay</item>
<item>parking_camera</item>
<item>climate_control</item>
<item>winter_tyres</item>
</equipment>
<county>Harju maakond</county>
<city>Tallinn</city>
<headline lang="et">Üks omanik, täielik hooldusajalugu</headline>
<headline lang="ru">Один владелец, полная история обслуживания</headline>
<headline lang="en">One owner, full service history</headline>
<description lang="et">Ostetud uuena Saksamaalt, hooldatud esinduses.
Kaasa suverehvid valuvelgedel.</description>
<description lang="ru">Куплен новым в Германии, обслуживался у официального дилера.
В комплекте летние шины на литых дисках.</description>
<description lang="en">Bought new in Germany and serviced at the main dealer.
Summer tyres on alloy wheels are included.</description>
<photos>
<photo>https://media.example.ee/stock/A-1041/1.jpg</photo>
<photo>https://media.example.ee/stock/A-1041/2.jpg</photo>
<photo>https://media.example.ee/stock/A-1041/3.jpg</photo>
</photos>
<video_url>https://www.youtube.com/watch?v=aqz-KE-bpKQ</video_url>
<agent_email>[email protected]</agent_email>
<updated_at>2026-11-18T09:30:00+02:00</updated_at>
</car>
<car>
<external_id>A-1057</external_id>
<make>Toyota</make>
<model>RAV4</model>
<variant>2.5 Hybrid</variant>
<year>2021</year>
<month>5</month>
<mileage_km>61500</mileage_km>
<price>29400</price>
<fuel>hybrid</fuel>
<gearbox>automatic</gearbox>
<drive>awd</drive>
<body>suv</body>
<power_kw>160</power_kw>
<color>white</color>
<owners>1</owners>
<equipment>
<item>navigation</item>
<item>tow_bar</item>
<item>keyless</item>
</equipment>
<county>Tartu maakond</county>
<city>Tartu</city>
<headline lang="et">Nelikvedu ja veokonks</headline>
<description lang="et">Müüa heas korras linnamaastur. Hooldusraamat on kaasas.</description>
<photos>
<photo>https://media.example.ee/stock/A-1057/1.jpg</photo>
<photo>https://media.example.ee/stock/A-1057/2.jpg</photo>
</photos>
</car>
<car>
<external_id>A-1063</external_id>
<make>Škoda</make>
<model>Octavia</model>
<year>2017</year>
<mileage_km>148000</mileage_km>
<price>9800</price>
<fuel>diesel</fuel>
<gearbox>manual</gearbox>
<city>Pärnu</city>
<headline lang="et">Ökonoomne universaal</headline>
<headline lang="en">An economical estate</headline>
<description lang="et">Korralik pereauto.</description>
<description lang="en">A tidy family car.</description>
<photos>
<photo>https://media.example.ee/stock/A-1063/1.jpg</photo>
</photos>
</car>
</cars>
{
"cars": [
{
"external_id": "A-1041",
"status": "live",
"make": "Volkswagen",
"model": "Golf",
"variant": "1.5 TSI Style",
"year": 2019,
"month": 3,
"mileage_km": 84200,
"price": 16900,
"vat_deductible": true,
"fuel": "petrol",
"gearbox": "automatic",
"drive": "front",
"body": "hatchback",
"power_kw": 110,
"engine_cc": 1498,
"color": "grey",
"doors": 5,
"seats": 5,
"owners": 1,
"condition": "good",
"service_history": "full_dealer",
"inspection_until": "2027-03",
"imported_from": "DE",
"vin": "WVWZZZCDZKW123456",
"plate": "123 ABC",
"equipment": [
"led_headlights",
"adaptive_cruise",
"heated_seats",
"carplay",
"parking_camera",
"climate_control",
"winter_tyres"
],
"county": "Harju maakond",
"city": "Tallinn",
"headline": {
"et": "Üks omanik, täielik hooldusajalugu",
"ru": "Один владелец, полная история обслуживания",
"en": "One owner, full service history"
},
"description": {
"et": "Ostetud uuena Saksamaalt, hooldatud esinduses.\nKaasa suverehvid valuvelgedel.",
"ru": "Куплен новым в Германии, обслуживался у официального дилера.\nВ комплекте летние шины на литых дисках.",
"en": "Bought new in Germany and serviced at the main dealer.\nSummer tyres on alloy wheels are included."
},
"photos": [
"https://media.example.ee/stock/A-1041/1.jpg",
"https://media.example.ee/stock/A-1041/2.jpg",
"https://media.example.ee/stock/A-1041/3.jpg"
],
"video_url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
"agent_email": "[email protected]",
"updated_at": "2026-11-18T09:30:00+02:00"
},
{
"external_id": "A-1057",
"make": "Toyota",
"model": "RAV4",
"variant": "2.5 Hybrid",
"year": 2021,
"month": 5,
"mileage_km": 61500,
"price": 29400,
"fuel": "hybrid",
"gearbox": "automatic",
"drive": "awd",
"body": "suv",
"power_kw": 160,
"color": "white",
"owners": 1,
"equipment": [
"navigation",
"tow_bar",
"keyless"
],
"county": "Tartu maakond",
"city": "Tartu",
"headline": {
"et": "Nelikvedu ja veokonks"
},
"description": {
"et": "Müüa heas korras linnamaastur. Hooldusraamat on kaasas."
},
"photos": [
"https://media.example.ee/stock/A-1057/1.jpg",
"https://media.example.ee/stock/A-1057/2.jpg"
]
},
{
"external_id": "A-1063",
"make": "Škoda",
"model": "Octavia",
"year": 2017,
"mileage_km": 148000,
"price": 9800,
"fuel": "diesel",
"gearbox": "manual",
"city": "Pärnu",
"headline": {
"et": "Ökonoomne universaal",
"en": "An economical estate"
},
"description": {
"et": "Korralik pereauto.",
"en": "A tidy family car."
},
"photos": [
"https://media.example.ee/stock/A-1063/1.jpg"
]
}
]
}