Guia de instalação

Do download ao seu primeiro cupom

Este é o caminho inteiro, sem pular etapa e sem esconder o que demora. Se travar em qualquer ponto, chama a gente — a gente instala junto com você por chamada de vídeo, sem cobrar.

Enquanto o CSC não sai, o programa já funciona em homologação: você emite cupons de teste à vontade, aprende o fluxo e chega no dia da virada sem susto. Cupom de homologação serve para treinar — ele não tem valor fiscal e não vale para o seu cliente.

Antes de começar

Três coisas que precisam existir

Não tem tudo ainda? Cadastre e instale mesmo assim. Seu código fica valendo e a gente resolve o resto com você durante o teste.

1. Um computador com Windows

Windows 10 ou Windows 11, 64 bits, com 4 GB de memória e uns 500 MB livres em disco. Serve o computador do caixa, um notebook simples ou aquele micro da retaguarda.

Hoje o instalador é só de Windows. Não existe versão para celular ou navegador, e não vai existir. Mac e Linux estão em desenvolvimento — o programa é feito em Java e já roda nos dois; falta o instalador assinado. Sem data prometida. Se o seu computador de trabalho não é Windows, melhor saber agora do que depois de assinar.

2. Certificado digital A1 do seu CNPJ

É o arquivo .pfx com senha — o mesmo que o seu contador provavelmente já usa. Ele é quem assina o cupom: sem ele, a SEFAZ não autoriza nada.

É pago à certificadora, não à gente — o preço é definido por ela — e costuma sair no mesmo dia. Como pedir está no passo 5.

3. O CSC do seu estado

CSC é o Código de Segurança do Contribuinte. É a SEFAZ do seu estado que libera, e é ele que transforma um cupom de teste em documento fiscal de verdade.

A liberação leva de 1 a 3 dias e o prazo é da SEFAZ. Você mesmo pede, no portal da SEFAZ do seu estado. Como fazer está no passo 7.

Você também precisa da Inscrição Estadual ativa e do credenciamento como emissor de NFC-e no seu estado. Na maioria dos casos o credenciamento sai junto com o pedido do CSC, no mesmo portal.

Passo a passo

Sete passos, na ordem

