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:
<xs:complexType name="SearchTargaResultJs">
        <xs:complexContent>
            <xs:extension base="gsh:SearchTargaResultBase">
                <xs:sequence>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="versioni" tipo="sh:VeicoloBase"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="marche" tipo="sh:Marca"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="modelli" tipo="sh:Modello"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="gamme" tipo="sh:Gamma"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="porte" tipo="xs:int"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="passi" tipo="xs:decimal"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="tipologie" tipo="sh:CodiceDescrizione"/>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="gruppi" tipo="sh:Gruppo"/>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>



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
  <xs:complexType name="ValutazioneJs">
        <xs:complexContent>
            <xs:extension base="shu:AbstractValutazione">
                <xs:sequence>
                    <xs:element name="id" tipo="xs:integer"></xs:element>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="accessoriSerie" tipo="shu:AccessorioValutazione"></xs:element>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="accessoriOptional" tipo="shu:AccessorioValutazione"></xs:element>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="riparazioniCarrozzeria" tipo="shu:Riparazione"></xs:element>
                    <xs:element minOccurs="0" maxOccurs="unbounded" name="riparazioniMeccanica" tipo="shu:Riparazione"></xs:element>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
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
}