TutoriaisIntegrações Chaves na Mão · API de veículosVoltar ao sistema ↗

Todos os tutoriais

Guia completo de Chaves na Mão - Veículos (API)

Envie veículos diretamente à API do Chaves na Mão após receber credenciais e concluir a homologação.

Tour visual com dados demonstrativos

Da configuração ao item marcado

As telas abaixo são reais da empresa Demo; nenhuma integração externa foi ativada.

1

Configure a integração com segurança

Confira modo, vertical, dados do anunciante e requisitos antes de ativar.

Abrir configuração
Configuração real de Chaves na Mão - Veículos (API) na empresa Demo
Integração demonstrativa mantida desativada
Etapa 1 de 2
01CadastreComplete o imóvel ou veículo.
02MarqueEscolha o portal no catálogo.
03ConfigureInforme dados e credenciais.
04ValideFaça um piloto antes do lote.

O que esta integração faz

PortalChaves na Mão - Veículos (API)
ModoAPI REST
CatálogoVeículos
Origem dos dadosProdutos/Serviços do CRM marcados para este portal.
Ao publicar, o CRM monta o JSON do veículo e envia ao endpoint da revenda. O retorno atualiza o status e o identificador externo.

Antes de configurar

Não marque Homologado por conta própria. Antes dessa confirmação, o sistema preserva os dados e bloqueia o disparo real.

Passo a passo completo

  1. No app Veículos, use Selecionar portais para este veículo e marque Chaves na Mão (API).
  2. Preencha os dados da revenda e a localização padrão.
  3. Informe o API Token e o Dealer ID.
  4. Salve ainda desativado e valide o layout com o portal.
  5. Após confirmação formal, marque Homologado e ative.
  6. Use Publicar em um veículo piloto; só depois utilize Publicar todos.
Exemplo da empresa Demo

O veículo “SUV Touring 2024 — Demo” está marcado para este portal e aparece na lista de publicação.

Campos que merecem atenção

CredenciaisAPI Token e Dealer ID/Loja.
HomologaçãoA caixa Homologado libera o envio real.
VeículoMarca, modelo, versão, anos, km, combustível, câmbio e preço.
ImagensFotos públicas e aceitas pelo portal.
StatusPendente, publicado ou erro com mensagem de retorno.
Cadastre os dados no produto antes de diagnosticar o portal. Campos ausentes no catálogo não podem ser inventados pelo feed ou pela API.

Como a publicação acontece

Ao publicar, o CRM monta o JSON do veículo e envia ao endpoint da revenda. O retorno atualiza o status e o identificador externo.

Feed XMLO portal busca periodicamente a URL. Alterações aparecem na próxima leitura.
APIO CRM envia o item quando você publica e registra o retorno.
ModeraçãoRecebido pelo portal não significa aprovado; regras comerciais e de conteúdo continuam válidas.

Entenda os status

PendenteItem marcado, ainda sem confirmação final do portal.
PublicadoA API aceitou o envio; o portal ainda pode moderar.
ErroAbra a mensagem e revise credenciais, contrato, campos e imagens.
Integração desativadaNenhum envio automático deve ser iniciado.

Checklist antes de ativar

  1. Confirme contrato, plano e homologação diretamente com o portal.
  2. Revise anunciante, telefone, e-mail, UF e cidade.
  3. Complete todos os campos do item e confira as fotos.
  4. Mantenha apenas um item piloto marcado no primeiro teste.
  5. Valide o retorno e a aparência no portal.
  6. Somente depois amplie para o restante do catálogo.

Dúvidas frequentes

Posso usar sem credenciais?

Use o card Chaves na Mão - Veículos, que trabalha com feed XML.

O que significa Homologado?

Que o portal aprovou credenciais, endpoint e formato do anúncio para a revenda.

Por que começar com um veículo?

Para validar campos e retorno sem enviar todo o estoque incorretamente.

O CRM garante que o anúncio será aprovado?

Não. O CRM prepara e entrega os dados; aprovação, moderação, prazo e regras comerciais pertencem ao portal.

Posso usar credenciais de demonstração?

Não. Credenciais precisam pertencer à conta ou revenda contratante e ser fornecidas pelo portal.