Ir para o conteúdo

Módulo Bling para WHMCS

Automatiza a emissão de notas fiscais da sua empresa

&

Agora, com o Módulo Gofas Bling para WHMCS, você pode automatizar a emissão notas fiscais de serviço (NFS-e) da sua empresa, integrando o Bling, um poderoso sistema de gestão empresarial, ao WHMCS, o mais completo sistema para recebimento de cobranças. 

COMPRAR AGORA

✓ Compatível com PHP 7.4 e PHP 8.1;

Principais funcionalidades

✓ Emissão automatizada de notas fiscais. Cria notas fiscais (NFS-e) automaticamente quando uma fatura é gerada ou paga no WHMCS;

✓ Emissão agendada de notas fiscais. Você pode definir um prazo após a data de pagamento das faturas para a emissão das notas fiscais. Útil em vários cenários onde é necessário aguardar confirmações, como por exemplo, de pagamento com cartão;

✓ Emissão manual de notas fiscais. Adiciona botões de ação na página de edição das faturas que permitem emitir, editar e visualizar as NFS-es de cada fatura do WHMCS;

✓ Criação de "contas a receber". Cria Contas a Receber no Bling quando uma fatura é publicada de acordo com as configurações de faturamento e ciclos definidas no WHMCS;

✓ Sincronização de notas fiscais. Você escolhe a frequência de sincronização de status das notas fiscais junto à prefeitura e o módulo atualiza periodicamente a situação de todas as notas fiscais armazenadas no WHMCS;

✓ Sincronização de clientes. Cria nova conta de cliente no Bling quando o mesmo é cadastrado no WHMCS. Contas de clientes também são criados no Bling quando NFS-es são emitidas ou contas a receber são criadas;

✓ Sincronização de produtos e serviços. Cria novo produtos ou serviços no Bling quando um produtos/serviço é criado no WHMCS. Quando um serviço é alterado no WHMCS o mesmo é atualizado no Bling;

✓ Painel administrativo de notas fiscais. Fornece uma interface visual intuitiva e fácil de usar no painel administrativo do WHMCS, com a lista de todas as notas fiscais criadas via integração, onde é possível verificar a situação de cada NFS-e e diversas informações relacionadas às notas, faturas e clientes, além de poder executar ações como, sincronizar, emitir, reenviar à prefeitura, editar, visualizar etc;

✓ Notas fiscais na área do cliente. Adiciona uma sessão exclusiva ao front end do WHMCS + um item no menu, onde seus clientes podem acessar todas as notas fiscais geradas para sua conta, além de verificar diversas informações, em uma interface semelhante a página de faturas da área do cliente, sem interferir no design do template do seu WHMCS;

✓ Diversos códigos de serviço. Permite definir o código de serviço "geral" + um código de serviço específico para cada serviço do WHMCS ao emitir as notas fiscais;

✓ NFS-e apenas para clientes específicos. Ao selecionar essa opção nas configurações o módulo emite notas fiscais apenas para clientes que possuam o campo personalizado "Emitir NFE" ativado no perfil;

✓ Suporte a todos os campos. O módulo detecta automaticamente CPF, CNPJ, Inscrição Estadual, Complemento e Número nos custom fields de cliente do WHMCS. Você não precisa configurar nada mais e o melhor: apenas o campo CPF ou CNPJ são obrigatórios, caso os endereços no seu WHMCS sigam o padrão "Nome da rua, nº", o módulo também vai detectar automaticamente;

✓ E muito mais...

Capturas de tela

Configuração do Bling

Para que o módulo funcione sua conta Bling deve estar apta a emitir notas fiscais, para isso há algumas configurações essenciais que devem ser verificadas antes de configurar o módulo:

  1. Configurar um certificado digital;
  2. Completar as informações da empresa;
  3. Completar a configuração da nota de serviço;
  4. Criar um usuário API com as permissões a seguir:

Instalação do módulo

  • Copie a pasta /modules/addons/gofasbling/ para dentro do diretório padrão de módulos addons do WHMCS: /whmcs/modules/addons/.
  • Ative o Addon em Opções > Módulos Addons;
  • Após a ativação, defina os grupos de administradores que terão acesso à tela de configuração. Apenas usuários autorizados a acessar o painel Bling devem ter acesso à essa área.

