WooCommerce
Emita notas fiscais de serviço (NFS-e) automaticamente a partir dos pedidos da sua loja WooCommerce.
O NFE.io Nota Fiscal for WooCommerce é o plugin oficial da NFE.io para WordPress. Ele acompanha os pedidos da loja e, quando o pedido chega ao status que você escolher, solicita a emissão da nota à NFE.io, que cuida da comunicação com a prefeitura.
A nota não sai na hora: a prefeitura processa o documento de forma assíncrona. O plugin registra um webhook assinado na sua conta NFE.io e é por ele que a loja fica sabendo quando a nota foi emitida, cancelada ou rejeitada. O status aparece na lista de pedidos, e o cliente recebe o link do PDF por e-mail.
Antes de começar
Você vai precisar de três coisas:
- WooCommerce ativo na loja, na versão 9.0 ou superior.
- Uma chave de API da NFE.io. Veja chaves de autenticação para gerar a sua.
- O plugin Brazilian Market on WooCommerce, que adiciona CPF e CNPJ ao checkout. A NFS-e exige a identificação fiscal do tomador, e é esse plugin que a coleta. O NFE.io Nota Fiscal for WooCommerce não duplica esses campos de propósito.
Requisitos de ambiente
| Versão mínima | |
|---|---|
| PHP | 8.2 |
| WordPress | 6.5 |
| WooCommerce | 9.0 |
Em versões de PHP anteriores à 8.2 o plugin permanece inativo e avisa, em vez de quebrar o site.
O plugin é compatível com o HPOS (High-Performance Order Storage) do WooCommerce, o armazenamento de pedidos em tabelas próprias. Funciona igual com o HPOS ligado ou desligado.
Passo 1: instalar o plugin
A listagem no diretório do WordPress.org está em processo de revisão. Até ela ser publicada, o plugin é distribuído pelas releases no GitHub.
Baixe o arquivo nfe-io-nota-fiscal-for-woocommerce-<versão>.zip anexado à release mais recente. Use o arquivo anexado, e não o Source code (zip) que o GitHub gera automaticamente na mesma página: o código-fonte sozinho não contém as dependências e o plugin não ativa.
No painel do WordPress, abra Plugins, clique em Adicionar novo, depois em Enviar plugin, escolha o arquivo e instale. Ao final, clique em Ativar.
Se a loja ainda tem o antigo NFe for WooCommerce instalado, desative-o antes de ativar este. Dois plugins ativos ao mesmo tempo solicitariam nota para o mesmo pedido, e uma NFS-e duplicada precisa ser cancelada manualmente. O plugin novo detecta o antigo em atividade e se recusa a iniciar, avisando na tela.
Suas configurações e as notas já registradas nos pedidos são preservadas: os dois leem os mesmos dados.
Passo 2: conectar a loja à sua conta
Com o plugin ativo, vá em WooCommerce → Configurações → Integração → Notas Fiscais (NFE.io).

Preencha a Chave da API. Assim que ela for salva, o plugin consulta a sua conta e preenche a lista de empresas — então escolha a empresa emissora em seguida.
Os demais campos desta seção definem o comportamento da emissão:
Emissão de NFe. Define se a nota é solicitada automaticamente quando o pedido muda de status, ou se você prefere solicitar manualmente, pedido a pedido.
Status da emissão no pedido. O status em que a emissão dispara. O mais comum é Processando, que no WooCommerce significa pagamento confirmado. Escolher um status anterior ao pagamento faria a loja emitir nota de pedido que ainda pode não ser pago.
Endereço é necessário para emissão. Mantenha em Sim se a sua prefeitura exige o endereço do tomador na nota. Com essa opção ligada, um pedido sem endereço utilizável não gera nota, e o motivo fica registrado no histórico do pedido.
Destacar envio dos impostos. Define se o valor do frete entra na base de cálculo dos impostos.
Clique em Salvar alterações ao final da página.
Passo 3: conferir o webhook

