CSC NFCe FI22¶
Código de Segurança do Contribuinte — token de 36 caracteres fornecido pela SEFAZ estadual que autentica a emissão de NFCe (cupom fiscal eletrônico). Sem CSC, NFCe não transmite.
Pré-requisitos¶
- Permissão Master
- Empresa DFe (FI10) cadastrada e ativa
- CSC gerado no portal da SEFAZ do estado (geralmente via certificado digital)
CSC ≠ certificado
O certificado A1 (FI04) assina o XML. O CSC é um token a parte que só a NFCe usa para gerar o QR Code de consulta pelo consumidor.
Campos¶
| Campo | Obrigatório | Detalhe |
|---|---|---|
| Empresa | Sim | Empresa emitente |
| Ambiente | Sim | 1 = Produção · 2 = Homologação |
| ID CSC | Sim | Identificador numérico de 1 a 6 dígitos (ex. 000001) |
| Token CSC | Sim | Token de 36 caracteres fornecido pela SEFAZ |
| Descrição | — | Identificação livre (ex. "CSC homologação 2026") |
| Ativo | — | Marque para o CSC ser usado |
Token sensível
O token CSC é guardado criptografado. Não compartilhe — quem tiver o CSC pode falsificar QR Codes da sua empresa.
Por que múltiplos CSC?¶
A SEFAZ permite dois CSC ativos no mesmo ambiente para suportar rotação sem indisponibilidade:
- CSC antigo continua válido enquanto o novo é cadastrado
- Você marca o novo como ativo
- Após a SEFAZ confirmar, desativa o antigo
Adicionalmente, cada empresa precisa de um CSC por ambiente (produção e homologação são tokens diferentes).
Passo a passo¶
1. Obter o CSC¶
No portal da SEFAZ do seu estado, com certificado digital A1:
- Acesse a área de NFCe
- Gere um novo CSC (gera
ID CSC+Token CSC) - Copie ambos com cuidado — token tem 36 caracteres, qualquer typo invalida
2. Cadastrar no Sistemax¶
Menu Fiscal → Cadastros → CSC NFCe, botão Novo:
- Selecione Empresa
- Escolha Ambiente (1 = Produção / 2 = Homologação)
- Cole ID CSC
- Cole Token CSC
- Marque Ativo
3. Testar emissão¶
Emita uma NFCe em homologação (Lista NFCe (FI23)). Se transmitir e o QR Code aparecer na DANFCe, o CSC está OK.
4. Rotacionar¶
Quando a segurança exigir trocar o CSC (vazamento, política interna, recomendação SEFAZ):
- Gere novo CSC no portal da SEFAZ
- Cadastre o novo mantendo o antigo ativo
- Marque o novo como ativo (o antigo pode ficar ativo paralelamente)
- Após algumas emissões bem-sucedidas com o novo, desative o antigo
Erros comuns¶
CSC inválido
SEFAZ rejeita com mensagem "ID CSC inválido". Confira se copiou os 36 caracteres completos do token e o ID correto.
CSC de produção em homologação
Não vai. Cada ambiente tem token próprio.
Esqueci o token
Não dá pra recuperar — gere um novo no portal da SEFAZ e atualize aqui.
Empresa nova sem CSC
Tentar emitir NFCe sem CSC ativo gera erro imediato no cliente. Cadastre antes da primeira emissão.