Ajuda do Tiny | API 2.0 | Pesquisar Notas Fiscais | Tiny ERP
Fechar
esqueci a minha senha
criar uma conta

Pesquisar Notas Fiscais API 2.0

Serviço destinado a fazer consulta de Notas Fiscais.

ElementoTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
formatostringobrigatórioFormato do retorno (json ou xml)
tipoNota (1)stringopcionalTipo da nota (E/S) E=Entrada, S=Saída
numero (1)stringopcionalNúmero da nota (no Tiny)
cliente (1)stringopcionalNome ou código (ou parte) do cliente
cpf_cnpj (1)stringopcionalCPF ou CNPJ do cliente
dataInicial (1)stringopcionalData incial das notas fiscais que deseja consultar no formato dd/mm/yyyy
dataFinal (1)stringopcionalData final das notas fiscais que deseja consultar no formato dd/mm/yyyy
situacao (1) (2)stringopcionalExibir notas fiscais na situação
numeroEcommerce (1)stringopcionalNúmero do pedido no ecommerce(ou no seu sistema)
idVendedor (3)intopcionalNúmero de identificação do vendedor no Tiny
nomeVendedor (3) (4)stringopcionalNome do vendedor no Tiny
pagina (5)intopcionalNúmero da página

(1) - Ao menos um desses parâmetros deve ser informado.
(2) - Código da situação conforme tabela de "Situações das Notas Fiscais".
(3) - Caso o vendedor não seja localizado no Tiny a consulta não retornará registros.
(4) - Este valor será desconsiderado caso seja informado valor para o parâmetro idVendedor.
(5) - Numero da página que deseja obter (por padrão são listados 50 registros por página), caso não seja informado o valor padrão é 1.

ElementoTipoTamanhoOcorrênciaDescrição
retorno--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-opcionalConforme tabela "Códigos de erro"
retorno.erros[ ] (1) (3)list-opcional [0..n]Contém a lista dos erros encontrados.
retorno.erros[ ].errostring-opcionalMensagem contendo a descrição do erro
retorno.paginaint-obrigatórioNúmero da página que está sendo retornada
retorno.numero_paginasint-obrigatórioNúmero de paginas do retorno
retorno.notas_fiscais[ ] (2)list-opcionalLista de resultados da pesquisa
retorno.notas_fiscais[ ].nota_fiscal (2)object-opcionalElemento utilizado para representar uma nota fiscal.
retorno.notas_fiscais[ ].nota_fiscal.idint-opcionalNúmero de identificação da nota fiscal no Tiny
retorno.notas_fiscais[ ].nota_fiscal.tipostring1opcionalTipo da nota fiscal (E/S)
retorno.notas_fiscais[ ].nota_fiscal.serieint-opcionalNúmero de série da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.numeroint-opcionalNúmero da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.numero_ecommercestring50opcionalNúmero do pedido no ecommerce(ou sistema)
retorno.notas_fiscais[ ].nota_fiscal.data_emissao (4)date10opcionalData de emissão da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.nomestring50opcionalNome do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente object10opcionalElemento utilizado para representar o cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.nomestring50obrigatórioNome do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.tipo_pessoastring1opcionalTipo de pessoa (F - Física, J - Jurídica, E - Estrangeiro)
retorno.notas_fiscais[ ].nota_fiscal.cliente.cpf_cnpjstring18opcionalCPF ou CNPJ do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.iestring18opcionalInscrição estadual do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.enderecostring50opcionalEndereço do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.numerostring10opcionalNúmero do endereço do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.complementostring50opcionalComplemento do endereço do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.bairrostring30opcionalBairro do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.cepstring10opcionalCep do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.cidadestring30opcionalNome da cidade do cliente conforme a Tabela de Cidades
retorno.notas_fiscais[ ].nota_fiscal.cliente.ufstring30opcionalUF do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.fonestring40opcionalTelefone do cliente
retorno.notas_fiscais[ ].nota_fiscal.cliente.emailstring40opcionalE-mail do cliente
retorno.notas_fiscais[ ].nota_fiscal.endereco_entregaobjectopcionalElemento utilizado para representar o endereço de entrega (se não houver, será retornado o mesmo de cobrança).
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.tipo_pessoastring1opcionalTipo de pessoa (F - Física, J - Jurídica, E - Estrangeiro)
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.cpf_cnpj string18opcionalCPF ou CNPJ de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.enderecostring50opcionalEndereço de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.numerostring10opcionalNúmero do endereço de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.complementostring50opcionalComplemento do endereço de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.bairrostring30opcionalBairro de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.cepstring10opcionalCep de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.cidadestring30opcionalNome da cidade de entrega conforme a Tabela de Cidades
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.ufstring30opcionalUF de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.fonestring40opcionalTelefone de entrega
retorno.notas_fiscais[ ].nota_fiscal.endereco_entrega.nome_destinatariostring60opcionalNome do destinatário da entrega
retorno.notas_fiscais[ ].nota_fiscal.transportador object-opcionalElemento utilizado para representar o transportador
retorno.notas_fiscais[ ].nota_fiscal.transportador.nomestring30obrigatórioNome do transportador
retorno.notas_fiscais[ ].nota_fiscal.valor (5)decimal- opcionalValor total da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.valor_produtos (5)decimalopcionalValor dos produtos da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.valor_frete (5)decimalopcionalValor do frete da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.id_vendedorint15opcionalNúmero de identificação do vendedor associado a nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.nome_vendedorstring50opcionalNome do vendedor associado a nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.situacaoint-opcionalCódigo conforme tabela de "Situações das Notas Fiscais"
retorno.notas_fiscais[ ].nota_fiscal.descricao_situacaostring25opcionalDescrição conforme tabela de "Situações das Notas Fiscais"
retorno.notas_fiscais[ ].nota_fiscal.chave_acessostring100opcionalChave de acesso da Nota Fiscal
retorno.notas_fiscais[ ].nota_fiscal.codigo_rastreamentostring25opcionalCódigo de rastreamento da nota fiscal
retorno.notas_fiscais[ ].nota_fiscal.url_rastreamentostring120opcionalURL de rastreamento 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 somente serão informados caso o retorno contenha erros.
(4) - Estes campos utilizam o formato dd/mm/yyyy, exemplo "01/01/2012".
(5) - Estes campos utilizam “.” (ponto) como separador de decimais, exemplo "5.25".


