Atualização: o Módulo Conta Azul para WHMCS voltou, reescrito para a nova API

Em novembro de 2025 o Conta Azul desligou a API antiga. Quem usava as versões 1.x e 2.x do módulo viu a integração simplesmente parar: cliente novo não virava pessoa, fatura paga não virava venda e o financeiro voltou para a planilha. O módulo foi reescrito do zero para a nova plataforma e chega agora à versão 3.1.2.

Reescrito para a nova API

Nova autenticação OAuth2, nova camada de dados e todos os endpoints remapeados. O token é renovado sozinho pelo cron e, se a renovação falhar, o módulo avisa na própria página do módulo em vez de falhar em silêncio.

O financeiro fecha sozinho

• Venda fiel à fatura. Itens, descontos e tributos entram exatamente como o cliente pagou, com o total idêntico ao do WHMCS
• Baixa automática no contas a receber. Fatura paga vira parcela baixada na conta financeira escolhida, com o método de pagamento equivalente ao gateway usado
• Classificação pronta. Categoria de receita e centro de custo em cada venda, alimentando fluxo de caixa e DRE sem retrabalho
• Nada é duplicado. Cada fatura carrega a marca da venda e da baixa. Reprocessar uma fatura, refazer um pagamento ou rodar o cron duas vezes não gera lançamento repetido
• Nada se perde. Vendas e baixas que esbarram em indisponibilidade da API voltam para uma fila e são reprocessadas pelo cron

Notas fiscais no lugar certo

As NFS-e e NF-e emitidas no Conta Azul são relacionadas às faturas de origem, com sincronização diária pelo cron e botão de sincronização manual. O cliente baixa o PDF e o XML numa seção dedicada da área do cliente, no mesmo formato da página de faturas, sem nenhuma alteração no template do WHMCS.

Configuração que se resolve sozinha

• Campos personalizados de cliente e de produto criados na ativação, sem configuração manual
• Detecção automática de CPF e CNPJ, com campo único ou campos separados
• Importação em massa dos clientes já existentes, em lote pelo cron, com cursor que retoma de onde parou
• Serviços associados por nome quando já existem e criados quando não existem, sem duplicar
• Controle de acesso por grupo de administradores e log completo das chamadas com o Debug ligado

Requisitos

• WHMCS 8.x ou superior
• PHP 8.2 a 8.4, com cURL e ionCube Loader 15 ou superior
• Cron do WHMCS ativo
• Conta no Conta Azul com acesso à API e pelo menos uma conta financeira cadastrada

Como atualizar

Se você já é cliente, a versão mais recente está disponível na sua área do cliente. Substitua a pasta modules/addons/gofascontaazul, acesse o módulo uma vez para aplicar as atualizações e refaça a autorização no Conta Azul, já na nova API.

Se você desinstalou o módulo quando a integração parou de funcionar, é este o momento de voltar. A causa era o desligamento da API antiga e ela não existe mais em nenhuma ponta.

Ainda não usa

Conheça o módulo e adquira sua licença em gofas.net/gca.

Dúvidas ou sugestões, fale com o nosso suporte.