Obter Estoque Produto API 2.0

Serviço destinado a fazer consulta de Produtos.

REST

REST URL

Elemento	Tipo	Ocorrência	Descrição
token	string	obrigatório	Chave gerada para identificar sua empresa
id	int	obrigatório	Número de identificação do produto no Tiny
formato	string	obrigatório	Formato do retorno (json)

Elemento	Tipo	Tamanho	Ocorrência	Descrição
retorno	object	-	obrigatório	Elemento raiz do retorno
retorno.status_processamento	int	-	obrigatório	Conforme tabela "Status de Processamento"
retorno.status	string	-	obrigatório	Contém o status do retorno “OK” ou “Erro”. Para o caso de conter erros estes serão descritos abaixo
retorno.codigo_erro ⁽¹⁾	int	-	condicional	Conforme tabela "Códigos de erro"
retorno.erros[ ] ^{(1) (3)}	list	-	condicional [0..n]	Contém a lista dos erros encontrados.
retorno.erros[ ].erro	string	-	condicional	Mensagem contendo a descrição do erro
retorno.produto ⁽²⁾	object	-	condicional	Elemento utilizado para representar o produto.
retorno.produto.id	int	-	condicional	Número de identificação do produto no Tiny
retorno.produto.nome	string	120	condicional	Nome do produto
retorno.produto.codigo	string	30	condicional	Código do produto
retorno.produto.unidade	string	3	condicional	Unidade do produto
retorno.produto.saldo ^{(4) (8)}	decimal	3	condicional	Saldo em estoque
retorno.produto.saldoReservado ^{(4) (7) (8)}	decimal	3	condicional	Saldo reservado em estoque
retorno.produto.depositos[ ] ^{(5) (8)}	list	-	condicional	Lista de depositos
retorno.produto.depositos[ ].deposito	-	-	condicional	Elemento utilizado para representar um deposito.
retorno.produto.depositos[ ].deposito.nome	string	120	condicional	Nome do depósito.
retorno.produto.depositos[ ].deposito.desconsiderar ⁽⁶⁾	string	1	condicional	Desconsidera o saldo do depósito(S/N).
retorno.produto.depositos[ ].deposito.saldo ⁽⁴⁾	decimal	-	condicional	Saldo do estoque no depósito.
retorno.produto.depositos[ ].deposito.empresa	string	120	condicional	Apelido da empresa.

(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".
(5) - Lista de Depósitos de estoque, exemplo: Loja, Depósito X, etc.
(6) - Considera o saldo do depósito no total em estoque do produto.
(7) - Este campo é retornado apenas se a conta possui a extensão Reserva de Estoques habilitada.
(8) - Se você possui a extensão MultiEmpresas e deseja considerar o estoque do produto em todas as empresas do grupo, realize a configuração Considerar estoque para API.

Exemplos da chamada em REST


$url = 'https://api.tiny.com.br/api2/produto.obter.estoque.php';
$token= 'coloque aqui a sua chave da api';
$id= 'xxxxx';
$formato = 'JSON';
$data = "token=$token&id=$id&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;
}

Obter Estoque Produto API 2.0

Parâmetros do serviço

Retorno do serviço

Exemplos de chamada da API

Exemplos da chamada em REST

Exemplos de retorno da API

Exemplos do retorno do serviço em JSON

Atendimento

Localização