Para emitir NFS-e dos pedidos do WooCommerce, instale o plugin emissaoja NFS-e for WooCommerce, cole a chave de API nas configurações e escolha quando emitir: só quando você clicar, quando o pedido for concluído ou quando estiver em processamento. O plugin cria o tomador com o CPF ou o CNPJ do cliente, emite no Emissor Nacional com o CNPJ e a senha do portal da sua empresa, sem certificado digital, e guarda número, chave de acesso, PDF e XML no próprio pedido.
Para quem serve
Para lojas que vendem serviço: cursos, consultorias, assinaturas de serviço, agendamentos, manutenção. Venda de produto físico emite NF-e, não NFS-e, e fica fora do plugin. A sua empresa precisa ser MEI, ME ou EPP do Simples Nacional, num município que emite pelo Emissor Nacional.
Como configurar
- Crie a conta no emissaoja, conecte a empresa com o CNPJ e a senha do Emissor Nacional e gere a chave em Conta → API.
- No WordPress, instale e ative o plugin e abra WooCommerce → Configurações → NFS-e (emissaoja).
- Cole a chave, escolha o ambiente e clique em Testar conexão: o plugin mostra a empresa conectada. Para testar sem efeito fiscal, use o ambiente Sandbox com uma chave
ej_test_. - Escolha quando emitir, a base do valor (total do pedido ou total sem frete) e o modelo da descrição, com os marcadores
{pedido},{itens}e{loja}.
O plugin lê o CPF e o CNPJ dos campos que lojas brasileiras já usam no checkout. Se a sua loja não pede o documento, ele pode acrescentar o campo "CPF ou CNPJ para a nota fiscal" no checkout clássico e no de blocos, com validação dos dígitos.
Como a emissão funciona
- A emissão roda em segundo plano, pelo agendador de tarefas do WooCommerce: o checkout não fica mais lento.
- Cada pedido tem uma referência fixa, enviada como chave de idempotência. Se a tarefa rodar de novo, a API devolve o mesmo pedido de emissão e não emite uma segunda nota.
- O plugin acompanha o pedido até a nota ser autorizada, recusada ou ficar incerta, e registra cada passo nas notas internas do pedido.
- Se a nota for bloqueada (por exemplo, falta o documento do cliente), a nota interna diz o que falta. Nota igual no mesmo dia não é reemitida sozinha.
- Na tela do pedido, a caixa NFS-e mostra o estado e tem os botões Emitir NFS-e agora, Conferir, Atualizar situação, Baixar PDF e Baixar XML. O download passa pelo seu servidor: a chave de API nunca vai ao navegador.
- Se você quiser, o cliente recebe uma nota no pedido com o número e o link de consulta pública da NFS-e.
O código-fonte está em github.com/Easymovel/emissaoja-woocommerce. A API que o plugin usa está documentada em /docs/.
Perguntas frequentes
Preciso de certificado digital?
Não. O emissaoja entra no Emissor Nacional com o CNPJ e a senha do portal, o acesso que o padrão nacional oferece a MEI e empresas do Simples Nacional.
E se o cliente não informar CPF nem CNPJ?
A emissão para com o bloqueio registrado no pedido. Peça o documento ao cliente, preencha o campo "CPF ou CNPJ (NFS-e)" no pedido e clique em Emitir NFS-e agora.
O plugin emite nota de produto?
Não. Ele emite só NFS-e, a nota de serviço do Emissor Nacional. Produto físico emite NF-e, por outro sistema.
Funciona com o checkout em blocos?
Sim. O plugin declara compatibilidade com o checkout em blocos e com o armazenamento de pedidos de alto desempenho (HPOS) do WooCommerce.