Nota Fiscal de Serviços

1. Acessando a tela de Notas Fiscais de Serviço

Para acessar a funcionalidade de NFS-e no BomControle:

• Faça login no sistema com um usuário que possua permissão para emitir notas fiscais de serviço.

• No menu superior, navegue até Vendas > Dia a dia > Nota Fiscal de Serviços.

• A tela de listagem/pesquisa de notas fiscais de serviço será exibida, mostrando as notas já emitidas ou em processo, juntamente com filtros de busca no topo. 

Figura 1 – Tela de Pesquisa de de Nota Fiscal de Serviço

Observação: A opção Nota Fiscal de Serviços só aparece se a empresa estiver configurada para emitir NFSe. No cadastro da empresa há um campo “Emite NFSe” que precisa estar marcado como Sim; caso contrário, a emissão de notas de serviço fica desabilitada no sistema.

2. Visão geral da tela de Notas Fiscais de Serviço

A tela de NFS-e é dividida em seções principais conforme destacado a seguir:

• Barra de filtros e busca: localizada no topo, permite filtrar as notas por empresa, destinatário, status, período de datas e texto de busca por número. Também exibe indicadores de total de notas emitidas e valor total no canto superior direito. Grid de resultados: lista as notas fiscais de serviço encontradas conforme os filtros aplicados. Cada linha representa uma NFS-e, com colunas mostrando informações relevantes (número, RPS, data, cliente, status, valor, etc.). 

• Ações em cada nota: na última coluna do grid há botões de ação por nota, como visualizar/editar detalhes, baixar XML/PDF e enviar por e-mail ao cliente. Essas ações podem variar conforme o status da nota. (Figura 4 – Botões de ação em cada registro)

• Barra de ações (rodapé): na parte inferior da tela, apresenta botões para ações em lote, incluindo Exportar XML de várias notas e Atualizar Status em lote das notas selecionadas. Cada área da interface será detalhada nas seções seguintes, incluindo a explicação de cada campo, filtro e botão, com suas regras e impactos no sistema.

3. Detalhamento dos campos, filtros e funcionalidades

A seguir apresentamos cada componente da tela de Nota Fiscal de Serviço em detalhe, incluindo regras de preenchimento e impactos em outros módulos do sistema. Os números correspondem aos elementos destacados nas figuras da seção anterior.

Figura 2 - Filtros da tela de pesquisa de nota fiscal de serviços

• Empresa (Filtro): define a empresa emitente cujas notas deseja-se pesquisar. Regras: obrigatório ter ao menos uma empresa selecionada; por padrão, o sistema já seleciona a empresa ativa no seu login. É possível marcar múltiplas empresas (no caso de ambiente multiempresa) para buscar notas de todas elas simultaneamente. Impacto: este filtro garante que somente notas emitidas pelas empresas escolhidas sejam exibidas. Ele afeta também outros filtros dependentes – por exemplo, o filtro de Destinatário exibirá clientes relacionados às empresas selecionadas.

• Destinatário (Filtro): permite filtrar as notas pelo cliente tomador do serviço. Regras: opcional – se nenhum destinatário for selecionado, a pesquisa inclui notas para todos os clientes. É possível selecionar mais de um destinatário. Impacto: auxilia a localizar notas de um cliente específico. Ao selecionar, o sistema busca somente notas cujo destinatário (cliente) corresponda aos escolhidos. Não afeta diretamente cálculos, mas restringe a visualização às notas daquele(s) cliente(s). Observação: O campo Destinatário considera apenas pessoas com papel de Cliente no sistema.

• Status (Filtro): filtra as notas fiscais de acordo com seu status atual. Regras: opcional – pode-se marcar um ou vários status para refinar a busca. As opções incluem: 

  • Não enviado (nota salva mas ainda não transmitida à prefeitura), 

  • Em processamento (envio em andamento aguardando resposta),

  • Emitido (nota autorizada com sucesso), 

  • RPS (emissão gerou um RPS pendente de envio), 

  • Enviado/Reenviado (nota enviada aguardando retorno), 

  • Cancelado (nota fiscal cancelada junto à prefeitura), 

  • Erro (falha na tentativa de emissão) – entre outros conforme a legislação municipal. Impacto: esse filtro ajuda a gerenciar o fluxo de notas, por exemplo, listando apenas notas que ainda precisam ser enviadas ou as que tiveram erro. Não modifica dados, apenas a lista exibida. Dica: Após tentar emitir notas, use os filtros Erro ou Não enviado para localizar rapidamente quais precisam de atenção.

• Tipo de Data (Filtro): determina qual data a ser considerada ao filtrar pelo Período. Regras: obrigatório selecionar uma das opções disponíveis. As opções padrões são: 

  • Data da Emissão (filtra pelas datas em que as notas foram efetivamente emitidas/autorizadas), 

  • Data da Venda (filtra pela data do pedido/venda que originou a nota) ou

  •  Data de Envio (filtra pela data em que a nota foi enviada à prefeitura).

    •  Por padrão, o sistema seleciona Data da Emissão ou Data da Venda como default (conforme configuração interna). Impacto: altera a forma como o Período é aplicado. Por exemplo, se escolher Data da Emissão e definir período “Janeiro”, trará notas cuja emissão foi em janeiro, mesmo que a venda seja de dezembro. Já se escolher Data da Venda, listará notas referentes a vendas daquele mês, independentemente da data em que a nota foi autorizada. Escolha o tipo conforme a necessidade de relatório/consulta.

• Período (Filtro): intervalo de datas usado na pesquisa, considerando o tipo de data acima. Regras: obrigatório informar um intervalo válido (data inicial e final). O sistema geralmente preenche automaticamente um período padrão (ex.: dos últimos 2 meses até a data atual). Você pode ajustar para o intervalo desejado. Impacto: limita a busca de notas dentro do intervalo definido. 

  • Por exemplo, para localizar notas emitidas no último trimestre, selecione as datas correspondentes. Notas fora desse range serão ignoradas na listagem. Observação: datas de início e fim muito amplas podem tornar a busca mais lenta ou trazer muitos resultados, portanto refine sempre que possível.