Configuração do módulo

    • Chave de licença: Obtida ao adquirir o módulo;
    • API Key: Insira a chave obtida ao criar o usuário API;
    • Administrador do WHMCS: Defina o administrador com permissões para utilizar a API interna do WHMCS;
    • Exportar clientes: Cadastra novo cliente no Bling quando cadastrado no WHMCS (clientes são criados no Bling quando NFS-es são emitidas, mesmo desativando essa opção);
    • Exportar produtos/serviços: Cria novo produtos no Bling quando um produtos/serviço é criado no WHMCS;
      • Escolha abaixo se os produtos/serviços do WHMCS devem corresponder a produtos ou serviços no Bling;
    • Criar Contas a Receber: Marque essa opção para criar Conta a Receber no Bling quando uma fatura é publicada no WHMCS;
      • Defina abaixo a categoria e o nome do vendedor das contas a receber criadas quando faturas forem publicadas;
    • Quando criar as NFS-e: Você pode escolher se o módulo deve emitir as notas quando a fatura é gerada, ou quando a fatura é paga;
    • Emitir NFE para: Escolha gerar as notas para "todos os clientes" ou "clientes selecionados". Para a opção Emitir NFE para: clientes selecionados funcionar é obrigatório existir um campo personalizado do tipo checkbox (Caixa de Opções) com o nome "Emitir NFE" ativado nas contas que terão NFEs emitidas automaticamente. Essa opção não desativa a emissão manual de notas;
    • Agendar Emissão: Número de dias após o pagamento da fatura que as notas devem ser emitidas. Preencher essa opção desativa a opção anterior e se aplica apenas à faturas pagas;
    • Sincronizar NFS-e: Escolha a frequência de sincronização de status e envio das notas fiscais à prefeitura. Você também poderá sincronizar manualmente sempre que desejar na interface administrativa do módulo;
    • Código de Serviço: Código de serviço relativo aos serviços prestados (mais informações no manual Bling). Mesmo que seja configurado um código de serviço para cada produto do WHMCS (opção a seguir), é necessário definir neste campo um código "geral" que será utilizado em faturas que não possuem um produto/serviço do WHMCS associado à elas;
    • Vincular Código de Serviço a cada respectivo serviço do WHMCS: O módulo exibirá na tela de configurações um campo de texto para cada serviço/produto cadastrado no seu WHMCS. Você pode deixar em branco para utilizar o "código de serviço geral" ou definir um código diferente para cada serviço do WHMCS;
    • Debug: Salva informações de diagnóstico no Log de Módulo do WHMCS.

Gerenciamento via WHMCS

    • Após a ativação do módulo acesse no painel administrativo do WHMCS o menu Opções > Módulos Addons > Gofas Bling;

      Nessa página são exibidas todas as NFS-es emitidas via integração, com informações sobre as respectivas faturas e clientes aos quais as notas fiscais pertencem.

      As ações disponíveis podem variar de acordo com o status das notas fiscais, na captura de tela a seguir é possível entender cada opção de gerenciamento.

Informações importantes

    • Versão mínima do WHMCS: 8.0;
    • Versão mínima do PHP: 8.1;

    • Lista de Prefeituras que possuem integração com o Bling para emissão de NFS-e:
      https://ajuda.bling.com.br/hc/pt-br/articles/360039971653-Lista-de-Prefeituras-que-possuem-integra%C3%A7%C3%A3o-com-o-Bling-para-emiss%C3%A3o-de-NFS-e

    • Campo personalizado CPF/CNPJ: É necessário criar um campo personalizado de cliente nas configurações do WHMCS para CPF ou CNPJ. Você pode criar apenas um campo onde o cliente pode preencher com CPF ou CNPJ, ou então criar dois campos distintos, um para cada documento. O módulo identifica automaticamente os campos personalizados pelos seus respectivos nomes;
    • Endereço: Endereços devem ser preenchidos no formato padrão do WHMCS, com logradouro e nº na mesma linha (campo "endereço 1"[address 1]), exemplo:
      "Avenida Brasil, 1234";
    • Campo personalizado Número: O número do endereço do cliente pode ser preenchido em um campo personalizado individual. O módulo detecta o campo pelo nome;
    • Campo personalizado Inscrição estadual: Não é obrigatório na maioria dos casos. Para preencher o valor "Inscrição Estadual" do cliente nas notas fiscais crie um campo personalizado com o nome "Inscrição estadual" (exatamente assim). O módulo detecta o campo pelo nome;
    • Erro ao enviar NFS-e à prefeitura: Indica que alguma configuração na sua conta Bling está incompleta ou há alguma autorização de acesso pendente junto à prefeitura, como por exemplo, o cadastramento do certificado digital. Tente enviar as notas fiscais manualmente para obter a mensagem de erro retornada pela prefeitura e entre em contato com o suporte Bling. Veja aqui como enviar notas de serviço à prefeitura.

