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:

Falando dos pré-requisitos para utilizar a API

Passe as seguintes informações no HEAD, caso não possua, solicite junto ao suporte.

  1. O seu TOKEN de USUÁRIO;
  2. TOKEN PÚBLICO;
  3. 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:

Anúncios