API storico tagliandi per concessionari e rivenditori

Esegua le verifiche dello storico tagliandi direttamente dai Suoi sistemi. Invii un VIN e riceva i tagliandi registrati dalla rete dei concessionari ufficiali della casa costruttrice come JSON strutturato. 3,99 € per interrogazione con tagliandi, oppure 2,99 € con il piano mensile da 59,99 € al mese.

  • Interrogazione tramite VIN
  • Tagliandi dei concessionari ufficiali per 38 marchi
  • 3,99 € per interrogazione con tagliandi, da un saldo ricaricato in anticipo; 2,99 € con il piano mensile
  • Nessun tagliando, nessun costo
4,8 da acquirenti verificati

Cosa può realizzare

Porti lo storico tagliandi della casa costruttrice dove il Suo team e i Suoi acquirenti già guardano, senza che nessuno esegua le verifiche a mano.

Acquisizione veicoli e DMS

Verifichi ogni permuta già in fase di valutazione: i tagliandi finiscono automaticamente nel Suo DMS o nel Suo gestionale dello stock.

Sito web e annunci

Mostri lo storico tagliandi verificato nelle pagine dei Suoi veicoli: il numero di tagliandi in concessionaria, la data dell'ultimo tagliando e il chilometraggio.

Piattaforme d'asta e di remarketing

Aggiunga alla pagina di ogni lotto lo storico tagliandi della casa costruttrice, perché gli acquirenti lo vedano prima che inizi la fase di offerta.

Flotte e rientri da leasing

A fine contratto verifichi la manutenzione di tutti i veicoli rientrati in un solo passaggio, senza digitare ogni veicolo uno per uno.

Come funziona

  1. Ottenga la chiave API

    L'accesso API fa parte di un account Professionisti approvato. Ci contatti e lo attiviamo. Poi ricarica il saldo e crea le Sue chiavi nella Sua Area personale Professionisti. Il piano mensile è opzionale.

  2. Invii il VIN

    Una richiesta autenticata per veicolo, con la Sua chiave nell'header x-api-key.

  3. Riceva i tagliandi strutturati

    Ogni tagliando in concessionaria torna con la sua data, il chilometraggio, il concessionario che l'ha eseguito e i lavori svolti, più un link al report ServiceStamp completo.

Esempio di richiesta e risposta

Una richiesta per veicolo. Ogni tagliando in concessionaria registrato dalla casa costruttrice torna in service_events.

URL di base: https://api.servicestamp.it/v1. Gli stessi endpoint rispondono anche su https://servicestamp.it/api/v1.

Richiesta

curl -G "https://api.servicestamp.it/v1/service-history" \
  -d vin=WVWZZZAUZKW582047 \
  -H "x-api-key: YOUR_API_KEY"

Risposta

{
  "success": true,
  "result": {
    "report_id": "rpt_8Kq2vX",
    "report_url": "https://servicestamp.it/report/rpt_8Kq2vX",
    "vehicle_identification_number": "WVWZZZAUZKW582047",
    "registration_mark": null,
    "vehicle": { "make": "Volkswagen", "model": "Golf", "year": 2019, "fuel_type": "Petrol" },
    "service_events": [
      {
        "date_of_service_event": "2024-09-12",
        "service_provider": "Concessionario Volkswagen autorizzato",
        "mileage_observed": 45230,
        "mileage_unit": "km",
        "service_type": "serviceVisit",
        "service_items": [
          { "item_type": "Service", "item_description": "Cambio olio motore e filtro" },
          { "item_type": "Inspection", "item_description": "Controllo multi-punto di sicurezza" }
        ]
      }
    ]
  }
}

Cosa contiene ogni tagliando

CampoSignificato
date_of_service_eventQuando è stato eseguito il tagliando
service_providerIl concessionario che ha eseguito i lavori
mileage_observed / mileage_unitChilometraggio al passaggio in officina, in km o mi
service_typeIl tipo di passaggio in officina
service_itemsOgni lavoro eseguito, con la sua categoria
report_urlIl report ServiceStamp completo con l'andamento del chilometraggio, da condividere con gli acquirenti o da scaricare in PDF

Un valore che non abbiamo torna come null e non manca mai: alcune case costruttrici non inviano l'unità del chilometraggio né la categoria del lavoro.

Codici di risposta

Si paga solo quando tornano tagliandi.

CodiceSignificato
200Tagliandi trovati. 3,99 € vengono scalati dal Suo saldo API, oppure 2,99 € con il piano mensile.
202Il sistema della casa costruttrice sta ancora lavorando. Riprovi dopo il tempo indicato nell'header Retry-After. Si paga solo quando tornano tagliandi.
204Nessun tagliando della casa costruttrice per questo veicolo. Non viene addebitato.
400VIN non valido.
401La chiave API manca, non è valida o è stata revocata.
402Il Suo saldo API è esaurito. Lo ricarichi nella Sua Area personale Professionisti.
403L'accesso API è disattivato o l'account Professionisti non è attivo.
404Nessun veicolo trovato per questo VIN. Non viene addebitato.
429Troppe richieste. Rallenti e riprovi dopo il tempo indicato nell'header Retry-After.
503L'interrogazione non è stata completata da parte nostra. Riprovi più tardi. Non viene addebitata.

Prezzi: pagamento per interrogazione, meno con il piano mensile

