Incluir Nota via XML API 2.0

Serviço destinado a incluir notas fiscais via XML.

REST

REST URL

Elemento	Tipo	Ocorrência	Descrição
token	string	obrigatório	Chave gerada para identificar a empresa
xml	string	obrigatório	XML da nota fiscal
numeroPedidoTiny ⁽¹⁾	string	opcional	Número do pedido de venda no Tiny
lancarContas ⁽²⁾	string	opcional	Lançar contas da nota fiscal/pedido de venda (S - Sim, N - Não)
lancarEstoque ⁽²⁾	string	opcional	Lançar estoque dos itens da nota fiscal/pedido de venda (S - Sim, N - Não)
origemLancamentos ⁽³⁾	string	opcional	Indica a origem dos lançamentos de estoque e contas (N - Nota Fiscal, P - Pedido de Venda vinculado)

(1) - O número do pedido será utilizado apenas para vincular o pedido de venda a nota fiscal.
(2) - Ao não informar este parâmetro o Tiny realizará o lançamento automaticamente para a nota fiscal.
(3) - Ao não informar este parâmetro o Tiny realizará os lançamentos para a nota fiscal. (4) - Caso o pedido tenha sido originado da importação de uma plataforma e-commerce, automaticamente serão disparados os gatilhos de envio de dados fiscais para a plataforma se estiver configurado.

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 ⁽¹⁾	int	-	condicional	Conforme tabela "Códigos de erro"
retorno.erros[] ⁽¹⁾	list	[0..n]	condicional	Contém a lista dos erros encontrados.
retorno.erros[ ].erro	string	-	condicional	Mensagem contendo a descrição do erro
retorno.idNotaFiscal ⁽²⁾	int	-	condicional	Número de identificação da nota fiscal no Tiny

(1) - Somente estará presente no retorno caso o elemento "status" seja "Erro".
(2) - Somente estará presente no retorno caso o elemento "status" seja "OK".

Exemplos da chamada


$url = 'https://api.tiny.com.br/api2/incluir.nota.xml.php';
$token = 'coloque aqui a sua chave da api';
$xml = 'xxxxx';
$data = "token=$token&xml=$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;
}

Incluir Nota via XML API 2.0

Parâmetros do serviço

Retorno do serviço

Exemplos de chamada da API

Exemplos da chamada

Exemplos de retorno da API

Exemplos do retorno do serviço

Atendimento

Localização