Configuração fiscal

Antes da primeira emissão, você precisa cadastrar 3 coisas: CNPJ + IM, certificado A1 e ambiente.

Vídeo em breve

Configurando o fiscal em 2 minutos

CNPJ e Inscrição Municipal

Em /app/configuracoes, aba Empresa, preencha:

  • CNPJ prestador (14 dígitos, com ou sem máscara)
  • Inscrição Municipal (varia por município)
  • Regime tributário (Simples Nacional, Lucro Presumido, etc.)
  • Código IBGE do município (ex.: 3550308 = São Paulo)
  • Alíquota ISS padrão (deixe em 5% se não souber)

Upload do certificado A1

O certificado digital A1 (arquivo .pfx) é usado pra assinar cada XML da NFS-e. Você compra em Autoridades Certificadoras (Certisign, Serasa, Valid, AC Safeweb).

Em /app/configuracoes, aba Certificado: faça upload do .pfx e informe a senha. A senha e o binary do certificado são criptografados em repouso com AES-256-GCM — sua senha nunca fica em texto claro no banco.

Ambiente: homologação vs produção

  • Homologação — ambiente de teste da Prefeitura. As notas emitidas não têm valor fiscal. Ideal para configurar e testar o fluxo antes de sair emitindo pra valer.
  • Produção — nota fiscal real e legalmente válida. Só ative depois que a homologação estiver rodando 100%.

Troque de ambiente na aba Ambiente. Recomendamos rodar 3-5 emissões em homologação antes de mudar pra produção.

Certificado expirando?

A1 vale 12 meses. Uploads sucessivos substituem o anterior — sem downtime. Veja também: FAQ.