Lista de Produtos Alterados API 2.0

Serviço destinado a obter a lista de produtos alterados.

Requer instalação de módulo adicional

Você pode acessar a página de Extensões do Tiny e instalar a extensão "API para estoque em tempo real".

Atenção

Registros já obtidos serão removidos da fila e marcados como processados.

REST

REST URL

Elemento	Tipo	Ocorrência	Descrição
token	string	obrigatório	Chave gerada para identificar sua empresa
dataAlteracao ⁽¹⁾	string	obrigatório	Data de alteração no formato dd/mm/yyyy hh:mm:ss
formato	string	obrigatório	Formato do retorno (json)
pagina ⁽²⁾	int	opcional	Número da página

(1) - Pode ser informado somente a data ou data e hora. Exemplos: 01/01/2011 ou 01/01/2012 15:30:00.
(2) - Número da página que deseja obter (por padrão são listados 100 registros por página), caso não seja informado o valor padrão é 1.

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.produtos[ ] ⁽²⁾	list	-	condicional	Lista de resultados da pesquisa
retorno.produtos[ ].produto ⁽²⁾	object	-	condicional	Elemento utilizado para representar um produto.
retorno.produtos[ ].produto.id	int	-	condicional	Número de identificação do produto no Tiny
retorno.produtos[ ].produto.nome	string	120	condicional	Nome do produto
retorno.produtos[ ].produto.codigo	string	30	condicional	Código do produto
retorno.produtos[ ].produto.unidade	string	3	condicional	Unidade do produto
retorno.produtos[ ].produto.localizacao	string	50	condicional	Localização física no estoque
retorno.produtos[ ].produto.preco ⁽⁴⁾	decimal	-	condicional	Preço de venda do produto
retorno.produtos[ ].produto.preco_promocional ⁽⁴⁾	decimal	-	condicional	Preço promocional do produto
retorno.produtos[ ].produto.descricao_complementar	string	-	condicional	A descrição complementar do produto
retorno.produtos[ ].produto.ncm	string	-	condicional	O NCM do produto
retorno.produtos[ ].produto.origem	int	-	condicional	A origem do produto
retorno.produtos[ ].produto.gtin	string	-	condicional	O GTIN do produto
retorno.produtos[ ].produto.gtin_embalagem	string	-	condicional	O GTIN da embalagem do produto
retorno.produtos[ ].produto.peso_liquido ⁽⁴⁾	decimal	-	condicional	O peso líquido do produto
retorno.produtos[ ].produto.peso_bruto ⁽⁴⁾	decimal	-	condicional	O peso bruto do produto
retorno.produtos[ ].produto.estoque_minimo ⁽⁴⁾	decimal	-	condicional	A quantidade mínima do produto em estoque
retorno.produtos[ ].produto.estoque_maximo ⁽⁴⁾	decimal	-	condicional	A quantidade máxima do produto em estoque
retorno.produtos[ ].produto.id_fornecedor	int	-	condicional	Número de identificação do fornecedor do produto no Tiny
retorno.produtos[ ].produto.codigo_fornecedor	string	-	condicional	Código do fornecedor do produto
retorno.produtos[ ].produto.codigo_pelo_fornecedor	string	30	condicional	Código do produto utilizado pelo fornecedor
retorno.produtos[ ].produto.unidade_por_caixa	int	-	condicional	Quantidade de unidades do produto por caixa
retorno.produtos[ ].produto.preco_custo ⁽⁴⁾	decimal	-	condicional	Preço de custo do produto
retorno.produtos[ ].produto.situacao	string	-	condicional	A situação do produto
retorno.produtos[ ].produto.tipo	string	-	condicional	O tipo do produto
retorno.produtos[ ].produto.classe_ipi	string	-	condicional	A classe de IPI do produto
retorno.produtos[ ].produto.valor_ipi_fixo ⁽⁴⁾	decimal	-	condicional	O valor do IPI do produto
retorno.produtos[ ].produto.cod_lista_servicos	string	-	condicional	O código de lista de serviços do produto
retorno.produtos[ ].produto.tipo_variacao	string	1	condicional	O tipo de variação do produto. (N - Normal, P - Produto pai, V - Produto variação
retorno.produtos[ ].produto.obs	string	-	condicional	As observações do produto
retorno.produtos[ ].produto.data_alteracao ⁽⁵⁾	datatime	-	condicional	Data de alteração do produto

(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) - Estes campos utilizam o seguinte formato “dd/mm/yyyy hh:mm:ss”.

Exemplos da chamada em REST


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

Lista de Produtos Alterados API 2.0

Requer instalação de módulo adicional

Atenção

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