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:
- Id = Vital para sincronização tanto da revenda para controle de alterações como para busca dos veículos. (número inteiro com até 10 dígitos)
- Nome = Nome para exibição no site (string com até 150 caracteres)
- Logradouro, Numero, Complemento, Bairro, Cidade e Estado = Informações do endereço da revenda
- Fone = Telefone(s) de contato (string com até 50 caracteres)
- Email = Email de contato (string com até 100 caracteres)
- Site = Link do site da revenda ou de sua página dentro do Portal* (string com até 150 caracteres)
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:
- Id = Vital para controle de alterações. (número inteiro até 10 dígitos)
- Marca = Marca do veículo (string com até 25 caracteres)
- Modelo = Além do modelo é possível incrementar com motor, combustível entre outras informações até o limite de caracteres. (string com até 50 caracteres)
- Ano = Ano de fabricação e ano do modelo para casos de anos diferentes, é possível informar de 2 a 9 caracteres. (ex. veículo ano 2010 pode ser informado apenas "10" ou para anos diferentes 2010/2011 - Fabricação/Modelo)
- Valor = Valor do veículo com número inteiro, casas decimais o sistema coloca na tela de exibição. (ex. veículo que custa R$ 23.000,00 deve-se enviar 23000)
- Link = Link do site da revenda ou de sua página dentro do Portal* com o detalhamento do veículo e fotos. (string com até 500 caracteres)
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.
