Home > Home > Documentación > Detalles de una tienda o empresa

Detalles de una tienda o empresa

Este servicio devuelve los detalles de una tienda o negocio como: direcciones, números de teléfono y así sucesivamente.

¿Cómo funciona?

Funcionamento dos detalhes técnicos de lojas ou empresas

En esta página:
  1. Aplicación envía una solicitud indicando el ID de la tienda / empresa.
  2. Servicio recibe la solicitud y busca los detalles de la tienda / empresa en Buscapé.
  3. Service devuelve la información de la tienda o la empresa en el formato XML para su aplicación.

Formatos de URL

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

Parámetros

Parámetros Tipo Descripción
sellerId Int Tienda de negocio ID

Formatos de respuesta

El formato de respuesta es XML.

Si desea utilizar el formato de respuesta JSON, agregue el format=json.

Solicitud de Muestras

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

Documento XSD (esquema XML)

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

Campos de respuesta

Result

Campos Tipo Descripción
details ResultDetails Solicitud de información
category CategoryType Datos de la categoría actual
totalResultsAvailable Int Total de artículos disponibles
Total de itens disponíveis Int Total de devolución
totalPages Int Total de páginas
page Int El número de página actual
match match Devuelve el tipo de palabra clave de búsqueda
  • all: Investigación perfecta, todas las palabras clave que se encuentran
  • any: una parte de investigación, algunas palabras clave que se encuentran
  • none: La búsqueda no encontrado

ResultDetails

Campos Tipo Descripción
applicationID String ID de aplicación
date String Fecha y hora de la solicitud
elapsedTime Long Tiempo de ejecución de la solicitud en milisegundos
status String Condición Jurídica y Social de Respuesta
code Int Código de respuesta
message String Responder mensaje

SellerType

Campos Tipo Descripción
id Int ID del vendedor
isTrustedStore Boolean Si es cierto, informa que la tienda tiene un sello de la empresa reconocida
sellerName String Nombre del vendedor
extra String Más información
thumbnail ThumbnailType Pronto el vendedor
links LinksType Siore links
  • vendedor: Tienda de URL
contacts ContactsType Lista de contactos
rating RatingType Evaluación Del Vendedor

LinksType

Campos Tipo Descripción
link LinkType Link

LinkType

Campos Tipo Descripción
type String Tipo de link
url String Dirección del Link

ThumbnailType

Campos Tipo Descripción
url String dirección de imagen

RatingType

Campos Tipo Descripción
userAverageRating UserRatingType Evaluación de los usuarios

UserRatingType

Campos Tipo Descripción
numComments Int Número de comentarios
rating String Promedio de calificaciones de los usuarios
link LinkType Link evaluación
  • XML: URL de hacer Serviço de avalição dos Usuario pelo ID do produto
specification SpecificationType Evaluación de los elementos del producto

SpecificationType

Campos Tipo Descripción
item ItemListType Lista de artículos especificación
links LinkType Links
label String Lista de artículos especificación

ItemListType

Campos Tipo Descripción
label String Nombre del artículo
value String Relación del artículo

ContactsType

Campos Tipo Descripción
contact ContactType Lista de contactos

ContactType

Campos Tipo Descripción
label String Póngase en contacto con la descripción
value String Póngase en contacto con valor

AddressesType

Campos Tipo Descripción
addresses AddressType De datos de direcciones

AddressType

Campos Tipo Descripción
name String Nombre del establecimiento
postalArea String Dirección
complement String Complemento de la dirección
district Strings Barrio
city String Ciudad
postalCode String Código postal
fone String Teléfono de Contacto
map MapType Coordenadas de la dirección

MapType

Campos Tipo Descripción
Latitude String Latitud
Longitude String Longitud

Ejemplo de respuesta

Buscar saraiva.com.br detalles, 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</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>

Errores

Como se observa en ResultDetails, la respuesta puede devolver códigos de error.

Aviso a los desarrolladores

Si la aplicación se ejecuta en un servidor, debe informar a los servicios web Buscapé el IP del usuario para acceder a su servidor. El IP del usuario debe ser informado por el parámetro clientIp. Si la aplicación se ejecuta directamente en la máquina del usuario final, tales como aplicaciones móviles o javascript, no es necesario informar el IP del usuario. Si, por ejemplo, el IP del usuario que accede a su servidor es 200.200.200.200, la llamada debe hacerse así:

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