Edasimüüjatele ja nende IT-partneritele
Laoseisu fail
Avalda müügis olevad autod ühe XML- või JSON-failina https-aadressil. Hooga loeb seda iga tund ja hoiab kuulutused failiga kooskõlas. Kuulutamine ja import on mõlemad tasuta.
Kuidas see käib
-
01
Avalda fail
Sinu laosüsteem kirjutab kõik müügis olevad autod ühte XML- või JSON-faili, mis asub https-aadressil.
-
02
Lisa faili aadress
Edasimüüja profiili omanik lisab aadressi vahekaardil "Autode import". Loeme faili kohe ja näitame, mida sealt leidsime: autod ja märkused. Avaldatud ei ole veel midagi.
-
03
Alusta importi
Sealtpeale loeme faili iga tund: uued autod ilmuvad, muutunud autod uuendatakse ja failist kadunud autod võetakse maha.
Saadad laoseisu juba mõnda teise portaali?
Saada see fail või selle aadress aadressile [email protected]. Kui failis on kõik, mida autokuulutus vajab, lisame selle vormingu ja sinu poolel ei pea midagi muutma.
Faili ülesehitus
Iga auto kohta üks kirje. Väljade nimed ja väärtused on mõlemas vormingus samad ning vormingu tunneme ise ära. Fail on UTF-8 kodeeringus.
-
JSON: objekt, milles on loend "cars" (sobib ka lihtsalt autode loend).
{"cars": [{ ... }, { ... }]} -
XML: juurelement "cars", iga auto kohta üks element "car".
<cars><car> ... </car></cars>
XML-is korratakse pealkirja ja kirjeldust iga keele kohta atribuudiga lang, varustus on elementide "item" loend ja fotod elementide "photo" loend. Kõike seda näitab allolev näide.
Ühe auto väljad
Kohustuslikud on täpselt need väljad, mida küsib enne avaldamist ka auto müügivorm. Auto, millel mõni neist puudub, jäetakse vahele ja nimetatakse logis. Ülejäänud fail imporditakse.
| Väli | Kohustuslik | Mida sinna kirjutada |
|---|---|---|
external_id |
jah | Sinu enda tunnus auto jaoks, kuni 191 märki. See peab jääma samaks nii kaua, kui auto failis on: selle järgi tunneme auto ära. |
status |
ei | live (vaikimisi), paused või sold. Vaata allpool reegleid. |
make |
jah | Mark nii, nagu see on meie loendis: "Volkswagen", "Škoda", "Mercedes-Benz". Mõistame ka kirjapilte "VW", "Skoda" ja "Mercedes". Auto, mille marki meie loendis pole, jäetakse vahele: kirjuta meile ja lisame margi. |
model |
jah | Mudel: "Golf". Kui see on meie loendis, kirjutame selle oma kirjapildis, muidu jääb nii, nagu sina kirjutasid. |
variant |
ei | Mootor ja varustustase nii, nagu neid nimetaksid: "1.5 TSI Style". Kuni 80 märki. |
year |
jah | Esmase registreerimise aasta. |
month |
ei | Esmase registreerimise kuu, 1 kuni 12. Aasta ja kuu asemel võid saata välja first_registration, näiteks "2019-03". |
mileage_km |
jah | Läbisõidumõõdiku näit kilomeetrites. |
price |
jah | Hind, mille ostja maksab, täiseurodes. |
vat_deductible |
ei | true, kui hind sisaldab käibemaksu ja ostja saab käibemaksuga arve. Kui väli puudub, siis false. |
fuel |
jah | Üks allpool loetletud väärtustest. |
gearbox |
jah | manual või automatic. |
drive |
ei | front, rear või awd. |
body |
ei | Üks allpool loetletud väärtustest. |
power_kw |
ei | Mootori võimsus kilovattides. Hobujõududes väärtus ("150 hj") arvutatakse ümber. |
engine_cc |
ei | Mootori töömaht kuupsentimeetrites. "1.5" loetakse liitriteks. |
color |
ei | Üks allpool loetletud väärtustest. Pikem värvinimi ("Tumehall metallik") viiakse kokku lähimaga. |
doors |
ei | 2 kuni 6. |
seats |
ei | 1 kuni 9. |
owners |
ei | Mitu omanikku autol on olnud. |
condition |
ei | Üks allpool loetletud väärtustest. |
service_history |
ei | Üks allpool loetletud väärtustest. |
inspection_until |
ei | Kuu, milleni tehnoülevaatus kehtib: "2027-03". |
imported_from |
ei | Selle riigi kahetäheline kood, kust auto toodi. Jäta välja, kui auto müüdi uuena Eestis. |
vin |
ei | VIN-koodi 17 märki. Hoitakse kuulutuse juures, avalikult ei näidata kunagi. |
plate |
ei | Numbrimärk. Hoitakse kuulutuse juures, avalikult ei näidata kunagi. |
equipment |
ei | Loend allpool toodud väärtustest. Mida loendis pole, see käib kirjeldusse. |
county |
ei | Üks 15 maakonnast, kirjutatuna nagu allpool. Mõistame ka kirjapilti "Harjumaa". |
city |
jah | Linn või vald, kus autot näha saab, eesti keeles: "Tallinn". |
headline |
jah | Üks rida keele kohta (et, ru, en), kuni 80 märki. |
description |
jah | Tekst keele kohta (et, ru, en), kuni 3 000 märki. HTML muudetakse lihttekstiks. Vähemalt ühes keeles peab olema nii pealkiri kui ka kirjeldus. |
photos |
jah | Fotode https-aadressid selles järjekorras, nagu neid näidatakse. Esimene on kaanefoto. Vähemalt üks, kõige rohkem 50. |
video_url |
ei | YouTube'i link. |
agent_email |
ei | Selle müügimeeskonna liikme sisselogimise e-post, kes autot müüb: kuulutusel on tema nimi ja sõnumid jõuavad tema postkasti. Kui väli puudub või e-post ei kuulu teie meeskonda, läheb auto profiili omaniku nimele. |
updated_at |
ei | Millal autot viimati muutsid. Vabatahtlik ja seda ei kasutata: võrdleme sisu ennast. |
Lubatud väärtused
Saada väärtused täpselt nii, nagu need on kirjas.
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
Loeme ka muid tavalisi kirjapilte: suurtähti, eesti-, vene- ja ingliskeelseid sõnu ("Automaat", "diisel", "универсал") ning arve tühikute või ühikutega ("84 200 km", "110 kW"). Vabatahtlik väärtus, millest me aru ei saa, jäetakse välja ja märgitakse logisse. Auto jääb vahele ainult kohustusliku välja pärast.
Reeglid ja piirangud
- Faili loetakse kord tunnis. Ebaõnnestunud lugemine ei muuda midagi. Seejärel ootame enne uut katset kauem (1 h, 3 h, 12 h, 24 h) ja pärast 3 järjestikust ebaõnnestumist saab profiili omanik ühe e-kirja.
- Midagi ei avaldata enne, kui edasimüüja profiili omanik on eelvaadet näinud ja vajutanud "Alusta importi".
- Autod viiakse kokku välja external_id järgi. Autot, mille kirje ei muutunud, ei puudutata. Portaalis käsitsi lisatud autodel external_id puudub ja import neid ei puuduta.
- Auto, mis puudub 2 järjestikusest õnnestunud lugemisest, võetakse portaalist maha. Kui see on failis tagasi, ilmub see uuesti samal lehel.
- Uus hind läheb auto hinnaajalukku samamoodi nagu käsitsi muudetud hind.
- Olek "paused" jätab auto sinu kontole, kuid võtab selle portaalist maha, "sold" märgib auto müüduks. Failis muutunud olekut järgitakse üks kord: mida pärast seda portaalis käsitsi muudad, jääb kehtima, kuni fail ütleb midagi uut.
- Fotod: kuni 50 auto kohta, ainult https, JPEG, PNG või WebP, igaüks kuni 25 MB. Laadime iga foto alla ühe korra ja hoiame oma koopiat ilma asukoha- ja kaameraandmeteta. Ebaõnnestunud fotot proovime järgmisel lugemisel uuesti ning auto avaldatakse siis, kui vähemalt üks foto on kohal.
- Fail: kuni 20 MB ja 5 000 autot, vastus 20 sekundi jooksul avalikul https-aadressil, kõige rohkem 3 ümbersuunamist. Sisselogimist ei ole: kui aadress peab jääma privaatseks, pane sellesse pikk juhuslik osa.
- Edasimüüjal võib olla kuni 5 faili. Faili saab ka üks kord käsitsi üles laadida: nii imporditakse selle autod ja ühtegi maha ei võeta.
- Failis olevat ei kontrollita ühegi välise allika järgi ja sellele ei lisata midagi: auto lehel on kirjas see, mida sa saatsid.
Kiiremini kui kord tunnis
Süsteem, mis teab, millal auto muutub, saab selle ühe auto kohe kuulutuste API kaudu ära saata: samad väljad, üks auto päringu kohta. Juurdepääs lülitatakse edasimüüjale sisse taotluse alusel.
Kuulutuste APITäielik näide
Kolm autot: esimesel on kõik väljad, viimasel ainult kohustuslikud. Mõlemas failis on samad autod.
<?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"
]
}
]
}