Roteiro de Configuração Inicial
Sequência em 5 passos: empresa, certificado A1, CSC, numeração e primeira nota.
Para começar a emitir documentos fiscais eletrônicos com o NFER, siga esta sequência ordenada de configuração. O processo leva menos de 5 minutos e prepara a empresa tanto para testes em homologação quanto para a virada definitiva de produção.
Cadastrar a Empresa Emissora
O primeiro passo é cadastrar os dados cadastrais da pessoa jurídica emissora (CNPJ, Razão Social, Inscrição Estadual e endereço completo com código IBGE).
Veja o guia completo de onboarding em Empresa & Onboarding ou use o endpoint POST /v1/companies.
Carregar Certificado Digital A1
A SEFAZ exige assinatura digital padrão ICP-Brasil em todos os XMLs transmitidos. Faça o upload do arquivo .pfx com a respectiva senha. Os certificados são armazenados em cofre criptografado com chave AES-256 e protegidos por isolamento de tenant.
Detalhes técnicos e monitoramento de validade em Upload do Certificado A1.
Configurar CSC (Obrigatório para NFC-e)
Se a empresa for emitir Cupom Fiscal Eletrônico (NFC-e modelo 65), obtenha o Código de Segurança do Contribuinte (CSC) e o ID do token no portal da SEFAZ estadual e vincule à empresa. Para NF-e (modelo 55), esta etapa não é necessária.
Instruções passo a passo em Conceitos e CSC de NFC-e.
Definir Séries e Numeração Inicial
Se a empresa já emitia notas fiscais por outro sistema, configure o número da próxima nota a ser emitida para manter a estrita continuidade da sequência fiscal e evitar rejeições por duplicidade na SEFAZ.
Saiba como definir contadores por série e ambiente em Séries e Numeração.
Emitir a Primeira Nota em Homologação
Com as credenciais e o certificado configurados, emita sua primeira nota em ambiente de testes (environment: "homologacao") para validar regras tributárias, retorno de chave de 44 dígitos e geração de PDF.
Siga o roteiro acelerado em Quick Start ou veja requisições prontas em Exemplos de Requisição.
Cadastros Complementares