Campos disponíveis para catálogos de inventário dos Anúncios automotivos

Nome

Obrigatório?

Descrição

Os usuários podem filtrar por este atributo?

vehicle_id

tipo: string

Sim

Máximo de caracteres: 100

ID exclusiva para o item. Pode ser uma variante de um veículo. Se houver várias instâncias da mesma ID, elas serão ignoradas. Você também pode usar o VIN para “vehicle_id” e “vin”. Exemplo: 1FADP5AU6DL536022

Sim

título

Tipo: string

Sim

Máximo de caracteres: 500

Recomendação de 40 ou menos para que o título apareça todo na tela. Nome completo do veículo. Isso é relevante e específico de cada veículo, e deve incluir o que está definido em year, make, model e trim. Exemplo: USD 299 por mês para o EndoHatch GE

Sim

descrição

Tipo: string

Sim

Máximo de caracteres: 5.000

Descrição breve do veículo. Não inclua texto promocional ou links. Não coloque texto em maiúsculas. Use quebras de linha para formatar a descrição. Exemplo: Volvo 2017 XC90 seminovo em ótimas condições, disponibilidade imediata

Sim

url

tipo: url

Sim

Link para um site externo, em que você pode consultar uma lista de veículos. É necessário o formato HTTP.

Não

ios_url

tipo: url

Não

Link para a página de destino do app. Se estiver preenchido e o usuário tiver o app instalado, acessaremos este URL primeiro. Caso contrário, seguiremos para o URL da web.

Não

android_url

tipo: url

Não

Link para a página de destino do app. Se estiver preenchido e o usuário tiver o app instalado, acessaremos este URL primeiro. Caso contrário, seguiremos para o URL da web.

Não

make

Tipo: string

Sim

Máximo de 100 caracteres

Fabricante ou marca do veículo. Exemplo: Endomoto

Sim

model

Tipo: string

Sim

Máximo de 100 caracteres

Modelo do veículo. Exemplo: EndoHatch

Sim

year

tipo: int

Sim

Ano de lançamento do veículo (no formato aaaa). Exemplo: 2015

Sim

mileage.value

tipo: int

Sim

A rodagem atual de veículos usados, em quilômetros (KM) ou milhas (MI). Para veículos novos, use zero (0). Para o Marketplace, os veículos precisam ter mais de 500 milhas/quilômetros. Exemplo: “1500” Valor maior ou igual a 0.

Sim

mileage.unit

Tipo: string

Sim

Unidades de rodagem: MI (milhas) ou KM (quilômetros)

Não

image_link

tipo: string

Sim

Máximo para os itens: a imagem deve ter no mínimo 500x500 px, mas recomendamos uma proporção de aspecto de 4:3 para maximizar a performance. O tamanho da imagem ideal é 800x600 px.

Não

transmission

Tipo: string

Não

Tipo da transmissão do veículo: automática ou manual.

Sim

body_style

Tipo: enum

Sim

Tipo da carroceria do veículo: CONVERSÍVEL, CUPÊ, HATCHBACK, MINIVAN, CAMINHONETE, SUV, SEDÃ, VAN, PERUA, CROSSOVER, CARRO_PEQUENO ou OUTRO.

Sim

drivetrain

Tipo: enum

Não

Tração do veículo. Valores aceitos: 4X2, 4X4, AWD, FWD, RWD ou Outro.

Sim

vin

Tipo: string

Não

Máximo de caracteres: 17. Número de ID do veículo (VIN). Você também pode usar o VIN para vehicle_id e vin. Observação: O VIN deve ter exatamente 17 caracteres, e só é necessário para veículos a partir de 1983. Barcos têm menos dígitos, e alguns veículos (como trailers) não possuem VIN. Exemplo: 1FADP5AU6DL536022

Sim

preço

Tipo: string

Sim

Valor e moeda do veículo. Formate o preço como o custo, seguido pelo código da moeda ISO, com um espaço entre o custo e a moeda. A moeda padrão é USD. Exemplo: 18000 USD, 32000 USD

Sim

exterior_color

Tipo: string

Sim

Máximo de 100 caracteres

Cor do veículo. Exemplo: Preto, Branco, Azul, Vermelho

Sim

state_of_vehicle

Tipo: string

Sim

Estado atual do veículo. Valores aceitos: Novo, Usado ou Seminovo (CPO).

Sim

fuel_type

