[Resolvido] Como obter detalhes de uma empresa ou loja afiliada ao Bus

Para obtermos detalhes de uma empresa ou loja afiliada ao BuscaPé, usaremos o serviço View Seller Details.

Como funciona este serviço?

Sua aplicação efetua a requisição à API do BuscaPé informando o ID da loja/empresa. O serviço View Seller Details a recebe e retorna detalhes da loja/empresa em formato XML.

/applications/core/interface/imageproxy/imageproxy.php?img=http://conteudo.imasters.com.br/20328/35086.png&key=47fb541c7ebeb104252abe6f1345b8eaacd51621053083a1b5c2e4c29dfe5edd" alt="35086.png" />

Por onde começar?

Primeiramente, em nosso site http://developer.buscape.com, clique na aba ?Documentação? -> ?Wrapper PHP?. Nessa página, você encontra toda a documentação do wrapper, assim como o link para seu download. Efetuado o download, inclua a classe em seu aplicativo e a instancie, informando o ID de sua aplicação.

require_once '../Apiki_Buscape_API.php';
$applicationId = '564771466d477a4458664d3d';
$objApikiWrapper = new Apiki_Buscape_API( $applicationId );

Logo após instanciar a classe Apiki_BuscaPe_API, chame o método viewSellerDetails, passando como parâmetro um array com o ID da loja/empresa.

- Busca a empresa ?Assunção Escapamento? relacionada ao ID 335525

$objApikiWrapper->viewSellerDetails( array( 'sellerId' => 335525 ) );

Se estiver efetuando a requisição à API do BuscaPé em ambiente de testes, não podemos nos esquecer de definir o SandBox antes de executar o método viewSellerDetails.

$objApikiWrapper->setSandbox();

Como é o retorno desse método?

Por padrão, todos os métodos da classe Apiki_ BuscaPe_ API são retornados no formato XML. Veja um exemplo abaixo:

echo $objApikiWrapper->viewSellerDetails( array( 'sellerId' => 335525 ) );A seguinte URL será exibida:

http://sandbox.buscape.com/service/viewSellerDetails/564771466d477a4458664d3d/BR/?sellerId=3355257

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="1" totalResultsAvailable="1" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
 <details>
 <applicationID>564771466d477a4458664d3d</applicationID>
 <applicationVersion>1.0.0.0</applicationVersion>
 <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
 <date>2011-02-21T18:13:42.022</date>
 <elapsedTime>2818</elapsedTime>
 <status>success</status>
 <code>0</code>
 <message>success</message>
 </details>
 <seller pagamentoDigital="false" isTrustedStore="false" id="335525">
 <sellerName>Assunção Escapamento</sellerName>
 <links>
 <link type="seller" url=""/>
 </links>
 <extra>Loja em MG, Contagem, Eldorado</extra>
 <contacts>
 <contact label="Atendimento" value="31-33551606"/>
 </contacts>
 <rating>
 <userAverageRating>
 <numComments>0</numComments>
 <rating>0.0</rating>
 </userAverageRating>
 </rating>
 <addresses>
 <address>
 <name>Assunção Escapamento</name>
 <postalArea>Avenida João César de Oliveira</postalArea>
 <complement>3168</complement>
 <district>Eldorado</district>
 <city>Contagem</city>
 <state>MG</state>
 <postalCode>32340000</postalCode>
 <fone>31-33551606</fone>
 <map>
 <latitude>-19.938570000</latitude>
 <longitude>-44.052960000</longitude>
 </map>
 </address>
 </addresses>
 </seller>
</Result>

Podemos também definir esse retorno em formato JSON. Veja um exemplo de como defini-lo e como são os dados retornados:

$objApikiWrapper->setFormat('json');
echo $objApikiWrapper->viewSellerDetails( array( 'sellerId' => 335525 ) );

http://sandbox.buscape.com/service/viewSellerDetails/564771466d477a4458664d3d/BR/?sellerId=335525&format=json

{"details":{"message":"success","elapsedtime":1,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":14,"valid":true,"timezone":-2147483648,"second":48,"millisecond":394,"month":2,"year":2011,"hour":18,"day":21,"xmlschematype":{"namespaceuri":"http://www.w3.org/2001/XMLSchema","prefix":"","localpart":"dateTime"},"eonandyear":{"lowestsetbit":0}},"applicationpath":"http://bws-apps.buscape.com/mobile/update","applicationid":"564771466d477a4458664d3d"},"totalresultsavailable":1,"seller":{"id":335525,"extra":"Loja em MG, Contagem, Eldorado","sellername":"Assunção Escapamento","links":[{"link":{"type":"seller","url":""}}],"rating":{"useraveragerating":{"rating":"0.0","numcomments":0}},"addresses":[{"address":{"complement":"3168","postalcode":"32340000","name":"Assunção Escapamento","map":{"longitude":"-44.052960000","latitude":"-19.938570000"},"state":"MG","fone":"31-33551606","postalarea":"Avenida João César de Oliveira","district":"Eldorado","city":"Contagem"}}],"istrustedstore":false,"pagamentodigital":false,"contacts":[{"contact":{"value":"31-33551606","label":"Atendimento"}}]},"totalresultsreturned":1}

Assista ao que mudou e às novidades da classe Apiki BuscaPé API 2.0 para PHP e a outros tutoriais prontos a lhe ajudar a integrar sua aplicação ao BuscaPé.

Até a próxima!

http://imasters.com.br/artigo/20328/apis-buscape/como-obter-detalhes-de-uma-empresa-ou-loja-afiliada-ao-buscape-usando-o-wrapper-php