$url = 'https://SERVER_API_DIRapi2/notas.fiscais.pesquisa.php';
$token = 'coloque aqui a sua chave da api';
$numero= 'xxxxx';
$data = "token=$token&numero=$numero&formato=XML";

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

$client = new nusoap_client("https://SERVER_API_DIRapi2.php?wsdl", true);
$client->soap_defencoding = 'UTF-8';
$client->decode_utf8 = false;

$result = $client->call("pesquisarNotasFiscaisService", array('token' => 'xxxxx','numero'=>'xxxxx','formato'=>'XML'));

$res = array();
if ($client->fault) {
	$retorno = $result['faultstring'];		
} else {
	$err = $client->getError();
	if ($err) {
		$retorno = $err;	    	
	} else {
		$retorno = $result;
	}
}
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>1</status_processamento>
  <status>Erro</status>
  <codigo_erro>2</codigo_erro>
  <erros>
    <erro>token invalido</erro>
  </erros>
</retorno>
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>2</status_processamento>
  <status>Erro</status>
  <codigo_erro>21</codigo_erro>
  <erros>
    <erro>A consulta retornou mais registros que o permitido</erro>
  </erros>
</retorno>
<?xml version="1.0" encoding="UTF-8"?>
<retorno>
  <status_processamento>3</status_processamento>
  <status>OK</status>
  <pagina>1</pagina>
  <numero_paginas>1</numero_paginas>
  <notas_fiscais>
    <nota_fiscal>
      <id>439995227</id>
      <tipo>S</tipo>
      <serie>1</serie>
      <numero>000149</numero>
      <numero_ecommerce/>
      <data_emissao>11/01/2018</data_emissao>
      <nome>henrique teste 1</nome>
      <cliente>
        <nome>henrique teste 1</nome>
        <tipo_pessoa>F</tipo_pessoa>
        <cpf_cnpj>182.334.983-86</cpf_cnpj>
        <ie/>
        <endereco>Rua teste</endereco>
        <numero>4</numero>
        <complemento>XVVF</complemento>
        <bairro>Centro</bairro>
        <cep>95.700-000</cep>
        <cidade>Bento Gonçalves</cidade>
        <uf>RS</uf>
        <fone>(54) 1234-1234</fone>
        <email>henrique1@tiny.com.br</email>
      </cliente>
      <endereco_entrega>
        <tipo_pessoa>F</tipo_pessoa>
        <cpf_cnpj>025.693.999-88</cpf_cnpj>
        <endereco>Rua das flores</endereco>
        <numero>5</numero>
        <complemento>casa</complemento>
        <bairro>Centro</bairro>
        <cep>95.700-000</cep>
        <cidade>Bento Gonçalves</cidade>
        <uf>RS</uf>
        <fone>(32) 1223-3411</fone>
        <nome_destinatario>hnrique entgra</nome_destinatario>
      </endereco_entrega>
      <transportador>
        <nome/>
      </transportador>
      <valor>165.51</valor>
      <valor_produtos>152.34</valor_produtos>
      <valor_frete>8.15</valor_frete>
      <id_vendedor>0</id_vendedor>
      <nome_vendedor/>
      <situacao>1</situacao>
      <descricao_situacao>Pendente</descricao_situacao>
      <codigo_rastreamento>EE301798383BR</codigo_rastreamento>
      <url_rastreamento>http://www.issoehumaurl.com</url_rastreamento>
    </nota_fiscal>
  </notas_fiscais>
</retorno>