Guia completo de Chaves na Mão - Veículos
Disponibilize o estoque de veículos por feed XML sem precisar de credenciais de API.
Da configuração ao item marcado
As telas abaixo são reais da empresa Demo; nenhuma integração externa foi ativada.
Configure a integração com segurança
Confira modo, vertical, dados do anunciante e requisitos antes de ativar.
O que esta integração faz
| Portal | Chaves na Mão - Veículos |
| Modo | Feed XML |
| Catálogo | Veículos |
| Origem dos dados | Produtos/Serviços do CRM marcados para este portal. |
Antes de configurar
- Plano ou homologação de feed com o Chaves na Mão.
- Veículos cadastrados como tipo Veículo.
- Marca, modelo, ano, preço e localização preenchidos.
- Veículos marcados para Chaves na Mão.
Passo a passo completo
- No app Veículos, abra o veículo e use Selecionar portais para este veículo para marcar Chaves na Mão.
- Abra a integração e informe os dados da revenda.
- Defina UF e cidade padrão para itens sem localização própria.
- Ative, salve e copie a URL do feed.
- Envie a URL ao Chaves na Mão com os dados do responsável.
- Acompanhe a homologação do layout e eventuais ajustes.
O veículo “SUV Touring 2024 — Demo” está marcado para este portal e aparece na lista de publicação.
Campos que merecem atenção
| Veículo | Tipo, marca, modelo e versão. |
| Ano e uso | Ano de fabricação, ano/modelo e quilometragem. |
| Especificações | Combustível, câmbio, cor e portas. |
| Oferta | Título, descrição e preço. |
| Localização e fotos | UF, cidade e imagens públicas. |
Como a publicação acontece
O XML organiza o estoque em Carga > Veículos. O portal lê a URL e atualiza os anúncios conforme o catálogo.
| Feed XML | O portal busca periodicamente a URL. Alterações aparecem na próxima leitura. |
| API | O CRM envia o item quando você publica e registra o retorno. |
| Moderação | Recebido pelo portal não significa aprovado; regras comerciais e de conteúdo continuam válidas. |
Entenda os status
| Pendente | Item marcado, ainda sem confirmação final do portal. |
| Publicado | A API aceitou o envio; o portal ainda pode moderar. |
| Erro | Abra a mensagem e revise credenciais, contrato, campos e imagens. |
| Integração desativada | Nenhum envio automático deve ser iniciado. |
Checklist antes de ativar
- Confirme contrato, plano e homologação diretamente com o portal.
- Revise anunciante, telefone, e-mail, UF e cidade.
- Complete todos os campos do item e confira as fotos.
- Mantenha apenas um item piloto marcado no primeiro teste.
- Valide o retorno e a aparência no portal.
- Somente depois amplie para o restante do catálogo.
Dúvidas frequentes
Preciso de API Token?
Não para este card. Ele usa somente a URL do feed XML.
Qual a diferença para Veículos (API)?
No feed o portal busca os dados; na API o CRM envia cada veículo usando credenciais homologadas.
A cidade padrão substitui o cadastro?
Ela serve como fallback quando o veículo não possui localização própria.
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.