Fechar
esqueci a minha senha
criar uma conta

Pesquisar Vendedores API 2.0

Serviço destinado a fazer consulta de vendedores.

ElementoTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
pesquisastringobrigatórioNome ou código (ou parte) do vendedor que deseja consultar
formatostringobrigatórioFormato do retorno (json ou xml)
pagina (1)intopcionalNúmero da página

(1) - Número da página de vendedores que deseja obter (por padrão são listados 50 registros por página), caso não seja informado o valor padrão é 1.

ElementoTipoTamanhoOcorrênciaDescrição
retorno object-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela "Status de Processamento"
retorno.statusstring-obrigatórioContém o status do retorno “OK” ou “Erro”. Para o caso de conter erros estes serão descritos abaixo
retorno.codigo_erro (1)int-condicionalConforme tabela "Códigos de erro"
retorno.erros[ ] (1) (3)list -condicional [0..n]Contém a lista dos erros encontrados.
retorno.erros[ ].errostring-condicionalMensagem contendo a descrição do erro
retorno.paginaint-obrigatórioNúmero da página que está sendo retornada
retorno.numero_paginasint-obrigatórioNúmero de paginas do retorno
retorno.vendedores[ ] (2)list-condicionalLista de resultados da pesquisa
retorno.vendedores[ ].vendedor (2)object-condicionalElemento utilizado para representar um vendedor.
retorno.vendedores[ ].vendedor.idint-condicionalNúmero de identificação do vendedor no Tiny
retorno.vendedores[ ].vendedor.codigostring30condicionalCódigo do vendedor
retorno.vendedores[ ].vendedor.nomestring50condicionalNome ou razão social do contato
retorno.vendedores[ ].vendedor.fantasiastring30condicionalNome fatansia do vendedor
retorno.vendedores[ ].vendedor.tipo_pessoastring1condicionalTipo de pessoa (F - Física, J - Jurídica, E - Estrangeiro)
retorno.vendedores[ ].vendedor.cpf_cnpjstring18condicionalCPF ou CNPJ do vendedor
retorno.vendedores[ ].vendedor.enderecostring50condicionalEndereço do vendedor
retorno.vendedores[ ].vendedor.numerostring10condicionalNúmero do endereço do vendedor
retorno.vendedores[ ].vendedor.complementostring50condicionalComplemento do endereço do vendedor
retorno.vendedores[ ].vendedor.bairrostring30condicionalBairro do vendedor
retorno.vendedores[ ].vendedor.cepstring10condicionalCep do vendedor
retorno.vendedores[ ].vendedor.cidadestring30condicionalNome da cidade conforme a Tabela de Cidades
retorno.vendedores[ ].vendedor.ufstring30condicionalUF do vendedor
retorno.vendedores[ ].vendedor.situacaostring15condicionalSituação do vendedor (Ativo,Excluido)

(1) - Somente estará presente no retorno caso o elemento "status" seja "Erro".
(2) - Somente estará presente no retorno caso o elemento "status" seja "OK".
(3) - Estes campos somente serão informados caso o retorno contenha erros.


$url = 'https://api.tiny.com.br/api2/vendedores.pesquisa.php';
$token = 'coloque aqui a sua chave da api';
$pesquisa = 'xxxxx';
$formato = 'XML';
$data = "token=$token&pesquisa=$pesquisa&formato=$formato";

enviarREST($url, $data);    

function enviarREST($url, $data, $optional_headers = null) {
	$params = array('http' => array(
		'method' => 'POST',
	    'content' => $data
	));
	
	if ($optional_headers !== null) {
		$params['http']['header'] = $optional_headers;
	}
	
	$ctx = stream_context_create($params);
	$fp = @fopen($url, 'rb', false, $ctx);
	if (!$fp) {
		throw new Exception("Problema com $url, $php_errormsg");
	}
	$response = @stream_get_contents($fp);
	if ($response === false) {
		throw new Exception("Problema obtendo retorno de $url, $php_errormsg");
	}
	
	return $response;
}

$client = new nusoap_client("https://api.tiny.com.br/api2.php?wsdl", true);
$client->soap_defencoding = 'UTF-8';
$client->decode_utf8 = false;

$result = $client->call("pesquisarVendedoresService", array('token' => 'xxxxx','pesquisa'=>'xxxxx','formato'=>'XML'));

$res = array();
if ($client->fault) {
	$retorno = $result['faultstring'];		
} else {
	$err = $client->getError();
	if ($err) {
		$retorno = $err;	    	
	} else {
		$retorno = $result;
	}
}
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>1</status_processamento>
  <status>Erro</status>
  <codigo_erro>2</codigo_erro>
  <erros>
    <erro>token invalido</erro>
  </erros>
</retorno>
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>2</status_processamento>
  <status>Erro</status>
  <codigo_erro>21</codigo_erro>
  <erros>
    <erro>A consulta retornou mais registros que o permitido</erro>
  </erros>
</retorno>
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>3</status_processamento>
  <status>OK</status>
  <pagina>1</pagina>
  <numero_paginas>1</numero_paginas>
  <vendedores>
    <vendedor>
      <id>46829055</id>
      <codigo>123</codigo>
      <nome>Vendedor Teste</nome>
      <fantasia>Teste</fantasia>
      <tipo_pessoa>F</tipo_pessoa>
      <cpf_cnpj>00000000000</cpf_cnpj>
      <endereco>Rua Teste</endereco>
      <numero>123</numero>
      <complemento>sala 1</complemento>
      <bairro>Centro</bairro>
      <cep>95700-000</cep>
      <uf>RS</uf>
      <situacao>Ativo</situacao>
    </vendedor>
  </vendedores>
</retorno>