Autobaza.pl
auto-ekspert•

API VIN w komisie: dane pojazdu we własnym programie

Dodaj autobaza.pl do źródeł Google
Redakcja

Redakcja

Autobaza.pl to portal motoryzacyjny specjalizujący się w raportach VIN, historii pojazdów i poradach dla kierowców. Tworzymy rzetelne treści, które pomagają podejmować świadome decyzje przy zakupie i użytkowaniu samochodów. Nasza redakcja łączy pasję do motoryzacji z wieloletnim doświadczeniem, przedstawiając złożone zagadnienia w prosty i praktyczny sposób. Publikujemy analizy, poradniki oraz aktualności dotyczące bezpieczeństwa, ekologii i nowych trendów w branży. Regularnie współpracujemy z partnerami, przygotowując także treści o charakterze promocyjnym. Naszym celem jest wspieranie kierowców w lepszym zrozumieniu rynku motoryzacyjnego i codziennej eksploatacji pojazdów.

Udostępnij:
Pracownik komisu sprawdza na tablecie dane używanego kombi na placu

VIN, dane techniczne, wycena i historia mogą trafiać bezpośrednio do programu Twojego komisu. Zobacz, które funkcje API odpowiadają poszczególnym etapom pracy, ile kosztują i jakie mają ograniczenia.

W skrócie

  • Pobierzesz VIN po numerze rejestracyjnym, ale nadal musisz porównać go z autem i dokumentami.
  • Dane zapisane w VIN-ie i specyfikacja katalogowa mają różny zakres.
  • Pełna historia nie obejmuje szkód ani sprawdzenia baz aut kradzionych.
  • Licencja służy do pobierania raportów w przeglądarce, a API do zasilania Twojego programu.

Każde auto w Twoim komisie przechodzi podobną drogę: przyjęcie, opis, wycena i rozmowa z kupującym. Przy większej rotacji wracają te same problemy: literówka w VIN-ie w umowie, wyposażenie w ogłoszeniu inne niż w dokumentach i cena ustalana „na oko”.

Jeśli masz własny program, arkusz połączony z bazą albo system do ogłoszeń, możesz zasilać go danymi przez API. W tym poradniku zobaczysz, które funkcje pasują do kolejnych etapów pracy i gdzie nadal potrzebna jest Twoja ocena.

Gdzie komis traci najwięcej czasu

Zacznij od rozpisania czynności, które powtarzasz przy każdym samochodzie:

  • Przyjęcie auta: dodajesz pojazd do bazy i przepisujesz jego identyfikatory.
  • Opis do ogłoszenia: uzupełniasz silnik, skrzynię, napęd i wyposażenie.
  • Wycena: szukasz wspólnego punktu odniesienia dla ceny zakupu i sprzedaży.
  • Pytania kupującego: sprawdzasz historię, przeznaczenie auta i informacje serwisowe.

Droga auta w komisie: przyjęcie, opis do ogłoszenia, wycena i pytania kupującego

Każdy z tych kroków możesz zasilić danymi pobieranymi po VIN-ie, zamiast ponownie wprowadzać je ręcznie.

Nie musisz jednak pobierać wszystkiego dla każdego samochodu. Zakres zapytań możesz dopasować do etapu: najpierw identyfikacja i podstawowe dane, później wycena oraz historia wybranych aut.

Od numeru rejestracyjnego do VIN-u

Funkcja getVinByReg zwraca VIN po numerze rejestracyjnym. Kod kraju jest opcjonalny, a domyślnie przyjmowana jest Polska. W komisie możesz wykorzystać ją do dodania auta do bazy bez przepisywania całego VIN-u. Zapytanie kosztuje 0,20 EUR.

To ułatwienie przy przyjęciu, nie potwierdzenie tożsamości samochodu. Na placu nadal porównujesz uzyskany VIN z oznaczeniem na nadwoziu i dowodem.

Jeśli porządkujesz starszą bazę, przyda Ci się checkVinValid, za 0,02 EUR za zapytanie. Funkcja sprawdza poprawność VIN-u. Gdy znajdzie błąd, podaje najbardziej prawdopodobny poprawny numer oraz do trzech alternatyw.

Propozycji poprawki nie traktuj jako automatycznej zgody na zmianę danych. To pomoc przy weryfikacji wpisu przed kolejnymi płatnymi zapytaniami, a nie zamiennik porównania numeru z autem.

Dane techniczne i wyposażenie do ogłoszenia

Program dla komisu samochodowego może pobierać dane techniczne przez dwie funkcje. Ich zakres nie jest jednak taki sam:

  • getVinDecoder — 0,05 EUR: dane zapisane w VIN-ie przy produkcji, w tym marka, model, pojemność i moc silnika. Dla wielu aut także wyposażenie standardowe i dodatkowe.
  • getVinCatalogSpec — 0,10 EUR: specyfikacja katalogowa dobrana do VIN-u: generacja, nadwozie, silnik, skrzynia, napęd, wymiary, masy, osiągi i spalanie.

