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 um número de 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 e na página do módulo
- Envio automático à prefeitura depois da criação da nota, com número máximo de tentativas configurável
- Reemissão da nota cancelada, pela página do módulo
- NFS-e apenas para clientes específicos, via campo personalizado "Emitir NFE" no perfil do cliente
- Emissão apenas para pessoa jurídica, pelo CNPJ do cadastro
- Conjunto de tributações por produto: um conjunto geral para todos os serviços ou um conjunto específico para cada serviço do WHMCS
- Notas fiscais na área do cliente. Seção dedicada no front end, sem interferir no template do WHMCS
- NFS-e na própria fatura, com número, série, data de emissão, situação, código de verificação e link de consulta na prefeitura
- Página de detalhes da nota, com os mesmos dados e o link de consulta
- Aviso por email ao cliente quando a NFS-e é emitida, por template próprio 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 escolhidos em listas alimentadas pela própria conta Bling
- Recorrência replicada na conta a receber, conforme o ciclo do serviço no WHMCS
- API v3 do Bling com autenticação OAuth 2.0, por Client Id e Client Secret e com repetição automática das requisições quando o Bling limita a chamada
- Fila de processamento com retentativas, para contas a receber e para o envio da NFS-e, com limite de contas a receber por execução
- 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
- Aviso por email ao administrador quando a emissão falha
- Registro de diagnóstico no Log de Módulo do WHMCS, opcional
- Envio de estatísticas de uso, opcional e com consentimento
- WHMCS 8.x ou superior
- PHP 8.2 a 8.4, com cURL e ionCube Loader 15 ou superior
- Cron do WHMCS ativo
- Conta Bling com a API v3 habilitada e um aplicativo cadastrado, para obter Client Id e Client Secret
- Dados da empresa, certificado digital e configurações de NFS-e ativos 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.
- Conjunto de Tributações: identificador do conjunto de tributações aplicado a todos os serviços e itens de fatura do WHMCS. Localize-o no painel do Bling em
ícone do perfil > Todas as configurações > Serviços > Configurações de NFS-e, na seção Conjunto de tributações. - Vincular um conjunto de tributações a cada respectivo serviço do WHMCS: conjunto específico por produto/serviço. Deixe em branco os que usam o conjunto 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.
Na página de edição de cada fatura, o administrador vê o número e a situação da NFS-e vinculada e pode emitir, editar no painel Bling ou visualizar a nota.
O menu "Minhas Notas Fiscais" na área do cliente lista as notas emitidas para ele.
Cada nota tem uma página com os dados completos e o link de consulta na prefeitura.
A própria fatura exibe a NFS-e vinculada, com número, situação, código de verificação e o link de consulta.
- Atualização da v2 para a v3: o campo Conjunto de Tributações substitui o antigo Código de Serviço. Quem vem da v2 tem gravado ali o código da lista de serviços da LC 116 (por exemplo
1.03), que a API v3 do Bling recusa. Antes de emitir notas na v3, troque o valor desse campo e dos campos por produto pelo identificador do conjunto de tributações da sua conta Bling. - 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.
Melhorias:
- NFS-e na fatura do cliente: adotar o formato da tabela Livro contábil - #99
- readme: seção Funcionalidades não reflete o que a v3 entrega - #98
- NFS-e na fatura do cliente: mover para o rodapé e ampliar dados e botões - #97
- Página do addon: botão Visualizar NFS-e sempre desabilitado e situação Disponível para consulta não tratada - #96
- consent_stats não definido é tratado como recusa, contrariando o default yes - #95
- Erro de JavaScript na página de detalhes da NFS-e: elemento do menu não existe - #94
- Detalhes da NFS-e sempre vazio: verificação de posse compara id de usuário com id de cliente - #93
- Tela de configurações não exibe o selo de status da licença - #92
- Hooks inativos: condição de licença legada não existe mais após a refatoração do synchronize.php - #91
- Fatura do cliente: exibir a NFS-e em painel (estilo gnfa) em vez de botão - #90
- Área do cliente: refazer viewnfse com painel branded - #89
Melhorias:
- Tela de config: versão local vazia quando o embed retorna vazio - #88
- NFS-e v3: mapear situacao e campos pela documentação (schema real) - #87
- Remover definições duplicadas em includes/functions.php - #86
- NFS-e v3 Etapa 3: limpeza do transporte v2 e telas admin - #85
- NFS-e v3 Etapa 2: sync de status e PDF/link/XML no WHMCS - #84
- Religar emissão e envio da NFS-e à API v3 (issuenfse) - #83
- Recorrência da conta a receber na v3: códigos de ocorrencia.tipo levantados por sondagem da API - #82
- Bling limita POSTs seguidos em /contas/receber e o módulo perde lançamentos em lote - #81
- Categoria e Vendedor viram listas alimentadas pela conta Bling - #80
- Separação de logradouro, número e complemento falha quando o nome da rua tem número - #79
- Atualização da v2 para a v3: trocar o Código de Serviço pelo Conjunto de Tributações do Bling - #78
- Renomear o prefixo gblg_ para gbl_ (retoma a #66) - #77
- Implementar a telemetria padrão Gofas - #76
- Auditar entrypoints web sem guarda WHMCS - #75
- Remover os condicionais de PHP 7.4 e os requires órfãos - #74
- Revisar a verificação de licença conforme o padrão do gca - #73
- Migrar contatos, produtos, contas a receber e NFS-e para a API v3 - #72
- Criar lib/gbl_api.php com OAuth 2.0 e retry - #71
- Reconstrução do módulo para a API v3 do Bling (v3.0.0) - #70
- Remover o diretório includesd (variante PHP 7.4) - #69
- 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
- Enviar NFS-e à prefeitura após a criação - #41
enhancement - Emitir NFS-e apenas para pessoa jurídica (cadastros que possuem CNPJ) - #38
enhancement - Incluir hooks da pasta /hooks/ automaticamente - #35
enhancement - verificar a existência da fatura antes de exibr as NFS-es - #32
- Email admin em caso de erros - #8
enhancement - Download da nota fiscal na fatura - #4
enhancement - Email com NFS-e quando status é Emitida - #2
enhancement
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