• Campo de busca “Número da nota”: permite localizar uma nota específica digitando parte do número. Regras: opcional. Insira números (até 100 caracteres, apenas dígitos) correspondentes ao Número NF ou Número RPS que procura. 

  • A cada tecla digitada, o sistema atualiza a listagem filtrando as notas cujo número contenha a sequência informada. Também é possível digitar o número completo para busca exata. Para limpar a busca, clique no “x” que aparece no campo quando há texto. Impacto: agiliza encontrar uma nota específica sem precisar exportar ou percorrer todas. Não distingue entre notas já emitidas ou não – filtra pelo identificador numérico disponível (se a nota não emitida ainda não tem Nº NF, ela pode ser filtrada pelo Nº RPS ou pelo ID interno exibido).

• Indicador “Notas Emitidas”: mostra quantas notas fiscais do conjunto filtrado estão com status Emitido (ou seja, autorizadas pela prefeitura). Regras: este campo é informativo, sem entrada do usuário. É atualizado automaticamente após cada pesquisa. O número exibido corresponde ao total de notas efetivamente emitidas (não inclui as que estão apenas salvas como RPS ou com erro). 

  • Impacto: ajuda a ter uma visão rápida de quantas notas já foram validadas pela prefeitura no período/seleção atual. Esse indicador pode ser útil em conferências contábeis ou de desempenho (ex.: “quantas notas emitimos este mês?”). Observação: se nenhuma nota estiver emitida no filtro atual, mostrará 0.

  • Imagem 3 - Indicador de Notas Emitidas e Valor Total das notas

    

• Indicador “Valor Total Notas Emitidas”: exibe a soma dos valores de todas as notas Emitidas no conjunto filtrado. Regras: campo informativo e calculado. Atualiza após a busca, somando apenas notas com status emitido (as não autorizadas não entram no total, pois ainda não são consideradas faturamento efetivo). Formato monetário em reais, sem casas decimais excedentes (ex.: 15.000,00). Impacto: fornece uma referência financeira do volume faturado em serviços no período/seleção. Útil para comparar com relatórios financeiros e verificar se todos os serviços foram de fato faturados. Observação: caso haja notas em outras moedas (raro em NFS-e, geralmente tudo em R$), o valor considerado é sempre em R$.

• Imagem 4 - Colunas do Grid de pesquisa de Nota Fiscal de Serviços

  

• Coluna “Nº” (ID da Nota): coluna do grid que exibe um número identificador interno para cada registro de emissão de NFS-e. Regras: não editável. Esse número é gerado pelo sistema para cada emissão criada. Ele pode ou não coincidir com o número oficial da nota; geralmente é um ID sequencial interno. Serve para referência rápida e seleção (por exemplo, ao marcar a caixa de seleção, você está selecionando aquela linha/ID). Impacto: esse ID interno é usado em integrações ou em suporte técnico para identificar univocamente a emissão no banco de dados. Para o usuário final, é apenas um índice; o número fiscal relevante é o NF ou RPS.

• Coluna “Venda”: exibe o número da venda/pedido vinculada e a data daquela venda. Regras: não editável; preenchido automaticamente. Se a NFS-e foi gerada a partir de uma Venda/Orçamento do módulo Vendas, aqui aparece o ID da Venda e logo abaixo a data da venda. Caso não haja uma venda associada (situação incomum, pois normalmente a nota nasce de uma venda), pode aparecer “N/A”. Impacto: indica a origem da nota fiscal. Clicando sobre o número da venda (quando disponível), é possível navegar para os detalhes daquela venda (dependendo da interface, pode haver um link). Essa referência é útil para conferência cruzada entre o que foi vendido e o que foi faturado. Exemplo: Venda 123 de 10/09/2025 – sabendo isso você pode consultar o pedido original se necessário.

• Coluna “Nº RPS”: mostra o número do RPS e sua série (formato “Série – Número”) se a nota fiscal de serviço foi inicialmente gerada como RPS. Regras: não editável; aparece somente se a empresa utiliza RPS. O RPS (Recibo Provisório de Serviço) é um número temporário dado à nota antes do envio à prefeitura. Impacto: enquanto a nota não for enviada, o RPS é o comprovante que o prestador pode emitir. Após a conversão em NFSe, a prefeitura devolve o número oficial. O sistema mantém o RPS registrado aqui. Em alguns municípios é necessário emitir um lote de RPS e depois enviar – este campo permite rastrear qual RPS virou qual NFSe. Se sua empresa não trabalha com RPS, esta coluna pode ficar em branco ou “N/A”.

• Coluna “Nº NF”: exibe o número oficial da Nota Fiscal de Serviço Eletrônica após emissão. Regras: não editável. Fica vazio até que a nota seja autorizada pela prefeitura. Uma vez emitida, passa a mostrar o número fornecido pela prefeitura. Esse número é único por município/emissor e é o que consta no documento fiscal oficial (XML/PDF). Impacto: é o dado principal para referência fiscal. Deve ser usado em declarações, guias de imposto (ISS), etc. Ao enviar por e-mail ou imprimir, esse é o número que o tomador verá como identificação da nota. Se a nota for cancelada, normalmente mantém-se o número (mas o status muda para cancelado).

• Coluna “Emissão”: indica a data de emissão da nota fiscal (ou do RPS, se ainda não foi convertido). Regras: não editável. Para notas emitidas, corresponde à data-hora em que a prefeitura autorizou a nota. Para notas não enviadas ou em processamento, pode exibir a data de geração do RPS ou estar em branco se nem RPS foi gerado. Impacto: é a data considerada oficial da emissão da NFSe (para fins de obrigação acessória, contabilidade e também para o filtro de Data da Emissão). Em relatórios municipais (como DES-IF) ou livros fiscais, essa é a data que importa. Deve coincidir com o período de competência do ISS.

