NFS-e — Nota Fiscal de Serviço Eletrônica

1. Pré-requisitos

Antes de começar a emitir NFS-e pelo Smartcash, você precisa ter alguns itens prontos. Confira a lista:

Certificado digital A1 (PFX)

O certificado digital A1 é um arquivo com extensão .pfx que identifica sua empresa digitalmente. Ele é obrigatório para assinar as notas fiscais eletrônicas.

• Deve ser do tipo A1 (arquivo digital, não o A3 que usa cartão/token físico)
• Deve estar vinculado ao CNPJ da empresa que vai emitir as notas
• Deve estar dentro da validade (certificados A1 duram 1 ano)
• Você precisa da senha do certificado (definida na hora da compra)

Cadastro na prefeitura

Sua empresa precisa estar habilitada para emissão de NFS-e no município onde está registrada. O Smartcash utiliza o sistema NFS-e Nacional (SEFIN), que está sendo adotado gradualmente pelos municípios brasileiros.

Informações fiscais

Você vai precisar das seguintes informações (seu contador pode ajudar):

• Código do município (IBGE) — código numérico de 7 dígitos do seu município
• Regime tributário — se sua empresa é Simples Nacional, Lucro Presumido, etc.
• Código do serviço (CNAE/NBS) — código que identifica o tipo de serviço prestado
• Código de tributação municipal — código do serviço na tabela do município

2. Upload do certificado A1

O primeiro passo da configuração é enviar o certificado digital para o Smartcash:

1. No menu lateral, clique em Notas Fiscais
2. No topo da tela, clique em Configurações (ícone de engrenagem)
3. Na seção Certificado Digital, clique em Enviar certificado
4. Selecione o arquivo .pfx do seu computador
5. Digite a senha do certificado
6. Clique em Upload

O sistema vai:

• Validar se o arquivo é um certificado PFX válido
• Verificar se a senha está correta
• Extrair a data de validade e o CNPJ do certificado
• Criptografar o certificado e armazená-lo com segurança

Verificar status do certificado

Após o upload, a tela de configuração mostra o status do certificado:

• CNPJ — CNPJ vinculado ao certificado (deve ser o mesmo da empresa)
• Validade — data de expiração do certificado
• Status — Válido ou Expirado

Remover certificado

Se precisar trocar o certificado (renovação ou erro), clique em Remover certificado e depois faça o upload do novo arquivo.

3. Configurar município e regime

Com o certificado instalado, configure os dados fiscais da sua empresa:

1. Na mesma tela de Configurações da NFS-e, preencha os campos:
   • Municipio (IBGE) — selecione ou digite o código do seu município
   • Regime tributário — Simples Nacional, Lucro Presumido, Lucro Real, etc.
   • Optante Simples Nacional — sim ou não
   • Código do serviço (tributação nacional) — código NBS do serviço
   • Código de tributação municipal — código na tabela de serviços do município
   • Ambiente — Produção (notas reais) ou Homologação (teste)
2. Clique em Salvar configuração

E-mail para o tomador

Na configuração, você pode ativar o envio automático por e-mail da nota para o tomador (cliente). Quando ativado, após cada emissão bem-sucedida, o sistema envia um e-mail para o tomador com o PDF da DANFSe anexo.

4. Emitir nota avulsa

Para emitir uma nota fiscal de serviço individual:

1. No menu lateral, clique em Notas Fiscais
2. Clique em Emitir Nota
3. Preencha os dados do tomador (quem recebe o serviço):
   • CPF ou CNPJ
   • Nome / Razão social
   • CEP (o sistema busca o endereço automaticamente)
   • E-mail (para envio da nota)
4. Preencha os dados do serviço:
   • Descrição do serviço — texto livre que aparece na nota (ex: "Consultoria em gestão financeira — Outubro/2026")
   • Valor — valor total do serviço
   • Data de competência — mes/ano a que se refere o serviço
5. Confira os dados no resumo
6. Clique em Emitir

O processo de emissão leva alguns segundos. O Smartcash:

1. Envia os dados para o serviço de emissão
2. O serviço monta o XML, assina digitalmente e envia para a SEFIN Nacional
3. A SEFIN processa e retorna o número da nota e a chave de acesso
4. O Smartcash recebe o PDF da DANFSe (documento auxiliar)
5. Se configurado, envia o e-mail para o tomador com o PDF anexo

Após a emissão

A nota emitida aparece na listagem de NFS-e com:

• Número da nota
• Chave de acesso
• Data de emissão
• Tomador
• Valor
• Status (Emitida, Cancelada, Erro)

Você pode clicar na nota para ver os detalhes completos ou baixar o PDF da DANFSe.

5. Emissão em lote

Se você precisa emitir várias notas de uma vez (ex: fechamento mensal com 20 clientes), a emissão em lote economiza muito tempo.

Como emitir em lote

1. Na listagem de NFS-e, selecione as notas que deseja emitir (checkbox)
2. Clique em Emitir em lote
3. O sistema inicia o processamento e exibe uma barra de progresso
4. Cada nota e emitida sequencialmente — você acompanha o status de cada uma em tempo real
5. Ao final, um resumo mostra quantas foram emitidas com sucesso e se houve erros

Recovery automático

Se durante a emissão em lote a conexão com o servidor for interrompida (queda de internet, navegador travou), não se preocupe. O sistema possui um mecanismo de recovery automático:

• O backend continua processando todas as notas mesmo se o navegador desconectar
• Ao reconectar, o sistema detecta o lote em andamento e mostra o banner "Conexão interrompida — recuperando status..."
• O progresso real é recuperado automaticamente do servidor
• Quando o lote termina, o resumo completo é exibido normalmente

6. Cancelar nota

Emitiu uma nota com erro? Você pode cancelar, desde que esteja dentro do prazo permitido pelo município (geralmente até o fechamento do mes de competência).

Processo de cancelamento

1. Na listagem de NFS-e, localize a nota que deseja cancelar
2. Clique no botão de cancelar (ícone vermelho)
3. Selecione o motivo do cancelamento:
   • Erro na emissão
   • Serviço não prestado
   • Duplicidade
4. Preencha a justificativa (texto obrigatório)
5. Confirme o cancelamento

O sistema envia o pedido de cancelamento para a SEFIN Nacional. Se aprovado, a nota fica com status Cancelada na listagem.

7. Reenviar para tomador

Se o tomador (cliente) não recebeu o e-mail com a nota, ou se você precisa enviar novamente por qualquer motivo, o Smartcash permite reenviar facilmente.

Como reenviar

1. Na listagem de NFS-e, localize a nota emitida
2. Clique no botão de reenviar (ícone verde de refresh)
3. O sistema reenvia o e-mail para o tomador com o PDF da DANFSe anexo

O e-mail enviado ao tomador contém:

• Dados da nota (número, valor, data)
• PDF da DANFSe em anexo
• Cópia (CC) para o e-mail da sua empresa

Notas com erro

Se uma nota teve erro na emissão (rejeição da SEFIN), ela aparece na listagem com status Erro e uma mensagem explicando o motivo. Você pode:

• Corrigir e reemitir — edite os dados e tente emitir novamente
• Excluir — remova a nota com erro da listagem (notas com erro não têm valor fiscal)