Emitir Nota Fiscal API 2.0

Serviço destinado a emitir uma Nota Fiscal.

REST

REST URL

Elemento	Tipo	Ocorrência	Descrição
token	string	obrigatório	Chave gerada para identificar sua empresa
id	int	obrigatório	Número de identificação da nota fiscal no Tiny ⁽ⁿ⁾
serie	string	opcional	Série da Nota Fiscal ⁽ⁿ⁾
numero	string	opcional	Número da Nota Fiscal ⁽ⁿ⁾
enviarEmail	string	opcional	(S/N) opção para enviar a nota para o email do cliente
formato	string	obrigatório	Formato do retorno (json)

(n) - Estes campos são utilizados para identificar a nota que se deseja emitir, pode ser enviado somente o id da nota ou a série e o número da mesma.

Elemento	Tipo	Tamanho	Ocorrência	Descrição
retorno	-	-	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	string	condicional	Mensagem contendo a descrição do erro
retorno.nota_fiscal ⁽²⁾	object	-	condicional	Nodo utilizado para representar uma nota fiscal.
retorno.nota_fiscal.id	int	-	condicional	Número de identificação da nota fiscal no Tiny
retorno.nota_fiscal.chave_acesso	string	50	condicional	Chave de acesso da nota fiscal
retorno.nota_fiscal.link_acesso	string	200	condicional	Link para acessar a nota fiscal
retorno.nota_fiscal.situacao	int	-	condicional	Código conforme tabela de "Situações das Notas Fiscais"
retorno.nota_fiscal.descricao_situacao	string	25	condicional	Descrição conforme tabela de "Situações das Notas Fiscais"
retorno.nota_fiscal.xml	string	-	condicional	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 somente serão informados caso o retorno contenha erros.
(4) - Estes campos devem ser informados no formato dd/mm/yyyy, exemplo "01/01/2012".
(5) - Estes campos utilizam “.” (ponto) como separador de decimais, exemplo "5.25".
(6) - Estes campos utilizam o formato hh:mm:ss, exemplo "10:45:01".

Exemplos da chamada em REST


$url = 'https://api.tiny.com.br/api2/nota.fiscal.emitir.php';
$token = 'coloque aqui a sua chave da api';
$id = 'xxxxx';
$data = "token=$token&id=$id&formato=JSON";

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

Emitir Nota Fiscal API 2.0

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