• Coluna “Empresa”: mostra a empresa que emitiu a nota. Regras: não editável. Traz o nome (ou nome fantasia) cadastrado da empresa emitente. Se o nome for muito longo, é exibido truncado com reticências, e o CNPJ é mostrado em formato padrão abaixo. Há tooltip (dica ao passar o mouse) revelando o nome completo e CNPJ. Impacto: em ambientes multiempresa, serve para distinguir qual empresa realizou aquela emissão. Não há ação direta, mas é importante verificar se a nota foi emitida pela empresa correta. Ex.: uma filial não pode emitir nota usando credenciais da matriz, então cada empresa tem que estar configurada separadamente – este campo permite conferir isso em caso de dúvidas.

• Coluna “Destinatário”: identifica o tomador do serviço (cliente). Regras: não editável. Exibe o nome do cliente e, se houver, o documento (CPF/CNPJ) abaixo ou a palavra “Sem documento” se não houver CPF/CNPJ cadastrado. Um tooltip detalha nome, nome fantasia (quando PJ) e documento do cliente. Impacto: verifica-se para quem a nota foi emitida. Deve corresponder ao cliente correto do serviço prestado. Se houver algum equívoco (ex.: cliente errado), a solução seria cancelar a nota e reemitir no cliente certo, já que esse campo não pode ser alterado após emissão. Também é útil para selecionar o destinatário no filtro de pesquisa ou ao enviar e-mail da nota (o envio utiliza os contatos do destinatário).

• Coluna “Status”: indica o status atual da NFS-e, com rótulos coloridos e texto descritivo. Regras: não editável diretamente pelo usuário – o status muda conforme as ações (envio, retorno, cancelamento). Principais status e seus significados:

  • Não enviado: a nota foi gerada no sistema (a partir de uma venda), mas ainda não foi transmitida para a prefeitura. Ela aguarda envio; nesse estado pode ser editada/alterada antes de enviar.

  • Em processamento: o sistema enviou a nota e está aguardando resposta da prefeitura (status intermediário, geralmente transitório).

  • Emitido: sucesso! A prefeitura autorizou a nota; a NFS-e está emitida oficialmente. Nesse status, opções como download de XML/PDF ficam disponíveis, e a nota não pode mais ser editada (apenas cancelada, se preciso).

  • RPS: indica que a nota foi gerada como RPS (Recibo Provisório). Ela precisa ser enviada/convertida em NFSe. Enquanto estiver como RPS, não tem validade fiscal definitiva.

  • Enviado/Reenviado: a nota (ou lote de RPS) foi enviada, possivelmente aguardando confirmação. “Reenviado” aparece quando houve um envio anterior com erro e o usuário acionou o envio novamente.

  • Processo Cancelamento: foi solicitada o cancelamento da nota à prefeitura e o sistema aguarda confirmação do cancelamento.

  • Cancelado: a nota foi cancelada com sucesso junto à prefeitura – deixa de ter validade fiscal (mas permanece listada como histórico).

  • Erro: houve alguma falha na emissão. Pode ser um erro de validação (ex.: dados incorretos, campos obrigatórios faltando) ou erro retornado pela integração com a prefeitura. Em caso de erro, o usuário pode editar os dados (se possível) e tentar emitir novamente. 

    • A nota em erro não possui número NFSe válido enquanto não for corrigida e reenviada.
      Impacto: o status é fundamental para as ações permitidas: por exemplo, se a nota está “Não enviada” ou “Erro”, haverá opção de Emitir (enviar) a nota; se está “Emitido”, haverá opção de Cancelar; se está “Em processamento” ou “Enviado”, pode-se Atualizar status para verificar se já foi concluído; se “Cancelado”, a nota é somente leitura. 

    • O status também direciona obrigações fiscais – apenas notas Emitidas contam para cálculo de ISS a recolher, por exemplo, enquanto RPS pendentes não. O usuário deve acompanhar e agir conforme o status para completar o ciclo de faturamento (emitir pendentes, corrigir erros, etc.).

• Coluna “Valor (R$)”: apresenta o valor total da nota fiscal de serviço. Regras: não editável. Corresponde à soma dos itens de serviço menos deduções (se houver) daquela nota. Exibido em formato moeda. Impacto: confirma o montante faturado. Deve bater com o valor da venda associada (salvo se a nota foi fracionada por parcela – ver próxima seção – caso em que cada nota representa uma parcela do contrato). Esse valor é usado para cálculo de impostos (ISS) e integração com contas a receber. Notas canceladas mantêm o valor original mas não são consideradas em somatórios financeiros finais.

  • Imagem 6 - Botões de ação no grid de pesquisa de nota fiscal de serviço

    

• Botão “Visualizar/Editar” (ação no grid): ícone (geralmente um lápis ou olho) que abre a janela de Detalhes da Nota Fiscal de Serviço. Regras: clique único para abrir (ou duplo clique na linha faz o mesmo). Se o usuário tiver permissão de edição e a nota estiver em um status editável (ex.: Não enviado ou Erro), ele poderá alterar alguns campos na tela de detalhes antes de reenviar. Se a nota já foi emitida, a tela abre apenas para visualização (edição bloqueada). Impacto: esta ação é o ponto de entrada para operações importantes: é dentro dessa janela modal que o usuário consegue, por exemplo, clicar “Emitir Nota” para enviar uma nota que está pendente, ou solicitar cancelamento de uma nota já emitida. Todos os dados da nota são mostrados (itens, impostos, dados do tomador, etc.), permitindo conferência. Observação: ao tentar editar notas sem estar vinculado a uma venda (situação rara), o sistema impede alterações – em geral, toda NFSe no BomControle está ligada a uma venda ou contrato.

Imagem 7 - Visualização da nota fiscal de serviço

