Pular para o conteúdo principal

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
PHP8.2
WordPress6.5
WooCommerce9.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​

Onde baixar

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.

Vindo do plugin antigo

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).

Campos de conexão: chave da API, empresa emissora, quando emitir e exigência de endereço

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​

Seção de configuração do webhook, com a URL e a situação atual

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.

Firewall e WAF

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​

Campos de código de serviço municipal, federal e descrição do 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)​

Campos da Reforma Tributária: código NBS, indicador de operação, código de classificação e perfil de validação

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​

Aba de campos fiscais na tela de edição do 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​

Coluna de notas fiscais 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​

Ações de nota fiscal disponíveis na tela do pedido

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

Dados da nota exibidos na tela do pedido

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​

Resumo de notas fiscais no painel do WordPress

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​

Opção de emissão retroativa e janela de dias

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.

Opção de registro de depuração

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​

Precisa de ajuda? Fale com a gente.

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.