For systemleverandører

Send lagerlisten til forhandleren med ett kall. Vi viser bilene med lenke til forhandlerens egen annonse. Formatet er enklere enn det dere sender til Finn.

1. Få en API-nøkkel

Send e-post til [email protected]. Én nøkkel gjelder for alle forhandlerne dere sender for. Forhandleren må også være meldt på hos oss.

2. Send hele lageret

Send POST /api/import/v1/biler med nøkkelen i headeren Authorization: Bearer <nøkkel>. Send hele lageret til én forhandler i hvert kall. En bil som ikke er med i listen, fjerner vi. Send når lageret endres, eller minst én gang i døgnet.

{
  "forhandler": { "orgnr": "123456789" },
  "biler": [
    {
      "id": "A-10293",
      "regnr": "AB12345",
      "merke": "Tesla",
      "modell": "Model 3",
      "variant": "Long Range AWD",
      "aar": 2020,
      "km": 84000,
      "pris": 249900,
      "drivstoff": "Elektrisk",
      "gir": "Automat",
      "annonseUrl": "https://forhandler.example/bil/10293",
      "bilder": ["https://forhandler.example/bilder/10293-1.jpg"],
      "status": "til_salgs"
    }
  ]
}

Feltene

Felt	Påkrevd	Innhold
`id`	Ja	Deres faste ID for bilen. Den samme ID-en i hvert kall.
`regnr` / `vin`	Ett av dem	Vi bruker det til å hente tekniske data fra Statens vegvesen. Vi viser det ikke.
`merke`, `modell`	Ja	Tekst, for eksempel «Toyota» og «RAV4».
`variant`	Nei	Tekst, for eksempel «Hybrid AWD-i».
`aar`	Ja	Årsmodell, heltall.
`km`	Ja	Kilometerstand, heltall.
`pris`	Ja	Pris i hele kroner, med mva og omregistreringsavgift.
`drivstoff`	Ja	Bensin, Diesel, Elektrisk, Hybrid, Ladbar hybrid, Hydrogen, Annet.
`gir`	Nei	Automat eller Manuell.
`annonseUrl`	Ja	Adressen til annonsen på forhandlerens nettside, med https. Alle klikk går hit.
`bilder`	Nei	Liste med bildeadresser, https, maks 40. Det første er hovedbildet.
`status`	Ja	`til_salgs` eller `solgt`.

Maks 2000 biler og 5 MB per kall.

3. Les svaret

Svaret sier hvor mange biler som er nye, endret og fjernet. Biler med feil står i feil, og resten av listen blir lagret likevel. Statuskoden er 400 bare når ingen biler kunne lagres.

{
  "mottatt": 41,
  "avvist": 1,
  "nye": 3,
  "endret": 5,
  "fjernet": 2,
  "feil": [{ "id": "A-10301", "melding": "Mangler eller ugyldig: pris" }]
}

Feilkoder

401: Nøkkelen mangler eller er feil.
400: Ugyldig JSON, feil organisasjonsnummer, eller ingen gyldige biler. Da lagrer vi ingenting, så en ødelagt liste tømmer ikke lageret.
403: Forhandleren har ikke meldt seg på Bilrekka, eller påmeldingen er ikke godkjent ennå. Ingen biler blir lagret.
502: Første gang vi får biler fra en forhandler, slår vi den opp i Enhetsregisteret. Svarer ikke registeret, prøv igjen senere.
413: Kallet er større enn 5 MB. Del ikke opp lageret; kontakt oss.