Hooga

Дилерам и их IT-партнёрам

Файл со складом

Выложите автомобили, которые у вас продаются, одним файлом XML или JSON по адресу https. Hooga читает его каждый час и приводит объявления в соответствие с ним. И размещение, и импорт бесплатны.

Как это работает

  1. 01

    Выложите файл

    Ваша складская система записывает все автомобили, которые продаются, в один файл XML или JSON по адресу https.

  2. 02

    Добавьте адрес файла

    Владелец профиля дилера добавляет адрес на вкладке «Импорт автомобилей». Мы сразу читаем файл и показываем, что в нём нашли: автомобили и замечания. Пока ничего не опубликовано.

  3. 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
live paused sold
fuel
petrol diesel hybrid plugin_hybrid electric gas
gearbox
manual automatic
drive
front rear awd
body
hatchback sedan estate suv coupe convertible minivan pickup van
color
white black grey silver blue red green brown beige yellow orange other
condition
excellent good fair needs_work
service_history
full_dealer full_independent partial none
equipment
led_headlights adaptive_cruise cruise_control heated_seats heated_steering_wheel carplay navigation parking_sensors parking_camera tow_bar sunroof leather keyless digital_cockpit climate_control parking_heater winter_tyres roof_rails
imported_from
DE SE FI LV LT PL NL BE FR IT ES AT CH DK NO GB US JP KR
county
Harju maakond Hiiu maakond Ida-Viru maakond Jõgeva maakond Järva maakond Lääne maakond Lääne-Viru maakond Põlva maakond Pärnu maakond Rapla maakond Saare maakond Tartu maakond Valga maakond Viljandi maakond Võ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 объявлений

Полный пример

Три автомобиля: у первого заполнены все поля, у последнего только обязательные. В обоих файлах одни и те же автомобили.

hooga-feed-example.xml Скачать
<?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>
hooga-feed-example.json Скачать
{
    "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"
            ]
        }
    ]
}