Ir para conteúdo
View in the app

A better way to browse. Learn more.

Portal do Host

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Módulo para Emissão de Nota Fiscal no WHMCS usando a API da FocusNFe

Featured Replies

Postado

Nos últimos meses, desenvolvi um módulo para WHMCS voltado à emissão automatizada de Notas Fiscais Eletrônicas, com integração direta à API da FocusNFe.

O módulo foi criado com base em demandas reais do mercado, priorizando automação, flexibilidade e segurança, simplificando a rotina fiscal e garantindo conformidade com a legislação vigente.

A escolha da Focus NFe como parceira foi estratégica. Além da robustez da API, a empresa oferece suporte consultivo especializado, que tem sido fundamental diante de mudanças regulatórias recentes, como a entrada em vigor do NBS, facilitando a adaptação do sistema a esse novo cenário.

Telas do Módulo WHMCS FocusNFe


Acesso fácil através do menu do WHMCS

image.png


Tela de configurações

image.png


Configuração no Perfil do Cliente

image.png


Log de Atividades

image.png


Painel FocusNFe

image.png

Principais funcionalidades

  • Emissão de nota fiscal antes do pagamento

  • Emissão automática após a identificação do pagamento

  • Emissão de notas fiscais avulsas, independentemente de faturas do WHMCS

  • Definição de valor mínimo para emissão de nota

  • Suporte a XMLs com NBS (padrão 2026)

As notas fiscais são enviadas automaticamente:

  • Para o e-mail do cliente principal

  • E também para o contato de cobrança, quando existente no cadastro do cliente
    (o envio é realizado pela própria plataforma da Prefeitura)

Valores da FocusNFe

  • Pacote com 100 notas

  • R$0,10 por nota adicional

  • Painel para API

  • Suporte Técnico (muito bom)

  • R$89,90/mês

Convite para fase Beta

Estou iniciando a preparação para o lançamento comercial do módulo e, antes disso, quero abrir um grupo de interessados para participar da fase Beta.

Essa etapa tem como objetivo validar a solução em diferentes cenários reais de uso, receber feedbacks qualificados e realizar eventuais refinamentos finais. Vale destacar que o módulo já está em produção há mais de 6 meses, operando de forma estável e sem registros de falhas, o que permite que a fase Beta seja focada em evolução e aprimoramento, e não em correções críticas.

Os participantes do Beta terão acesso antecipado ao módulo, poderão influenciar diretamente no roadmap do produto e contarão com um canal direto para suporte e sugestões. A proposta é entregar um módulo maduro, bem documentado e realmente alinhado à rotina de quem utiliza o WHMCS diariamente.

Licença Beta

Para manter a saúde do projeto (e ajudar a pagar as incontáveis xícaras de café ), a participação na fase Beta será mediante uma licença anual simbólica no valor de R$ 100,00/ano.

Contato

Interessados podem entrar em contato pelo e-mail: contato[@]afixar.com.br

Fico à disposição para esclarecer dúvidas e trocar ideias com quem quiser participar da construção desse projeto.

Editado por afixar
Adição dos planos da FocusNFe


Postado

Estamos realizando os testes, até o momento o módulo se demonstrou eficiente.


Postado
  • Autor

Pessoal, estou compartilhando uma nova atualização do módulo
FocusNFe para WHMCS — versão v5.7.

Gusttavo Lima Comemoracao GIF by CentralDeFãsGusttavoLima

Essa versão foi ajustada principalmente para melhorar a gestão de NFe emitidas, cancelamentos e cenários com imposto retido.

😀 Principais novidades da versão

Foi adicionada uma nova aba chamada Notas Emitidas, onde é possível visualizar as notas registradas no módulo, com informações como data de emissão, número da NFe, destinatário, valor, referência FocusNFe, status e ações disponíveis.

A listagem agora conta com ações para:

  • visualizar a fatura vinculada;

  • acessar XML;

  • acessar PDF;

  • cancelar quando o status permitir;

  • consultar notas em processamento;

  • visualizar erros de cancelamento.

Também foi criada uma nova aba chamada Cancelar, com uma operação mais segura para cancelamento. Agora é possível escolher entre:

  • cancelar apenas a NFe;

  • cancelar apenas a fatura WHMCS;

  • cancelar NFe e fatura.

Antes de executar o cancelamento, o módulo permite fazer uma simulação, mostrando os dados da fatura, cliente, NFe, valores, status local e status consultado na FocusNFe. Isso ajuda a evitar cancelamentos incorretos.

Outra melhoria importante é o autocomplete no campo ID da fatura. Ao digitar o número, o módulo já exibe informações como cliente, status da fatura, valor, vencimento e NFe vinculada, quando existir.

O cancelamento também ficou mais seguro. A versão anterior podia considerar o HTTP 200 como sucesso, mas agora o módulo também interpreta o status retornado pela FocusNFe. Se a prefeitura ou a FocusNFe retornar erro, como erro_cancelamento ou cancelamento_indeferido, a fatura WHMCS não é cancelada automaticamente. O retorno detalhado fica visível na tela, com código, mensagem, correção sugerida e JSON bruto.

Também foram mantidas as regras para clientes com imposto retido. O módulo considera o valor bruto do serviço para emissão da NFe e permite que a fatura WHMCS fique com o valor líquido a pagar.

Coffee Work GIF by OiExemplo:

Serviço de Hospedagem: R$ 100,00
Imposto Retido: -R$ 3,00
Total a pagar: R$ 97,00
Valor do serviço na NFe: R$ 100,00

Resumo da v5.7

  • nova aba Notas Emitidas;

  • nova aba Cancelar;

  • simulação antes do cancelamento;

  • autocomplete de fatura;

  • paginação na listagem;

  • ações conforme status da NFe;

  • exibição detalhada de erros da FocusNFe;

  • cancelamento mais seguro;

  • tratamento de imposto retido;

  • image.png


    image.png

❤️ Como adquirir o módulo

O módulo já está disponível em sua versão mais recente e pode ser adquirido mediante uma licença anual simbólica no valor de R$ 100,00/ano.

Coffee Cafe GIFEssa contribuição ajuda a manter a evolução do projeto, cobrir custos de desenvolvimento, documentação, testes, suporte e, claro, as incontáveis xícaras de café necessárias para continuar melhorando o módulo.

Ao adquirir a licença, o usuário terá acesso ao módulo, atualizações futuras dentro do período da licença e um canal direto para suporte, dúvidas e sugestões de melhoria.

A proposta continua sendo entregar uma solução madura, bem documentada e alinhada à rotina de quem utiliza o WHMCS diariamente.

Interessados podem entrar em contato pelo e-mail:

contato[@]afixar.com.br

Fico à disposição para esclarecer dúvidas, ouvir sugestões e trocar ideias com outros colegas que desejam utilizar ou contribuir com a evolução do projeto.

Editado por afixar


Participe da conversa

Você pode postar agora e se cadastrar mais tarde. Se você tem uma conta, faça o login para postar com sua conta.
Nota: Sua postagem exigirá aprovação do moderador antes de ficar visível.

Visitante
Infelizmente, seu conteúdo contém termos que não são permitimos. Edite seu conteúdo para remover as palavras destacadas abaixo.
Responder

Quem Está Navegando 2

Informação Importante

Concorda com os nossos termos?

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.