Ir para o conteúdo

Atualização: Módulo Bling para WHMCS 3.0, reconstruído para a API v3

A API v2 do Bling está sendo desligada. O Módulo Bling para WHMCS foi reconstruído do zero para a API v3 e chega agora à versão 3.0.1.

Reconstruído para a API v3

Autenticação OAuth 2.0, com Client Id e Client Secret obtidos no cadastro de aplicativos do Bling, e todos os endpoints remapeados. Quando o Bling limita a chamada, o módulo repete a requisição sozinho em vez de perder o lançamento.

O antigo Código de Serviço deu lugar ao Conjunto de Tributações, que é como a v3 organiza a tributação da nota. Categoria e vendedor da conta a receber viraram listas alimentadas pela sua própria conta Bling, sem digitar código.

Notas fiscais de serviço

  • Emissão automática. 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
  • Envio automático à prefeitura depois da criação da nota, com número máximo de tentativas configurável
  • Emissão manual pela página do módulo e pela própria fatura, no admin do WHMCS
  • Conjunto de tributações por produto, um geral para todos os serviços ou um específico para cada serviço
  • Emissão restrita a pessoa jurídica e aos clientes marcados para receber nota

O que o seu cliente vê

A NFS-e aparece na própria fatura, com número, série, data de emissão, situação e código de verificação, mais o link de consulta na prefeitura. Há ainda uma seção dedicada com todas as notas do cliente e uma página com os detalhes de cada uma, sem nenhuma alteração no template do WHMCS. Quando a nota é emitida, o cliente recebe um email por template próprio do WHMCS.

Nada se perde

Contas a receber e envios de NFS-e que esbarram em indisponibilidade da API voltam para uma fila e são reprocessados pelo cron, com número de tentativas configurável e limite de lançamentos por execução. Quando a emissão falha, o administrador é avisado por email.

Requisitos

  • 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
  • Dados da empresa, certificado digital e configurações de NFS-e ativos na conta Bling

Como atualizar

Se você já é cliente, a versão mais recente está disponível na sua área do cliente. Substitua a pasta modules/addons/gofasbling, acesse o módulo uma vez para aplicar as atualizações e preencha o Client Id e o Client Secret do seu aplicativo no Bling. A configuração mudou, então vale revisar as opções do módulo depois de atualizar.

Ainda não usa

Conheça o módulo e adquira sua licença em gofas.net/gbl.

Dúvidas ou sugestões, fale com o nosso suporte.

Deixe um Comentário

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

Role para cima