Dekoder obsługuje marki europejskie, amerykańskie i azjatyckie, ale zakres oraz dokładność odpowiedzi zależą od pojazdu. Specyfikacja katalogowa opisuje natomiast wariant modelu, a nie fabryczny zapis konkretnego egzemplarza.

Jeśli pasuje ponad 50 wariantów katalogowych, auto nie zostaje dopasowane i zapytanie nie jest płatne. Przy przygotowywaniu opisu rozróżniaj więc dane egzemplarza od danych wariantu. Więcej o tym przeczytasz w poradniku jak sprawdzić wyposażenie auta po VIN-ie.

Wycena, która nie zależy od tego, kto ją robi

Wycena samochodu po VIN przez getVinValuation wymaga podania VIN-u, przebiegu i waluty. Zapytanie kosztuje 0,10 EUR i zwraca wartość minimalną, średnią, maksymalną oraz medianę.

Opcjonalnie otrzymasz też wyceny aut z sąsiednich roczników i z innym przebiegiem. Możesz więc korzystać ze wspólnego punktu odniesienia przy negocjacjach i ustalaniu ceny ogłoszenia, zamiast opierać proces wyłącznie na ocenie konkretnego handlowca.

Funkcja działa tak samo u każdego pracownika. Nie zastępuje jednak oceny stanu samochodu na placu: wynik traktuj jako punkt wyjścia, a nie gotową decyzję zakupową.

Tak wygląda skrócona przykładowa odpowiedź z wersji demo:

{
  "functionName": "api/v3/getVinValuation",
  "functionResponse": {
    "valuation": {
      "calcValuation": {
        "price_min": 87820,
        "price_med": 94780,
        "price_avr": 98323,
        "price_max": 112244
      }
    },
    "userParams": {
      "make": "KIA",
      "model": "SORENTO",
      "year": 2018,
      "fuel": "DIESEL",
      "odometer": 240000,
      "currency": "PLN"
    }
  }
}

Historia, przeznaczenie i akcje serwisowe

Zanim pobierzesz pełną historię, możesz sprawdzić dostępny zakres informacji. Pozostałe funkcje dobierasz osobno — historia, przeznaczenie i obsługa serwisowa odpowiadają na inne pytania.

Funkcja Co zwraca Kiedy przydaje się w komisie Cena za zapytanie
checkVinHistory Zakres dostępnych informacji dla VIN-u Przed decyzją o pobraniu pełnej historii 0,01 EUR
getVinHistory Zmiany właścicieli, odczyty przebiegu, ceny z aukcji Przy sprawdzaniu przeszłości auta 1 EUR
getVinStolenDatabases Wyniki sprawdzenia internetowych baz aut poszukiwanych i kradzionych w kilku krajach Europy Przy dodatkowej weryfikacji przed zakupem 0,50 EUR
getVinPurpose Fabryczne przeznaczenie specjalne i dostępny kanał sprzedaży Przy weryfikacji konfiguracji oraz sposobu sprzedaży auta 0,20 EUR
getVinRecalls Akcje dotyczące VIN-u albo modelu i rocznika Przy sprawdzaniu informacji o akcjach serwisowych 0,10 EUR
getServiceSchedule Czynności na poprzedni, najbliższy i kolejny serwis według VIN-u i przebiegu Przy sprawdzaniu zakresu obsługi serwisowej 0,10 EUR

Przy interpretacji odpowiedzi uwzględnij ograniczenia:

  • Szkody: getVinHistory nie obejmuje szkód ani baz kradzionych. Do szkód służą osobne funkcje checkDamagesForVin i getDamagesForVin, wyceniane indywidualnie.
  • Bazy kradzionych: obecność na liście nie przesądza o kradzieży, a brak wpisu nie gwarantuje, że auto nie jest poszukiwane.
  • Przeznaczenie: getVinPurpose opisuje konfigurację fabryczną, nie późniejsze przeróbki. Kanał sprzedaży jest dostępny głównie dla marek Chrysler, Jeep, Dodge, Ram, GM i Mercedes-Benz. Płacisz przy znalezionym przeznaczeniu, wyraźnym zapisie „standardowe” albo kanale sprzedaży.
  • Akcje serwisowe po VIN: dane są niekompletne. Dla Polski obejmują akcje ogłoszone do listopada 2018 r., Wielkiej Brytanii do października 2025 r., a USA do maja 2024 r. To uzupełnienie, nie jedyne źródło — przy autach z Polski nadal ma sens sprawdzenie aktualnych akcji w ASO producenta. Brak wyników oznacza brak opłaty.

Ile to kosztuje — przykład

Załóżmy, że przyjmujesz ok. 40 aut miesięcznie. Dla każdego pobierasz ten sam zestaw podstawowych danych, a pełną historię zamawiasz po wstępnej selekcji dla ok. 25 samochodów.

Funkcja Cena za zapytanie Koszt miesięczny
getVinByReg 0,20 EUR 8 EUR
getVinDecoder 0,05 EUR 2 EUR
getVinValuation 0,10 EUR 4 EUR
getVinRecalls 0,10 EUR 4 EUR
checkVinHistory 0,01 EUR 0,40 EUR
getVinHistory — ok. 25 aut 1 EUR 25 EUR
Razem — ok. 43 EUR

