Home > API & Documentação > Detalhes de uma loja ou empresa

Detalhes de uma loja ou empresa

Nesta página:

Este serviço retorna os detalhes de uma loja ou empresa como: endereços, telefones de contato e etc.

Como funciona?

  1. Aplicação efetua uma requisição informando o ID da loja/empresa.
  2. Serviço recebe a requisição e busca os detalhes da loja/empresa no Buscapé.
  3. Serviço retorna a detalhes da loja/empresa no formato XML para aplicação.

Funcionamento dos detalhes técnicos de lojas ou empresas

Formatos de URL aceitos

http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=<sellerId>

Parâmetros

Parâmetros Tipo Descrição
sellerId Int ID da loja/empresa

Formatos de resposta

O formato padrão de resposta é XML.

Caso queira utilizar o formato de resposta JSON, adicione o parâmetro format=json.

Exemplo de requisição

http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=155

XSD Document (XML SCHEMAS)

http://developer.buscape.com/xsd/buscape.xsd

Campos de resposta

Result

Campos Tipo Descrição
details ResultDetails Detalhes da requisição
category CategoryType Dados da categoria atual
totalResultsAvailable Int Total de itens disponíveis
Total de itens disponíveis Int Total de itens retornados
totalPages Int Total de páginas
page Int Número da página atual
match match Retorna o tipo de pesquisa por palavra(s)-chave(s)
  • all: Pesquisa perfeita, toda(s) palavra(s)-chave(s) encontrada(s)
  • any: Pesquisa parcial, alguma(s) palavra(s)-chave(s) encontrada(s)
  • none: Pesquisa não encontrada

ResultDetails

Campos Tipo Descrição
applicationID String ID da aplicação
date String Data/Hora da requisição com timezone
elapsedTime Long Tempo de execução da requisição em milisegundos
status String Status da resposta
code Int Código da resposta
message String Mensagem da resposta

SellerType

Campos Tipo Descrição
id Int ID do vendedor
isTrustedStore Boolean Se true, informa que a loja tem um selo de empresa reconhecida
sellerName String Nome do vendedor
extra String Outras informações da loja
thumbnail ThumbnailType Logo do vendedor
links LinksType Links da loja
  • seller: URL da loja
contacts ContactsType Lista de contatos
rating RatingType Avaliação do vendedor

LinksType

Campos Tipo Descrição
link LinkType Link

LinkType

Campos Tipo Descrição
type String Tipo do Link:
url String Endereço do link

ThumbnailType

Campos Tipo Descrição
url String Endereço imagem

RatingType

Campos Tipo Descrição
userAverageRating UserRatingType Avaliação dos usuários

UserRatingType

Campos Tipo Descrição
numComments Int Número de comentários
rating String Média das notas dos usuários
link LinkType Link da avaliação
  • xml: URL do serviço de avalição dos usuário pelo ID do produto
specification SpecificationType Avaliação por itens do produto

SpecificationType

Campos Tipo Descrição
item ItemListType Lista de itens da especificação
links LinkType Links
label String Descrição da especificação

ItemListType

Campos Tipo Descrição
label String Nome do Item
value String Valor do item

ContactsType

Campos Tipo Descrição
contact ContactType Lista de contatos

ContactType

Campos Tipo Descrição
label String Descrição do contato
value String Valor do contato

AddressesType

Campos Tipo Descrição
addresses AddressType Dados do endereço

AddressType

Campos Tipo Descrição
name String Nome do estabelecimento
postalArea String Endereço
complement String Complemento do endereço
district Strings Bairro
city String Cidade
postalCode String CEP
fone String Telefone de contato
map MapType Coordenadas do endereço

MapType

Campos Tipo Descrição
Latitude String Latitude
Longitude String Longitude

Exemplo de resposta

Buscar detalhes da saraiva.com.br, id=155.

