Configurar NFS-e
Prepare a emissão de notas fiscais: município, certificado A1, ambiente, numeração do DPS, regime tributário, códigos de serviço (incluindo IBS/CBS), descrição da nota e emissão automática.
- Menu: Configurações › Financeiro › Notas fiscais
- Plano: Completo
- Quem usa: Administrador
Nesta página (7)
- Para que serve
- Quem usa
- Passo a passo
- Configurar pela primeira vez
- Ligar a emissão automática
- Liberar nota de competência futura
- Trocar o certificado vencido
- Campos importantes
- Emitente e prefeitura
- Emissão
- Certificado e ambiente
- Dados fiscais
- Regime tributário
- Códigos por serviço
- Como a nota sai hoje
- Descrição e endereço
- Regras do sistema
- Erros comuns e como resolver
- Dúvidas comuns
Para que serve
Aqui você deixa a academia pronta para emitir NFS-e pelo Sistema Nacional (Emissor Nacional, gov.br): quem emite, em qual prefeitura, com qual certificado, quais impostos e qual texto sai na nota.
Quem usa
Só o Administrador. Disponível no plano Completo.
A mesma configuração também abre pelo botão Configuração na tela Notas Fiscais.
Passo a passo
Configurar pela primeira vez
- Confira em Emitente e prefeitura se o CNPJ da academia e a Razão social estão preenchidos. Se não, clique em Editar dados da academia e complete em Dados da academia.
- Escolha o Estado (UF) e o Município (prefeitura) da inscrição fiscal.
- Em Provedor de emissão, deixe Sistema Nacional NFS-e (gov.br). Para a maioria das academias essa é a única opção da lista.
- Em Certificado e ambiente, escolha o arquivo do Certificado digital A1 (.pfx), digite a senha e clique em Enviar certificado.
- Deixe o Ambiente em Homologação (teste).
- Preencha Dados fiscais: inscrição municipal, alíquota do ISS, série e Próximo nº de DPS. Se tiver dúvida na alíquota, use a Calculadora do Simples — Anexo III.
- Preencha Regime tributário com os dados da contabilidade.
- Em Códigos por serviço, preencha as colunas Aulas e Locação de quadra, também com os dados da contabilidade.
- Confira os textos em Descrição do serviço na nota.
- Preencha o Endereço do emitente.
- Clique em Salvar e testar conexão. A mensagem de sucesso confirma a conexão e o certificado.
- Confira o quadro Como a nota sai hoje: ele resume emissor, ambiente e códigos de cada serviço, e mostra os avisos do que ainda falta.
- Marque Integração ativa e clique em Salvar configurações.
- Em Contas Bancárias, marque Emite nota fiscal (NFS-e) nas contas da empresa que recebem os pagamentos.
- Faça uma emissão de teste. Quando estiver tudo certo, mude o Ambiente para Produção (nota real) e salve.
Ligar a emissão automática
- Em Emissão, marque Emissão automática.
- Preencha Emitir para pagamentos a partir de com a data de corte.
- Clique em Salvar configurações.
Liberar nota de competência futura
- Em Emissão, marque Permitir nota de competência futura (regime de caixa).
- Clique em Salvar configurações.
O que muda na fila e na nota está em Nota fiscal de competência futura.
Trocar o certificado vencido
- Escolha o novo arquivo .pfx e digite a senha.
- Clique em Enviar certificado. Se o novo arquivo for recusado, o certificado anterior continua valendo.
Campos importantes
Emitente e prefeitura
- CNPJ da academia e Razão social — vêm dos dados cadastrais. Só leitura aqui.
- Estado (UF) e Município (prefeitura) — município da inscrição fiscal da empresa.
- Provedor de emissão — Sistema Nacional NFS-e (gov.br). Algumas academias têm também a opção municipal.
Emissão
- Integração ativa — liga a emissão. Desligada, a fila de notas fica só para consulta.
- Emissão automática — emite sozinha as notas dos recebimentos em contas marcadas com Emite nota fiscal.
- Emitir para pagamentos a partir de — data de corte: pagamentos anteriores não entram na fila nem na emissão automática.
- Permitir nota de competência futura (regime de caixa) — libera a emissão, uma a uma, de aula ou locação já paga de um mês que ainda não chegou. A nota sai com a data da emissão como competência. Começa desligada.
Certificado e ambiente
- Certificado digital A1 (.pfx) — arquivo .pfx ou .p12 da empresa, com a senha.
- Ambiente — Homologação (teste) ou Produção (nota real).
Dados fiscais
- Inscrição municipal — número da inscrição na prefeitura.
- Alíquota ISS (%) — entre 2% e 5%.
- Tributos aprox. Lei 12.741 — total (%) — percentual aproximado de tributos informado na nota (no Simples, a alíquota efetiva).
- Série do DPS — série da numeração. O padrão é 1.
- Último nº de DPS emitido — último número usado pelo BQuadra. Só leitura.
- Próximo nº de DPS — vem preenchido com o último + 1. Ajuste ao começar a emitir ou ao trocar de emissor, para continuar a sequência já usada pelo seu CNPJ e série no Emissor Nacional, inclusive notas emitidas pelo portal.
Regime tributário
Vale para aulas e locação. Preencha com a contabilidade.
- Simples Nacional — Não optante, MEI ou ME/EPP optante.
- Apuração no Simples — normalmente Pelo Simples Nacional. Só para ME/EPP optante.
- Regime especial — normalmente Nenhum.
- Apuração IBS/CBS no Simples — como a empresa apura IBS e CBS. Só para ME/EPP optante.
- Atividade no Simples (cAtvSN) — 07 (serviços do Anexo III com ISS), 09 (serviços sujeitos ao Fator R) ou 11 (locação de bens móveis). Só para ME/EPP optante.
Os dois últimos passam a ser exigidos pelo Emissor Nacional a partir de 01/12/2026. Sem eles, a nota de ME/EPP optante não é enviada.
Códigos por serviço
Há uma coluna para Aulas (aula, Private e avulsa) e outra para Locação de quadra. Cada cobrança usa a coluna da sua categoria.
- Item da lista LC 116 — padrões 06.04 (aulas) e 03.03 (locação).
- Cód. tributação nacional — padrões 080201 (aulas) e 030303 (locação).
- Cód. tributação municipal — preencha só se a prefeitura exigir.
- NBS (9 dígitos) — código da Nomenclatura Brasileira de Serviços.
- IBS/CBS › Enquadramento — Integral, Educação desportiva, redução de 60% ou Personalizado. Escolher um enquadramento preenche CST e cClassTrib. Em Não informado, o grupo IBS/CBS não sai na nota.
- CST, cClassTrib e cIndOp (opcional) — livres só no enquadramento Personalizado. O cClassTrib precisa começar pelo CST.
A redução de 60% só vale no regime regular de IBS/CBS, não dentro do Simples.
Como a nota sai hoje
Quadro só de leitura, calculado com a configuração salva: emissor, ambiente, leiaute e, para aulas e locação, os códigos que vão na nota. Linhas marcadas com Atenção mostram o que falta.
Descrição e endereço
- Descrição da atividade — Aulas e — Locação — texto do serviço na nota, até 1000 caracteres.
- Endereço do emitente — Logradouro, Número, CEP, Bairro, Telefone e E-mail.
Regras do sistema
- O emitente é sempre a empresa cadastrada nos dados da academia. Ao salvar, o CNPJ e a razão social são copiados de lá.
- O certificado precisa ser do mesmo CNPJ da academia e estar dentro da validade.
- A senha do certificado fica guardada de forma protegida e aparece apenas como “senha cadastrada”.
- Na descrição,
{competencia}vira o mês/ano da nota (ex.: 09/2026). Qualquer outro código entre chaves é recusado. - Pagamento atrasado: a nota sai com a competência do mês do pagamento, e o trecho ” - … {competencia}” é retirado do texto. O mesmo trecho sai na competência passada e na nota de competência futura, que usam a data da emissão.
- Só entram na fila os recebimentos em contas marcadas com Emite nota fiscal (NFS-e) em Contas Bancárias, com titular igual ao CNPJ da academia.
- O Próximo nº de DPS precisa ser maior que o último já registrado na mesma série e ambiente.
- Campos fiscais com formato errado ficam em vermelho e bloqueiam Salvar configurações e Salvar e testar conexão.
- Descrição vazia impede a emissão das notas daquela atividade.
- Não use “locação” ou “aluguel” no texto da nota (LC 214/2025).
- A calculadora do Anexo III: acima de R$ 4,8 milhões em 12 meses, a empresa está fora do Simples; na 6ª faixa, o ISS sai do DAS e a alíquota deve vir da contabilidade. O ISS é limitado ao teto de 5%.
- A emissão automática nunca antecipa competência futura, nunca emite competência já apurada e não emite pagamentos anteriores à data de corte.
- Academia nova começa com a integração desligada e o ambiente em Homologação.
Erros comuns e como resolver
- “Complete o cadastro da academia antes de emitir notas.” ou “Complete o CNPJ e a razão social em Configurações → Dados cadastrais da academia” — preencha os dados em Dados da academia.
- “O CNPJ do certificado não corresponde ao CNPJ cadastrado na academia” — o certificado é de outra empresa. Use o A1 do CNPJ da academia.
- “O certificado está fora do período de validade” — renove o certificado com a certificadora e envie o novo.
- “Envie o certificado A1 no formato .pfx ou .p12” — o arquivo escolhido não é um certificado A1.
- “Escolha o arquivo .pfx do certificado” — selecione o arquivo antes de clicar em Enviar certificado.
- “Chave privada não encontrada no .pfx” — o arquivo está incompleto. Exporte o certificado de novo, com a chave privada.
- “O Sistema Nacional não confirmou a conexão…” — confira certificado, senha, município e ambiente, e teste de novo.
- “Corrija os campos marcados em vermelho antes de salvar” — há um código fiscal com formato inválido. O texto embaixo do campo diz o formato esperado.
- “Próximo nº de DPS deve ser maior que …” — o número informado já foi usado nessa série e ambiente. Use o seguinte ao último emitido.
- “cClassTrib … deve começar pelo CST IBS/CBS” — escolha um Enquadramento pronto ou corrija o cClassTrib para começar com os 3 dígitos do CST.
- “Provedor municipal indisponível para esta academia: use o Sistema Nacional NFS-e” — deixe o provedor em Sistema Nacional NFS-e (gov.br).
- “Variável não suportada: … Use apenas {competencia}” — remova o código entre chaves que não é
{competencia}. - “Sem descrição: as notas desta atividade não serão emitidas.” — preencha a descrição da atividade.
- “Não foi possível carregar os municípios do IBGE” — falha temporária ao buscar a lista de cidades. Tente escolher a UF de novo.
Dúvidas comuns
Onde altero o CNPJ ou a razão social que saem na nota?
Em Configurações › Dados cadastrais. Na tela de notas fiscais esses campos são só leitura; use o atalho Editar dados da academia.
Qual a diferença entre Homologação e Produção?
Homologação é teste: as notas não têm validade fiscal. Produção emite nota real. Teste em Homologação e só depois mude para Produção.
Como sei qual alíquota de ISS usar?
Use a Calculadora do Simples — Anexo III: informe o faturamento dos últimos 12 meses e clique em Aplicar nos campos acima. Na dúvida, confirme com a sua contabilidade.
Posso mudar o texto da nota?
Sim, em Descrição do serviço na nota. O único código aceito é {competencia}, trocado pelo mês/ano da nota. Não use as palavras locação ou aluguel.
Já emitia notas por outro sistema ou pelo portal. Qual número de DPS devo usar?
Em Próximo nº de DPS, informe o número seguinte ao último já usado para o seu CNPJ e série no Emissor Nacional, contando as notas emitidas fora do BQuadra. Número já usado é rejeitado como duplicado.
O que preencho em Apuração IBS/CBS no Simples e Atividade no Simples (cAtvSN)?
São dados do regime tributário que a contabilidade informa. Valem para ME/EPP optante do Simples e passam a ser exigidos pelo Emissor Nacional a partir de 01/12/2026: sem eles a nota não é enviada.
Marquei tudo e a fila de notas continua vazia. O que falta?
Falta dizer quais contas emitem nota. Em Financeiro › Contas Bancárias, edite a conta do gateway ou do banco da empresa e marque Emite nota fiscal (NFS-e). Só recebimentos nessas contas entram na fila.
A emissão automática emite notas antigas?
Não. Ela só vale para pagamentos a partir da data em Emitir para pagamentos a partir de. Também nunca antecipa competência futura nem emite competência já apurada.
Obrigado! Que bom que ajudou.
Obrigado por avisar. Conte pelo WhatsApp o que faltou.