Do 1 ao 4 você faz sozinho em cerca de 15 minutos. O 5, o 6 e o 7 dependem de terceiros — a certificadora e a SEFAZ do seu estado — e por isso levam de 1 a 3 dias.

  1. Baixe o instalador

    O arquivo é um .msi para Windows 10 e 11. Baixe no computador onde o programa vai rodar — normalmente o do caixa. Se você estiver lendo isso no celular, o link também chega no seu e-mail junto com o código.

    Versão 1.0.0 · .msi

    Baixar para Windows

  2. Instale — e passe pelo aviso azul do Windows

    Dê dois cliques no arquivo baixado e siga o instalador. Ele não pergunta quase nada.

    Terminou, aparece o ícone do meusimplesfiscal na área de trabalho. Abra.

  3. Cole o seu código de ativação

    Na primeira vez o programa pede o código que você recebeu no cadastro — aquele com letras e números, em quatro blocos. Cole, confirme e pronto: o teste começa a valer a partir daí.

    Perdeu o código, formatou a máquina ou fechou a aba antes de copiar? Peça de novo em reenviar código. Ele volta para o mesmo e-mail do cadastro.

  4. Cadastre a sua empresa

    Na primeira vez o Assistente inicial abre sozinho e conduz o cadastro. Depois, os mesmos campos ficam em Empresa e emissão, no menu da esquerda: CNPJ, razão social, endereço com código IBGE da cidade, Inscrição Estadual e regime tributário. O programa é feito para o Simples Nacional — é esse o regime que ele calcula e é ele que você deve marcar.

    Confira o endereço com calma: ele sai impresso no cupom e a SEFAZ compara com o cadastro dela.

  5. Importe o certificado digital A1

    No programa, menu da esquerda: Certificado digital. Escolha o arquivo .pfx, digite a senha e salve. A senha fica guardada cifrada no próprio computador — ela não vai para lugar nenhum.

    Ainda não tem o A1? É assim que se consegue:

    • Procure uma certificadora credenciada pela ICP-Brasil — seu contador quase sempre já trabalha com uma e resolve isso em uma ligação.
    • Peça o modelo A1 (arquivo), não o A3 (cartão ou token). O A1 é o que o programa usa.
    • A validação hoje costuma ser por videochamada, com o responsável pelo CNPJ e um documento com foto.
    • O preço é da certificadora e varia entre elas — compare antes de fechar. Sai no mesmo dia na maioria dos casos.
    • Guarde o arquivo e a senha em lugar seguro. Se perder, não tem como recuperar: só emitindo outro.

  6. Emita o primeiro cupom em homologação

    O programa começa em homologação, que é o ambiente de treino da própria SEFAZ. É de propósito: dá para errar à vontade sem gerar documento fiscal.

    Cadastre um item em Produtos, abra Emitir NFC-e, adicione o produto e emita. Em alguns segundos aparece ● Cupom autorizado. Esse cupom tem chave de acesso e QR Code como um de verdade — só que carimbado como teste.

    Para ver o papel: abra Documentos, clique no cupom e em Ver DANFCE (PDF). Dali você manda para a sua impressora térmica de bobina 58 mm ou 80 mm, daquelas que já ficam no balcão. Impressora fiscal antiga (ECF) não é necessária — a NFC-e acabou com essa exigência.

  7. Ligue o CSC e vire para produção

    Este é o passo que transforma treino em documento fiscal. São duas informações que a SEFAZ do seu estado te entrega:

    • O CSC — uma sequência comprida de letras e números.
    • O ID do CSC (ou Token) — um número curto, normalmente 1 ou 2.

    No programa: Empresa e emissão, bloco Configuração fiscal (SEFAZ). Preencha ID do CSC e CSC, troque o campo Ambiente de Homologação para Produção e clique em Salvar dados da empresa. Emita uma venda pequena e real para conferir. Saiu ● Cupom autorizado sem o aviso de teste? Está no ar.

    Um detalhe que pega muita gente: o CSC de homologação e o de produção são diferentes. Se você virou o ambiente e o cupom foi rejeitado, quase sempre é o CSC de homologação que ficou no campo.

    Não quer fazer isso sozinho? Marca uma chamada de vídeo com a gente. Esse passo é a parte chata, e é justamente a parte que a gente faz com você, sem cobrar.

Depois disso o dia a dia é sempre o mesmo: abrir venda, escolher o produto, emitir. E se a internet cair no meio do expediente, o programa avisa em amarelo e continua funcionando — quando a conexão voltar, ele manda sozinho o que ficou pendente.

CSC estado por estado

Como pegar o CSC no seu estado

O caminho muda de estado para estado, mas o pedido é sempre parecido. Abaixo está o roteiro geral e a lista das 27 unidades da federação.

O que vale em todo estado

  • Você precisa de Inscrição Estadual ativa e de credenciamento como emissor de NFC-e. Onde o credenciamento ainda não existe, ele é pedido no mesmo formulário do CSC.
  • O acesso ao portal quase sempre é feito com o certificado digital da empresa — o mesmo A1 do passo 5. Por isso o A1 vem antes do CSC na ordem deste guia.
  • O serviço costuma aparecer com um destes nomes: "CSC — Código de Segurança do Contribuinte", "Gerar CSC" ou "Token NFC-e".
  • Peça o CSC de produção e, se o portal oferecer, também o de homologação. São códigos diferentes e servem para ambientes diferentes.
  • Copie o código inteiro e anote o ID/Token que aparece ao lado dele. Sem o ID, o CSC sozinho não autoriza.
  • A liberação leva de 1 a 3 dias úteis na maioria dos estados. Quem manda no prazo é a SEFAZ.

Onde pedir, por estado

