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.
- Possuir uma conta de acesso do Super Fiscal.
- Obter o TOKEN para acesso a API.
- Ter pelo menos uma empresa devidamente credenciada para emissão de nota fiscal eletrônica.
- Possuir o certificado digital do tipo A1 (.pfx) e sua senha correspondente.
- 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
}
Segue um artigo que falamos sobre isso: https://blog.animalcode.com.br/2017/12/18/super-fiscal-desvendando-os-campos-do-json-para-criar-uma-nota-fiscal-eletronica/.
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/