Integra o ERP Bling ao WHMCS: emite as notas fiscais de serviço (NFS-e) das suas faturas, exporta clientes e produtos, e cria as contas a receber, tudo automaticamente. Desenvolvido pela Gofas Software.
- Emissão automática de NFS-e. A nota é emitida quando a fatura é gerada ou quando é paga, com opção de agendar a emissão para alguns dias após o pagamento
- Emissão manual de NFS-e. Botões de ação na edição da fatura, no admin do WHMCS
- Notas fiscais na área do cliente. Seção dedicada no front end, sem interferir no template do WHMCS
- Exportação de clientes. O cliente cadastrado no WHMCS é criado como contato no Bling
- Exportação de produtos e serviços. Cada produto/serviço do WHMCS é criado no Bling, como produto ou como serviço, conforme a configuração
- Contas a receber. Cada fatura publicada no WHMCS gera uma conta a receber no Bling, com categoria e vendedor configuráveis
- Sincronização agendada. Status das notas, envio à prefeitura e demais verificações, uma vez por dia ou a cada 5 minutos, via cron do WHMCS. Também é possível sincronizar manualmente
- NFS-e apenas para clientes específicos, via campo personalizado "Emitir NFE" no perfil do cliente
- Código de serviço por produto: um código geral para todos os serviços, ou um código específico para cada serviço do WHMCS
- WHMCS >= 7.0
- PHP 7.4 a 8.3
- Conta Bling com API habilitada
- Dados da empresa e certificado digital configurados na conta Bling
- Baixe o módulo na sua área do cliente e descompacte.
- Copie a pasta
modules/addons/gofasblingpara o diretóriomodules/addons/da sua instalação WHMCS. - Ative o módulo em
Configurações > Módulos Addons.
- Configure o certificado digital e os dados da empresa na sua conta Bling.
- Habilite a emissão de NFS-e e configure a integração com a prefeitura, conforme o manual Bling.
- Gere a chave de API da sua conta Bling e guarde para usar na configuração do módulo.
- Chave de licença: obtida ao adquirir o módulo.
- API Key: chave de API da sua conta Bling.
- Debug: salva informações de diagnóstico no Log de Módulo do WHMCS.
- Exportar clientes: cadastra o cliente no Bling quando ele é cadastrado no WHMCS. Mesmo desativada, o cliente é criado no Bling na emissão da NFS-e.
- Exportar produtos/serviços: cria o produto no Bling quando um produto ou serviço é criado no WHMCS.
- Criar produtos ou serviços: define se os produtos/serviços do WHMCS correspondem a produtos ou a serviços no Bling.
- Criar Contas a Receber: cria a conta a receber no Bling quando a fatura é publicada no WHMCS.
- Categoria: categoria das contas a receber criadas.
- Vendedor: vendedor das contas a receber criadas.
- Emitir NFS-e: quando a fatura é gerada ou quando é paga.
- Agendar Emissão: número de dias após o pagamento da fatura para emitir a nota. Preencher esse campo desativa a opção anterior.
- Emitir NFE para: todos os clientes ou clientes selecionados via campo personalizado "Emitir NFE" (checkbox).
- Sincronizar NFS-e, clientes, serviços e contas a receber: frequência da sincronização agendada, uma vez por dia ou a cada 5 minutos.
- Código de Serviço: código único aplicado a todos os serviços e itens de fatura do WHMCS. Consulte as tabelas de códigos.
- Vincular Código de Serviço a cada respectivo serviço do WHMCS: código específico por produto/serviço. Deixe em branco os que usam o código geral.
Acesse Configurações > Módulos Addons > Gofas Bling. A página lista as NFS-e emitidas pela integração, com informações da fatura e do cliente, e as ações disponíveis conforme o status de cada nota.
- Campo personalizado CPF/CNPJ: crie um campo personalizado de cliente para CPF e/ou CNPJ. O módulo identifica o campo automaticamente pelo nome.
- Endereço: preencha no formato padrão do WHMCS, com logradouro e número na mesma linha (campo "Endereço 1"), ex.: "Avenida Brasil, 1234".
- Erro ao enviar a NFS-e à prefeitura: normalmente indica configuração incompleta na conta Bling ou pendência junto à prefeitura, como o certificado digital. Emita a nota manualmente para ver a mensagem retornada pela prefeitura.
- Sempre faça backup antes de alterar qualquer coisa no seu sistema.
- Personalizações podem ser feitas por hooks, sem editar o código do módulo, mantendo a atualização possível.
Abrir issue no fórum do módulo.
Software proprietário da Gofas Software, protegido pela Lei 9.609/98 e pelos tratados de direitos autorais. A aquisição concede licença de uso, não a titularidade do software.
Trechos do contrato de licença de uso:
- Não redistribuir: é proibido o aluguel, o arrendamento, o empréstimo, a cessão e o licenciamento do software a terceiros, total ou parcial, assim como o fornecimento de serviços de hospedagem comercial do software (Cláusula 10ª, §3º).
- Não modificar: é vedado qualquer procedimento que implique engenharia reversa, descompilação, desmontagem, tradução, adaptação ou modificação do software, bem como qualquer alteração não autorizada de suas funcionalidades (Cláusula 10ª, §2º).
- Módulo alterado perde o suporte: a Gofas não se responsabiliza por defeitos decorrentes de alteração do software, de operação por pessoas não autorizadas ou da integração com softwares de terceiros (Cláusula 10ª, §7º). O suporte é uma cortesia e não é garantido pela licença (Cláusula 7ª, §1º).
Melhorias:
- Padronizar readme.md e criar a página do módulo (13633) - #68
- Link de suporte aponta para post inexistente (?p=12313) - #67
- Renomear prefixo gblg_ para gbl_ - #66
Correções:
Correções:
- Corrigido o erro no front end quando não há emissões array_keys(): Argument #1 ($array) must be of type array output.php:83 - #64
bug
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Compatibilidade com PHP 7.4 e 8.1 no mesmo módulo - #63
enhancement - Previne erro retornado no PHP 8 ao processar uma variável como array quando a mesma é string - #62
- Melhoria na obtenção de informações da instalação do WHMCS - #61
- Corrigido o erro retornado em consultas em massa quando o cliente não possui serviços ou produtos associados à sua conta - #60
- Dispensa a necessidade de selecionar o admin do WHMCS nas configurações. Agora o admin que realiza a instalação é definido como responsável pelas chamadas à API interna do WHMCS - #58
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Link "sincronizar" removido da página de exibição das NFS-es no admin - #40
enhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Template da área do cliente adaptado para os padrões técnicos do WHMCS 8.6+ - #59
- Corrigido o erro que quebrava o layout da edição de faturas no WHMCS v8.6+ - #56
- Substitui separador de itens da fatura por quebra de linha na descrição dos serviços da NFS-e - #48
enhancement - Melhora formatação dos links das notas fiscais na página de edição das faturas - #47
enhancement - Obtém URLs do sistema a partir das configurações gerais utilizando funções nativas do WHMCS - #46
enhancement - Atualizar status da NFS-e cancelada ao sincronizar - #42
enhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- compatibilidade php8+ - #54
bugenhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Sincronização de serviços - #53
enhancement - Sincronização de clientes - #52
enhancement - Contas a receber - #51
enhancement - Adiciona novos dados ao Log - #49
enhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Agrupa itens de linha da fatura no campo serviços para evitar erros de integração - #45
enhancement
Correções:
- Corrige a obtenção do número no endereço do cliente quando este está na mesma linha do nome da rua - #44
bug
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Nova Opção: Vincular Código de Serviço aos respectivos serviços no WHMCS - #39
enhancement - Campo "Emitir NFE" no perfil do cliente - #37
enhancement - Adicionar hook EmailPreSend para gerar NFS-e ao gerar a fatura via cron diário - #36
bugenhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- Campo "Emitir NFE" no perfil do cliente - #37
enhancement - Adicionar hook EmailPreSend para gerar NFS-e ao gerar a fatura via cron diário - #36
bugenhancement
Vale mencionar:
- Documentação e lançamento - #1
documentation
Melhorias:
- User-Agent no header da requisição ao verificar atualizações no gofas.net - #33
enhancement - Suporte ao custom field "número" - #28
enhancement - Limita a 100 caracteres a descrição de serviços gerada a partir dos itens de linha da fatura - #27
duplicateenhancement - Melhora formatação do endereço quando Logradouro + nº estão na mesma linha (address1) - #25
enhancement - Suporte a custom field "Inscrição Estadual" - #23
enhancement - Remove função depreciada - #16
enhancement - Suporte ao custom field "complemento" - #12
enhancement
Correções:
- Verificar a obtenção de todos os items de linha da fatura ao definir os serviços da NFS-e - #31
bug - Corrigido erro no nome da setting gblglocalkey (estava gblggblglocalkey) - #30
bug - Inclui ID da fatura no campo "número da loja" de NFS-es geradas sob agendamento - #26
bug - Aprimorada a obtenção de dados do cliente da função gblg_customer - #20
bug - Erro de exibição na área do cliente em versões do WHMCS menor que 8.0 - #18
bug
Documentation:
- Automatização e aprimoramento do log de alterações (Changelog) - #34
documentation - Documentação e lançamento - #1
documentation
Melhorias:
- Remove função depreciada - #16
enhancement - Notas sequenciais via cron - #10
enhancement - Opção: código de serviço - #9
enhancement - Página com lista de notas fiscais na área do cliente - #3
enhancement
Documentation:
- Lista de Prefeituras que possuem integração com o Bling para emissão de NFS-e - #19
documentation - Tela de configuração - #11
documentation - Documentação e lançamento - #1
documentation