Você está usando um navegador que não é suportado pelo Tiny. Saiba mais

Pesquisar Produtos API 2.0

Serviço destinado a fazer consulta de Produtos.

ElementoTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
formatostringobrigatórioFormato do retorno (json)
pesquisastringobrigatórioNome ou código (ou parte) do produto que deseja consultar
idTagintopcionalNúmero de identificação da tag no Tiny
idListaPreco (1)intopcionalNúmero de identificação da lista de preço no Tiny
pagina (2)intopcionalNúmero da página
gtinstringopcionalGTIN/EAN do produto
situacao (3)stringopcionalSituação dos produtos ("A" - Ativo, "I" - Inativo ou "E" - Excluído)
dataCriacaostringopcionalData de criação do produto. Formato dd/mm/aaaa hh:mm:ss

(1) - Os preços de venda retornados serão calculados de acordo com a lista de preço informada.
(2) - Número da página de produtos que deseja obter (por padrão são listados 100 registros por página), caso não seja informado o valor padrão é 1.
(3) - Caso o parâmetro não seja enviado, serão assumidos os produtos nas situações Ativo e Inativo.

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.produtos[ ] (2)list-condicionalLista de resultados da pesquisa
retorno.produtos[ ].produto (2)object-condicionalElemento utilizado para representar um produto.
retorno.produtos[ ].produto.idint-obrigatórioNúmero de identificação do produto no Tiny
retorno.produtos[ ].produto.nomestring120obrigatórioNome do produto
retorno.produtos[ ].produto.codigostring30condicionalCódigo do produto
retorno.produtos[ ].produto.preco (4)decimal- obrigatórioPreço de venda do produto
retorno.produtos[ ].produto.preco_promocional (4)decimal- obrigatórioPreço promocional do produto
retorno.produtos[ ].produto.preco_custo (4)decimal- condicionalPreço de custo do produto
retorno.produtos[ ].produto.preco_custo_medio (4)decimal- condicionalPreço médio de custo do produto
retorno.produtos[ ].produto.unidadestring3condicionalUnidade do produto
retorno.produtos[ ].produto.gtinstring14condicionalGTIN/EAN do produto
retorno.produtos[ ].produto.tipoVariacaostring1obrigatórioTipo de variação "N" - Normal, "P" - Pai, "V" - Variação
retorno.produtos[ ].produto.localizacaostring50condicionalLocalização física no estoque
retorno.produtos[ ].produto.situacaostring1condicionalSituação dos produtos ("A" - Ativo, "I" - Inativo, "E" - Excluído)
retorno.produtos[ ].produto.data_criacaostring19condicionalData de criação do produto. Formato dd/mm/aaaa hh:mm:ss

(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.
(4) - Estes campos utilizam “.” (ponto) como separador de decimais, exemplo "5.25".


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

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;
}