NFER
Visão GeralQuick StartAutenticaçãoAmbientesConfiguração InicialExemplos de RequisiçãoGlossário FiscalChecklist de Go-LiveFAQModelo de DadosCiclo de Vida & FluxoContingência AutomáticaLimites & Rate LimitEvitando DuplicidadeErros e RetransmissãoSplit Fiscal HíbridoNovoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoCódigos de ServiçoConceitosEmissão Passo a PassoNovoRegimes, CST e CFOPEventos FiscaisVisão Geral & CronogramaNovos Campos na APITabela cClassTribDevoluções & AnulaçõesChecklist de MigraçãoVisão Geral & NSUCorporate+NF-e Recebidas & MD-eCorporate+NFS-e Tomadas (ADN)Corporate+CT-e Fretes & DesacordoCorporate+White-Label & Org APIEmpresaCertificado A1 & CSCHabilitação SEFAZCadastrosNumeraçãoPlanos

Homologação e Produção

Isolamento de séries, tpAmb SEFAZ e como virar a chave da empresa.

O NFER opera com dois ambientes estritamente isolados: Homologação e Produção. Ambos utilizam a mesma infraestrutura, a mesma Base URL da API e os mesmos contratos de dados, garantindo que tudo o que você testar em homologação funcione exatamente da mesma forma em produção.

Homologação vs Produção

CaracterísticaHomologação (Testes)Produção
Código SEFAZ (tpAmb)2 (Homologação)1 (Produção)
Validade Jurídica / FiscalNenhuma. Notas apenas para validação técnica.Válida perante a Receita Federal e SEFAZ estadual.
Impressão DANFE / DACTECarimbo com tarja d’água “SEM VALOR FISCAL”.Documento auxiliar oficial para circulação e trânsito.
Numeração e SériesContadores isolados. Não afetam a contabilidade real.Numeração contínua e sequencial oficial da empresa.
Base URL da APIhttps://api.nfer.me/v1https://api.nfer.me/v1
Chave de AutenticaçãoMesma X-API-Key da sua empresa.Mesma X-API-Key da sua empresa.

Mesma URL, mesmo contrato

Ao contrário de outros serviços legados que mantêm URLs diferentes para sandbox, no NFER a Base URL é única. O ambiente de destino na SEFAZ é determinado pela configuração da empresa emitente no banco de dados.

Isolamento de Séries e Numeração

As sequências numéricas de NF-e, NFC-e, NFS-e e CT-e são registradas com a restrição única (company_id, serie, numero, environment). Isso significa que você pode emitir centenas de notas de teste na série 1 em homologação sem queimar nenhum número ou quebrar a sequência fiscal exigida pelo seu contador para a produção.

Como Virar a Chave para Produção

Quando todos os testes de integração e emissão estiverem aprovados, altere o campo environment da empresa para producao:

PUT/v1/companies/:id
curl -X PUT https://api.nfer.me/v1/companies/$COMPANY_ID \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"environment": "producao"
}'

Pré-requisitos para Produção

Antes de virar para produção, certifique-se de que a empresa possui um Certificado Digital A1 válido carregado, o CSC de produção cadastrado (se emitir NFC-e) e a numeração inicial da série sincronizada com sua contabilidade.

Próximos Passos

AnteriorAutenticaçãoPróximoConfiguração Inicial