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.