Guida utilizzo Motornet:
Definizione dei servizi
Le definizione dei servizi Motornet sono disponibili all'url https://webservice.motornet.it/api/ sia per l'interfaccia REST che per l'interfaccia SOAP, nella sezione "Versione 3".
Le strutture dati utilizzate sono comuni tra REST e SOAP e definite in schemi XSD disponibili all'url https://webservice.motornet.it/api/services/v3_0/xsd
I web services sono raggruppati per mercato (nuovo/usato) e per tipo veicolo.
Autenticazione
L'accesso all'infrastruttura Motornet è governata da un server OAuth2 standard. La definizione publica del servizio è raggiungibile all’url https://webservice.motornet.it/auth/realms/webservices/.well-known/openid-configuration
Tutte le chiamate ai web services Motornet devono includere l’header di autenticazione standard OAuth 2.0 Bearer Token [https://datatracker.ietf.org/doc/html/rfc6750]
L’Access token si ottiene dal server OAuth2 Motornet; segue un esempio a riga di comando (linux) [sostituire USERNAME & PASSWORD con quelle a voi assegnate]
curl --data "grant_type=password&client_id=webservice&username=USERNAME&password=PASSWORD" https://webservice.motornet.it/auth/realms/webservices/protocol/openid-connect/token
Si noti che, come da specifiche OAuth2, è necessario effettuare il refresh periodico dell’access token [Sostituire REFRESH_TOKEN con il corrispondente valore ricevuto nella chiamata sopra]
curl --data "grant_type=refresh_token&client_id=webservice&refresh_token=REFRESH_TOKEN" https://webservice.motornet.it/auth/realms/webservices/protocol/openid-connect/token
Path per verifica targa
/public/usato/generali/targa
Chiamata:
curl -X GET -H "Authorization: bearer TOKEN" "https://webservice.motornet.it/api/v3_0/rest/public/usato/generali/targa?targa=fd360rb"
Risposta:
Valutazione:
valutazione
Ultima modifica di Mauro Cerutti il 2022/09/07 17:20
Path
/public/usato/auto/valutazione
Descrizione
Valutazione di un determinato veicolo
Parametri
parametro codiceMotornetUnivoco
stile query
obbligatorio si
formato stringa
descrizione Codice Mnet (Codice Motornet univoco)
parametro anno
stile template
obbligatorio si
formato numero (AAAA)
descrizione anno di immatricolazione del veicolo
parametro mese
stile query
obbligatorio si
formato intero [1-12]
descrizione mese di immatricolazione del veicolo
parametro km
stile query
obbligatorio no
formato intero
descrizione km percorsi dal veicolo
parametro codice_omologazione
stile query
obbligatorio no
formato string
descrizione codice di omologazione del veicolo
parametro targa
stile query
obbligatorio no
formato stringa
descrizione targa del veicolo
parametro telaio
stile query
obbligatorio no
formato string
descrizione numero telaio del veicolo
parametro CostoOrarioManodoperaMeccanica
stile query
obbligatorio no
formato decimale
descrizione costo manodopera dell'eventuale riparazione meccanica
parametro CostoOrarioManodoperaCarrozzeria
stile query
obbligatorio no
formato decimal
descrizione costo manodopera dell'eventuale riparazione della carrozzeria
parametro autocarro
stile query
obbligatorio no
formato boolean
descrizione SOLO PER AUTO - flag per correggere la valutazione per i veicoli immatricolati come autocarro (true = sì, false = no)
parametro neoPatentato
stile query
obbligatorio no
formato boolean
descrizione se valorizzato in input, viene restituito in output e nell'XML
parametro ValutazioneDealer
stile query
obbligatorio no
formato decimal
descrizione Valutazione inserita dal Dealer
parametro annoValutazione
stile query
obbligatorio no
formato integer
descrizione anno della pubblicazione da utilizzare per la valutazione
parametro meseValutazione
stile query
obbligatorio no
formato intero [1-12]
descrizione mese della pubblicazione da utilizzare per la valutazione
parametro guidkey
stile query
obbligatorio no
formato string
descrizione codice univoco da generare lato client per poter recuperare, in un secondo momento, l’xml della valutazione
parametro perizia
stile query
obbligatorio no
formato periziaValutazione
descrizione valutazione della perizia effettuata
parametro accessori
stile query
obbligatorio no
formato shu:AccessorioValutazioneRequest
descrizione indicare gli accessori opzionali (ID, prezzo) da inserire nella valutazione
parametro lavoriMeccanica
stile query
obbligatorio no
formato shu:Riparazione
descrizione indicare il nome, le ore ed il prezzo delle riparazioni meccaniche da inserire nella valutazione
parametro lavoriCarrozzeria
stile query
obbligatorio no
formato shu:Riparazione
descrizione indicare l'ID dell'accessorio
Risposta
tipo shu:ValutazioneJs
mime application/json
Esempio
curl -X POST -H "Content-Type: application/json" -H "Authorization: bearer TOKEN" "https://webservice.motornet.it/api/v3_0/rest/public/usato/auto/valutazione" --data '{"codiceMotornetUnivoco":"A084507","anno":2019,"mese":10,"km":1000,"targa":null,"telaio":null,"accessori":[{"id":15065288,"prezzo":350}],"codiceOmologazione":123,"costoOrarioManodoperaMeccanica":35,"costoOrarioManodoperaCarrozzeria":50,"autocarro":false,"lavoriMeccanica":[{"nome":"aaaa","ore":1,"prezzo":100},{"nome":"bbbb","ore":1,"prezzo":100}],"lavoriCarrozzeria":[{"nome":"aaaa","ore":1,"prezzo":100},{"nome":"bbbb","ore":1,"prezzo":100}],"valutazioneDealer":1000,"annoValutazione":null,"meseValutazione":null,"guidkey":"PROVALUCAUI1"}'
{
"valutazione": {
"edizDati": "09/2022",
"marca": {
"acronimo": "MER",
"nome": "Mercedes"
},
"allestimento": "E 200 d Exclusive auto",
"anno": 2019,
"mese": 10,
"km": 1000,
"targa": null,
"quotazioneEurotaxBlu": 21500.00,
"quotazioneEurotaxBluKm": 24500.00,
"quotazioneEurotaxGiallo": 25000.00,
"quotazioneEurotaxGialloKm": 28000.00,
"descrizionePeriodoValutazione": "09/2022",
"tipoVeicolo": null,
"codiceOmologazione": "123",
"telaio": null,
"modello": "Classe E - W213 Berlina",
"autocarro": false,
"immagine": "https://www.motornet.it/img/modelli/auto/MER/Classe%20E%201.jpg",
"codiceMotornetUnivoco": "A084507",
"codiceMotore": "654916",
"alimentazione": {
"codice": "D",
"descrizione": "Diesel"
},
"quotazioneEurotaxBluTotale": 26321.2000,
"quotazioneEurotaxGialloTotale": 29821.2000,
"ivaBlu": null,
"ivaGiallo": null,
"variazioneKm": 3000.00,
"variazionePersonalizzata": null,
"valutazioneDealer": 1000,
"percorrenzaMediaKm": 70000,
"dataImmatricolazione": null,
"dataImmatricolazioneEstero": null,
"dataImmatricolazioneItalia": null,
"paeseImmatricolazioneEstero": null,
"targaEstero": null,
"dataUltimaRevisione": null,
"prezzoAccessori": 2391.2000,
"prezzoListino": 58115.00,
"totaleRiparazioniCarrozzeria": 300.0000,
"costoOrarioManodoperaCarrozzeria": 50,
"totaleRiparazioniMeccanica": 270.0000,
"costoOrarioManodoperaMeccanica": 35,
"xml": "https://webservice.motornet.it/xml/2022/09/07/mauro_80120_20220907_171236.xml",
"perizia": null,
"id": 21661063,
"accessoriSerie": [
{
"id": 15065082,
"uff": {
"codice": "580",
"descrizione": "Climatizzatore automatico THERMATIC"
},
"norm": {
"codice": "0017",
"descrizione": "Climatizzatore automatico"
},
"mot": null,
"gruppo": {
"codice": "S",
"descrizione": "Di Serie"
},
"idDizionario": 70603,
"prezzo": null,
"prezzoListino": null,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0020",
"descrizione": "Abitacolo interno"
}
},
{
"id": 15065088,
"uff": {
"codice": "891",
"descrizione": "Luci «ambient» 64 colori e tre zone cromatiche"
},
"norm": {
"codice": "0136",
"descrizione": "Illuminazione abitacolo"
},
"mot": null,
"gruppo": {
"codice": "S",
"descrizione": "Di Serie"
},
"idDizionario": 207422,
"prezzo": null,
"prezzoListino": null,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0020",
"descrizione": "Abitacolo interno"
}
},
{
"id": 15065151,
"uff": {
"codice": "U25",
"descrizione": "Soglie d'ingresso anteriori illuminate"
},
"norm": {
"codice": "0136",
"descrizione": "Illuminazione abitacolo"
},
"mot": null,
"gruppo": {
"codice": "S",
"descrizione": "Di Serie"
},
"idDizionario": 71590,
"prezzo": 0.00,
"prezzoListino": 0.00,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0020",
"descrizione": "Abitacolo interno"
}
},
{
"id": 15065147,
"uff": {
"codice": "246",
"descrizione": "Orologio analogico nella consolle centrale"
},
"norm": {
"codice": "0156",
"descrizione": "Orologio analogico"
},
"mot": null,
"gruppo": {
"codice": "S",
"descrizione": "Di Serie"
},
"idDizionario": 71194,
"prezzo": 0.00,
"prezzoListino": 0.00,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0020",
"descrizione": "Abitacolo interno"
}
},
...
{
"id": 15065083,
"uff": {
"codice": "B59",
"descrizione": "Dynamic Select"
},
"norm": {
"codice": "0187",
"descrizione": "Selettore stile di guida"
},
"mot": null,
"gruppo": {
"codice": "S",
"descrizione": "Di Serie"
},
"idDizionario": 81091,
"prezzo": 0.00,
"prezzoListino": 0.00,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0009",
"descrizione": "Sistemi di assistenza"
}
}
],
"accessoriOptional": [
{
"id": 15065288,
"uff": {
"codice": "P62",
"descrizione": "Interni in nero / grigio titanio pearl designo"
},
"norm": {
"codice": "0109",
"descrizione": "Interni personalizzazione colori"
},
"mot": null,
"gruppo": {
"codice": "O",
"descrizione": "Optional"
},
"idDizionario": 905147,
"prezzo": 350,
"prezzoListino": 5978.00,
"dataListino": "2019-10-22",
"macroGruppo": {
"codice": "0001",
"descrizione": "Interni"
}
}
],
"riparazioniCarrozzeria": [
{
"nome": "aaaa",
"ore": 1.00,
"prezzo": 100.00
},
{
"nome": "bbbb",
"ore": 1.00,
"prezzo": 100.00
}
],
"riparazioniMeccanica": [
{
"nome": "aaaa",
"ore": 1.00,
"prezzo": 100.00
},
{
"nome": "bbbb",
"ore": 1.00,
"prezzo": 100.00
}
]
},
"valutazioniDisponibili": 8929,
"accessiDisponibili": 998449
}