Miesięczny koszt przykładowego zestawu API: ok. 21 EUR dla 20 aut, ok. 43 EUR dla 40 aut i ok. 87 EUR dla 80 aut

Przy takim zestawie koszt rośnie z ok. 21 EUR dla 20 aut do ok. 43 EUR dla 40 i ok. 87 EUR dla 80 aut miesięcznie; największą pozycją pozostaje pełna historia.

Rozliczasz zapytania w euro. W razie błędu lub braku danych zapytanie jest bezpłatne. Odpowiedzi otrzymujesz w formacie JSON, a podłączeniem zajmuje się programista obsługujący Twój system.

Na anglojęzycznej stronie api.vin znajdziesz opisy i ceny funkcji, demo z przykładowymi odpowiedziami oraz formularz testowego klucza API. Jest też opis przetwarzania wsadowego: CSV na wejściu, plik JSON albo webhook na wyjściu. Taki tryb przydaje się do jednorazowego uzupełnienia danych całego placu.

Licencja Biznesowa czy API?

Wybór zależy od tego, czy chcesz udostępnić pracownikom raporty w przeglądarce, czy automatycznie pobierać dane do własnego systemu.

Licencja Biznesowa API
Dla kogo Dla Ciebie i pracowników sprawdzających auta lub pokazujących raport kupującemu Dla komisu pobierającego dane do własnego programu
Jak korzystasz Pełne raporty w przeglądarce, kodem licencji Odpowiedzi JSON w Twoim systemie
Rozliczenie Przedpłacony pakiet, bez osobnej płatności za każdy raport Za zapytania, w euro
Czy potrzebny programista Nie — korzystasz w przeglądarce Tak — do podłączenia systemu
Kiedy wybrać Gdy potrzebujesz raportów obsługiwanych przez pracowników Gdy dane mają trafiać automatycznie do przyjęcia auta, ogłoszenia i wyceny

Licencja Biznesowa autobaza.pl daje większy bonus na raporty przy większym pakiecie. Z opcją „FV zawsze” faktura VAT do każdego zakupu wystawia się automatycznie.

Rozsądnie zacząć od licencji, jeśli przede wszystkim sprawdzasz auta i pokazujesz raporty kupującym. Po API sięgnij, gdy rośnie liczba samochodów, a przepisywanie danych kosztuje Cię więcej niż samo sprawdzenie.

Sprawdź, jakie procedury serwisowe czekają na ten pojazd

Wpisz numer VIN i zobacz, co powinno być zrobione przy aktualnym przebiegu — zanim zapytasz sprzedawcę o książkę serwisową.

Najczęściej zadawane pytania

Jak pobrać VIN po numerze rejestracyjnym do programu komisu?
Służy do tego `getVinByReg`; kod kraju jest opcjonalny, a domyślnie przyjmowana jest Polska. Uzyskany VIN nadal musisz porównać z oznaczeniem na nadwoziu i dowodem.
Ile kosztuje API do danych pojazdu?
Płacisz za poszczególne zapytania w euro, a błąd lub brak danych oznacza brak opłaty. W opisanym zestawie dla ok. 40 aut miesięcznie, z pełną historią dla ok. 25 z nich, koszt wynosi ok. 43 EUR.
Czy pełna historia przez API pokaże szkody?
`getVinHistory` nie obejmuje szkód ani baz pojazdów kradzionych. Do szkód służą osobne funkcje `checkDamagesForVin` i `getDamagesForVin`, których cena jest ustalana indywidualnie.
Czym różni się Licencja Biznesowa od API?
Licencja pozwala Twoim pracownikom pobierać pełne raporty w przeglądarce kodem licencji, w ramach przedpłaconego pakietu. API służy do automatycznego pobierania danych do Twojego programu, a jego podłączenie wymaga programisty.
Czy akcje serwisowe po VIN są kompletne?
Nie — zakres `getVinRecalls` jest ograniczony, a dla Polski obejmuje akcje ogłoszone do listopada 2018 r. Traktuj wynik jako uzupełnienie i nadal sprawdzaj aktualne akcje w ASO producenta.

Autorem artykułu jest:

Redakcja

Redakcja

Redakcja Autobaza.pl

Autobaza.pl to portal motoryzacyjny specjalizujący się w raportach VIN, historii pojazdów i poradach dla kierowców. Tworzymy rzetelne treści, które pomagają podejmować świadome decyzje przy zakupie i użytkowaniu samochodów. Nasza redakcja łączy pasję do motoryzacji z wieloletnim doświadczeniem, przedstawiając złożone zagadnienia w prosty i praktyczny sposób. Publikujemy analizy, poradniki oraz aktualności dotyczące bezpieczeństwa, ekologii i nowych trendów w branży. Regularnie współpracujemy z partnerami, przygotowując także treści o charakterze promocyjnym. Naszym celem jest wspieranie kierowców w lepszym zrozumieniu rynku motoryzacyjnego i codziennej eksploatacji pojazdów.

Powiązane artykuły