PDV - Obter Pedido API 2.0
Serviço destinado a obter pedidos.
Parâmetros do serviço
Elemento | Tipo | Ocorrência | Descrição |
---|---|---|---|
token | string | obrigatório | Chave gerada para identificar a empresa |
id (1) | int | obrigatório | Número de identificação do pedido no Tiny |
Retorno do serviço
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 (1) | int | - | condicional | Conforme tabela "Códigos de erro" |
retorno.erros[] (1) | list | [0..n] | condicional | Contém a lista dos erros encontrados. |
retorno.erros[ ].erro | string | - | condicional | Mensagem contendo a descrição do erro |
retorno.pagina (2) | int | - | condicional | Número da página que está sendo retornada |
retorno.numero_paginas (2) | int | - | condicional | Número de paginas do retorno |
retorno.pedido (2) | object | - | condicional | Informações sobre o pedido |
retorno.pedido.id | int | - | obrigatório | Número de identificação do pedido no Tiny |
retorno.pedido.numero | int | - | obrigatório | Número do pedido |
retorno.pedido.data (3) | date | - | obrigatório | Data do pedido |
retorno.pedido.frete | decimal | - | obrigatório | Valor do frete |
retorno.pedido.desconto | decimal | - | obrigatório | Valor do desconto |
retorno.pedido.valorICMSSubst | decimal | - | obrigatório | Valor total do ICMS ST |
retorno.pedido.valorIPI | decimal | - | obrigatório | Valor total do IPI |
retorno.pedido.totalProdutos | decimal | - | obrigatório | Valor total dos produtos |
retorno.pedido.totalVenda | decimal | - | obrigatório | Valor total do pedido |
retorno.pedido.fretePorConta | string | - | obrigatório | Remetente (R), destinatário (D), terceiros (T) ou sem frete (S) |
retorno.pedido.pesoLiquido | decimal | - | obrigatório | Peso líquido |
retorno.pedido.pesoBruto | decimal | - | obrigatório | Peso bruto |
retorno.pedido.observacoes | string | - | obrigatório | Observações gerais |
retorno.pedido.formaPagamento | string | - | obrigatório | Código conforme tabela de Formas de pagamento |
retorno.pedido.situacao | string | - | obrigatório | Situação no Tiny |
retorno.pedido.contato | object | - | obrigatório | Informações sobre o contato |
retorno.pedido.contato.nome | string | 50 | obrigatório | Nome do contato |
retorno.pedido.contato.fantasia | string | 60 | obrigatório | Nome fantasia |
retorno.pedido.contato.codigo | string | 30 | obrigatório | Código |
retorno.pedido.contato.tipo | string | - | obrigatório | Física (F), Jurídica (J), Extrangeiro (E) ou Extrangeiro no Brasil (X) |
retorno.pedido.contato.cpfCnpj | string | - | obrigatório | CPF / CNPJ, conforme tipo da pessoa |
retorno.pedido.contato.endereco | string | - | obrigatório | Endereço |
retorno.pedido.contato.enderecoNro | string | - | obrigatório | Número |
retorno.pedido.contato.complemento | string | - | obrigatório | Complemento |
retorno.pedido.contato.bairro | string | - | obrigatório | Bairro |
retorno.pedido.contato.cidade | string | - | obrigatório | Cidade |
retorno.pedido.contato.uf | string | - | obrigatório | Sigla do estado |
retorno.pedido.contato.cep | string | - | obrigatório | CEP |
retorno.pedido.contato.fone | string | - | obrigatório | Número do telefone |
retorno.pedido.contato.celular | string | - | obrigatório | Número do celular |
retorno.pedido.contato.email | string | - | obrigatório | E-mail de contato |
retorno.pedido.contato.inscricaoEstadual | string | - | obrigatório | Inscrição estadual |
retorno.pedido.contato.indIEDest | string | - | obrigatório | Indicador da IE do Destinatário |
retorno.pedido.enderecoEntrega | object | - | obrigatório | Informações sobre o endereço de entrega |
retorno.pedido.enderecoEntrega.nome | string | 50 | obrigatório | Nome do contato para entrega |
retorno.pedido.enderecoEntrega.tipo | string | - | obrigatório | Física (F), Jurídica (J), Extrangeiro (E) ou Extrangeiro no Brasil (X) |
retorno.pedido.enderecoEntrega.cpfCnpj | string | - | obrigatório | CPF / CNPJ, conforme tipo da pessoa |
retorno.pedido.enderecoEntrega.endereco | string | - | obrigatório | Endereço |
retorno.pedido.enderecoEntrega.enderecoNro | string | - | obrigatório | Número |
retorno.pedido.enderecoEntrega.complemento | string | - | obrigatório | Complemento |
retorno.pedido.enderecoEntrega.bairro | string | - | obrigatório | Bairro |
retorno.pedido.enderecoEntrega.cidade | string | - | obrigatório | Cidade |
retorno.pedido.enderecoEntrega.uf | string | - | obrigatório | Sigla do estado |
retorno.pedido.enderecoEntrega.cep | string | - | obrigatório | CEP |
retorno.pedido.enderecoEntrega.fone | string | - | obrigatório | Número do telefone |
retorno.pedido.itens[] | list | [0..n] | obrigatório | Lista de itens do pedido |
retorno.pedido.itens[].id | int | - | obrigatório | Número de identificação do item no Tiny |
retorno.pedido.itens[].idProduto | int | - | obrigatório | Número de identificação do produto no Tiny |
retorno.pedido.itens[].descricao | string | - | obrigatório | Descrição do produto |
retorno.pedido.itens[].codigo | string | - | obrigatório | Código do produto |
retorno.pedido.itens[].valor | decimal | - | obrigatório | Valor do item |
retorno.pedido.itens[].quantidade | decimal | - | obrigatório | Quantidade |
retorno.pedido.itens[].desconto | decimal | - | obrigatório | Valor do desconto |
retorno.pedido.itens[].pesoLiquido | decimal | - | obrigatório | Peso líquido |
retorno.pedido.itens[].pesoBruto | decimal | - | obrigatório | Peso bruto |
retorno.pedido.itens[].unidade | string | - | obrigatório | Unidade |
retorno.pedido.itens[].tipo | string | - | obrigatório | Produto (P) ou serviço (S) |
retorno.pedido.itens[].ncm | string | - | obrigatório | Nomenclatura comun do Mercosul |
retorno.pedido.itens[].origem | string | - | obrigatório | Origem do produto conforme ICMS |
retorno.pedido.itens[].cest | string | - | obrigatório | Código especificador da substituição tributária |
retorno.pedido.itens[].gtin | string | - | obrigatório | GTIN / EAN do produto |
retorno.pedido.itens[].gtinTributavel | string | - | obrigatório | GTIN / EAN tributável do produto |
retorno.pedido.parcelas[] | list | [0..n] | obrigatório | Lista de parcelas do pedido |
retorno.pedido.parcelas[].formaPagamento | string | - | obrigatório | Código conforme tabela de Formas de pagamento |
retorno.pedido.parcelas[].dataVencimento (3) | date | - | obrigatório | Data de vencimento da parcela |
retorno.pedido.parcelas[].valor | decimal | - | obrigatório | Valor da parcela |
retorno.pedido.parcelas[].tPag | string | - | obrigatório | Có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".
Exemplos de chamada da API
$url = 'https://api.tiny.com.br/api2/pdv.pedido.obter.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;
}