API Marketplace permite que classificados obtenham as informações dos veículos cadastrados no Estoque Cockpit do lojista e publiquem veículos em seu portal. Além disso, a API possibilita que os leads gerados no classificado sejam integrados com o Cockpit.CRM para gestão centralizada na plataforma.
A API Marketplace também pode ser utilizada por lojistas que desejam integrar seu site próprio com o Cockpit para gestão centralizada de anúncios e recebimento de leads.
Registre-se no Portal de Desenvolvedores da Webmotors
É simples, faça seu registro de usuário na página
Cadastre-se.
Crie a sua APP
Após ter se registrado no portal, registre seu aplicativo na área logada para obter seu Client ID e Client Secret no menu
APPs, através do botão
Cadastrar Nova APP.
Preencha os dados de sua APP e selecione as seguintes API's:
• API MARKETPLACE
Solicite autorização para uso da API
Após a criação de sua APP, gentileza abrir um chamado na seção
Suporte solicitando a liberação da API Consulta de Estoque. Nesse chamado, informe os seguintes dados:
- • Nome do Solicitante:
- • Contato do Solicitante (E-mail e telefone):
- • Contato do canal de Suporte (E-mail e telefone):
- • Nome do Classificado:
- • Razão Social:
- • CNPJ:
- • Site:
- • Nome da APP do Portal do Desenvolvedor:
- • Logo e ícone do Classificado (em PNG):
- • País de atuação do classificado
- • De que forma é obtido o aceite do usuário para compartilhamento dos dados de contato (LGPD)?
Obs: Todos os dados são obrigatórios para a solicitação da integração.
Assim que a análise da solicitação for concluída, comunicaremos o resultado através do chamado aberto.
Homologação
Você será informado sobre a aprovação ou reprovação do pedido de acesso à API através do próprio chamado. Caso sua solicitação seja aprovada, enviaremos os dados de acesso para nosso ambiente de homologação.
Para mais informações sobre autenticação
clique aqui.
Utilize a seguinte URL para acessar nosso ambiente de homologação:
https://hlg-webmotors.sensedia.com/oauth/v1/access-token
Os códigos de retorno são baseados nos
códigos HTTP.
Somente após a homologação aprovada, a aplicação estará disponível para integração aos clientes em ambiente produtivo.
O horário de funcionamento do ambiente de homologação é de segunda à sexta, das 08hrs até 20hrs.
IMPORTANTE: Os acessos ao ambiente de testes/homologação da Webmotors serão revogados após 90 dias corridos ou quando a integração desenvolvida for aprovada e promovida para ambiente produtivo (o que ocorrer primeiro). O prazo para expiração dos acessos é calculado a partir da data de liberação das credenciais para testes.
Desenvolvimento da Aplicação
Após obter as credenciais para acesso ao ambiente de teste/homologação da Webmotors, acesse nossa documentação para iniciar o desenvolvimento:
•
API Marketplace
Com os dados acima você poderá utilizar todos os métodos disponíveis na API Marketplace.
Ativação da integração em Produção
Após concluir com sucesso a homologação, abra um novo chamado no canal de
Suporte e solicite a liberação das APIs em ambiente de Produção. Para tanto, encaminhe as evidências de sucesso dos seguintes itens:
Evidências de Publicação:
- • Listagem de Veículos do Estoque;
- • Status da publicação (Publicado/Erro);
Evidências de Leads:
- • Inclusão de novos leads;
Ativação da integração no Cockpit
Com a liberação da integração em ambiente de Produção, o lojista que deseja ativar a integração com o Classificado precisa criar um usuário com perfil “Integrador de API”. Veja em nossa
FAQ o passo-a-passo para criar o usuário.
Após a criação do usuário, é necessário que o lojista ative a integração com o canal, via Cockpit:
• Causas prováveis: Acessar Estoque > Integrações e ativar a integração com o canal.
A partir da ativação do Classificado no Cockpit Estoque pelo lojista, o classificado terá acesso aos dados dos veículos selecionados para publicação, atualização e desativação no portal.
• Gestão de Leads: Acessar CRM > Integrações e ativar a integração com o canal.
A partir da ativação do Classificado no Cockpit.CRM pelo lojista, será possível encaminhar os leads gerados no classificado para o Cockpit.CRM.
Principais erros
a) 401 - Unauthorized
Causas prováveis:
- • Token de Integração utilizado para autenticação é inválido: A autenticação deve ser realizada utilizando o token gerado pelo Cockpit no momento da ativação do Classificado no Estoque ou CRM;
- • Integração com o classificado desativada no Estoque ou CRM: A ativação da integração com o Classificado deve ser realizada pelo lojista no Cockpit;
- • Não há usuário com perfil “Integrador de API” ativo do Cockpit: O lojista deve cadastrar um usuário com perfil “Integrador de API” na aba “Conta” do Cockpit e mantê-lo com status “Ativo” para que integração com o classificado funcione.
-
-