Super Fiscal – Exemplo de implementação da API via JQUERY
Este artigo é destinado a empresas de TI ou desenvolvedores de software que pretendem utilizarem a API do Super Fiscal para emissão de nota fiscal eletrônica.
Utilize nossa API para emitir notas fiscais pelo seu software. Compatível com Notas Fiscais (NFe), serviço (NFSe) e ao consumidor (NFCe), para todos os estados brasileiros, mais informações comerciais sobre o nosso produto em: www.superfiscal.com.br
Integração para qualquer linguagem de programação.
Este é o guia básico para você seguir e proceder com a implementação da API no seu software para emissão da nota fiscal eletrônica.
Dando sequência em nossa série de artigos de como implementar a API para emissão de nota fiscal eletrônica no seu software.
A solução API do Super Fiscal foi desenvolvida com a tecnologia REST, que é padrão de mercado e independe da tecnologia utilizada por nossos clientes. Dessa forma, é possível integrar-se utilizando as mais variadas linguagens de programação, tais como: ASP, ASP. Net, Java, PHP, Ruby, Python, etc.
Ambiente Produção / Teste
Requisição de transação: https://www.superfiscal.com.br/api/notafiscal
Pré-requisitos:
Passe as seguintes informações no HEAD, caso não possua, solicite junto ao suporte.
- O seu TOKEN de USUÁRIO;
- TOKEN PÚBLICO;
- O TOKEN da EMPRESA Saiba mais em: Super Fiscal – Como obter a chave da empresa para inserir no JSON
--request POST "https://www.superfiscal.com.br/api/notafiscal" --header "Content-Type: application/json" --header "token: TOKEN_PUBLICO " --header "usuario: TOKEN_USUARIO"
//PRODUÇÃO
//var url = 'https://www.superfiscal.com.br/api/notafiscal';
$("#btn").click(function () {
var postFatura = {
"codigo": 20029, //CODIGO DA FATUA
"fatura": "0", //ENVIAR ZERO
"usuario": "TOKEN DE USUÁRIO", //TOKEN DE USUARI
"empresa": "TOKEN EMPRESA", //TOKEN EMPRESA
"valor": 100.0000, // VALOR TOTAL DA NOTA
"produtos": [{
"Codigo": 1015, // CÓDIGO DO PRODUTO
"Guid": "a8742015-31dc-4daf-aca8-20c5980330d2", //GUID DO PRODUTO SE TIVER
"Descricao": "CONSULTA", //DESCRIÇÃO DO PRODUTO
"Tipo": 2, // INFORME 1 PARA PRODUTO E 2 PARA SERVIÇO
"EAN": "0", //EAN
"NCM": "0",
"CEST": "0",
"EXTIPI": " ",
"CFOP": 5012,
"UnidadeComercial": "UNID",
"QtdComercial": 1.0,
"ValorUnitarioCom": 100.0000,
"EANTrib": "0",
"UnidTributavel": "UNID",
"QtdTributavel": 1.0,
"ValorUnitarioTrib": 100.0000,
"ValorFrete": 0.0,
"ValorSeguro": 0.0,
"ValorDesconto": 0.0,
"IndicadorTotal": true,
"CodigoTabelaICMS": 12,
"CodigoTabelaISS": 2,
"CodigoTabelaIPI": 0,
"CodigoTabelaII": 0,
"CodigoTabelaPIS": 0,
"CodigoTabelaCofins": 1,
"Excluido": false,
"cListServ": ""
}],
"consumidor": {
"nome": "nome do cliente", // NOME DO CLIENTE
"cnpjoucpf": "00000000000", //ENVIE NULO OU O CPF CORRETO
"ie": "",
"email": "",
"endereco": "",
"bairro": "",
"cidade": "",
"uf": "",
"cep": "",
"celular": ""
}
};
$.ajax({
url: url,
type: 'post',
data: postFatura,
headers: {
token: 'TOKEN_PUBLICO',
usuario: 'TOKEN_USUARIO'
},
dataType: 'json',
success: function (data, textStatus, jqXHR) {
alert(jqXHR.responseText);
var j = jQuery.parseJSON(jqXHR.responseText);
alert(j.msg);
alert(j.status);
alert(j.success);
alert(j.url);
},
error: function (data) {
alert('erro..');
},
timeout: 20000
});
});
O retorno em JSON possui a estrutura abaixo:
{
"msg": "373 - Rejeicao: Descricao do primeiro item diferente de NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
"url": null,
"cod": "43",
"status": "Rejeitada",
"xml": "LINK PARA BAIXAR O XML",
"success": false
}
- o campo msg pode ser usado para receber uma mensagem do sistema, por exemplo, o motivo da rejeição ou erro.
- o campo url use-o para impressão online do DANFE.
- o campo código é o número da NF-e
- o campo status mostra a situação da NF-e
- o campo xml use-o para baixar o xml de retorno.
- o campo success é boleano e apresenta se a nota foi autorizada.
Talvez você se interessa em dar uma lida em:
- Guia do desenvolvedor – Como utilizar a API para emitir a nota fiscal eletrônica – Parte I
- Super Fiscal – Exemplo de implementação da API via PHP
