Campi disponibili per cataloghi di inventari di annunci per il settore automotive

Nome

Obbligatorio?

Descrizione

È possibile usare questo attributo per filtrare i risultati?

vehicle_id

tipo: string

Sì

Limite massimo caratteri: 100.

ID univoco per l’elemento. Può essere una variante di un veicolo. In caso di istanze multiple dello stesso ID, verranno ignorate tutte. È anche possibile utilizzare il VIN sia per vehicle_id che per vin. Esempio: 1FADP5AU6DL536022

Sì

titolo

tipo: string

Sì

Limite massimo caratteri: 500.

Per visualizzare interamente il titolo, si consigliano massimo 40 caratteri. Nome completo del veicolo. Campo relativo e specifico a ciascun veicolo; deve contenere informazioni relative ad anno, marca, modello, allestimento. Esempio: 299 USD al mese per EndoHatch GE

Sì

description

tipo: string

Sì

Limite massimo caratteri: 5000.

Breve testo descrittivo del veicolo. Non includere testo promozionale o link. Non inserire testo completamente in maiuscolo. Usa interruzioni di linea per formattare la descrizione. Esempio: Volvo XC90 del 2017 usata in ottime condizioni, subito disponibile.

Sì

url

tipo: url

Sì

Link al sito esterno in cui è possibile visualizzare l’elenco di veicoli. Formato HTTP richiesto.

No

ios_url

tipo: url

No

Link alla pagina di destinazione dell’app. Se il campo è compilato e l’utente ha l’app installata, passeremo prima a questo URL. In caso contrario, ci baseremo sull’URL per il Web.

No

android_url

tipo: url

No

Link alla pagina di destinazione dell’app. Se il campo è compilato e l’utente ha l’app installata, passeremo prima a questo URL. In caso contrario, ci baseremo sull’URL per il Web

No

make

tipo: string

Sì

Limite massimo caratteri: 100.

Marca o brand del veicolo. Esempio: Endomoto

Sì

model

tipo: string

Sì

Limite massimo caratteri: 100.

Modello del veicolo. Esempio: EndoHatch

Sì

year

tipo: int

Sì

Anno di lancio del veicolo in formato aaaa. Esempio: 2015

Sì

mileage.value

tipo: int

Sì

Per i veicoli usati, il chilometraggio corrente del veicolo espresso in chilometri (km) o miglia (mi). Per i veicoli nuovi, usa il valore zero (0). Per Marketplace, i veicoli devono avere oltre 500 miglia/chilometri. Esempio: ‘1500’. Valore pari o superiore a 0.

Sì

mileage.unit

tipo: string

Sì

Unità del chilometraggio: mi (miglia) o km (chilometri)

No

link immagine [image_link]

tipo: string

Sì

Dimensioni max elemento: l’immagine deve essere di almeno 500x500 pixel, ma consigliamo un formato 4:3 per le prestazioni migliori. Dimensione immagine ideale: 800x600.

No

transmission

Tipo: string

No

Tipo di cambio del veicolo: automatico o manuale.

Sì

body_style

Tipo: enum

Sì

Stile della carrozzeria del veicolo: DECAPOTTABILE, COUPÉ, DUE VOLUMI, MINIVAN, PICKUP, SUV, BERLINA, VAN, STATION WAGON, CROSSOVER, SUPERUTILITARIA o ALTRO.

Sì

drivetrain

Tipo: enum

No

Trasmissione del veicolo Valori supportati: 4X2, 4X4, 4RM, FWD, RWD, Altro.

Sì

vin

Tipo: string

No

Limite massimo caratteri: 17. Numero ID del veicolo (VIN). È anche possibile utilizzare il VIN sia per vehicle_id che per vin. Nota: il VIN deve essere esattamente di 17 caratteri e non è richiesto per i veicoli antecedenti al 1983. Il VIN delle imbarcazioni ha meno caratteri, alcuni veicoli (ad es. i rimorchi) non richiedono il VIN. Esempio: 1FADP5AU6DL536022

Sì

price

Tipo: string

Sì

Costo e valuta del veicolo. Formattare il prezzo come il costo, seguito dal codice valuta ISO, con uno spazio tra costo e valuta. La valuta predefinita è il dollaro americano (USD). Esempio: 18.000 USD, 32.000 USD

Sì

exterior_color

tipo: string

Sì

Limite massimo caratteri: 100.

Colore del veicolo. Esempio: nero, bianco, blu, rosso

Sì

state_of_vehicle

tipo: string

Sì

Stato attuale del veicolo. Valori supportati: nuovo, usato o CPO (certificato di originalità).

Sì