tipo: string

Não

Tipo de combustível do veículo. Valores aceitos: DIESEL, ELÉTRICO, FLEX, GASOLINA, HÍBRIDO ou OUTRO.

Sim

condition

Tipo: string

Não

Condição do veículo. Valores aceitos: EXCELENTE, BOM, REGULAR, RUIM ou OUTRA.

Sim

sale_price

Tipo: string

Não

Preço promocional ou preço especial. Formate o preço como o custo, seguido pelo código da moeda ISO, com um espaço entre o custo e a moeda. Exemplo: 16.000 USD

Sim

disponibilidade

tipo: enum

Não

Disponibilidade do veículo: disponível ou indisponível. Não mostramos no anúncio nenhum veículo indisponível.

Sim

vehicle_type

Tipo: string

Não

Tipo do veículo. Valores esperados: carro_caminhonete (padrão se nada for informado), barco, comercial, motocicleta, esportivo, motorhome, trailer ou outro.

Sim

trim

Tipo: string

Não

Máximo de caracteres: 50

Corte do veículo. Exemplo: 5DR HB SE

Sim

interior_color

Tipo: string

Não

Máximo de caracteres: 100

Cor interna do veículo.

Sim

date_first_on_lot

Tipo: string

Não

Data em que o veículo chegou pela primeira vez na concessionária. Usado para indicar a idade do inventário. Use o formato aaaa-mm-dd. Exemplo: 2018-09-05

Sim

days_on_lot

tipo: int

Não

Quantidade de dias que o veículo está no pátio. Deve ser incrementado todos os dias. Valor maior ou igual a 0. Exemplo: 62

Sim

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

Tipo: string

Não

Até cinco campos personalizados para quaisquer informações relacionadas a números que você queira usar para filtrar itens enquanto cria seus conjuntos. Neste campo, você pode filtrar por intervalos numéricos (maior que ou menor que) enquanto cria um conjunto. Por exemplo, você pode usar esse campo para indicar o ano em que determinado item foi fabricado, depois filtrar um intervalo de anos específico em um conjunto.

Esse campo aceita números inteiros entre 0 e 4294967295. Ele não aceita números negativos, decimas ou separadores de milhares, como -2, 5,5 ou 10.000. Exemplo: 2022

Sim

Nome

Descrição

Obrigatório?

Estilo 1 do formato de endereço: endereço completo (não use os dois estilos)

address

tipo: string

Endereço físico completo da concessionária, formatado como: {addr 1: [ENDEREÇO DA RUA], city: [CIDADE], region: [ESTADO, CONDADO, REGIÃO OU PROVÍNCIA], country: [PAÍS]}. O código postal é opcional. Exemplo: {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}

Sim

Estilo 2 do formato de endereço: vários cabeçalhos (não use os dois estilos)

address.addr1

tipo: string

O endereço da sua concessionária (rua e número). Exemplo: 123 Foxglove Rd

Sim

address.city

tipo: string

Cidade em que a concessionária está localizada. Exemplo: Palo Alto

Sim

address.region

tipo: string

Estado, condado, região ou província em que concessionária está localizada. Exemplo: Califórnia

Sim

address.country

Tipo: string

País em que a concessionária está localizada. Exemplo: Estados Unidos

Sim

latitude

tipo: float

Latitude da localização da concessionária. Exemplo: 37,484100

Sim

longitude

tipo: float

Longitude da localização da concessionária. Exemplo: -122,148252

Sim

address.postal_code

tipo: string

Código postal da concessionária (ou CEP no Brasil). Exemplo: 75008 (Paris, França) ou 01310-930 (São Paulo)

Não

Outros identificadores opcionais para concessionárias

dealer_id

Tipo: string

Máximo de caracteres: 100

ID alfanumérica da concessionária.

Não

dealer_name

Tipo: string

Máximo de caracteres: 100

Nome da concessionária.

Não

dealer_phone

tipo: string

Número de telefone da concessionária. Requisitos: deve mostrar o botão de Ligar em uma listagem do Marketplace. Deve estar em um formato válido para números de telefone. Deve incluir o código do país (DDI). Exemplo: +1 3603453333, 001 (360)345-3333

Não

stock_number

Tipo: string

A designação da própria concessionária para o veículo no pátio. O número de estoque é uma maneira de a concessionária organizar o inventário de veículos específicos. Exemplo: N8990

Não