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

Boas práticas

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.

Preciso preencher os campos Nbs, Cclasstrib, Indop e Operação?​

Na tela da NFS-e existe um bloco com quatro campos ligados à Reforma Tributária (IBS/CBS). Eles não travam o Salvar — a NFS-e fica em Pendente mesmo com eles em branco —, mas travam a emissão em parte dos municípios.

Campo na telaO que é
Nbs (Nomenclatura Brasileira de Serviços)Classificação nacional do serviço prestado. Escolha pela busca por código ou descrição.
Cclasstrib (Código de Classificação de Tributária)Classificação tributária do serviço. Ao escolher o Cclasstrib o sistema já traz junto o código de situação tributária do IBS/CBS correspondente — você não informa esse código separadamente.
Indop (Indicador de Operação)Indicador da operação de fornecimento, que define o local de incidência do IBS. Só fica habilitado depois que o Nbs é escolhido: a lista de indicadores é filtrada pelo Nbs selecionado.
OperaçãoNormal ou Consumidor Final.

Quando eles são obrigatórios

  • Padrão nacional da NFS-e — o bloco de IBS/CBS só entra na nota quando o Cclasstrib está preenchido. Preencheu o Cclasstrib e deixou o Indop em branco? A emissão para com "Código indicador da operação de fornecimento obrigatório para emissão da NFSe com grupo IBS/CBS". Ou preenche os dois, ou deixa os dois em branco.
  • Barueri (SP) — o município passou a exigir esse bloco em toda emissão e todo cancelamento. Faltando Nbs, Cclasstrib ou Indop, a emissão para com "Campos obrigatórios do registro tipo 4 (Ambiente de Dados Nacional) ausentes ou inválidos", listando o que faltou.

Serviços de evento ainda não saem em Barueri. Códigos de serviço iniciados em 12 (eventos) exigem nome do evento e datas de início/fim, que ainda não têm campo no cadastro. A emissão para com "Serviço de evento ... exige Nome do Evento e datas de início/fim no registro tipo 4, ainda não suportados". Para esses serviços, emita pelo portal da prefeitura até que o campo exista.

Se você já usa a NFS-e e nunca preencheu esses campos: volte nas NFS-e ainda em Pendente dos municípios acima e complete o bloco antes de emitir — só o Salvar não avisa.

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 e confirme.

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 excluído" — 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.

Além desses, o idworks faz algumas conferências antes de enviar e para com uma mensagem em português:

MensagemCausaComo resolver
"Inscrição Municipal do prestador inválida (recebido: ... com N caracteres, esperado no máximo 15)"A Inscrição Municipal da empresa emissora tem mais de 15 dígitos — normalmente porque foi digitada junto com outro número.Corrija o campo em Configurações → Empresa. Só a inscrição municipal, sem a estadual e sem outro código junto.
"Código IBGE do município do prestador inválido" / "Código IBGE do município do tomador inválido"O município da empresa (ou do cliente) não está reconhecido — normalmente CEP ou cidade preenchidos à mão, fora do padrão.Refaça o endereço pelo CEP em Configurações → Empresa ou no cadastro do Cliente, escolhendo a cidade pela lista.
"UF do tomador não confere com o município"O estado gravado no endereço do cliente não é o estado a que a cidade pertence (ex.: cidade de SP com UF MG). A prefeitura recusa essa combinação.Corrija o endereço do cliente — deixe UF e cidade coerentes.
"Campos obrigatórios do registro tipo 4 (Ambiente de Dados Nacional) ausentes ou inválidos"Faltam os campos de IBS/CBS. Ver Preciso preencher os campos Nbs, Cclasstrib, Indop e Operação?.Complete Nbs, Cclasstrib e Indop na NFS-e e emita de novo.
"Código indicador da operação de fornecimento obrigatório para emissão da NFSe com grupo IBS/CBS"O Cclasstrib foi preenchido mas o Indop ficou em branco.Escolha o Indop (ele só habilita depois do Nbs) ou limpe o Cclasstrib.
"Serviço de evento ... exige Nome do Evento e datas de início/fim no registro tipo 4, ainda não suportados"Código de serviço de evento (iniciado em 12) em Barueri.Emita essa nota pelo portal da prefeitura; o cadastro do evento ainda não existe no idworks.

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

Emiti a NFS-e mas o PDF não abre — e agora?​