• Botão “Download” (ação no grid): ícone (disquete ou seta para baixo) para baixar os arquivos da nota fiscal. Regras: se a nota estiver Emitida (status Emitido), ao clicar o sistema inicia o download do PDF da nota (layout da prefeitura) e/ou do XML. Alguns municípios têm ambos disponíveis; o BomControle tentará baixar os dois arquivos. Se a nota não estiver emitida (por ex., status Não enviado ou Em processamento), clicar exibirá uma notificação informando que não há documento ainda. Impacto: permite ao usuário obter imediatamente os documentos fiscais para arquivamento, impressão ou envio manual. Por exemplo, após emitir, pode-se clicar em Download e salvar o PDF da NFSe para enviar ao cliente (caso não queira usar a função de e-mail). Se o usuário não tiver permissão de visualização de notas, o sistema mostrará uma mensagem de permissão negada.

• Botão “Enviar por e-mail” (ação no grid): representado por um ícone de envelope, essa ação facilita o envio da NFSe ao tomador via e-mail. Regras: ao clicar, abre-se um modal Enviar Nota Fiscal por E-mail já contextualizado para NFS-e. Normalmente, o sistema pedirá confirmação e permitirá escolher destinatários adicionais ou usar os contatos do cliente. Por padrão, o e-mail do cliente cadastrado é utilizado. Após confirmar o envio, o status de e-mail da nota muda para “Enviado” no sistema (embora esse status específico de e-mail não seja visível na grid principal, evita reenvio duplicado). Impacto: agiliza a entrega do documento fiscal ao cliente. Essa função utiliza a configuração de e-mail de NFSe definida no cadastro da empresa (geralmente enviando com cópia ou remetente específico, conforme configurado). Não altera o status fiscal da nota, apenas registra que foi enviada por e-mail. Dica: Utilize essa opção após a nota ser emitida, para garantir que o cliente receba o PDF da NFSe rapidamente.

• Imagem 8 - Botões de ação no rodapé da tela de pesquisa

  

• Botão “Exportar XML” (ação em lote, rodapé): localizado na barra inferior, botão verde Exportar XML. Regras: habilitado independentemente de seleção de linhas (ele considera o filtro inteiro). Ao clicar, o sistema inicia um processo em segundo plano: todas as notas fiscais emitidas dentro dos filtros atuais (empresa(s), período etc.) terão seus XML agregados. 

  • O usuário receberá uma notificação no sistema quando o pacote estiver pronto para download (um arquivo .zip contendo os XML). Impacto: importante para compliance contábil/fiscal – possibilita extrair rapidamente todos os XMLs para entrega ao contador ou importação em outro sistema. Observe que se o filtro incluir muitas notas, o processo pode demorar alguns minutos. O usuário pode continuar usando o sistema enquanto isso; ao concluir, haverá uma notificação com link para baixar. Campos ignorados: os filtros de destinatário, status e texto de busca não são aplicados na exportação; por padrão, são exportados XML das empresas e período informados (todas as notas emitidas nesse recorte temporal).

• Botão “Atualizar Status” (ação em lote, rodapé): botão Atualizar Status na barra inferior para verificar o estado de múltiplas notas de uma vez. Regras: o botão fica ativo somente se houver pelo menos uma nota selecionada no grid (marcada na caixa à esquerda da coluna Nº). Pode-se selecionar várias notas (inclusive de diferentes status). Ao clicar em Atualizar Status, o sistema abrirá uma janela de confirmação informando quantas notas serão consultadas. Confirmando, ele enviará requisições de atualização para cada nota selecionada: para cada ID, consulta a prefeitura ou o servidor do BomControle pelo status atual. 

  • Ao terminar todas, mostra mensagem de sucesso se todas atualizaram, ou mensagem de erro caso alguma falhe (com detalhes do primeiro erro encontrado). Impacto: esse procedimento efetua para cada nota praticamente o mesmo que clicar em “Consultar/Atualizar” individualmente dentro da tela de detalhes. Ou seja, pode transformar notas RPS em Emitido se a prefeitura já tiver retornado, marcar notas Em processamento como Emitido ou Erro conforme resposta, etc. Útil para pós-envio em lote (ex.: após enviar várias notas em lote RPS, selecione todas e clique em atualizar para sincronizar os status). Observação: é necessário ter permissão de editar notas fiscais de serviço para usar essa função, pois ela modifica o status; caso contrário o sistema negará a ação.

• Função “Cancelar Nota Fiscal” (dentro da visualização): uma funcionalidade relevante disponível ao abrir os detalhes de uma NFS-e já emitida é o cancelamento. Regras: somente aplicável se a nota estiver em status Emitido (ou “Emitido/Enviado” aguardando cancelamento). Ao clicar em Cancelar dentro da tela de detalhes da nota, o sistema solicita um motivo de cancelamento e então envia a solicitação à prefeitura. Enquanto o cancelamento não é confirmado, a nota pode ficar com status Processo Cancelamento. Uma vez confirmado, o status muda para Cancelado. Impacto: cancelar uma nota fiscal inutiliza seu efeito fiscal – deve-se depois emitir outra se necessário refazer o faturamento. 

  • O cancelamento impacta o financeiro (se havia um título a receber atrelado, normalmente deve ser extornado manualmente) e relatórios de impostos (ISS daquela nota deixa de ser devido). Importante: só cancele notas quando houver garantia de que o serviço não será cobrado ou houve erro na emissão (ex.: CNPJ do tomador errado). O sistema registra o motivo do cancelamento para auditoria. Observação: Prefeituras impõem prazos e condições para cancelamento (p.ex., muitas exigem cancelamento em até x dias da emissão). O BomControle não cancela se expirar esse prazo – nesse caso, mensagem de erro da prefeitura será exibida.

4. Emitindo uma nova Nota Fiscal de Serviço

Nesta seção, explicamos como gerar/emitir uma nova NFS-e no BomControle, dado que na tela de Notas Fiscais de Serviço não existe um botão “Novo” direto. A emissão de notas de serviço está integrada aos processos de venda e faturamento do sistema. Em resumo, a criação de uma NFSe ocorre durante o registro de uma venda/contrato ou no faturamento de um contrato de serviços. Abaixo descrevemos o passo a passo típico:

a) Emissão via Venda/Orçamento de Serviço: Quando você realiza uma venda de serviço (ou converte um orçamento em venda) no BomControle, o sistema oferece campos específicos para configurar a emissão da nota fiscal de serviço daquela venda. Após preencher os itens (produtos/serviços) e demais dados da venda, localize a seção Nota Fiscal de Serviço (NFSe) no formulário da venda. 

Imagem 9 - Tela de criação de uma Nova Venda

Observação: para mais detalhes sobre a criação de uma nova venda, consultar manual “Cadastro de Orçamento ou Venda”

Nessa seção, você deverá:

• Ativar a opção “Emitir NFSe?” – Trata-se de um botão toggle (Sim/Não). Coloque em “Sim” para indicar que aquela venda deve gerar uma nota fiscal de serviço. 

Regras: este campo só fica habilitado se a empresa selecionada na venda estiver configurada para emitir NFSe (caso contrário, aparece desabilitado com um tooltip informando que a empresa não emite NFSe). Uma vez marcado “Sim”, o sistema revelará campos adicionais de configuração da nota de serviço.

• Escolher “Emitir Nota Fiscal por Parcela” ou “Valor Total”: Logo abaixo, se sua venda possuir parcelamento (múltiplas parcelas de pagamento), você deve definir como a nota fiscal será emitida. Há duas opções mutuamente exclusivas (representadas por botões de rádio):

• Emitir Nota Fiscal por Parcela: selecionando esta opção, o BomControle gerará uma NFSe separada para cada parcela da venda. Ou seja, se a venda tem, por exemplo, 3 parcelas mensais, serão criadas 3 notas fiscais (cada uma com data e valor correspondentes à parcela). Essa opção é útil para contratos de prestação de serviço contínua, onde se fatura mensalmente.

• Emitir Nota Fiscal no Valor Total: com esta opção, será emitida uma única NFSe pelo valor total da venda, independentemente do número de parcelas. Nesse caso, mesmo que o pagamento seja parcelado, a nota fiscal sairá integral, geralmente na data da primeira parcela (ou conforme data de emissão definida). Use esta opção para vendas de serviço à vista ou quando se deseja apenas uma nota global.
  Regra: por padrão, o sistema deixa “por Parcela” marcado (Sim) se há mais de uma parcela. O usuário pode alterar conforme a necessidade. Uma vez escolhida a modalidade, isso influenciará o momento da geração da nota: notas por parcela podem ser geradas conforme cada parcela vence/é recebida, enquanto nota única é gerada imediatamente ao finalizar a venda.

• Local de prestação do serviço: selecione onde o serviço foi prestado, com três possibilidades: Empresa, Cliente ou Outros. Regras: esse campo é obrigatório quando Emitir NFSe = Sim. Por default vem “Empresa”.

• Empresa: indica que o serviço foi prestado no endereço da empresa emitente. Ao escolher “Empresa”, o sistema automaticamente define o Município de prestação como a cidade da empresa, e não exige endereço extra.

• Cliente: indica que o serviço foi executado no endereço do cliente tomador. Ao selecionar “Cliente”, o sistema tentará usar o endereço cadastrado para o cliente na venda. Regra: é necessário que a venda tenha um cliente selecionado com endereço definido. Se o cliente da venda não tiver um endereço completo cadastrado (principalmente cidade), o sistema exibirá um erro ao tentar salvar, solicitando selecionar um cliente válido com endereço. Quando válido, o Município de prestação é preenchido com a cidade do cliente automaticamente.

• Outros: indica que o serviço ocorreu em local diverso (que não seja o endereço da empresa nem exatamente o do cliente). Ao selecionar “Outros”, você deverá informar manualmente o município e possivelmente o endereço detalhado do local da prestação. Regras: ao escolher “Outros”, o campo Município de prestação fica habilitado para seleção livre (você deve escolher a cidade onde o serviço foi prestado). Além disso, o sistema verifica a configuração da empresa/cidade para saber se precisa do endereço completo: algumas prefeituras exigem o endereço exato do local quando marcado “Outros”. O BomControle, neste caso, exibirá um formulário adicional chamado Endereço de Prestação de Serviço para você preencher logradouro, número, bairro, CEP etc. Esse formulário só aparece se for necessário (dependendo do município escolhido e das configurações internas). Dica: Use “Outros” quando, por exemplo, o serviço foi feito em obra, em campo ou em uma localidade diferente da sede da empresa ou do cliente – assim você garante que a nota refletirá corretamente o local de ocorrência do serviço para fins de ISS.

• Município de prestação do serviço: campo que acompanha o anterior. Se Local for Empresa ou Cliente, este campo é preenchido automaticamente (e geralmente travado para edição: no caso de Empresa, fica fixo na cidade da empresa; no caso de Cliente, na cidade do cliente selecionado). Se Local = Outros, este campo se torna obrigatório para seleção manual. Escolha no dropdown o município onde o serviço foi prestado. Impacto: o município de prestação é um dado crítico na NFSe – define para qual prefeitura a nota será emitida (no caso de empresas que atuam em múltiplas cidades) e pode afetar retenção de ISS. Por exemplo, se sua empresa é de São Paulo mas prestou serviço em outro município, pode ser que o ISS seja devido naquela localidade (caso de construção civil, alguns tipos de serviço, etc.). O BomControle usa esse campo para endereçar a emissão à prefeitura correta e aplicar regras específicas daquele município.

• Natureza da Operação (NFSe): selecione a natureza da operação para a nota de serviço. Regras: obrigatório quando Emitir NFSe. As opções disponíveis vêm pré-configuradas conforme padrões municipais, por exemplo: Tributação no Município, Tributação Fora do Município, Isenta/Imune, Exigibilidade Suspensa, etc., e também uma opção “Não Informado” (default). Escolha a opção que corresponda à situação tributária do serviço:

• Tributação no Município: quando o ISS será recolhido normalmente no município do prestador (caso geral para serviços locais).

• Fora do Município: quando o serviço foi prestado fora da cidade do prestador e o ISS será devido no local da prestação (algumas legislações exigem destacar isso).

