Módulo Conecta Nota para WHMCS (antiga Nota Fácil by vhsys). Automatiza a emissão de notas fiscais de serviço (NFS-e) da sua empresa, integrando o Conecta Nota ao WHMCS.
Suporta Simples Nacional e Lucro Real / Lucro Presumido com retenções federais (PIS, COFINS, CSLL, IR, INSS), campos avançados da Reforma Tributária (IBS/CBS) e todos os demais campos disponíveis na API Conecta Nota, cada um opcional e enviado apenas se preenchido.
- NFS-e no email e no WhatsApp do cliente: quando a nota é emitida, o cliente recebe o link da NFS-e por email (modelo editável no WHMCS) e por WhatsApp, com o módulo Gofas WHMCS WhatsApp
- Emissão automática de notas fiscais. Cria NFS-e automaticamente quando uma fatura é gerada ou paga no WHMCS
- Emissão manual de notas fiscais. Botões de ação na edição da fatura para emitir, editar e visualizar as NFS-e de cada fatura
- Painel administrativo de notas fiscais. Lista de todas as NFS-e emitidas via integração, com situação de cada nota e ações de sincronizar, emitir, reenviar à prefeitura, editar e visualizar
- Notas fiscais na área do cliente. Seção dedicada no front end, com interface semelhante à página de faturas, sem interferir no template do WHMCS
- Simples Nacional e Lucro Real / Lucro Presumido: retenções federais configuráveis (PIS, COFINS, CSLL, IR, INSS), cada uma com alíquota e opção de retenção independentes
- PIS/COFINS próprio: CST e alíquotas destacados separadamente das retenções, quando aplicável ao regime
- Reforma Tributária (IBS/CBS): finalidade, tipo e indicador da operação, classificação tributária, CST e alíquotas de IBS e CBS
- Campos avançados opcionais: NBS, natureza da operação, deduções, descontos incondicional e condicional, outras retenções. Todo campo não preenchido é omitido do envio à API, sem afetar quem não usa esses recursos
- Diversos CNAEs e códigos de serviço: código "geral" + código específico por serviço do WHMCS
- NFS-e apenas para clientes específicos, via campo personalizado "Emitir NFE" no perfil do cliente
- Suporte a todos os campos de endereço/documento: detecta automaticamente CPF, CNPJ, Inscrição Estadual, Complemento e Número nos campos personalizados de clientes do WHMCS
- Reenvio de NFS-e por e-mail e reenvio automático à prefeitura, com número de tentativas configurável
- Telemetria com consentimento: opção "Estatísticas de uso" na configuração. Com consentimento, o módulo grava e associa ao cliente as notas emitidas/confirmadas; sem consentimento, o envio é anônimo e agregado
- WHMCS >= 8.6
- PHP 8.2 ou superior
- ionCube Loader 15 ou superior
- Conta Conecta Nota (antiga Nota Fácil) com API habilitada
- Certificado digital e dados da empresa configurados na conta Conecta Nota
- Baixe o arquivo em https://gofas.net/gcnd/ e descompacte.
- Copie a pasta
modules/addons/gofasnotafacilpara o diretóriomodules/addons/da sua instalação WHMCS. - Ative o módulo em
Opções > Módulos Addons.
Repita os passos a seguir nos dois ambientes, produção e testes:
- Configurar um certificado digital
- Completar as informações da empresa (webhook não é necessário)
- Criar um usuário com a regra Softhouse Usuario e salvar login e senha para usar na configuração do módulo
Produção: https://app.notafacil.io/ · Testes: https://staging.app.notafacil.io/
- Chave de licença: obtida ao adquirir o módulo.
- Login / Senha / Secret Key (Produção): credenciais do usuário Softhouse criado em app.notafacil.io.
- Login / Senha / Secret Key (Testes): credenciais do usuário Softhouse criado em staging.app.notafacil.io.
- Sandbox: ative para gerar notas em modo de testes.
- Debug: salva informações de diagnóstico no Log de Módulo do WHMCS.
- Emitir NFS-e: quando a fatura é gerada ou quando é paga.
- Emitir NFE para: todos os clientes ou clientes selecionados via campo personalizado "Emitir NFE" (checkbox).
- Tipo de local de prestação do serviço: Endereço Emitente (dados da empresa) ou Endereço Destinatário (dados do cliente).
- RPS: numeração do RPS da última nota emitida junto à prefeitura. Não altere após o início das emissões via WHMCS.
- Série do RPS: consulte a prefeitura, seu contador ou o suporte Conecta Nota.
- Tipo de imposto / Reter imposto / Alíquota: imposto principal da nota (ISS, ISSSN, ou outro conforme orientação do contador).
- Alíquota e Reter, para PIS, COFINS, CSLL, IR e INSS: retenções federais para Lucro Real / Lucro Presumido. Deixe em branco a alíquota que não se aplica (Simples Nacional deixa todas em branco).
- Máximo de tentativas de emissão: tentativas de reenvio automático à prefeitura via cron do WHMCS (a cada 5 minutos).
- Código do Município / CNAE / Código de Serviço: códigos padrão aplicados a todas as notas.
- Vincular CNAE e Código de Serviço a cada serviço do WHMCS: define códigos específicos por produto/serviço; deixe em branco os que usam o código padrão.
- Natureza da operação: natureza da operação da NFS-e.
- NBS: código NBS (Nomenclatura Brasileira de Serviços). Opcional.
- Valor de deduções / Desconto incondicional / Desconto condicional / Outras retenções: campos opcionais da base de cálculo. Em branco, não são enviados.
- Destacar PIS/COFINS próprio: habilita o envio de CST e alíquotas de PIS/COFINS destacados na nota (distinto das retenções federais).
- CST PIS/COFINS / Alíquota PIS própria / Alíquota COFINS própria: preenchidos apenas com a opção acima habilitada.
- Habilitar Reforma Tributária (IBS/CBS): habilita o envio dos campos abaixo na nota.
- Finalidade (finNFSe) / Tipo da operação (tpOper) / Indicador da operação (cIndOp) / Classificação tributária (cClassTrib) / CST IBS/CBS / Alíquota IBS / Alíquota CBS: campos da Reforma Tributária. Consulte seu contador para os códigos aplicáveis ao seu enquadramento e município.
- Estatísticas de uso: com consentimento, o módulo grava e associa ao cliente as notas emitidas/confirmadas, além de enviar dados de identificação da instalação. Sem consentimento, o envio de estatísticas é anônimo e agregado. A verificação de novas versões permanece ativa em ambos os casos.
- Controle de Acesso: grupos de administradores/operadores com permissão de acesso ao módulo.
Todos os campos avançados (Reforma Tributária, PIS/COFINS próprio, NBS, deduções, descontos, outras retenções) são opcionais: quando não preenchidos, não são incluídos no envio à API, sem qualquer efeito sobre instalações que não os utilizam.
Acesse Opções > Módulos Addons > Gofas Conecta Nota. A página lista todas as NFS-e emitidas via integração, com informações da fatura e do cliente, além de ações de sincronizar, emitir, reenviar à prefeitura, editar e visualizar, variando conforme o status de cada nota.
- Campo personalizado CPF/CNPJ: crie um campo personalizado de cliente para CPF e/ou CNPJ (unificado ou dois campos distintos). O módulo identifica os campos 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".
- Campo personalizado Número: o número do endereço pode ficar em um campo personalizado individual, detectado pelo nome.
- Campo personalizado Inscrição Estadual: opcional na maioria dos casos. Crie um campo personalizado chamado exatamente "Inscrição estadual" para que seja enviado.
- Erro ao enviar NFS-e à prefeitura: indica configuração incompleta na conta Conecta Nota ou pendência junto à prefeitura (ex.: certificado digital). Envie a nota manualmente para obter a mensagem de erro retornada pela prefeitura.
- Sempre faça backup antes de alterar qualquer coisa no seu sistema.
- Configurações personalizadas podem ser feitas sem editar o código original, via hooks, mantendo o módulo atualizável.
Abra um tópico no fórum do módulo. Para enviar código ou logs, use um link do Gist (gist.github.com) ou do Pastebin (pastebin.com).
Melhorias:
- Integração com o módulo renomeado para Gofas WHMCS WhatsApp - #56
enhancement
Correções:
- Logo da Nota Fácil na lista de módulos addon do WHMCS - #55
bug
Melhorias:
- Avisar o cliente por email e WhatsApp quando a NFS-e for emitida - #53
enhancement
Correções:
- Erro fatal no pagamento da fatura com o número de RPS em branco (PHP 8) - #54
bug - Licença inválida no cron: emissões e atualizações do cron não rodavam - #52
bug - Cron falhava ao gravar o XML da nota (coluna nota_xml inexistente) - #51
bug - Status da NFS-e voltava para Cadastrada ao abrir a nota na área do cliente - #50
bug - Cliente podia ver a NFS-e de outro cliente pela página da nota - #49
bug
Correções:
- AfterCronJob liga display_errors e usa caminho com ponto colado - #48
bug
Melhorias:
- Atualização importante de segurança - #47
Melhorias:
- Renomear para Módulo Conecta Nota e padronizar o readme - #24
Melhorias:
- Nome do módulo no menu Addons: encurtar para 'Gofas Conecta Nota' - #23
- readme: H1 para 'Gofas Conecta Nota (antiga Nota Fácil by vhsys)' e remover linha redundante - #22
- readme: remover a menção a código público e padronizar a licença - #20
- readme: titulo igual ao titulo da pagina - #19
Melhorias:
- Imagem do readme.md apontava para repo privado (404 para quem não tem acesso) - #18
Melhorias:
- readme.md: adiciona captura de tela real da configuração e ajusta enquadramento da imagem - #17
Melhorias:
- Bloco nacional ausente e Reforma Tributária com estrutura incorreta (confirmado pelo suporte Conecta Nota) - #16
Melhorias:
- readme.md linkava para o zip cru do repositório em vez do download oficial encriptado - #15
Melhorias:
- Confirma posição do campo de consentimento e reescreve readme.md no padrão gefib - #14
Melhorias:
- Campos avançados da API (Reforma Tributária IBS/CBS, PIS/COFINS próprio, NBS, deduções) com envio condicional e telemetria no padrão gefib - #13
Melhorias:
- Rejeição NF350 (XSD ABRASF) por serialização de float com precisão excessiva no json_encode - #12
Melhorias:
- Rebrand: Nota Fácil -> Conecta Nota (antiga Nota Fácil) nos textos visíveis - #11
- Telemetria opt-in (LGPD): campo consent_stats + envio anônimo agregado sem consentimento - #10
- Suporte a Lucro Real: NFS-e com múltiplas retenções federais (PIS, COFINS, CSLL, IR, INSS) - #9
- Compatibilidade com PHP 8.2 e 8.3 - #8
enhancement
Melhorias:
- Substitui pipe ( | ) por vírgula na descrição da fatura para evitar erros no webservice de prefeituras específicas - #7
enhancement
Melhorias:
- Optimizada a execução de emissões através das tarefas cron do WHMCS - #5
enhancement - Adicionados novos campos de configuração relacionados a impostos evitando erros de emissão em prefeituras que exigem o envio de - Tipo de imposto - Reter - Valor do imposto - #4
bugenhancement - Evita conflito com portais de pagamento - #2
enhancement