Le interrogazioni vengono scalate da un saldo ricaricato in anticipo, a 3,99 € ciascuna e solo quando tornano tagliandi. Il piano mensile opzionale da 59,99 € al mese riduce questo prezzo a 2,99 €, conviene da 60 interrogazioni al mese ed è annullabile in qualsiasi momento. Ricarichi il Suo saldo a partire da 50,00 € con carta nella Sua Area personale.

VocePrezzo
Interrogazione con tagliandi, pagamento per interrogazione3,99 €
Piano mensile dell'API (opzionale)59,99 € al mese
Interrogazione con tagliandi, con il piano mensile2,99 €

Nessun tagliando, nessun costo

Un'interrogazione che non trova tagliandi della casa costruttrice non costa nulla, esattamente come le verifiche che esegue come Professionista dalla Sua Area personale.

Riprovare è gratuito

Una risposta «ancora in elaborazione» non viene mai addebitata. Interroghi di nuovo quando il risultato è pronto e paga una sola volta.

Cosa è coperto

L'API fornisce i tagliandi registrati dalla rete dei concessionari ufficiali delle case costruttrici per 38 marchi, per i veicoli dall'anno modello 2012 in poi. Quanto è dettagliato un tagliando dipende dalla casa costruttrice.

I tagliandi provengono dai sistemi delle case costruttrici e mostrano quindi la manutenzione eseguita presso i concessionari ufficiali. I lavori fuori dalla rete ufficiale non sono registrati in quei sistemi. La copertura di ogni singolo marchio è nella pagina delle case costruttrici.

Domande frequenti sull'API storico tagliandi

Chi può usare l'API storico tagliandi?

L'accesso API è aperto agli account Professionisti ServiceStamp approvati. Ci racconti cosa sta sviluppando e lo attiviamo. Poi ricarica il saldo e crea e gestisce le Sue chiavi live e di test nella Sua Area personale Professionisti. Il piano mensile è opzionale: riduce il prezzo per interrogazione.

Mi serve il VIN?

Sì. Invii il VIN a 17 caratteri. L'API non cerca un veicolo dalla targa, quindi con la sola targa non è possibile alcuna interrogazione.

Quanto velocemente arrivano i risultati?

Le interrogazioni si completano di norma con una sola chiamata. Se il sistema di una casa costruttrice impiega più tempo, riceve una risposta 202 con l'header Retry-After. Interroghi di nuovo dopo quel tempo: la Sua chiamata interroga nuovamente la casa costruttrice, può richiedere alcuni secondi, e si paga una sola volta.

Quanto costa l'API?

3,99 € per ogni interrogazione con tagliandi, scalati da un saldo che ricarica con carta nella Sua Area personale Professionisti (da 50,00 € a 10.000,00 € per ricarica). Il piano mensile opzionale costa 59,99 € al mese per account Professionisti e riduce ogni interrogazione a 2,99 €: conviene quindi da 60 interrogazioni al mese. Un'interrogazione che non trova tagliandi della casa costruttrice non costa nulla, e interrogare di nuovo lo stesso veicolo entro 24 ore è gratuito. Può annullare il piano mensile in qualsiasi momento; resta attivo fino alla fine del mese già pagato.

Cosa succede quando il mio saldo è esaurito?

Le interrogazioni live rispondono con 402 finché non ricarica il saldo. Le scriviamo via e-mail quando il saldo scende sotto 50,00 €, e di nuovo quando un'interrogazione viene rifiutata. Le chiavi di test continuano a funzionare.

E se interrogo lo stesso veicolo due volte?

Una seconda interrogazione dello stesso veicolo dal Suo account entro 24 ore restituisce il report che ha già e non viene addebitata. Per questo anche un nuovo tentativo dopo una risposta 202 non viene mai addebitato due volte.

Esiste un ambiente di test (sandbox)?

Sì. Chieda una chiave di test (inizia con ss_test_). Restituisce un report di esempio per qualsiasi VIN valido, non scala mai il Suo saldo e non contatta mai i sistemi delle case costruttrici. Il VIN TEST0000000000204 restituisce la risposta «nessun tagliando» e TEST0000000000202 la risposta «ancora in elaborazione», così può preparare ogni caso prima di andare live.

C'è un limite di richieste?

Sì, di default 60 richieste al minuto per account, condivise tra tutte le Sue chiavi. Ogni risposta contiene gli header X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Se Le serve di più, ce lo dica.

L'API verifica finanziamenti, sinistri o furti?

No. L'API copre la verifica dello storico tagliandi: i tagliandi della rete dei concessionari ufficiali che la casa costruttrice ha registrato per un VIN. Non contiene precedenti finanziari o ipoteche, sinistri né dati sui furti.

Le interrogazioni API compaiono nella mia Area personale Professionisti?

Sì. Ogni interrogazione compare nella Sua Area personale Professionisti accanto alle verifiche che esegue da lì, così tutto il Suo team può vederla.

Posso condividere i risultati con gli acquirenti?

Sì. Ogni risposta contiene una report_url al report ServiceStamp completo, che può condividere con un acquirente o scaricare in PDF.

Pronto a collegare i Suoi sistemi?

Ci racconti cosa sta sviluppando e quanti veicoli verifica all'incirca ogni mese, e prepariamo tutto per Lei.

Oppure via e-mail: hello@servicestamp.it

Compri o vendi veicoli in grandi volumi?

Report a partire da 4,99 € al prezzo fisso per professionisti, con supporto dedicato e area personale per il tuo team.

Richiedi un account Professionisti