Estamos publicando o caminho exato de cada portal conforme conferimos em campo — link de SEFAZ errado atrapalha mais do que ajuda. Enquanto o seu estado não estiver detalhado aqui, procure por "CSC" ou "Código de Segurança do Contribuinte" no portal da SEFAZ do seu estado, logado com o seu certificado.

  • Acre (AC) — SEFAZ-AC. Caminho no portal: a publicar.
  • Alagoas (AL) — SEFAZ-AL. Caminho no portal: a publicar.
  • Amapá (AP) — SEFAZ-AP. Caminho no portal: a publicar.
  • Amazonas (AM) — SEFAZ-AM. Caminho no portal: a publicar.
  • Bahia (BA) — SEFAZ-BA. Caminho no portal: a publicar.
  • Ceará (CE) — SEFAZ-CE. Caminho no portal: a publicar.
  • Distrito Federal (DF) — SEFAZ-DF. Caminho no portal: a publicar.
  • Espírito Santo (ES) — SEFAZ-ES. Caminho no portal: a publicar.
  • Goiás (GO) — Economia-GO. Caminho no portal: a publicar.
  • Maranhão (MA) — SEFAZ-MA. Caminho no portal: a publicar.
  • Mato Grosso (MT) — SEFAZ-MT. Caminho no portal: a publicar.
  • Mato Grosso do Sul (MS) — SEFAZ-MS. Caminho no portal: a publicar.
  • Minas Gerais (MG) — SEF-MG. Caminho no portal: a publicar.
  • Pará (PA) — SEFA-PA. Caminho no portal: a publicar.
  • Paraíba (PB) — SEFAZ-PB. Caminho no portal: a publicar.
  • Paraná (PR) — SEFA-PR. Caminho no portal: a publicar.
  • Pernambuco (PE) — SEFAZ-PE. Caminho no portal: a publicar.
  • Piauí (PI) — SEFAZ-PI. Caminho no portal: a publicar.
  • Rio de Janeiro (RJ) — SEFAZ-RJ. Caminho no portal: a publicar.
  • Rio Grande do Norte (RN) — SET-RN. Caminho no portal: a publicar.
  • Rio Grande do Sul (RS) — Receita Estadual RS. Caminho no portal: a publicar.
  • Rondônia (RO) — SEFIN-RO. Caminho no portal: a publicar.
  • Roraima (RR) — SEFAZ-RR. Caminho no portal: a publicar.
  • Santa Catarina (SC) — SEF-SC. Caminho no portal: a publicar.
  • São Paulo (SP) — SEFAZ-SP. Caminho no portal: a publicar.
  • Sergipe (SE) — SEFAZ-SE. Caminho no portal: a publicar.
  • Tocantins (TO) — SEFAZ-TO. Caminho no portal: a publicar.

Quando emperra

Os quatro tropeços mais comuns

O Windows não deixou instalar

É o SmartScreen do passo 2. Clique em Mais informações → Executar assim mesmo. Se o computador for da rede da loja e tiver bloqueio de administrador, quem instala precisa entrar como administrador.

O código de ativação não foi aceito

Confira se ele não veio com espaço no começo ou no fim ao colar. Se o código venceu — eles têm prazo curto de propósito — peça outro em reenviar código ou chama a gente que a gente gera um novo na hora.

O certificado A1 não abriu

Quase sempre é senha do arquivo trocada com a senha do portal da certificadora — são coisas diferentes. Vale conferir também a validade: o A1 vale um ano e vence sem avisar.

O cupom foi rejeitado em produção

Os três motivos campeões: CSC de homologação usado em produção, Inscrição Estadual sem credenciamento para NFC-e, ou endereço da empresa diferente do cadastro da SEFAZ. A mensagem de rejeição que aparece na tela diz qual dos três é — e se não estiver claro, manda um print para a gente.

Travou? Chama a gente

A gente instala o programa junto com você por chamada de vídeo, sem cobrar. O certificado A1 e o CSC você pede direto na certificadora e na SEFAZ — o passo a passo está aqui em cima.

Falar no WhatsApp Escrever por e-mail