Bom de Lance
Integração AutoCerto × Bom de Lance
Guia para a equipe de suporte do AutoCerto. Leva menos de um minuto por loja.
Guia para a equipe de suporte do AutoCerto.
O Bom de Lance é um marketplace de veículos. Quando um cliente de vocês quer anunciar o estoque dele lá, ele abre um chamado com vocês — e o cadastro leva menos de um minuto, numa página que a gente preparou para este fim.
Este documento existe para vocês saberem exatamente o que vai chegar e o que fazer. Não há nada a instalar, nada a desenvolver e nada a manter.
Como funciona, em três passos
1. O cliente de vocês pede. Dentro do Bom de Lance ele clica em "Integrar com AutoCerto" e depois em "Solicitar integração". O nosso sistema manda um e-mail para o suporte de vocês, com o assunto:
Solicitação de XML para integração — Bom de Lance
No corpo vão o nome da loja, o CNPJ, a cidade e o contato — para vocês localizarem a conta dele aí — e um botão.
2. Vocês clicam no botão e colam a URL do XML de estoque daquela loja. A página mostra o nome da loja em destaque, para não haver troca de cliente, e um campo. Antes de salvar, a gente abre o arquivo e confere: se ele não abrir, nada é gravado e a mensagem diz o porquê.
3. Pronto. A integração liga na hora. O lojista recebe um aviso dentro do Bom de Lance dizendo que o estoque dele foi conectado, e a partir daí a gente busca o XML sozinho, de hora em hora.
O que a gente faz com o arquivo
- Só leitura. A gente busca o XML no endereço que vocês cadastraram. Nunca escrevemos nada em sistema de vocês, e não pedimos nenhuma credencial de API.
- De hora em hora. Se o arquivo não mudou, nada acontece — a gente compara antes de processar.
- O pátio inteiro, sempre. A gente entende o XML como a lista completa da loja: o que sumiu de lá sai daqui, o que apareceu entra.
- Nada é apagado por engano. Se uma remessa tentar remover mais de 30% do estoque de uma vez, a gente bloqueia e avisa o lojista em vez de obedecer. Arquivo truncado ou fora do ar não derruba o estoque de ninguém.
Formatos aceitos
A gente lê o formato de XML de estoque que o AutoCerto já publica hoje para os portais. Os campos que a gente usa de cada veículo:
| Campo | Obrigatório | Observação |
|---|---|---|
| identificador | sim | precisa ser estável entre as remessas |
| marca, modelo | sim | usados no casamento com a tabela FIPE |
| versão | não | melhora muito o casamento |
| ano do modelo | sim | |
| ano de fabricação | não | |
| preço | sim | aceita 74.900,00, 74900.00 e 74900 |
| km, câmbio, combustível, cor, portas | não | |
| opcionais | não | |
| fotos (URLs) | não | a gente baixa e converte |
Veículo sem os obrigatórios não derruba a remessa: ele fica de fora, com o motivo escrito, e o lojista vê isso na tela dele.
A documentação técnica completa, se algum desenvolvedor de vocês quiser, está em bomdelance.com.br/docs/integracao.
São dois endereços diferentes — e só um deles tem prazo
Vale separar, porque os dois aparecem no mesmo chamado:
| O que é | Tem prazo? | |
|---|---|---|
| O link do chamado | O botão que vai no e-mail, e que abre a página onde vocês colam a URL. É nosso. | Sim |
| A URL do XML | O endereço do estoque da loja, que vocês cadastram ali. É de vocês. | Não |
A URL do XML não vence. Uma vez cadastrada, ela fica valendo direto, e a gente busca o arquivo de hora em hora, indefinidamente. Vocês não precisam renovar nada, nem refazer nada depois. Ela só muda se a loja pedir.
O link do chamado
- É único por loja, e não serve para mais nada além de cadastrar a URL do XML daquela loja: não mostra estoque, não mostra contatos, não dá acesso a nada além disso.
- Ele não pede login — é a credencial em si, e por isso é tratado como senha do nosso lado (guardamos só o resumo criptográfico dele).
- Ele para de funcionar assim que vocês salvam a URL. Cumpriu o que veio fazer, morreu — não fica um link ativo esquecido na caixa de e-mail de vocês.
- Se o chamado ficar parado, ele vence sozinho em 30 dias.
- Nos dois casos, o lojista gera outro pela tela dele em um clique. Se vocês precisarem corrigir uma URL cadastrada errada, é só pedir isso a ele.
Perguntas que vocês podem ter
Precisamos adicionar o Bom de Lance como destino no integrador? Não. Esse era o caminho que a gente imaginava no começo; o que vocês propuseram — cadastrar a URL numa página nossa — é mais simples para os dois lados e não exige alteração no produto de vocês.
Vocês mandam leads de volta para o AutoCerto? Hoje não. As mensagens dos compradores ficam no Bom de Lance, e o lojista responde por lá. Se um dia isso mudar, será conversado com vocês antes.
Custa alguma coisa para o AutoCerto? Não. E também não custa nada ao lojista pelo lado de vocês: o que ele paga é a assinatura dele no Bom de Lance.
E se a loja pedir para desligar? O próprio lojista desliga com uma chave na tela dele, sem precisar falar com vocês nem com a gente. Nada é apagado — ele pode religar quando quiser.
Quem procuramos se algo der errado? Responder o próprio e-mail do pedido já chega à loja. Para falar com a gente: [email protected].