Histórico de atualizações

    • Changelog

      v2.2.2 (29/11/2023)

      Full Changelog

      Fixed bugs:

      • Corrigidos os erros de compatibilidade do PHP na tela de notas no admin #65

      v2.2.1 (28/11/2023)

      Full Changelog

      Fixed bugs:

      • 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

      v2.2.0 (06/04/2023)

      Full Changelog

      Implemented enhancements:

      • Compatibilidade com PHP 7.4 e 8.1 no mesmo módulo #63

      Closed issues:

      • 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

      v2.1.2 (24/03/2023)

      Full Changelog

      Implemented enhancements:

      • Link "sincronizar" removido da página de exibição das NFS-es no admin #40

      v2.1.1 (23/03/2023)

      Full Changelog

      Implemented enhancements:

      • Substitui separador de itens da fatura por quebra de linha na descrição dos serviços da NFS-e #48
      • Melhora formatação dos links das notas fiscais na página de edição das faturas #47
      • Obtém URLs do sistema a partir das configurações gerais utilizando funções nativas do WHMCS #46
      • Atualizar status da NFS-e cancelada ao sincronizar #42

      Closed issues:

      • 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

      v2.1.0 (05/03/2023)

      Full Changelog

      Implemented enhancements:

      • compatibilidade php8+ #54

      v2.0.0 (05/03/2023)

      Full Changelog

      Implemented enhancements:

      • Sincronização de serviços #53
      • Sincronização de clientes #52
      • Contas a receber #51
      • Adiciona novos dados ao Log #49

      v1.2.1 (07/07/2021)

      Full Changelog

      Implemented enhancements:

      • Agrupa itens de linha da fatura no campo serviços para evitar erros de integração #45

      Fixed bugs:

      • Corrige a obtenção do número no endereço do cliente quando este está na mesma linha do nome da rua #44

      v1.2.0 (20/05/2021)

      Full Changelog

      Implemented enhancements:

      • Nova Opção: Vincular Código de Serviço aos respectivos serviços no WHMCS #39

      v1.1.0 (04/05/2021)

      Full Changelog

      Implemented enhancements:

      • Campo "Emitir NFE" no perfil do cliente #37
      • Adicionar hook EmailPreSend para gerar NFS-e ao gerar a fatura via cron diário #36

      v1.0.1 (11/02/2021)

      Full Changelog

      Implemented enhancements:

      • User-Agent no header da requisição ao verificar atualizações no gofas.net #33
      • Suporte ao custom field "número" #28
      • Melhora formatação do endereço quando Logradouro + nº estão na mesma linha (address1) #25
      • Suporte a custom field "Inscrição Estadual" #23
      • Remove função depreciada #16
      • Suporte ao custom field "complemento" #12

      Fixed bugs:

      • Verificar a obtenção de todos os items de linha da fatura ao definir os serviços da NFS-e #31
      • Corrigido erro no nome da setting gblglocalkey (estava gblggblglocalkey) #30
      • Inclui ID da fatura no campo "número da loja" de NFS-es geradas sob agendamento #26
      • Aprimorada a obtenção de dados do cliente da função gblg_customer #20
      • Erro de exibição na área do cliente em versões do WHMCS menor que 8.0 #18

      Closed issues:

      • Automatização e aprimoramento do log de alterações (Changelog) #34

      v1.0.0 (03/02/2021)

      Full Changelog

      Implemented enhancements:

      • Notas sequenciais via cron #10
      • Opção: código de serviço #9
      • Página com lista de notas fiscais na área do cliente #3

      Closed issues:

      • Lista de Prefeituras que possuem integração com o Bling para emissão de NFS-e #19
      • Tela de configuração #11
      • Documentação e lançamento #1

      * This Changelog was automatically generated by github_changelog_generator

COMPRAR AGORA

4 comentários

  1. Felipe em 29/10/2024 às 17:41

    Ainda funciona em 2024 com a mudança da API?

    • Gofas em 31/10/2024 às 12:07

      Sim, mas esse módulo ainda utiliza a API v2 e para contas novas é necessário solicitar ao suporte Bling a criação de um “usuário API”.

  2. Reginaldo em 13/07/2023 às 23:55

    Uma dúvida.

    É necessário ter uma asintatura bling? Se sim, a partir de qual plano?

    • Gofas em 10/08/2023 às 20:02

      Sim precisa ter uma assinatura/conta Bling para utilizar esse módulo, a partir de qualquer plano que inclua a emissão de NFS-e.

Deixe um Comentário

Você precisa fazer login para publicar um comentário.

Role para cima