Pular para o conteúdo principal

Listar NF Serviço

A tela Listar NF Serviço centraliza as notas fiscais de serviço (NFS-e) cadastradas pela empresa. Cada linha é uma NFS-e com cliente, código de serviço, cidade, valor, status atual e valor já pago. A tela é a porta de entrada para criar, emitir, abrir, alterar e excluir as NFS-e — e também para acompanhar quais já estão pagas e quais ainda não foram quitadas.

A NFS-e é gerada em duas etapas: primeiro você cria a NFS-e em Pendente (preenchendo cliente, serviço, valor, retenções, etc.) e depois emite na prefeitura (envio à API municipal). Só depois da emissão a NFS-e ganha número oficial, código de verificação e fica disponível para download de XML/PDF. As configurações ficam em Configurações → Empresa (Inscrição Municipal, endereço, certificado) e na lista de códigos de serviço do município — sem isso o sistema bloqueia a criação.

Índice​

Conceito

Cadastro e edição

Emissão

Busca e filtros

Regras de negócio

Referência rápida

O que é Listar NF Serviço?​

É a tela que mostra todas as NFS-e cadastradas pela empresa — emitidas, pendentes e com erro. Cada linha traz a data de criação, a data de emissão (quando já emitida), o status da NF, o número da NFS-e (após emissão), o cliente, a cidade, o valor da nota e o valor já recebido (das contas a receber vinculadas).

📍 Onde: menu lateral → Vendas → Listar NF Serviço.

Qual a diferença entre NF de Serviço e NF de Produto?​

NF de Serviço (NFS-e)NF de Produto (NF-e modelo 55)
O que documentaPrestação de serviço.Venda/movimentação de mercadoria.
Emitida paraPrefeitura municipal (cada município tem seu webservice).SEFAZ estadual.
TributosISS (municipal) + retenções federais (IRRF, PIS, COFINS, CSLL).ICMS, IPI, PIS, COFINS, ICMS-ST, FCP, DIFAL.
Vinculada aCliente + código de serviço municipal.Pedido + itens.
TelaListar NF Serviço (esta).Listar Notas Fiscais.

A NFS-e tem regras próprias por município — código de serviço, alíquota de ISS e formato do retorno mudam entre prefeituras.

Quais status uma NFS-e pode ter?​

StatusSignificado
PendenteRecém-criada, ainda não enviada à prefeitura.
ErroA emissão foi tentada e a prefeitura recusou (mensagem detalhada fica no histórico).
EnviadaLote em processamento na prefeitura.
EmitidaPrefeitura aceitou e devolveu número da NFS-e + código de verificação.
CanceladaNFS-e foi cancelada na prefeitura (perde validade fiscal).

Use a coluna Status NF para isolar o que precisa de ação.

Como criar uma nova NF de Serviço?​

Cadastros que você precisa ter antes

  • Empresa — com Inscrição Municipal e endereço completo cadastrados em Configurações → Empresa. Sem isso o sistema bloqueia com "Obrigatório preencher a inscrição municipal no cadastro da empresa" ou "Obrigatório preencher o endereço completo no cadastro da empresa".
  • Cliente — cadastrado em Clientes. Precisa pertencer à conta autenticada.
  • Código de serviço — código municipal do tipo de serviço prestado (cadastro de códigos por município).

Para criar:

  1. Clique em Nova NF de Serviço no topo da tela.
  2. Selecione a Conta (quando há multi-conta) e, se necessário, um Faturador diferente da conta principal.
  3. Selecione o Cliente e o Endereço de prestação (do cliente).
  4. Informe o Código de serviço (do município) e os campos do serviço: Quantidade, Valor unitário, Alíquota de ISS.
  5. Preencha as retenções quando aplicável: IRRF, PIS, COFINS, CSLL.
  6. Adicione Observações se quiser que apareçam na NFS-e.
  7. Clique em Salvar.