A nota está emitida — o PDF é uma etapa separada. Nos municípios do padrão nacional, quem gera a DANFSE é o ambiente nacional, e ela costuma ficar pronta alguns segundos depois da autorização. O idworks tenta buscar o arquivo várias vezes seguidas logo após a emissão; se mesmo assim não vier, ele:

  1. Mantém a NFS-e emitida e válida (o número e a chave já saíram).
  2. Registra no histórico da NFS-e um evento de erro explicando que a DANFSE não foi devolvida.

O que fazer: aguarde alguns minutos e abra o PDF de novo pela tela de detalhe. Se continuar indisponível por horas, acione o suporte com o número e a chave de acesso da nota — o XML continua disponível para download e vale como documento fiscal.

No cancelamento vale a mesma lógica, com um detalhe importante. Se o cancelamento foi aceito pela prefeitura mas o novo PDF não veio, o histórico registra "Cancelamento registrado na SEFIN, mas o DANFSE cancelado não foi obtido — o PDF armazenado ainda é o autorizado, sem tarja". Ou seja: a nota está cancelada, mas o PDF guardado ainda é o da autorização, sem a tarja de cancelamento. Não use esse PDF como comprovante de cancelamento — use o XML do evento ou o portal da prefeitura.

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). 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.

Boas práticas para a NFS-e​

Deixar o cadastro completo antes de emitir evita recusa da prefeitura, NFS-e travada e correção que só dá para fazer cancelando. Vale seguir estes cuidados:

  • Complete a empresa antes da primeira NFS-e. Inscrição Municipal, endereço completo, certificado A1 dentro da validade e os códigos de serviço do município são pré-requisito — sem eles o sistema bloqueia na criação ou a prefeitura recusa na emissão.
  • Confirme que o município está habilitado. O sistema só emite para cidades já integradas; se a sua não estiver, a criação é barrada. Verifique antes de prometer prazo ao cliente.
  • Revise cliente, código de serviço e alíquota de ISS antes de emitir. São as causas mais comuns de recusa da prefeitura (código inválido, alíquota divergente, CPF/CNPJ ou endereço incompleto). Conferir antes economiza uma rodada de erro.
  • Faça todas as correções enquanto está em Pendente ou Erro. Depois de emitida a NFS-e fica imutável — qualquer ajuste exige cancelar e emitir uma nova. Acerte os dados antes de mandar para a prefeitura.
  • Para reemitir uma NFS-e com erro, leia a mensagem da prefeitura primeiro. Ela fica registrada na nota; corrija exatamente o que ela aponta antes de reenviar, senão a prefeitura recusa de novo.
  • Cancele, não exclua, uma NFS-e já emitida. Excluir só vale para Pendente/Erro; para anular uma emitida o caminho é Cancelar na tela de detalhe — e reverta o pagamento em Contas a Receber antes, senão a exclusão é bloqueada.
  • Use a coluna Valor Pago para achar o que está em aberto. Valor Pago menor que o Valor da nota mostra NFS-e ainda não quitada — bom ponto de partida para cobrança e conciliação.

Resumo de parametrizações​

Acesse em Configurações → Parametrizações → Fiscal Serviço. São as parametrizações que afetam a NFS-e:

ParametrizaçãoSubmenuO que muda quando ativada
Percentual retenção IRFiscal ServiçoPreenche sozinho o valor de retenção de IRRF ao criar ou editar a NFS-e, calculado sobre o valor total dos serviços.
Percentual retenção PISFiscal ServiçoMesma lógica, para a retenção de PIS.
Percentual retenção COFINSFiscal ServiçoMesma lógica, para a retenção de COFINS.
Percentual retenção CSLLFiscal ServiçoMesma lógica, para a retenção de CSLL.
Gerar boleto após emissão NFFiscal ServiçoGera o boleto automaticamente depois que a NFS-e é emitida. Só funciona quando o tipo de pagamento do registro é boleto e a integração bancária está configurada.
Ignorar itens tipo serviço na emissão da nota fiscalFiscal ServiçoAfeta a NF-e de produto, não a NFS-e: tira os itens de serviço da NF-e para que eles sejam faturados separadamente aqui.

Duas regras importantes das retenções:

  • Só preenchem o que está em branco. Se você informar o valor da retenção manualmente na NFS-e, o percentual parametrizado não sobrescreve o que você digitou.
  • Valor mínimo de R$ 10. Quando o cálculo dá R$ 10 ou menos, a retenção é gravada como zero em vez do valor calculado.

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).
Última atualização em