• Isenta/Imune: quando o serviço é isento de ISS ou o prestador/cliente tem imunidade.
  (entre outras conforme legislação).
  Impacto: a natureza da operação é informada no XML da NFSe e determina cálculo de impostos. Por exemplo, “Isenta” pode fazer com que ISS seja zero na nota. O sistema já traz uma natureza padrão configurada no cadastro da empresa (definida na aba de Configurações NFSe da empresa). Você pode deixar a padrão ou ajustar caso específico. Se não tiver certeza, consulte seu contador ou deixe como “Tributação no Município” (caso mais comum para prestar serviço dentro da cidade da empresa).

• Botão “Informar impostos e retenções”: clique neste botão (representado por um ícone de edição/cálculo) para abrir o modal de Impostos e Retenções da NFSe. Regras: este passo é opcional na venda, mas crucial se houver impostos a reter. Importante: o botão fica desabilitado caso o cliente selecionado seja Pessoa Física, pois geralmente não se aplicam retenções de impostos federais quando o tomador é PF. Se o cliente for Pessoa Jurídica, você poderá clicar para detalhar retenções.
  No modal de Impostos, você terá campos para configurar, por exemplo: ISS Retido pelo Tomador, IRRF, CSLL, PIS/COFINS, INSS entre outros, conforme o regime. Preencha de acordo com o contrato/serviço:

• Configuração de Retenção de ISS: marque se o ISS será retido (caso o tomador seja responsável tributário) e informe alíquota se diferente.

• Impostos Federais Retidos (IR, INSS etc.): informe as bases de cálculo e valores a reter se o tomador for obrigado a reter esses tributos.
  Ao confirmar, o sistema retornará à venda com esses valores calculados. Impacto: Os impostos e retenções informados serão aplicados na nota fiscal no momento da emissão – o valor do ISS destacado, quem recolhe (se retido, a nota sai com ISS retido = sim e valor zero para recolhimento do prestador), e os outros tributos serão mencionados no campo de descrição da nota conforme layout da prefeitura. Além disso, o BomControle ajusta o total líquido da venda se houver retenções (reduzindo o valor líquido a receber, por exemplo). Sempre revise esses dados com atenção, pois afetam tanto a validade fiscal quanto o financeiro (ex.: se ISS for retido pelo cliente, você receberá menos 5% do valor, então o contas a receber deve refletir isso).

• Campos de Construção Civil (Código da Obra/ART): se algum item da venda estiver marcado como referente à construção civil, o sistema exibirá dois campos extras: Código da Obra e ART. Regras: estes campos só aparecem se pelo menos um serviço adicionado na venda for do tipo “Construção Civil”. (No cadastro de Tipo de Serviço, existe uma flag “Construção civil”; quando usada, qualquer item com aquele tipo vai acionar esses campos na nota). Preencha:

• Código da Obra: o código do projeto/obra no cadastro da prefeitura ou órgão competente (até 128 caracteres).

• ART: número da Anotação de Responsabilidade Técnica vinculada (até 128 caracteres).
  Ambos campos são obrigatórios para certas prefeituras quando a natureza do serviço for construção civil. Impacto: Essas informações serão incluídas na NFSe (alguns municípios exigem para liberar a nota). Sem preenchê-las, a tentativa de emissão poderia resultar em erro de validação caso o serviço seja de construção. Se não aplicável, os campos podem ficar vazios, mas atenção: se o item marcou como construção civil indevidamente, talvez deva corrigir o cadastro do tipo de serviço.

• Observação da Nota Fiscal: campo de texto livre para adicionar alguma observação complementar que constará na nota fiscal de serviço. Regras: opcional; até 900 caracteres. Você pode escrever quaisquer detalhes importantes, como “Serviço prestado conforme contrato X”, ou discriminar retenções de forma customizada, etc. Impacto: O texto inserido aqui será incluído no corpo da NFS-e (geralmente no campo de observações adicionais do RPS/XML). Útil para mencionar informações exigidas pelo tomador ou legislação que não tenham campo próprio. Exemplo de uso: em notas com ISS retido, alguns usuários inserem “ISS será recolhido pelo tomador conforme Lei Municipal…”; ou informações de isenção, “Serviço imune de ISS conforme Art. y”. Use com parcimônia e apenas quando necessário para esclarecimentos adicionais.

Depois de preencher todos esses campos na venda e conferir os itens e valores, você finaliza/salva a venda. A partir daí, o BomControle tomará as seguintes ações de emissão:

• Geração da nota fiscal de serviço no sistema: Ao finalizar a venda com “Emitir NFSe” habilitado, o sistema cria automaticamente o registro da NFS-e no módulo de Notas Fiscais de Serviço. Se optou por Nota por Parcela, ele gera registros para cada parcela (com status inicial “Não enviado” cada). Se optou Nota Valor Total, gera um único registro. Nesse momento, a(s) nota(s) estarão com status Não enviado (ainda não transmitidas). Elas aparecerão na tela de listagem de NFS-e. Você pode inclusive acessar imediatamente a tela Vendas > Dia a dia > Nota Fiscal de Serviços para vê-las listadas. Note que ainda não possuem número NFSe, apenas RPS (se configurado) ou identificador interno.

• Transmissão/Envio da NFSe: O envio efetivo da nota para a prefeitura não ocorre automaticamente ao salvar a venda, pois depende de uma ação do usuário (ou de uma rotina de faturamento, no caso de contratos). Você tem duas formas de proceder:

• Envio manual nota a nota: Na tela de Notas Fiscais de Serviço, localize a nota com status Não enviado correspondente. Clique no ícone de Visualizar/Editar para abrir os detalhes. Revise os dados e então clique no botão Emitir Nota (às vezes rotulado como “Enviar” ou “Emitir NFSe”) dentro da tela de detalhes. O sistema vai então conectar-se à prefeitura e tentar emitir a nota. Se tudo estiver correto, em poucos segundos o status mudará para Emitido e um número de NFSe será atribuído (a tela será atualizada com o número oficial). Caso haja algum problema, o sistema retornará um erro específico (ex.: dados inconsistentes, problemas de conexão, etc.) e a nota ficará com status Erro – permitindo que você corrija (volte à aba de edição) e tente novamente.

