Fatura paga no WHMCS vira NFS-e no Bling. Uma nota por fatura, sem digitar de novo.

O módulo Bling para WHMCS que encontrei à venda custa R$ 19,98 por mês, cerca de R$ 240 por ano, e há reclamações dele no Portal do Host. O Brasa Conector Bling custa R$ 99,90 por ano, roda inteiro no seu WHMCS e usa o seu próprio aplicativo do Bling.

Cada fatura paga vira uma NFS-e com o tomador, o código do serviço que você informar e o total da fatura. ISS, item da lista de serviços e numeração do RPS vêm das configurações de NFS-e do seu Bling. Com o envio automático ligado, a nota vai à prefeitura na hora e o número e o link aparecem na tela do módulo; desligado, ela fica pendente no Bling para você conferir e emitir por lá.

Entra pelo CPF ou CNPJ, do campo Tax ID do WHMCS ou de um campo personalizado que você indicar. Contato que já existe no Bling não é cadastrado de novo. O endereço sai do cadastro do cliente: rua com o número depois da vírgula, Endereço 2 como bairro, cidade, estado e CEP. Cliente sem documento ou sem bairro e cidade para antes de chamar o Bling, e a tela diz o que preencher.

Não. A NFS-e do Bling não tem um código nosso, então o módulo guarda a hora do envio antes de enviar. Se a resposta do Bling se perder no caminho, a próxima tentativa procura a nota daquele dia com o mesmo CPF ou CNPJ e o mesmo valor que nenhuma outra fatura pegou. Se achar duas iguais, ele para e pede para você conferir no Bling, em vez de emitir outra.

A fatura espera na fila e o cron do WHMCS tenta de novo, cinco vezes, com espera crescente. Recusa do Bling ou da prefeitura aparece na tela com o motivo e o botão Reenviar. A recusa da prefeitura não apaga a nota: ela fica no Bling para você corrigir e emitir.

Um plano com Notas Fiscais de Serviço e o seu usuário com permissão nelas: sem isso, o próprio Bling não deixa autorizar o aplicativo. A NFS-e precisa estar configurada para a sua prefeitura (certificado, série, RPS e tributos) e o serviço cadastrado com um código.

Pelo seu próprio aplicativo, criado de graça na Área do Integrador do Bling com o link 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 do Bling. 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 módulo passou por um WHMCS de teste com o fluxo inteiro contra um Bling simulado, que recusa o que a documentação oficial da API não aceita, com a resposta perdida, a nota repetida e a fila, e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. A emissão real da NFS-e não foi testada aqui, porque a nossa conta de teste do Bling não tem o módulo de notas de serviço, e cada prefeitura tem a sua regra. Por isso o preço é de R$ 99,90 e não R$ 197. Antes de ligar o envio automático, pague uma fatura pequena para você mesmo com ele desligado e confira a nota no Bling.

A versão 0.2 manda as faturas pagas depois da ativação e, se você escolher a data em “Pagas desde”, também as anteriores, sem repetir as que já foram. Reembolso no WHMCS não cancela a NFS-e: cancele no Bling. Contas a receber e pedido de venda no Bling ficam de fora: o módulo faz só a nota. Se precisar de uma dessas, chame no WhatsApp.

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 ao seu Bling para criar o aplicativo e autorizar.

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.