Guia do Iniciante do Super Fiscal - Produzido pela AnimalCode Tecnologia

Guia do Iniciante

Confira as perguntas mais frequentes sobre o nosso produto. Se depois de ler esta seção você ainda tiver alguma dúvida, não hesite em entrar em contato conosco.

O Super Fiscal é uma API para emissão de nota fiscal eletrônica. Use a nossa API para gerar a NF-E ou NFC-e sem complicação e de forma super simples!

O Super Fiscal é perfeito para ajudar o seu software na emissão de nota fiscal eletrônica.

Basicamente o Super Fiscal receberá as informações de venda (por exemplo) do seu software, em seguida, o mesmo entregará a nota fiscal eletrônica.

A API do Super Fiscal utiliza como padrão a estrutura de dados em formato JSON. Existe um artigo que falamos do seu funcionamento geral em: https://blog.animalcode.com.br/2017/12/07/guia-do-desenvolvedor-como-utilizar-a-api-para-emitir-a-nota-fiscal-eletronica-parte-ii/

Simmm, com uma única assinatura você poderá cadastrar quantos clientes (empresas) desejar para emissão da nota fiscal eletrônica.

O controle da sua assinatura é por quantidade de notas fiscais emitidas e não por empresas cadastradas.

  1. Possuir uma conta de acesso do Super Fiscal.
  2. Obter o TOKEN para acesso a API.
  3. Ter pelo menos uma empresa devidamente credenciada para emissão de nota fiscal eletrônica.
  4. Possuir o certificado digital do tipo A1 (.pfx) e sua senha correspondente.
  5. Cadastrar a empresa e o certificado no Super Fiscal

No vídeo acima é falado um pouco a respeito.

Você deverá cadastrar o seu e-mail e senha neste link, em seguida, entre em contato com o suporte solicitando à ativação da sua conta, para isto, clique na opção Fale Conosco.

O exemplo abaixo gera uma nota fiscal eletrônica.

                                                    
                                                

        --request POST "https://www.superfiscal.com.br/api/notafiscal"
        --header "Content-Type: application/json"
        --header "token: TOKEN_PUBLICO "
        --header "usuario: TOKEN_USUARIO"

        {
            "codigo": 83,
            "fatura": "<< ENVIAR EM BRANCO >>",
            "usuario": "<< INSIRA O SEU TOKEN >>",
            "empresa": "<< INSIRA O CÓDIGO DA EMPRESA >>",
            "valor": 15,
            "produtos": [
                            { 
                                "Codigo": 1005, 
                                "Guid": "A8893EDF-3D0F-4F2F-96D3-BDD55EC568D6", 
                                "Descricao": "PÃO DE QUEIJO", 
                                "Tipo": 2, 
                                "EAN": "0", 
                                "NCM": "0", 
                                "CEST": "0", 
                                "EXTIPI": " ", 
                                "CFOP": 5933, 
                                "UnidadeComercial": "UNID", 
                                "QtdComercial": 1, 
                                "ValorUnitarioCom": 15.00, 
                                "EANTrib": "0", 
                                "UnidTributavel": "UNID", 
                                "QtdTributavel": 1, 
                                "ValorUnitarioTrib": 15.00, 
                                "ValorFrete": 0.0, 
                                "ValorSeguro": 0.0, 
                                "ValorDesconto": 0.0, 
                                "IndicadorTotal": true, 
                                "CodigoTabelaICMS": 15, 
                                "CodigoTabelaISS": 1, 
                                "CodigoTabelaIPI": 1, 
                                "CodigoTabelaII": 1, 
                                "CodigoTabelaPIS": 5, 
                                "CodigoTabelaCofins": 3, 
                                "Excluido": false, 
                                "cListServ": "06.01" 
                            }
                        ],
                            "consumidor":
                                    { 
                                        "nome": "", 
                                        "cnpjoucpf": "", 
                                        "ie": "", 
                                        "email": "", 
                                        "endereco": "", 
                                        "bairro": "", 
                                        "cidade": "", 
                                        "uf": "DF", 
                                        "cep": "70000000", 
                                        "celular": "" 
                                    }
                                }
    
                                                

                                                    
                                                

                                                        {
                                                        "msg": "373 - Rejeicao: Descricao do primeiro item diferente de NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
                                                        "url": "<< url para visualização do DANFE>>",
                                                        "cod": "43",
                                                        "status": "Autorizada",
                                                        "xml": "<< LINK PARA BAIXAR O XML >>",
                                                        "success": true
                                                        }


                                                    
                                                

No momento temos os exemplos nas linguagens de programação abaixo, caso queira contribuir enviando um exemplo da linguagem de programação que utiliza ficaremos gratos ;-)

Exemplo de implementação utilizando PHP: https://blog.animalcode.com.br/2017/12/18/super-fiscal-exemplo-de-implementacao-da-api-via-php/
Exemplo de implementação utilizando JQUERY: https://blog.animalcode.com.br/2017/12/11/super-fiscal-exemplo-de-implementacao-da-api-via-jquery/

APRENDA CONFIGURAR A EMPRESA PARA EMISSÃO DA NOTA

Você não precisa enviar os dados da empresa do seu cliente toda vez que for emitir a nota fiscal, este diferencial se deve devido a possibilidade de cadastrar a empresa do seu cliente no Super Fiscal. Saiba como cadastrar a empresa do seu cliente em: https://blog.animalcode.com.br/2017/12/08/super-fiscal-como-cadastrar-uma-empresa-e-configurar-para-emitir-a-nota-fiscal-eletronica-parte-i/.

Uma vez que cadastrou a empresa do seu cliente, siga com a configuração para correta emissão do documento fiscal.
Importante: Escolha sempre a maior versão disponível do serviço da SEFAZ.

Existe um artigo que tratamos sobre este assunto: https://blog.animalcode.com.br/2017/12/08/super-fiscal-como-cadastrar-uma-empresa-e-configurar-para-emitir-a-nota-fiscal-eletronica-parte-ii/.

Estando tudo pronto com o cadastro da empresa, para referenciar a mesma no JSON é necessário pegar o token da empresa, para isto, aprenda como através deste artigo: https://blog.animalcode.com.br/2017/12/08/super-fiscal-como-obter-a-chave-da-empresa-para-inserir-no-json/

Animal Code

Social Links