Fatura paga vira venda
Cada fatura paga no WHMCS vira uma venda aprovada na sua Conta Azul, com o serviço e o total certos.
Módulo para WHMCS · Conta Azul · GPL
Fatura paga no WHMCS vira venda na Conta Azul. Pronta para emitir a NFS-e, uma venda por fatura.
Se a sua empresa emite pela Conta Azul, cada fatura paga no WHMCS vira uma venda aprovada lá, com o cliente pelo CPF ou CNPJ e o serviço que você vende. Você para de digitar a venda duas vezes e emite a NFS-e na Conta Azul como já faz.
BR.S2 — O que o plugin faz
O cliente paga no WHMCS. A venda aparece na Conta Azul.
Pronta para a NFS-e
A venda chega com o serviço cadastrado na Conta Azul, e a NFS-e sai dela como você já faz.
Cliente pelo CPF ou CNPJ
O cadastro na Conta Azul é achado pelo documento ou pelo e-mail exato, sem cliente repetido.
Uma venda por fatura
Número guardado antes de enviar e código da fatura na venda: resposta perdida não duplica.
Fila que não perde
Conta Azul fora do ar: a fatura espera e o cron tenta de novo. Recusa mostra o motivo e o Reenviar.
Aplicativo só seu
Seu aplicativo da Conta Azul, com os tokens cifrados no seu WHMCS. Nada passa por servidor nosso.
Provado na API real da Conta Azul numa conta de teste: a fatura paga virou a venda aprovada com o valor e o serviço certos, a resposta perdida achou a mesma venda em vez de criar outra, e o mesmo CPF não virou um segundo cliente. O pacote foi carregado num WHMCS 9 de verdade.
R$ 197 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por fatura. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. O plano da Conta Azul é o seu, contratado direto com a Conta Azul.
BR.S3 — Como fica no WHMCS
A tela do módulo no seu WHMCS.
A tela é o HTML que o módulo gera, com dados de exemplo. No seu WHMCS, a lista mostra as suas faturas e as vendas da sua Conta Azul.
BR.S4 — Como instalar
Três passos, e o WHMCS já manda as vendas para a Conta Azul.
1. Envie os arquivos
Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria a pasta modules/addons/brasacontaazul.
2. Ative e autorize
Em Configurações, Módulos adicionais, ative o Brasa Conector Conta Azul e abra a tela dele em Addons. Crie o aplicativo na Conta Azul com a URL que ela mostra, cole o client_id e o client_secret e clique em Autorizar.
3. Escolha e confira
Escolha o serviço, a categoria e a conta financeira, pague uma fatura pequena para você mesmo e veja a venda na Conta Azul.
BR.S5 — Perguntas frequentes
O que perguntam antes de comprar.
Por que não o módulo que já existe?
O módulo Conta Azul para WHMCS que encontrei à venda custa R$ 19,98 por mês, cerca de R$ 240 por ano. O Brasa Conector Conta Azul custa R$ 197 por ano, roda inteiro no seu WHMCS e usa o seu próprio aplicativo da Conta Azul.
O que vai para a Conta Azul?
Cada fatura paga vira uma venda aprovada com o cliente, o serviço que você escolheu e o total da fatura, na data do pagamento, com a forma de pagamento (Pix, boleto, cartão), a categoria de receita e a conta financeira que você escolher. Os itens da fatura vão nas observações. A NFS-e sai da venda na própria Conta Azul, do jeito que você já emite lá.
E o cliente?
Entra pelo CPF ou CNPJ, do campo Tax ID do WHMCS ou de um campo personalizado que você indicar, e, sem documento, pelo e-mail exato. Cliente que já existe na Conta Azul não é cadastrado de novo.
Uma fatura pode virar duas vendas?
Não. O número da venda fica guardado no seu WHMCS antes de enviar, e cada venda leva nas observações um código desta instalação e da fatura. Se a resposta da Conta Azul se perder no caminho, a próxima tentativa acha a venda que já existe em vez de criar outra. Duas faturas ao mesmo tempo também não brigam pelo mesmo número.
E se a Conta Azul estiver fora do ar?
A fatura espera na fila e o cron do WHMCS tenta de novo, cinco vezes, com espera crescente. Recusa da Conta Azul aparece na tela com o motivo e o botão Reenviar. Se a autorização vencer de vez, a tela pede para autorizar de novo e as faturas esperam.
Preciso cadastrar o serviço na Conta Azul?
Sim, o serviço que você vende (hospedagem, domínio, suporte) cadastrado em Serviços na Conta Azul, porque é ele que traz o código e os impostos da NFS-e. Na tela do módulo você escolhe esse serviço numa lista lida da sua Conta Azul, junto com a categoria e a conta financeira.
Como o WHMCS se conecta à minha Conta Azul?
Pelo seu próprio aplicativo, criado de graça no Portal do Desenvolvedor da Conta Azul com a URL que a tela do módulo mostra. Você cola o client_id e o client_secret, clica em Autorizar e entra com o seu usuário da Conta Azul. O aplicativo e os tokens ficam cifrados no banco do seu WHMCS, com o segredo da sua instalação, e nada passa por servidor nosso.
O que já foi testado, e o que não foi?
O módulo passou por um WHMCS de teste com o fluxo inteiro contra uma Conta Azul simulada, que recusa o que a documentação oficial não aceita, e foi provado na API real da Conta Azul, numa conta de teste: a fatura paga virou a venda aprovada com o valor e o serviço certos, a resposta perdida achou a mesma venda em vez de criar outra, e o segundo pagamento do mesmo CPF não cadastrou o cliente de novo. O pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A tela de autorização com o seu aplicativo e a emissão da NFS-e não foram testadas aqui, porque dependem da sua conta. Antes de seguir, pague uma fatura pequena para você mesmo e confira a venda na Conta Azul.
E as faturas pagas antes de instalar?
A versão 0.1 manda só as faturas pagas depois da ativação. Reembolso no WHMCS também não cancela a venda na Conta Azul: cancele lá. Se precisar de uma dessas, chame no WhatsApp.
O que preciso para instalar?
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, o cron do WHMCS ativo e acesso de administrador à sua Conta Azul para criar o aplicativo e autorizar.
E se eu não renovar a licença?
O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte. Pagou depois, ela volta a ficar ativa sozinha.
BR.S6 — Suporte
Seu WHMCS tem algo diferente?
Faturas antigas, cancelar a venda no reembolso e emitir a NFS-e pelo WHMCS ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira fatura não chegar à Conta Azul, chame no WhatsApp. Você fala com quem escreveu o módulo.