• Envio em lote (para várias notas): Alternativamente, se você gerou muitas notas (por exemplo, notas de todas parcelas de um contrato ou várias vendas) e deseja enviar todas de uma vez, pode usar a seleção em lote na listagem. Marque as notas desejadas (status Não enviado ou RPS) e clique em Atualizar Status no rodapé. Na confirmação, o sistema as enviará. Notas que estavam “Não enviado” deverão mudar para Emitido ou Erro conforme o resultado. Notas que estavam “RPS” podem passar a Emitido. Essa abordagem poupa tempo em caso de dezenas de notas pendentes de envio.

Imagem 10 - Tela de criação de uma Nova Venda do tipo Contrato

Observação: para mais detalhes sobre a criação de uma nova venda de Contrato, consultar manual “Cadastro de Contrato”

b) Emissão via Faturamento de Contrato: Para contratos (vendas recorrentes), o BomControle possui um módulo de Faturamento que gera parcelas periódicas e respectivas notas. O funcionamento é similar: no cadastro do Contrato de Serviço, existe a opção de emitir NFSe para cada fatura. Se configurado, a cada ciclo de faturamento o sistema criará as notas fiscais de serviço conforme as parcelas do contrato, com status Não enviado. O usuário então deve proceder ao envio delas (manualmente ou em lote) como descrito acima. No contexto deste manual, vale salientar que o resultado final aparece igualmente na tela de Notas Fiscais de Serviço. Ou seja, independentemente de a NFSe vir de uma venda avulsa ou de um faturamento de contrato, todas serão listadas e gerenciadas na mesma interface.

Pós-emissão – verificação e ações: Depois de emitida a NFSe, verifique se: 

- O PDF e XML estão disponíveis (use o botão Download para checar). Salve-os caso precise. 

- Se necessário, envie a nota para o cliente usando o botão de e-mail. O sistema não envia automaticamente ao salvar a venda – isso fica a seu critério, manual ou automático se configurado via automação (ex.: algumas empresas deixam programado envio de NFSe automático, mas essa configuração está no cadastro da empresa em “Enviar e-mail NFSe”). 

- Caso encontre algum erro depois da emissão (por exemplo, valor errado, ou cliente errado), será preciso cancelar a nota junto à prefeitura (conforme explicado anteriormente) e então gerar outra correta. Lembre-se: depois de autorizada, a nota não pode ser simplesmente editada – qualquer alteração requer cancelamento e nova emissão.

5. Relação do cadastro de NFS-e com outros módulos do sistema

A emissão de Nota Fiscal de Serviço no BomControle impacta diversos módulos e cadastros, dada sua natureza integrada aos processos de vendas e obrigações fiscais. Abaixo destacamos as principais interações e dependências:

• Configurações da Empresa: O cadastro da Empresa (menu Financeiro > Cadastros > Empresa) possui uma aba de Configurações de NFSe. É ali que se define, por exemplo, se a empresa emite NFSe, em qual ambiente (produção ou homologação), dados como Inscrição Municipal, Regime Especial, Natureza de Operação padrão, e credenciais de integração com a prefeitura (certificado digital, usuário/senha ou tokens, dependendo do município). Se alguma dessas configurações estiver faltando ou incorreta, a emissão de notas de serviço poderá falhar. Por exemplo:

• Sem Inscrição Municipal cadastrada, muitas prefeituras nem aceitam a nota (o sistema exigirá esse campo).

• Se “Emite NFSe” estiver desativado, a opção de emissão não aparece nas vendas nem a tela de NFS-e abre.

• A natureza de operação padrão definida na empresa será sugerida em cada venda (como visto, pode ser ajustada caso a caso).

• O e-mail padrão de envio de NFSe, configurado na empresa, será utilizado ao mandar notas por e-mail (ex.: cópia para fiscal@empresa ou remetente).
  Em resumo, antes de começar a emitir é crucial que o cadastro da empresa esteja completo e correto. Esse alinhamento com o módulo Empresa garante que a nota saia dentro dos parâmetros exigidos pela legislação municipal específica.

• Cadastro de Tipos de Serviço: Este cadastro (menu Financeiro > Cadastros > Tipo de Serviço) é onde se definem os serviços que sua empresa presta, com seus códigos fiscais e alíquotas de ISS. Cada item de serviço vendido puxa informações do Tipo de Serviço correspondente. Impacto direto: os dados do tipo de serviço são usados na composição da NFSe:

• Código Municipal do serviço: vai no XML da NFSe, identificando a atividade conforme a prefeitura.

• Código CNAE e Código Federal (LC 116): também podem ser enviados na nota dependendo do município.

• Alíquota de ISS: a taxa de ISS configurada no Tipo de Serviço é aplicada para calcular o imposto na nota. Se a alíquota estiver errada no cadastro, o ISS na NFSe sairá incorreto.

• Flag de Incidência de ISS: se um tipo de serviço estiver marcado como “Não incide ISS” (isento), o sistema tratará a nota conforme (ISS zero, independente de alíquota).

• Indicador de Construção Civil: conforme mencionado, se marcado, ativa a exigência de Código Obra/ART na nota.
  Em suma, cada item da NFSe deriva de um Tipo de Serviço, então mantenha esse cadastro atualizado e condizente com as exigências fiscais. Um tipo de serviço mal cadastrado pode causar rejeição da nota (p.ex., código municipal inválido) ou problemas de cálculo (ISS calculado errado).

• Clientes (Pessoas) e Endereços: O módulo de Pessoa/Cliente fornece os dados do tomador que irão para a NFSe: nome/razão social, CPF ou CNPJ, endereço. É fundamental que, para emitir NFSe, o cliente tenha um endereço completo cadastrado, incluindo cidade e estado, e obviamente CPF/CNPJ correto. Impactos:

• O nome e documento do cliente vão no cabeçalho da NFSe.

• O endereço do cliente é usado se o Local de prestação = Cliente (o município dali passa a ser o de incidência do ISS em alguns casos).

