← Svi API-ji

DMS oglasi

Dostupno
Smjer:
DMS → wagen
Za koga:
DMS sustavi (upravljanje zalihom salona)

Salon vozilo unosi jednom, u svoj DMS, a oglas na wagen.hr se pojavljuje, mijenja i povlači sam. Cijena se pamti kao povijest, pa kupac vidi pojeftinjenje.

Dva načina spajanja. Bez ikakvog razvoja: pošaljite nam adresu istog XML feeda koji šaljete Njuškalu (Njuškalov format već čitamo). U stvarnom vremenu: pozivi ispod, uz vaš ID vozila.

Prvo slanje je cijela zaliha salona (PUT na popis oglasa). Oglas koji salon već ima na wagenu preuzima se po VIN-u, pa ne nastaju duplikati; oglasi kojih nema u listi se povlače. Poslije su dovoljni pojedinačni pozivi. Vozilo je na wagenu u roku od minute, a ishod po vozilu (adresa oglasa, greške) vidite pozivom GET.

Uz vozilo se može poslati JOM broj (homologacijska izvedba, CVH).

Ono što salon uredi na wagenu (istaknuti oglas, bedž, redoslijed fotografija) DMS ne prepisuje.

Podacima salona pristupate tek kad salon u svom Kokpitu na wagenu poveže vaš sustav. Bez toga ključ ne vidi ništa od tog salona.

Pozivi

Adresa: https://api.wagen.hr · ključ u zaglavlju Authorization: Bearer wgn_…

  • GET/dms/v1/saloniSaloni koji su povezali vaš sustav (ID salona).
  • PUT/dms/v1/saloni/{salon}/oglasiCijela zaliha salona; oglasi kojih nema u listi se povlače.
  • PUT/dms/v1/saloni/{salon}/oglasi/{vanjskiId}Novi ili izmijenjeni oglas (podaci vozila, cijena, fotografije kao URL-ovi, JOM).
  • DELETE/dms/v1/saloni/{salon}/oglasi/{vanjskiId}Vozilo više nije u ponudi.
  • POST/dms/v1/saloni/{salon}/oglasi/{vanjskiId}/prodanoVozilo je prodano (prodajna cijena po želji).
  • GET/dms/v1/saloni/{salon}/oglasiŠto je objavljeno na wagenu, adresa oglasa i greške provjere podataka.

Polja vozila

Vrijednosti polja s fiksnim popisom su na stranici Šifrarnici.

PoljeVrstaOpis
vintekst ili nullVIN (17 znakova). Preporučeno: po njemu se preuzima postojeći oglas i povlače podaci vozila.
jomtekst ili nullJOM broj (homologacijska izvedba, CVH), kad ga znate. Ne prikazuje se u oglasu.
kategorijatekst ili nullKategorija; bez nje je određujemo sami.putnicki · motocikli · transportni · kamperi
podtiptekst ili nullPodtip za gospodarska vozila, motocikle i kampere.
marka *tekstMarka.
model *tekstModel.
paket_opremetekst ili nullPaket opreme ili linija (npr. Life, M Sport).
motorizacijatekst ili nullOznaka motorizacije (npr. 2.0 TDI DSG).
godina_prve_registracijebroj ili nullGodina prve registracije.
kilometrazabroj ili nullPrijeđeni kilometri.
cijena_eurbroj ili nullCijena u eurima, cijeli broj; bez cijene = "na upit".
u_sustavu_pdvda/neProdaja u sustavu PDV-a (PDV se može odbiti).
novoda/neNovo vozilo.
gorivotekst ili nullGorivo.benzin · dizel · hibrid · plug-in-hibrid · elektricni · plin · cng
mjenjactekst ili nullMjenjač.rucni · automatski
pogontekst ili nullPogon.prednji · straznji · 4x4
karoserijatekst ili nullKaroserija (osobna vozila).limuzina · karavan · suv · hatchback · coupe · kabriolet · monovolumen · kombi · pickup · ostalo
bojatekst ili nullBoja.crna · bijela · siva · srebrna · plava · crvena · zelena · smedja · bez · zuta · narancasta · ostalo
snaga_kwbroj ili nullSnaga u kW.
obujam_ccmbroj ili nullObujam u cm³.
broj_vratabroj ili nullBroj vrata.
ostecenjetekst ili nullStanje vozila.bez-stete · popravljena-steta · karambolirano · tehnicki-kvar
opistekst ili nullOpis prodavača (običan tekst).
fotografijenizhttps adrese fotografija, prvim redom. Preuzimamo ih jednom; promjena adrese = nova fotografija.
opremanizOprema: nazivi ili tvorničke šifre.

* obavezno polje

Pristup i pitanja: kontakt@wagen.hr