API XML para publicação de revendas e veículos
Objetivo
Ao disponibilizar a sincronização das revendas do Portal* ao visitante, estamos oferecendo ao mesmo uma quantia maior e de melhor qualidade no quesito informação atualizada, uma vez que estas informações estão sendo entregues/publicadas pelos Portais* os quais possuem um contato direto com o revendedor para atualização de endereços e fones de contato.
Ao disponibilizar a sincronização dos veículos das revendas do Portal* estamos oferecendo ao visitante um acesso mais rápido a informação buscada assim como um filtro melhor para o acesso ao site da revenda para obter o detalhamento das informações.
Vantagens em ser um Portal* parceiro
Uma vitrine nova para todos os clientes (revendas) em nível nacional.
Cada revenda publicada no Guia Revendas, o Portal* aparece ao lado com um selo (banner Micro Bar - 88x31 pixels) com link para o seu site.
Uma página de parceiros com um espaço para logomarca (banner Rectangle - 180x150 pixels) e link para o site.
Segurança
Processo funciona a partir de uma chave de segurança, uma senha previamente cadastrada no Guia Revendas, a qual apenas o Portal* e o Guia Revendas possuem conhecimento, desta forma não é necessário uma autenticação para integração/sincronização dos dados, apenas o uso desta chave privada possibilita que apenas o Guia Revendas busque estas informações.
Se o Portal* preferir, pode-se deixar o acesso ao XML liberado sem a utilização da chave de segurança.
Fluxo
Após o cadastro do Portal* no Guia Revendas onde é informado o site, cadastramento do selo (banner Micro Bar - 88x31 pixels), link para sincronização dos dados e a chave privada de acesso, o Guia Revendas já estará pronto para buscar as informações, lista de revendas e seus veículos.
Este processo de sincronização ocorre dua vezes ao dia em horários pré-determinados entre o Guia Revendas e o Portal* para evitar uma eventual sobrecarga no link de acesso e base de dados.
Uma vez sincronizado os dados, todas as revendas deste Portal* será listada acompanhada de um selo do Portal* (banner Micro Bar - 88x31 pixels) assim como um link para listar/exibir os veículos.
Arquivo XML - REVENDAS
Arquivo responsável pela divulgação das revendas do Portal*.
Este arquivo possui a quantia de registros exportados, a data e hora de exportação para fins de controle do sistema de importação.
Descrição dos campos:
Veja um exemplo do XML gerado: revendas.xml
Veja as regras para geração do XML: revendas.xsd
Faça o download do manual com as especificações dos campos do XML.
Para a criação do arquivo XML o Guia Revendas esta disponibilizando uma classe em PHP para utilização: guiarevendas.php
Veja como utilizar a classe PHP do Guia Revendas para gerar o XML das revendas: exemplo_revenda.codigo.php
Basta criar um Array com os índices com os nomes dos campos do XML, popular com os dados, instanciar a classe GuiaRevendas passando de parâmetro a chave privada e a chave publica para conferência.
Instanciada a classe, basta passar o array com os dados para a classe gerar o XML.
Arquivo XML - VEÍCULOS
Arquivo responsável pela divulgação dos veículos das revendas.
Este arquivo possui o Id da revenda solicitada, a quantia de registros exportados, a data e hora de exportação para fins de controle do sistema de importação.
Descrição dos campos:
Veja um exemplo do XML gerado: veiculos.xml
Veja as regras para geração do XML: veiculos.xsd
Faça o download do manual com as especificações dos campos do XML.
Para a criação do arquivo XML o Guia Revendas esta disponibilizando uma classe em PHP para utilização: guiarevendas.php
Veja como utilizar a classe PHP do Guia Revendas para gerar o XML dos veículos: exemplo_veiculo.codigo.php
Basta criar um Array com os índices com os nomes dos campos do XML, popular com os dados, instanciar a classe GuiaRevendas passando de parâmetro a chave privada e a chave publica para conferência.
Instanciada a classe, basta passar o array com os dados para a classe gerar o XML.
Suporte
Para qualquer tipo de ajuda, desde esclarecimento técnico sobre o funcionamento, como auxilio para desenvolvimento dos arquivos XML, basta entrar em contato pelo email contato@guiarevendas.com.br
* Portal: Todo site que possui vários sites de revendas "dentro" de si.