A NFS-e fica em status Pendente, aguardando emissão. Você pode emitir agora pelo botão Mais Ações → Emitir Nota Fiscal ou deixar para mais tarde.

Pré-requisito: privilégio Criar Nota Fiscal de Serviço.

Como editar uma NFS-e?​

Clique no ícone Editar (lápis) na linha ou dê duplo-clique na linha. A tela completa da NFS-e abre numa nova aba — você pode alterar cliente, código de serviço, valores, retenções, observações.

A edição só faz efeito enquanto a NFS-e está em Pendente ou Erro. Depois de emitida, a NFS-e fica imutável (qualquer correção exige cancelar e emitir uma nova).

Pré-requisito: privilégio Editar Nota Fiscal de Serviço.

Como excluir uma NFS-e?​

Clique no ícone Deletar (lixeira) na linha. Uma janela de confirmação aparece com o nome do cliente. Confirme para excluir.

A exclusão é definitiva — remove a NFS-e, seu histórico e as contas a receber vinculadas (se não houver pagamento baixado). Se você quer apenas anular a NFS-e já emitida, use Cancelar dentro da tela de detalhe (não Deletar).

Pré-requisito: privilégio Deletar Nota Fiscal de Serviço.

Quando o sistema bloqueia a exclusão?​

Duas situações principais:

  • "Status nota fiscal não excluir NFSe" — a NFS-e está em status posterior a Pendente ou Erro (Enviada, Emitida ou Cancelada). NFS-e já enviada à prefeitura não pode ser excluída no sistema; para anular uma emitida, use Cancelar (na tela de detalhe).
  • "Nota fiscal já tem pagamento baixado e não pode ser excluido" — existe uma conta a receber Paga ou Parcialmente Paga vinculada à NFS-e. Reverta o pagamento em Contas a Receber antes de excluir.

Como emitir a NFS-e na prefeitura?​

  1. Localize a NFS-e em Pendente na lista.
  2. Marque a caixa dela (à esquerda da linha).
  3. Abra Mais Ações → Emitir Nota Fiscal.
  4. Aguarde o retorno da prefeitura. Ao sucesso, o status passa para Enviada ou Emitida (depende da prefeitura — algumas devolvem na hora, outras processam em lote).
  5. Quando a prefeitura confirma, a NFS-e ganha Número, Código de verificação e fica disponível para download de XML/PDF na tela de detalhe.

Pré-requisito: privilégio Emitir Nota Fiscal de Serviço.

Como emitir várias NFS-e de uma vez?​

Marque várias caixas e use Mais Ações → Emitir Nota Fiscal. O sistema processa cada NFS-e individualmente (uma chamada por NFS-e à prefeitura). Erros isolados não bloqueiam as outras — cada uma é tratada separadamente.

O que pode dar errado na emissão?​

A maioria dos erros vem da prefeitura (cada município tem suas regras). Os mais comuns:

  • Código de serviço inválido — o código informado não existe na lista do município.
  • Alíquota de ISS divergente — o valor informado não bate com o esperado para o serviço/cidade.
  • CPF/CNPJ do cliente inválido — dados cadastrais com formato incorreto.
  • Endereço incompleto — falta CEP, número, bairro.
  • Certificado digital expirado — A1 da empresa fora da validade.
  • NFS-e fora de sequência — algumas prefeituras exigem numeração sequencial.

A mensagem retornada pela prefeitura é gravada na NFS-e (campo de observações/erro) e visível na tela de detalhe.

Como reemitir uma NFS-e com erro?​

  1. Localize a NFS-e em Erro na lista (filtro Status = Erro).
  2. Clique em Editar para abrir e ver a mensagem da prefeitura.
  3. Corrija o que estiver errado (dados, código, alíquota, etc.).
  4. Salve.
  5. Volte para a lista e marque a NFS-e.
  6. Mais Ações → Emitir Nota Fiscal.

O sistema reenvia para a prefeitura. Se o problema era no cadastro da empresa (inscrição municipal, certificado), ajuste lá antes de tentar de novo.

