Escolar Documentos
Profissional Documentos
Cultura Documentos
Buscapé Manual de Integração XML
Buscapé Manual de Integração XML
Integrao
Buscap XML
ndice
#
1. Objetivo do documento ............................................................... 3
2. Pr-requisitos ................................................................................. 3
3. Para que serve? ............................................................................... 3
4. Como saber se um XML capturvel? ....................................... 3
5. Como deve ser a estrutura de um XML? ................................... 5
6. Campos extras ................................................................................. 9
7. Casos especiais Diviso de XML ............................................ 10
_Manual de Integrao
Buscap XML
1. Objetivo do documento
Fornecer todas as instrues para que um canal (ex. plataforma de lojas) realize
a integrao com o Buscap para a gerao do arquivo XML contendo as ofertas
do lojista no formato correto, de tal forma a habilit-la na sua base de lojas.
2. Pr-requisitos
_ Esta integrao se aplica somente a lojas que estiverem cadastradas no Buscap,
atravs da Central de Negcios CN (http://negocios.buscapecompany.com.br/)
que esto configuradas para captura automtica atravs de uma URL que aponta
para o arquivo XML contendo as ofertas do lojista.
_ Fornecer o contedo XML compacto. Zip, GZip ou compatvel.
_Manual de Integrao
Buscap XML
Para lojistas que vendem produtos de moda e acessrios, existem outros itens que
so obrigatrios:
1- Cor
2- Tamanho
Sendo opcionais:
1 - Parcelamento
2 - Id Oferta
3 - Modelo do produto
4 - Marca do produto
O item de parcelamento deve estar no seguinte formato para que ele seja
compreendido pelo nosso sistema:
Exemplo, uma oferta no valor de R$ 100,00 parcelado em 10 prestaes:
_ 10x de R$ 10,00
O item de Id oferta um campo que poder ser ou no alfanumrico, que possui duas
finalidades:
_ Utiliz-lo como um meio de diferenciar as ofertas;
_ Colocao da oferta no PRODUTO NICO de maneira automtica, o que ns
chamamos de vnculo.
Quando utilizado com o intuito de diferenciar as ofertas, seu Id adicionado
na descrio junto com a palavra cod..
_Manual de Integrao
Buscap XML
<descricao>Nome/titulo do Oferta</descricao>
<preco>Preo do Oferta</preco>
oferta.</id_oferta>
<link_prod>Link de Detalhes</link_prod>
possvel</categoria>
parcelamento>
</produto>
.
.
.
</produtos>
</lojaxyz>
_Manual de Integrao
Buscap XML
Para lojistas que vendem produtos de moda e acessrios, a estrutura do XML com
as tags cor e tamanho fica da seguinte maneira:
<?xml version=1.0 encoding=ISO-8859-1?>
<!-- Generated at 2012-08-06T09:15:30GMT-3--> <lojaxyz>
<produtos>
<produto>
<descricao>Nome/titulo do Oferta</descricao>
<preco>Preo do Oferta</preco>
oferta.</id_oferta>
<link_prod>Link de Detalhes</link_prod>
possvel</categoria>
parcelamento>
</produto>
.
.
.
</produtos>
</lojaxyz>
_Manual de Integrao
Buscap XML
EXEMPLO:
<?xml version=1.0 encoding=ISO-8859-1?> <!-- Generated at
2012-08-06T09:15:30GMT-3--> <lojaxyz>
<produtos>
<produto>
<preco>R$ 200,00</preco>
<id_oferta>5896179</id_oferta>
<link_prod>http://www.lojaxyz.com.br/prod/5896179/sony-cyber-shot-
abc123</link_prod>
<imagem>http://www.lojaxyz.com.br/imagem/5896179.jpg</imagem>
<disponibilidade>25</disponibilidade>
</produto>
<produto>
<preco>R$ 1200,00</preco>
<id_oferta>6789354</id_oferta>
<link_prod>http://www.lojaxyz.com.br/prod/6789354/sony-XYZ</link_prod>
<imagem>http://www.lojaxyz.com.br/imagem/6789354.jpg</imagem>
<parcelamento> 4x de R$ 300,00</parcelamento>
<disponibilidade>12</disponibilidade> </produto>
.
.
.
</produtos>
<lojaxyz>
IMPORTANTE:
Apesar da flexibilidade para a criao do XML, h um item que deve ser
_Manual de Integrao
Buscap XML
<descricao>...</descricao>
<preco>...</preco>
<id_oferta>...</id_oferta>
<link_prod>...</link_prod>
<imagem>...</imagem>
<categoria>...</categoria>
<parcelamento>...</parcelamento>
<disponibilidade>...</disponibilidade>
</produto>
</produtos>
</lojaxyz>
_Manual de Integrao
Buscap XML
Nesta representao, o timestamp fica logo no inicio do XML antes da tag raiz inicial
(<lojaxyz> neste exemplo acima).
6. Campos extras
Tambm possumos campos extras para suprir necessidades especiais, exemplificadas
a seguir:
_ Cdigo de barras: Cdigo numrico UPC/EAN/GTIN
_ ISBN: 13 ou 10 dgitos
_ Detalhes: Maiores informaes sobre a oferta
_ Data estoque: no formato dd/mm/aaaa
_ Id filial: Cdigo nico que identifica a filial
<codigo_barra>Cdigo de Barra numrico, se mais de um, separar por
vrgula</codigo_barra>
<isbn>Cdigo do ISBN se for livro</isbn>
<detalhes>Os sub-ns existentes nesse campo variam de acordo com cada
caracterstica das ofertas</detalhes>
<data_estoque>data de atualizao da informao do estoque desta oferta</dt_
estoque>
<id_filial>Cdigo nico que identifica o filial, o mesmo usado no cadastro na CN</
id_filial>
_Manual de Integrao
Buscap XML
10