NF-e e NFC-e

A biblioteca trabalha com NF-e modelo 55 e NFC-e modelo 65. Escolha o modelo na configuração do emissor e preencha o documento com o mesmo modelo e identidade.

Configuração	NF-e	NFC-e
modelo	55	65
Certificado	A1	A1
CSC	Não se aplica à NF-e	Necessário para recursos que usam CSC/QRCode
Carta de correção	Método disponível	Método recusado pela API
Impressão/DANFE	Fora do escopo	Fora do escopo

Configuração de NFC-e

Este fragmento mostra a configuração. Substitua os valores pela configuração da sua integração, sem usar credenciais reais em exemplos de desenvolvimento:

const emissor = criarEmissor({
  cnpj: 'CNPJ_DO_EMITENTE', // 14 dígitos
  uf: 'CE',
  modelo: 65,
  ambiente: 2,
  certificado: { pfx, senha },
  csc: { id: '000001', valor: cscValor }
});

pfx, senha e cscValor são variáveis fornecidas pela sua aplicação. O ID do CSC aceita de 1 a 6 dígitos. O CSC precisa corresponder ao emitente e ambiente usado.

No objeto TNFeInput, ajuste Ide.modelo para 65 e preencha os campos do cenário NFC-e. Mudar apenas esse número no exemplo NF-e não produz uma integração completa de NFC-e.

Ambiente de homologação e produção

ambiente: 2 seleciona homologação. ambiente: 1 seleciona produção. O campo de ambiente do documento deve acompanhar essa escolha.

Homologação é um serviço fiscal remoto; não é um modo offline. Use documentos e certificados sintéticos com serviços locais nos testes de implementação. Uma homologação fiscal real exige planejamento próprio e registro separado dos resultados por UF e cenário.

Responsabilidades da aplicação

A aplicação fornece os dados fiscais, define a tributação, calcula e confere valores, administra séries e numeração e armazena XML, chave, recibo e protocolo. Use o resultado fiscal para acompanhar a situação da operação.

Em caso de timeout depois de uma possível transmissão, não faça uma nova tentativa automática. Veja Erros e recuperação.

Escopo atual

A presença de enums e campos ACBr nos modelos não significa que cada forma de contingência ou cada cenário fiscal tenha sido homologado. A versão inicial oferece as operações documentadas; DANFE, impressão, A3, outros documentos e cálculo comercial ficam fora do escopo.

Veja a API e a validação registrada.