Você não precisa configurar nada aqui. O plugin registra o webhook sozinho na sua conta NFE.io assim que a chave de API é salva, gera o segredo usado para assinar as entregas e passa a verificar a assinatura de cada notificação recebida.
A seção existe para consulta e diagnóstico. A situação do webhook mostra se ele está ativo. Se aparecer um aviso dizendo que a loja não está recebendo atualizações, use o link Gerar um novo segredo e registrar o webhook de novo.
Se a sua hospedagem filtra requisições de entrada, libere a URL mostrada nesse campo. É por ela que a NFE.io avisa a loja de que a nota foi emitida — sem ela, o pedido fica parado em "processando" mesmo depois de a nota sair.
Passo 4: códigos de serviço

Estes são os códigos que vão na nota. Peça-os ao seu contador — eles dependem da atividade da empresa e do município:
Código de serviço municipal (CityServiceCode). O código da sua prefeitura para o serviço prestado.
Código de serviço federal LC 116 (FederalServiceCode). O código correspondente na Lei Complementar 116.
Descrição do serviço. O texto que aparece na nota descrevendo o que foi prestado.
Os valores definidos aqui valem para a loja inteira. Produtos e variações podem sobrescrevê-los individualmente, como mostra o passo 6.
Passo 5: Reforma Tributária (RTC)

Os campos da Reforma Tributária seguem a mesma lógica dos códigos de serviço: o que estiver preenchido aqui é usado quando o produto ou a variação não trazem valor próprio.
Código NBS (nbsCode). A Nomenclatura Brasileira de Serviços correspondente ao que você vende.
Indicador de operação e Código de classificação compõem o grupo ibsCbs da nota.
Perfil de validação RTC. Define o rigor com que o plugin confere o conteúdo antes de enviar. No perfil Equilibrado, que é o padrão, campos essenciais ausentes bloqueiam a emissão e o restante gera apenas aviso no histórico do pedido.
Em caso de dúvida sobre qualquer um desses valores, fale com o seu contador.
Passo 6: códigos por produto

Quando a loja vende serviços diferentes entre si, cada produto pode ter os seus próprios códigos. Na tela de edição do produto, abra a aba de campos fiscais do plugin e preencha o que for específico daquele item.
O valor do produto tem precedência sobre o valor geral da loja. Produtos variáveis aceitam códigos por variação, o que permite tratar cada variação como um serviço distinto.
Acompanhando as notas
Na lista de pedidos

A lista de pedidos ganha uma coluna com a situação da nota de cada pedido. Pedidos sem nota mostram a ação para solicitar a emissão.
No pedido

Na tela do pedido, o seletor de ações permite solicitar a emissão ou baixar o PDF de uma nota já emitida.

Os dados da nota emitida — número, código de verificação, data e link para o documento — aparecem junto aos dados do pedido.
O histórico do pedido registra cada passo: quando a emissão foi solicitada, quando a NFE.io confirmou e, se algo deu errado, qual foi o motivo. É o primeiro lugar a olhar quando uma nota não sai.
No painel

O painel do WordPress mostra um resumo com a quantidade de notas emitidas, em processamento, canceladas e com erro.
Para o cliente
Na área Minha conta do cliente, cada pedido com nota emitida oferece o PDF para download. O cliente também recebe um e-mail com o link assim que a NFE.io confirma a emissão — e não antes, para que o aviso nunca anuncie um documento que ainda não existe.
Emissão retroativa

Se você quer emitir notas de vendas já concluídas, habilite a emissão retroativa e defina de quantos dias atrás os pedidos podem ser considerados.
Quando algo não sai
Ligue o registro de depuração na última seção das configurações. Com ele ativo, o plugin grava o que aconteceu em cada tentativa, e o registro fica em WooCommerce → Status → Histórico.

Esse registro é o que o nosso time pede quando você abre um chamado. Ele mostra a resposta da API para cada pedido e costuma apontar a causa direto.
Consulte também
- Conheça mais sobre nota fiscal
- Chaves de autenticação
- Código-fonte e releases do plugin
- Histórico de versões
Precisa de ajuda? Fale com a gente.