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

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 100 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.fantasiastring60obrigató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://api.tiny.com.br/api2/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;
}
{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [
      {
        "erro": "token invalido"
      }
    ]
  }
}
{
  "retorno": {
    "status_processamento": 2,
    "status": "Erro",
    "codigo_erro": 20,
    "erros": [
      {
        "erro": "A Consulta não retornou registros"
      }
    ]
  }
}
{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "pagina": "1",
    "numero_paginas": "1",
    "pedidos": [
      {
        "id": "439816124",
        "numero": "1",
        "data": "17/10/2017",
        "frete": "0.00",
        "desconto": "0",
        "valorICMSSubst": "0.00",
        "valorIPI": "0.00",
        "totalProdutos": "170.00",
        "totalVenda": "170.00",
        "fretePorConta": "R",
        "pesoLiquido": "0.000",
        "pesoBruto": "0.000",
        "observacoes": "",
        "formaPagamento": "dinheiro",
        "situacao": "0",
        "contato": {
          "nome": "Oeslei Kuhn",
          "fantasia": "",
          "codigo": "",
          "tipo": "F",
          "cpfCnpj": "035.413.420-56",
          "endereco": "Rua Doutor Aguinaldo da Silva Leal",
          "enderecoNro": "320",
          "complemento": "",
          "bairro": "Cidade Alta",
          "municipio": "Bento Gonçalves",
          "idMunicipio": "4302105",
          "uf": "RS",
          "cep": "95.700-358",
          "fone": "",
          "celular": "",
          "email": "oeslei@tiny.com.br",
          "inscricaoEstadual": "",
          "indIEDest": "0"
        },
        "enderecoEntrega": {
          "nome": "Oeslei Kuhn",
          "tipo": "F",
          "cpfCnpj": "035.413.420-56",
          "endereco": "Rua Doutor Aguinaldo da Silva Leal",
          "enderecoNro": "320",
          "complemento": "",
          "bairro": "Cidade Alta",
          "municipio": "Bento Gonçalves",
          "idMunicipio": "4302105",
          "uf": "RS",
          "cep": "95.700-358",
          "fone": ""
        },
        "itens": [
          {
            "id": "439816125",
            "idProduto": "439717234",
            "descricao": "Need For Speed 2015",
            "codigo": "NFS2015",
            "valor": "126.0000000000",
            "quantidade": "1.0000",
            "desconto": "0.00",
            "pesoLiquido": "0.230",
            "pesoBruto": "0.220",
            "unidade": "un",
            "tipo": "P",
            "ncm": "1010.10.10",
            "origem": "0",
            "cest": "01.003.00",
            "gtin": "0123456789123",
            "gtinTributavel": ""
          },
          {
            "id": "439816126",
            "idProduto": "439717252",
            "descricao": "The Elder Scrolls V - Skyrim - Legendary Edition",
            "codigo": "TESV – 2",
            "valor": "44.0000000000",
            "quantidade": "1.0000",
            "desconto": "0.00",
            "pesoLiquido": "0.230",
            "pesoBruto": "0.220",
            "unidade": "un",
            "tipo": "P",
            "ncm": "1010.10.10",
            "origem": "0",
            "cest": "",
            "gtin": "0123456789321",
            "gtinTributavel": ""
          }
        ],
        "parcelas": [
          {
            "formaPagamento": "dinheiro",
            "dataVencimento": "17/10/2017",
            "valor": "170.00",
            "tPag": "01"
          }
        ]
      }
    ]
  }
}