Ir para o conteúdo

Módulo NFE.io para WHMCS

Automatize a emissão de notas fiscais com WHMCS e NFE.io!

CAPTURAS DE TELA

Clique nas imagens para ampliar

Listagem de notas fiscais
Gerenciador de notas fiscais nas faturas

PRINCIPAIS FUNCIONALIDADES

Emite notas fiscais automaticamente, quando a fatura é publicada, ou quando a fatura é paga.

Permite agendar a emissão de notas fiscais para um determinado número de dias após a confirmação dos pagamentos.

✓ Emite notas fiscais de forma sequencial, evitando sobrecargas nos sites das prefeituras.

✓ Exibe o status da NFE e adiciona botões de ações relacionadas às notas na página de edição das faturas.

✓ Cancela a nota fiscal quando a fatura é cancelada (opcional).

Exibe nas configurações do módulo quando há uma versão mais recente disponível para download.

Opcionalmente, salva o debug das chamadas à API NFE.io no log de Módulo do WHMCS para diagnóstico e aprendizado.

REQUISITOS DO SISTEMA

  1. WHMCS versão 7.2.1 ou superior;
  2. PHP 5.6 ou superior
  3. Tarefas cron do WHMCS devem estar funcionando a cada 5 minutos, conforme descrito na documentação oficial (https://docs.whmcs.com/Crons);
  4. É necessário um portal de pagamento ativado e que a criação de faturas do WHMCS esteja funcional, sendo que as notas fiscais são emitidas no momento da criação ou após o pagamento das faturas geradas manual ou automaticamente pelo WHMCS.

INSTALAÇÃO

  1. Faça download do módulo neste link;
  2. Descompacte o arquivo .zip;
  3. Copie o diretório /gofasnfeio/, localizados na pasta /modules/addons/ do arquivo recém descompactado, para a pasta /modules/addons/ da instalação do WHMCS;

PRÉ CONFIGURAÇÃO E ATIVAÇÃO

  1. No painel administrativo do WHMCS, caso ainda não exista, crie um campo personalizado de cliente para CPF e/ou CNPJ. Caso prefira, você pode criar dois campos distintos, sendo um campo apenas para CPF e outro campo apenas para CNPJ. O módulo identifica os campos do perfil do cliente automaticamente;

  2. Ative o addon no painel administrativo do WHMCS, em Opções > Módulos Addon > Gofas NFE.io > Ativar;

 

CONFIGURAÇÕES DO MÓDULO

  1. API Key: (Obrigatório) Chave de acesso privada gerado na sua conta NFE.io, necessária para a autenticação das chamadas à API (Obter Api Key);

  2. ID da Empresa: (Obrigatório) Nesse campo você deve indicar o ID da empresa ao qual serão associadas as notas fiscais geradas pelo WHMCS. (Obter ID da empresa);
  3. Código de Serviço: (Obrigatório) O código de serviço varia de acordo com a categoria de tributação do negócio. Saiba mais sobre o código de serviço aqui;
  4. Quando emitir NFE: Selecione se deseja que as notas fiscais sejam geradas quando a fatura é publicada ou quando a fatura é paga;

  5. 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;

  6. Cancelar NFE: Se essa opção está ativada, o módulo cancela a nota fiscal quando a fatura cancelada;

  7. Debug: Marque essa opção para salvar informações de diagnóstico no Log de Módulo do WHMCS;

  8. Controle de Acesso: Escolha os grupos de administradores ou operadores que terão permissão para acessar a lista de faturas gerada pelo módulo no menu Addons > Gofas NFE.io.

Ao baixar esse módulo você concorda com nosso contrato de licenciamento de software.

CHANGELOG

  • v1.2.2
    • Garante que o rpsSeraiNumber não seja alterado quando já configurado manualmente.
  • v1.2.1
    • Corrigido erro que alterava a série do RPS nas configurações de acordo com a série RPS das NFEs já geradas.
  • v1.2.0
    • Novo campo nas configurações para informar a Série do RPS (RPS Serial Number). Será preenchido automaticamente na próxima emissão, caso não preenchido;
    • Novo campo nas configurações para informar o número RPS (RPS Number). Caso não preenchido, será preenchido automaticamente na próxima emissão, após consultar a NFE mais recente gerada. Não sendo gerado ou configurado nenhum número RPS, o módulo irá configurar automaticamente com "1" o valor desse campo;
  • v1.1.3
    • Agora o número RPS é obtido consultando a NFE mais recente gerada;
  • v1.1.2
    • Melhoria na verificação de atualizações;
  • v1.1.1
    • Obtém via API o rpsSerialNumber e rpsNumber da empresa antes de gerar cada nota fiscal;
    • O rpsNumber da nova NFE a ser gerada sempre é "último rpsNumber + 1".
  • v1.0.1
    • Corrigido bug ao salvar NFE no banco de dados na criação da fatura.
  • v1.0.0
    • Lançamento.
Role para cima