fuel_type

tipo: string

No

Tipo di alimentazione del veicolo. Valori supportati: DIESEL, ELETTRICA, FLEX, BENZINA, IBRIDO, ALTRO.

Sì

condition

tipo: string

No

Condizioni del veicolo. Valori supportati: ECCELLENTI, OTTIME, BUONE, CATTIVE, ALTRO.

Sì

sale_price

tipo: string

No

Prezzo scontato o prezzo speciale. Formattare il prezzo come il costo, seguito dal codice valuta ISO, con uno spazio tra costo e valuta. Esempio: 16.000 USD

Sì

availability

tipo: enum

No

Disponibilità del veicolo: disponibile o non disponibile. Non mostriamo veicoli non disponibili nell’annuncio.

Sì

vehicle_type

tipo: string

No

Tipo di veicolo. Valori previsti: car_truck (predefinito se non fornito), imbarcazione, commerciale, motociclo, powersport, camper, rimorchio o altro.

Sì

trim

tipo: string

No

Limite massimo caratteri: 50

Allestimento del veicolo. Esempio: 5DR HB SE

Sì

interior_color

tipo: string

No

Limite massimo caratteri: 100.

Colore degli interni del veicolo.

Sì

date_first_on_lot

tipo: string

No

Data di primo arrivo del veicolo presso il lotto del concessionario. Utilizzata per indicare l’età di inventario. Usa il formato gg-mm-aaaa. Esempio: 05-09-2018

Sì

days_on_lot

tipo: int

No

Da quanti giorni il veicolo è nel lotto. Deve aumentare quotidianamente. Valore pari o superiore a 0. Esempio: 62

Sì

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

tipo: string

No

Fino a cinque campi personalizzati per eventuali informazioni numeriche aggiuntive secondo cui filtrare gli elementi quando crei le configurazioni. Questo campo ti consente di filtrare per intervalli numerici (è maggiore di, è minore di) quando crei una configurazione. Ad esempio, potresti usare questo campo per indicare l’anno di produzione di un articolo e quindi filtrare per un determinato intervallo di anni in una configurazione.

Questo campo supporta numeri interi compresi tra 0 e 4294967295. Non supporta numeri negativi, numeri decimali o punti, ad esempio -2, 5,5 o 10.000. Esempio: 2022

Sì

Nome

Descrizione

Obbligatorio?

Formato indirizzo, stile 1: indirizzo completo (non usare entrambi gli stili)

address

tipo: string

Indirizzo fisico completo della concessionaria, formattato come:{addr 1: [VIA, PIAZZA], city: [CITTÀ], region: [COMUNE, PROVINCIA, REGIONE], country: [PAESE]. Il codice di avviamento postale è facoltativo. Esempio: {addr1: ‘550 Auto Center Dr’, city: ‘Watsonville’, region: ‘CA’, postal_code: ‘96075’, country: ‘US’}

Sì

Formato indirizzo, stile 2: intestazioni multiple (non usare entrambi gli stili)

address.addr1

tipo: string

L’indirizzo del concessionario (via e civico). Esempio: via Roma 123

Sì

address.city

tipo: string

Città in cui ha sede la concessionaria. Esempio: Palo Alto

Sì

address.region

tipo: string

Comune, provincia o regione in cui ha sede la concessionaria. Esempio: California

Sì

address.country

tipo: string

Paese in cui ha sede la concessionaria. Esempio: Stati Uniti

Sì

latitude

tipo: float

Latitudine della sede della concessionaria. Esempio: 37.484100

Sì

longitude

tipo: punto mobile

Longitudine della sede della concessionaria. Esempio: -122.148252

Sì

address.postal_code

tipo: string

Codice di avviamento postale della concessionaria (fuori dagli USA o codice ZIP negli USA). Esempio: 75008 (Parigi, Francia) o 94025 (Menlo Park)

No

Identificatori aggiuntivi facoltativi della concessionaria

dealer_id

tipo: string

Limite massimo caratteri: 100.

ID alfanumerico della concessionaria.

No

dealer_name

tipo: string

Limite massimo caratteri: 100.

Nome della concessionaria.

No

dealer_phone

tipo: string

Numero di telefono della concessionaria. Requisiti: nell’elenco del Marketplace deve apparire il pulsante Chiama. Deve essere un numero di telefono di formato valido. Deve includere il codice del paese. Esempio: +1 3603453333, 001 (360)345-3333

No

stock_number

tipo: string

Designazione propria della concessionaria per la macchina nel lotto. Il numero di magazzino è un modo utilizzato dal concessionario per includere nell’inventario veicoli specifici. Esempio: N8990

No