Este tutorial explica, de forma simples, como instalar e configurar o módulo de emissão de Nota Fiscal de Serviço (NFS-e) no WHMCS. Após concluir este passo a passo, o sistema estará pronto para emitir notas fiscais automaticamente.
(PASSO 1) Faça o download do módulo de Nota Fiscal fornecido pela DDR Host em seu computador e descompacte o arquivo.
(PASSO 2) Acesse o servidor onde o WHMCS está instalado utilizando um programa de FTP (como FileZilla) ou o Gerenciador de Arquivos do cPanel.
(PASSO 3) Localize a pasta do WHMCS e envie a pasta do módulo para o seguinte caminho:
(PASSO 4) Após enviar os arquivos acesse o painel administrativo do WHMCS.
No menu superior direito clique no símbolo da ENGRENAGEM e depois em Opções > Módulos Adicionais (Addon Modules).
Localize o módulo de Notas Fiscais (NFS-e), clique em ATIVAR e em seguida clique em CONFIGURAR.
(PASSO 5) Preencha os campos de configuração conforme explicado abaixo.
Chave da Licença
Informe a chave de licença fornecida no momento da contratação do módulo. Após inserir corretamente, o status da licença será exibido como ativo.
CNPJ da Empresa
Informe o CNPJ da sua empresa, apenas com números. Este será o CNPJ utilizado para emitir as notas fiscais.
E-mail da Empresa
Informe o e-mail oficial da sua empresa. Esse e-mail será será exibido na Nota Fiscal.
Telefone da Empresa
Informe o telefone da empresa com DDD que será exibido na Nota Fiscal. Somente números.
Código do Município (IBGE)
Informe o código IBGE da cidade onde sua empresa está localizada. Esse código identifica o município emissor da Nota Fiscal e é obrigatório. Consulte nesta página.
Endpoint da API Nacional
Este campo já vem preenchido com o endereço oficial da API Nacional de NFS-e. Não altere este campo, a menos que seja orientado pelo suporte.
Código de Serviço Padrão
Informe o código padrão do serviço prestado pela sua empresa. Esse código identifica o tipo de serviço na Nota Fiscal. Para serviços de hospedagem de sites utilize o código 010302. Consulte nesta página.
Série da NFS-e
Informe o número da série da Nota Fiscal. Normalmente é um número simples, como 900, utilizado para controle da numeração das notas.
Caminho do Certificado
Informe o caminho completo no servidor de hospedagem para o arquivo do Certificado Digital A1 (.pfx) da empresa.
Senha do Certificado
Informe a senha do Certificado Digital A1. Caso o certificado não possua senha, deixe este campo em branco.
Campo CPF/CNPJ (Cliente)
Selecione o campo do cadastro do cliente que contém o CPF/CNPJ. Esse campo é obrigatório para a emissão da Nota Fiscal.
Campo Inscrição Municipal (Cliente)
Selecione o campo que contém a Inscrição Municipal do cliente e que será utilizado em clientes com CNPJ. Caso não queira configurar, deixe como “Nenhum”.
Exibir Número da Fatura
Quando ativado, o número da fatura será exibido na Nota Fiscal, facilitando a identificação do pagamento.
Descrição Adicional
Texto opcional que será exibido na Nota Fiscal, entre o número da fatura e a descrição dos serviços da fatura do WHMCS.
Retenção de ISS Padrão (%)
Informe o percentual de ISS que será retido pelo Tomador (Cliente), caso aplicável. Utilize ponto para separar decimais (Exemplo: 2.00). Se não houver retenção, deixe em branco.
Campo ISS Padrão (Cliente)
Caso alguns clientes possuam retenção de ISS diferente do padrão, selecione o campo do cadastro do cliente onde esse valor será informado para sobrescrever a configuração do ISS Padrão.
Na página de "Campos Personalizados dos Clientes" recomendamos criar o campo com a opção "" marcada, para que a opção seja gerenciada somente pelo administrador do WHMCS e o cliente não consiga preencher o campo.
Modo de Emissão
Selecione se a Nota Fiscal será emitida automaticamente após o pagamento da fatura ou manualmente.
Meios de Pagamento
Selecione para quais formas de pagamento a Nota Fiscal será emitida automaticamente (Exemplo: Boleto, PIX, Cartão).
Grupos de Clientes
Selecione para quais grupos de clientes a emissão automática será aplicada.
Criar Tarefas
Quando ativado, o sistema cria uma tarefa interna no WHMCS sempre que ocorrer algum erro na emissão da Nota Fiscal.
Enviar E-mail
Quando ativado, o cliente receberá um e-mail automático informando que a Nota Fiscal foi emitida.
Debug
Exibe mensagens detalhadas de erro e deverá ser habilitado somente caso a mensagem de erro genérica não seja suficiente para identificar o erro na emissão da Nota Fiscal. Utilize apenas em caso de diagnóstico técnico.
INFORMAÇÕES DA NOTA FISCAL NA FATURA
Abra o arquivo viewinvoice.tpl do template do seu WHMCS (Geralmente localizado em: /templates/six/viewinvoice.tpl) e logo acima de <div class="panel panel-default"> adicione:
Caso tenha dúvidas sobre a configuração ou tenha erros com a emissão da Nota Fiscal, entre em contato com a nossa equipe por um ticket pela Central do Cliente.