Como filtrar a lista?​

No painel Filtros, os campos disponíveis incluem:

  • Conta — quando há multi-conta.
  • Faturador — para isolar NFS-e emitidas por um faturador específico.
  • Cliente — pelo nome/razão social do cliente.
  • CPF/CNPJ — apenas dígitos.
  • Número NFS — pelo número da NFS-e emitida.
  • Status NF — Pendente, Erro, Enviada, Emitida, Cancelada.
  • Data criação — período em que a NFS-e foi cadastrada.
  • Data NF — período em que a NFS-e foi emitida.

Use o filtro de Status combinado com Data NF para conferências mensais.

Como abrir os detalhes da NFS-e?​

Duas opções:

  • Duplo-clique na linha — abre a tela completa da NFS-e numa nova aba (mesma ação do ícone Editar).
  • Ícone Editar (lápis) na linha.

Na tela de detalhe você vê todos os campos, o histórico de envios, a mensagem de erro (quando aplicável), os pagamentos vinculados e os botões para emitir, cancelar, baixar XML e baixar PDF.

Pré-requisito: privilégio Visualizar Nota Fiscal de Serviço.

O que preciso configurar antes de emitir a primeira NFS-e?​

Confira nesta ordem:

  1. Inscrição Municipal preenchida no cadastro da empresa (Configurações → Empresa).
  2. Endereço completo da empresa (rua, número, bairro, CEP, cidade, UF).
  3. Município habilitado para NFS-e — o sistema só permite emitir para cidades cujo município emite NFS-e via integração suportada. Se a sua cidade não está habilitada, contate o suporte.
  4. Certificado digital A1 dentro da validade, vinculado à empresa.
  5. Códigos de serviço do município cadastrados para a empresa.
  6. Cliente com dados corretos (CPF/CNPJ válido, endereço completo).

Sem isso o sistema bloqueia já no momento de criar — ou a prefeitura rejeita na emissão.

Posso emitir NFS-e em qualquer município?​

Não. O sistema só permite emitir para municípios habilitados — cidades cujo webservice de NFS-e o idworks já integrou. A verificação acontece automaticamente: ao tentar criar uma NFS-e, o sistema confere o município da empresa contra a lista de cidades habilitadas. Se não estiver habilitado, a criação é bloqueada.

Para verificar se o seu município é suportado, consulte o cadastro de códigos de serviço ou abra um chamado com o suporte.

Posso usar um faturador diferente da minha conta principal?​

Sim. No campo Faturador ao criar a NFS-e, você pode selecionar outra empresa do mesmo grupo (vinculada como Empresa Principal / CompanyMain). A NFS-e fica registrada na conta principal, mas é emitida no CNPJ/Inscrição do faturador escolhido. O sistema valida o vínculo antes de gravar.

Se o faturador informado não pertence ao grupo, retorna "Faturador não existe".

Como funciona a coluna Valor Pago?​

Mostra a soma dos pagamentos registrados nas contas a receber vinculadas à NFS-e. Por exemplo, NFS-e de R$ 1.000 com duas parcelas pagas de R$ 300 mostra R$ 600 na coluna.

Compare com a coluna de Valor para identificar NFS-e ainda em aberto (Valor Pago menor que Valor) e usar como ponto de partida para cobrança ou conciliação.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar Nota Fiscal de ServiçoAcesso à tela e abertura da NFS-e por duplo-clique.
Criar Nota Fiscal de ServiçoBotão Nova NF de Serviço.
Editar Nota Fiscal de ServiçoÍcone Editar (lápis) na linha.
Deletar Nota Fiscal de ServiçoÍcone Deletar (lixeira) na linha.
Emitir Nota Fiscal de ServiçoAção Mais Ações → Emitir Nota Fiscal.
Cancelar Nota Fiscal de ServiçoBotão Cancelar na tela de detalhe (anula uma NFS-e já emitida).