• Se o cliente for Pessoa Física, o sistema restringe certos campos (ex.: retenções não se aplicam; não preenche campo de Inscrição Municipal do tomador porque PF não tem).

• Se for Pessoa Jurídica, a NFSe normalmente exige a Inscrição Municipal do tomador em algumas cidades – no BomControle, esse campo não está no cadastro geral de pessoas, pois nem todos clientes PJ têm IM. Se sua prefeitura exigir IM do tomador, isso deve ser informado manualmente nas observações ou configurado via integração específica (caso o sistema suporte).
  Resumindo, o cadastro correto do cliente assegura emissão tranquila. Erros aqui (CNPJ errado, endereço faltante) resultam em rejeição ao enviar a nota. Sempre revise os dados do tomador antes de emitir, principalmente em primeira nota para um cliente novo.

• Vendas/Contratos e Financeiro: A emissão de NFSe está diretamente ligada ao módulo Vendas (pedidos, orçamentos, contratos) e tem reflexos no Financeiro (Contas a Receber):

• Ao marcar “Emitir NFSe” em uma venda, como descrito, a venda gerará as notas fiscais. Isso vincula a venda ao(s) registro(s) de NFSe. Posteriormente, se você acessar a tela da venda novamente (ou um contrato), verá referência às notas emitidas ali (por exemplo, um contrato pode listar as notas geradas em cada faturamento).

• Quando a NFSe é efetivamente emitida, normalmente o financeiro (contas a receber) daquela venda já foi gerado no momento da finalização da venda ou faturamento do contrato. O status da nota não interfere na existência do título financeiro – ou seja, salvar a venda gera o título a receber, independentemente da nota ter sido autorizada ainda. Porém, algumas empresas só reconhecem a receita após a nota ser emitida. Nesse sentido, você pode usar o relatório de Contas a Receber em conjunto com a tela de NFSe para garantir que não haja faturas sem nota ou vice-versa.

• Em casos de cancelamento de NFSe, o sistema não cancela automaticamente o contas a receber. O usuário precisará avaliar: se a nota foi cancelada porque a venda foi cancelada, possivelmente terá que estornar o título financeiro manualmente. Se a nota foi cancelada apenas para correção (e outra será emitida em seguida), o título original ainda pode ser válido, apenas ficará associado à nova nota depois. Atualmente, o vínculo nota-título não é rígido no BomControle, portanto acompanhe essa relação manualmente.

• Faturamento recorrente (Contratos): no módulo de contratos de serviço, ao configurar parcelas mensais e emissão de NFSe por parcela, o sistema ao gerar cada parcela também gera a nota respectiva. Essas notas entram no fluxo normal de NFS-e. Existe também uma tela de Faturamento consolidada, porém o acompanhamento final de notas emitidas ainda é feito na tela de Notas Fiscais de Serviço em Vendas. Logo, usuários do módulo de contratos devem usar a listagem de NFSe para verificar se todas as parcelas de um período foram efetivamente autorizadas (especialmente se a integração com prefeituras é assíncrona ou por lote RPS).

• Relatórios e Dashboards: as notas fiscais de serviço emitidas compõem os dados de faturamento de serviços da empresa. Há painéis no Dashboard de Vendas que podem incluir o valor faturado de serviços (que corresponde, grosso modo, à soma das NFS-e emitidas). Também no Financeiro > Relatórios, ao apurar receitas, convém filtrar por notas emitidas para ter segurança de que está contando apenas valores já fiscalmente realizados.

• Impostos e Obrigações Acessórias: O módulo fiscal do BomControle utiliza as informações das NFSe para auxiliar na apuração de ISSQN e geração de guias ou declarações:

• A aba/funcionalidade de ISSQN (caso existente no sistema) vai buscar todas as notas de serviço emitidas no período e calcular o ISS a pagar de acordo com as alíquotas e regimes. Notas canceladas ou com ISS retido não contam para pagamento (mas podem contar para declaração, dependendo do município). Então, é importante emitir e cancelar notas apropriadamente para que a apuração fique correta.

• Alguns municípios exigem envio de declaração eletrônica (como DES-IF, GISS, etc.). Se o BomControle tiver integração, ele usará os dados das NFSe emitidas. Se não tiver, você deverá utilizar os XMLs/PDFs exportados para preencher essas declarações no portal da prefeitura.

• Retenções Federais: quando você informa retenções de impostos federais (IRRF, INSS) no modal de Impostos e Retenções, esses valores não só aparecem na NFSe, mas também podem ser considerados em relatórios de impostos a recolher (por exemplo, um relatório de IRRF retido de terceiros a pagar, se o sistema possuir). Fique atento para lançar corretamente, pois o BomControle pode não ter um módulo automático para guiá-los, mas pelo menos os dados ficam registrados para consulta.

• Permissões de Usuário: O controle de acesso do sistema permite que apenas usuários autorizados emitam ou cancelem NFSe. Isso significa que o botão “Emitir NFSe” ou “Cancelar” só aparece para usuários com permissão de editar notas fiscais de serviço; caso contrário, tais usuários poderiam apenas visualizar. Da mesma forma, a tela de Notas Fiscais de Serviço em si exige a permissão de visualizar notas fiscais de serviço. Portanto, verifique as permissões no módulo de Segurança do sistema se um usuário não estiver conseguindo acessar ou operar nessa tela. Esse aspecto de segurança garante que somente pessoas treinadas/manutenção fiscal façam alterações nas notas, já que são documentos oficiais.

Conclusão

Em conclusão, o cadastro de Nota Fiscal de Serviço do BomControle é uma peça central que interliga Vendas, Financeiro e Fiscal. Para utilizá-lo de forma eficaz, assegure que os cadastros base (Empresa, Tipos de Serviço, Clientes) estejam corretos, e siga os processos de emissão através de vendas ou contratos conforme descrito. Assim, você terá as NFS-e emitidas de forma consistente, evitando erros e mantendo o compliance fiscal da sua empresa em dia.