Consultar Estoque Webmotors

É simples, faça seu registro de usuário na página Cadastre-se informando "Classificado" no campo "Tipo de cliente".

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:
• WEBMOTORS CATALOGO API 1.0.0 [API PARA INTEGRAÇÃO DE CATÁLOGO DA WEBMOTORS]
• WEBMOTORS ESTOQUE CANAIS API 1.0.0 [API PARA INTEGRAÇÃO DE ESTOQUE PARA OUTROS CANAIS]

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):
• • Cite o CNPJ de clientes em comum com a Webmotors:
• • Regiões de atuação do Classificado:
• • Quantidade de Estoque:

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.

Você receberá a liberação ou negação de uso no 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.

O horário de funcionamento do ambiente de homologação é de segunda à sexta, das 08hrs até 20hrs.

Somente após a homologação aprovada, a aplicação estará disponível para integração aos clientes em ambiente produtivo.

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.

Após obter sua autenticação, acesse nossa documentação para iniciar o desenvolvimento:
• Integração do catálogo Webmotors
• Integração de estoque para outros canais

Com os dados acima você poderá utilizar todos os métodos disponíveis nas API's para integrar o catálogo e estoque com a Webmotors.

Baixe a Collection do Postman clicando aqui.

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:
 

• • Listagem de interações;
• • Status da publicação (Publicado/Erro);
• • Listagem de estoque.

Cada lojista de forma individual deve entrar no endereço https://cockpit.webmotors.com.br/classificados-integrados, realizar a ativação do novo classificado e enviar o token (chave de acesso) que será gerado juntamente a ativação para a equipe do classificado. Este token terá que ser inserido no classificado e será a sua chave de acesso na Webmotors.

Após o classificado estar ativado, o lojista, em sua página de Gestão de Estoque, poderá efetuar a captura do anúncio para que o classificado possa consumir os dados do anúncio e publicar em seu portal.



Nesta API está disponibilizado um end-point onde é possível atualizar o status do anúncio, informar erro na publicação e também enviar o link do anúncio após publicado. Estas informações refletirão diretamente na gestão de estoque do cliente. Consulte a documentação desse end-point clicando aqui.

a) 401 - Unauthorized



Causas prováveis:

• 1) 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. Para conferir este dado, acesse a aba de Classificados Integrados do Cockpit.


• 2) Integração com o classificado desativada na aba de classificados integrados da loja:
  
  A ativação da integração com o Classificado deve ser realizada pelo lojista na aba Classificados Integrados do Cockpit.


• 3) 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.

b) Listagem de interações vazia

• • URL Homologação: http://hlg-webmotors.sensedia.com/estoquecanais/v1/interacoes
• • URL Produção: http://api-webmotors.sensedia.com/estoquecanais/v1/interacoes

Causa provável:
 

• Lojista não solicitou a publicação, despublicação ou atualização de veículos no Classificado Integrador via Cockpit.
  
  Sempre que o lojista executa uma ação no Cockpit que deve ser refletiva no Classificado Integrado, como por exemplo, solicitar a publicação ou despublicação do veículo, ou atualizar um veículo publicado, os dados da interação ficam disponíveis para consulta nesta listagem.
  
  Caso a listagem retorne vazia, isto pode significar que o lojista não solicitou nenhuma atualização. Ao acionar o Suporte Técnico Webmotors, certifique-se de que alguma ação tenha sido executada através do botão de captura no Cockpit Estoque, conforme demonstrado abaixo:
  
  
  
  Assim que os veículos forem enviados para captura, os dados estarão disponíveis no endpoint de listagem para captura.

c) Listagem de estoque vazia

• • URL Homologação: http://hlg-webmotors.sensedia.com/estoquecanais/v1/itens
• • URL Produção: http://api-webmotors.sensedia.com/estoquecanais/v1/itens

Causa provável:
 

• Não há veículos com status “Publicado” associado ao Classificado Integrador no Cockpit.
  
  Os Classificados Integrados devem reportar para o Cockpit o status final da ação solicitada pelo Lojista (Sucesso ou Erro), através de endpoint específico para este fim, conforme consta na documentação da integração.
  
  Caso isto não ocorra, o status do veículo não será atualizado no Cockpit e não será possível obter os dados dos veículos publicados no canal através deste endpoint de Listagem.
  
  Ao acionar o Suporte Técnico Webmotors, certifique-se de que há veículos com status “Publicado” associados ao Classificado Integrado Cockpit Estoque, conforme demonstrado abaixo: