Ajuda do Tiny | API 2.0 | PDV - Pesquisar Pedidos | Tiny ERP
Fechar
esqueci a minha senha
criar uma conta

PDV - Pesquisar Pedidos API 2.0

Serviço destinado a fazer consulta de pedidos.

ElementoTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar a empresa
pagina (1)intopcionalNúmero da página

(1) - Número da página de pedidos que deseja obter (por padrão são listados 50 registros por página). 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)list [0..n]condicionalContém a lista dos erros encontrados.
retorno.erros[ ].errostring-condicionalMensagem contendo a descrição do erro
retorno.pagina (2)int-condicionalNúmero da página que está sendo retornada
retorno.numero_paginas (2)int-condicionalNúmero de paginas do retorno
retorno.pedidos[] (2)list[1..n]condicionalLista de resultados da pesquisa
retorno.pedidos[].idint-obrigatórioNúmero de identificação do pedido no Tiny
retorno.pedidos[].numeroint-obrigatórioNúmero do pedido
retorno.pedidos[].data (3)date-obrigatórioData do pedido
retorno.pedidos[].fretedecimal-obrigatórioValor do frete
retorno.pedidos[].descontodecimal-obrigatórioValor do desconto
retorno.pedidos[].valorICMSSubstdecimal-obrigatórioValor total do ICMS ST
retorno.pedidos[].valorIPIdecimal-obrigatórioValor total do IPI
retorno.pedidos[].totalProdutosdecimal-obrigatórioValor total dos produtos
retorno.pedidos[].totalVendadecimal-obrigatórioValor total do pedido
retorno.pedidos[].fretePorContastring-obrigatórioRemetente (R), destinatário (D), terceiros (T) ou sem frete (S)
retorno.pedidos[].pesoLiquidodecimal-obrigatórioPeso líquido
retorno.pedidos[].pesoBrutodecimal-obrigatórioPeso bruto
retorno.pedidos[].observacoesstring-obrigatórioObservações gerais
retorno.pedidos[].formaPagamentostring-obrigatórioCódigo conforme tabela de Formas de pagamento
retorno.pedidos[].situacaostring-obrigatórioSituação no Tiny
retorno.pedidos[].contatoobject-obrigatórioInformações sobre o contato
retorno.pedidos[].contato.nomestring50obrigatórioNome do contato
retorno.pedidos[].contato.fantasiastring30obrigatórioNome fantasia
retorno.pedidos[].contato.codigostring30obrigatórioCódigo
retorno.pedidos[].contato.tipostring-obrigatórioFísica (F), Jurídica (J), Extrangeiro (E) ou Extrangeiro no Brasil (X)
retorno.pedidos[].contato.cpfCnpjstring-obrigatórioCPF / CNPJ, conforme tipo da pessoa
retorno.pedidos[].contato.enderecostring-obrigatórioEndereço
retorno.pedidos[].contato.enderecoNrostring-obrigatórioNúmero
retorno.pedidos[].contato.complementostring-obrigatórioComplemento
retorno.pedidos[].contato.bairrostring-obrigatórioBairro
retorno.pedidos[].contato.cidadestring-obrigatórioCidade
retorno.pedidos[].contato.ufstring-obrigatórioSigla do estado
retorno.pedidos[].contato.cepstring-obrigatórioCEP
retorno.pedidos[].contato.fonestring-obrigatórioNúmero do telefone
retorno.pedidos[].contato.celularstring-obrigatórioNúmero do celular
retorno.pedidos[].contato.emailstring-obrigatórioE-mail de contato
retorno.pedidos[].contato.inscricaoEstadualstring-obrigatórioInscrição estadual
retorno.pedidos[].contato.indIEDeststring-obrigatórioIndicador da IE do Destinatário
retorno.pedidos[].enderecoEntregaobject-obrigatórioInformações sobre o endereço de entrega
retorno.pedidos[].enderecoEntrega.nomestring50obrigatórioNome do contato para entrega
retorno.pedidos[].enderecoEntrega.tipostring-obrigatórioFísica (F), Jurídica (J), Extrangeiro (E) ou Extrangeiro no Brasil (X)
retorno.pedidos[].enderecoEntrega.cpfCnpjstring-obrigatórioCPF / CNPJ, conforme tipo da pessoa
retorno.pedidos[].enderecoEntrega.enderecostring-obrigatórioEndereço
retorno.pedidos[].enderecoEntrega.enderecoNrostring-obrigatórioNúmero
retorno.pedidos[].enderecoEntrega.complementostring-obrigatórioComplemento
retorno.pedidos[].enderecoEntrega.bairrostring-obrigatórioBairro
retorno.pedidos[].enderecoEntrega.cidadestring-obrigatórioCidade
retorno.pedidos[].enderecoEntrega.ufstring-obrigatórioSigla do estado
retorno.pedidos[].enderecoEntrega.cepstring-obrigatórioCEP
retorno.pedidos[].enderecoEntrega.fonestring-obrigatórioNúmero do telefone
retorno.pedidos[].itens[]list[0..n]obrigatórioLista de itens do pedido
retorno.pedidos[].itens[].idint-obrigatórioNúmero de identificação do item no Tiny
retorno.pedidos[].itens[].idProdutoint-obrigatórioNúmero de identificação do produto no Tiny
retorno.pedidos[].itens[].descricaostring-obrigatórioDescrição do produto
retorno.pedidos[].itens[].codigostring-obrigatórioCódigo do produto
retorno.pedidos[].itens[].valordecimal-obrigatórioValor do item
retorno.pedidos[].itens[].quantidadedecimal-obrigatórioQuantidade
retorno.pedidos[].itens[].descontodecimal-obrigatórioValor do desconto
retorno.pedidos[].itens[].pesoLiquidodecimal-obrigatórioPeso líquido
retorno.pedidos[].itens[].pesoBrutodecimal-obrigatórioPeso bruto
retorno.pedidos[].itens[].unidadestring-obrigatórioUnidade
retorno.pedidos[].itens[].tipostring-obrigatórioProduto (P) ou serviço (S)
retorno.pedidos[].itens[].ncmstring-obrigatórioNomenclatura comun do Mercosul
retorno.pedidos[].itens[].origemstring-obrigatórioOrigem do produto conforme ICMS
retorno.pedidos[].itens[].ceststring-obrigatórioCódigo especificador da substituição tributária
retorno.pedidos[].itens[].gtinstring-obrigatórioGTIN / EAN do produto
retorno.pedidos[].itens[].gtinTributavelstring-obrigatórioGTIN / EAN tributável do produto
retorno.pedidos[].parcelas[]list[0..n]obrigatórioLista de parcelas do pedido
retorno.pedidos[].parcelas[].formaPagamentostring-obrigatórioCódigo conforme tabela de Formas de pagamento
retorno.pedidos[].parcelas[].dataVencimento (3)date-obrigatórioData de vencimento da parcela
retorno.pedidos[].parcelas[].valordecimal-obrigatórioValor da parcela
retorno.pedidos[].parcelas[].tPagstring-obrigatórioCódigo tPag utilizado no XML da nota fiscal

(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 utilizam o formato dd/mm/yyyy, exemplo "dd/mm/yyyy".


$url = 'https://SERVER_API_DIRapi2/pdv.pedidos.php';
$token = 'coloque aqui a sua chave da api';
$pesquisa = 'xxxxx';
$data = "token=$token";

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