http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=155
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Result xmlns="urn:buscape" totalResultsReturned="1" totalResultsAvailable="1">
        <details>
            <applicationID><APPLICATION_ID></applicationID>
            <date>2009-01-26T17:42:59.468-03:00</date>
            <elapsedTime>18</elapsedTime>
            <status>success</status>
            <code>0</code>
            <message>success</message>
        </details>
        <seller isTrustedStore="true" id="155">
            <sellerName>Saraiva e Siciliano S.A</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo155.gif"/>
            <links>
                <link type="seller" url="http://www.livrariasaraiva.com.br/?PAC_ID=6297"/>
            </links>
            <extra>Vende pela Internet</extra>
            <contacts>
                <contact label="Televendas" value="11-33352957"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>31631</numComments>
                    <rating>9.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>31631</numComments>
                    <rating>diamante</rating>
                </eBitRating>
            </rating>
            <addresses>
                <address>
                    <name>MEGA CAMPINAS</name>
                    <postalArea>IGUATEMI</postalArea>
                    <complement>777 SUC 2 - 2º Piso</complement>
                    <district>Vl Brandina</district>
                    <city>Campinas</city>
                    <state>SP</state>
                    <postalCode>13094691</postalCode>
                    <fone>19-32520223</fone>
                    <map>
                        <latitude>-22.893826962</latitude>
                        <longitude>-47.026324305</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA RIBEIRÃO PRETO</name>
                    <postalArea>Rua São José - até 1351/1352</postalArea>
                    <complement>933</complement>
                    <district>Centro</district>
                    <city>Ribeirão Preto</city>
                    <state>SP</state>
                    <postalCode>14010160</postalCode>
                    <fone>16-39410433</fone>
                    <map>
                        <latitude>-21.183397708</latitude>
                        <longitude>-47.809557083</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA NOVO SHOPPING RIBEIRÃO</name>
                    <postalArea>Avenida Presidente Kennedy - até 1900 - lado par</postalArea>
                    <complement>1500 Área Comercial 309</complement>
                    <district>Ribeirânia</district>
                    <city>Ribeirão Preto</city>
                    <state>SP</state>
                    <postalCode>14096350</postalCode>
                    <fone>16-39654340</fone>
                    <map>
                        <latitude>-21.201461147</latitude>
                        <longitude>-47.767514429</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA OUVIDOR</name>
                    <postalArea>Rua do Ouvidor - de 50/51 ao fim</postalArea>
                    <complement>98 A</complement>
                    <district>Centro</district>
                    <city>Rio de Janeiro</city>
                    <state>RJ</state>
                    <postalCode>20040030</postalCode>
                    <fone>21-25073785</fone>
                    <map>
                        <latitude>-22.903266667</latitude>
                        <longitude>-43.177523333</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA TIJUCA</name>
                    <postalArea>Avenida Maracanã - de 1531 ao fim - lado ímpar</postalArea>
                    <complement>987  Piso L1 -  Lojas 1008/9/10/12/13</complement>
                    <district>Tijuca</district>
                    <city>Rio de Janeiro</city>
                    <state>RJ</state>
                    <postalCode>20530230</postalCode>
                    <fone>21-38723477</fone>
                    <map>
                        <latitude>-22.922600000</latitude>
                        <longitude>-43.235910000</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA RIO SUL</name>
                    <postalArea>Rua Lauro Muller - de 191 ao fim - lado ímpar</postalArea>
                    <complement>116 Lj. 301 - Parte C13</complement>
                    <district>Botafogo</district>
                    <city>Rio de Janeiro</city>
                    <state>RJ</state>
                    <postalCode>22290160</postalCode>
                    <fone>21-25437002</fone>
                    <map>
                        <latitude>-22.956360000</latitude>
                        <longitude>-43.175990000</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA NYCC</name>
                    <postalArea>Avenida das Américas - de 03979 a 05151 - lado ímpar</postalArea>
                    <complement>5000 LUC 103 - Nível Térreo</complement>
                    <district>Barra da Tijuca</district>
                    <city>Rio de Janeiro</city>
                    <state>RJ</state>
                    <postalCode>22631004</postalCode>
                    <fone>21-24316494</fone>
                    <map>
                        <latitude>-22.999411620</latitude>
                        <longitude>-43.360991676</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA SALVADOR</name>
                    <postalArea>Avenida Tancredo Neves - lado ímpar</postalArea>
                    <complement>2915 Loja 205 B - Piso 2</complement>
                    <district>Caminho das Árvores</district>
                    <city>Salvador</city>
                    <state>BA</state>
                    <postalCode>41820021</postalCode>
                    <fone>71-33417020</fone>
                    <map>
                        <latitude>-12.975421190</latitude>
                        <longitude>-38.457738997</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA RECIFE</name>
                    <postalArea>SHOPPING CENTER RECIFE</postalArea>
                    <complement>777 Loja 28B/108A</complement>
                    <district>Boa Viagem</district>
                    <city>Recife</city>
                    <state>PE</state>
                    <postalCode>51020900</postalCode>
                    <fone>81-34649393</fone>
                    <map>
                        <latitude>-8.119213571</latitude>
                        <longitude>-34.921259286</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA GOIÂNIA</name>
                    <postalArea>Avenida Jamel Cecílio - de 3569 a 4139 - lado ímpar</postalArea>
                    <complement>3300  Piso 3 - Loja T-359</complement>
                    <district>Jardim Goiás</district>
                    <city>Goiânia</city>
                    <state>GO</state>
                    <postalCode>74810100</postalCode>
                    <fone>62-35151588</fone>
                    <map>
                        <latitude>-16.709852026</latitude>
                        <longitude>-49.233034240</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA CURITIBA</name>
                    <postalArea>Rua Comendador Araújo - até 2129/2130</postalArea>
                    <complement>731 Lojas 251, 252 e 258</complement>
                    <district>Centro</district>
                    <city>Curitiba</city>
                    <state>PR</state>
                    <postalCode>80420000</postalCode>
                    <fone>41-32328081</fone>
                    <map>
                        <latitude>-25.437950526</latitude>
                        <longitude>-49.281359649</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA FLORIANÓPOLIS</name>
                    <postalArea>Avenida Madre Benvenuta - de 0522/523 a 1246/1247</postalArea>
                    <complement>687 Espaço Comercial 338 A</complement>
                    <district>Santa Mônica</district>
                    <city>Florianópolis</city>
                    <state>SC</state>
                    <postalCode>88035000</postalCode>
                    <fone>48-32343474</fone>
                    <map>
                        <latitude>-27.591477928</latitude>
                        <longitude>-48.515193933</longitude>
                    </map>
                </address>
                <address>
                    <name>MEGA PRAIA DE BELAS</name>
                    <postalArea>Avenida Praia de Belas - lado ímpar</postalArea>
                    <complement>1181 2º Piso - Loja 05</complement>
                    <district>Praia de Belas</district>
                    <city>Porto Alegre</city>
                    <state>RS</state>
                    <postalCode>90110001</postalCode>
                    <fone>51-32316868</fone>
                    <map>
                        <latitude>-30.048020000</latitude>
                        <longitude>-51.227680000</longitude>
                    </map>
                </address>
            </addresses>
        </seller>
    </Result>

Erros

Conforme visualizado em ResultDetails, a resposta pode retornar códigos de erros.

Aviso aos desenvolvedores

Caso o seu aplicativo seja executado em um servidor, é necessário informar aos webservices do Buscapé o IP do usuário que acessa o seu servidor. O IP do usuário deve ser informado através do parâmetro clientIp. Caso o seu aplicativo seja executado diretamente na máquina do usuário final, como aplicações mobile ou javascript, não é necessário informar o IP do usuário. Se, por exemplo, o IP do usuário que acessou o seu servidor seja 200.200.200.200, a chamada deveria ser feita assim:

http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=<sellerId>&clientIp=200.200.200.200

Caso o aplicativo, sistema ou site utilize cache, o mesmo deverá ser de, no máximo, uma hora para produtos e categorias. No caso de ofertas, como o clique é validado através do IP do usuário e pela hora do clique, o cache não pode existir pois, se dois IP's acessam o mesmo link de oferta, o clique é invalidado.

Topo