Pular para o conteúdo principal

NF Serviço Tomado

A tela NF Serviço Tomado é a caixa de entrada das notas fiscais de serviço que a empresa recebe de fornecedores. Cada linha é uma NFSe emitida por algum prestador para o CNPJ da empresa, capturada automaticamente do sistema da prefeitura. A tela é puramente consultiva: o operador pode visualizar a DANFSE em PDF, baixar o XML original e filtrar por período, fornecedor, número da nota ou tags — não há lançamento, edição, exclusão ou pagamento por aqui.

A entrada das notas no feed não é manual e não vem por integração de marketplace: o sistema executa um job periódico que consulta os webservices de NFSe das prefeituras usando o certificado digital A1 cadastrado na empresa. As notas chegam aqui de forma automática, com atraso de minutos a horas conforme o município, e ficam armazenadas com o XML original e a DANFSE em PDF (quando o município ou o ambiente nacional ADN gera o PDF).

Como o feed não tem parametrizações próprias (Configurações → Parametrizações não tem nada que afete esta tela), os pré-requisitos para o feed funcionar ficam no cadastro da empresa (em Configurações → Empresa): o certificado digital A1 precisa estar cadastrado e válido, e a opção de recebimento do feed precisa estar ativa.

Índice​

Conceito

Visualização e busca

Ações disponíveis

Regras de negócio

Pré-requisitos e configuração

Referência rápida

O que é a tela NF Serviço Tomado?​

É a caixa de entrada das notas fiscais de serviço emitidas para o CNPJ da empresa por seus fornecedores. O sistema busca essas notas direto na prefeitura e mostra aqui — junto com o XML e a DANFSE em PDF — para que o time financeiro/fiscal possa acompanhar tudo que foi emitido contra a empresa.

A tela é somente consulta: você visualiza, filtra, baixa o XML e abre o PDF. Não há criação, edição ou exclusão de notas aqui — a nota é da prefeitura, não do idworks.

📍 Onde: menu lateral → Notas Fiscais → NF Serviço Tomado.

Qual a diferença entre NF Serviço Tomado e NF Serviço Emitida?​

NF Serviço Tomado (esta tela)NF Serviço Emitida
Quem emiteO fornecedor, contra o CNPJ da empresa.A empresa, contra um cliente.
Origem da notaConsulta automática à prefeitura (não vem do idworks).Criada pelo idworks via envio ao sistema da prefeitura.
Tem botão Nova?Não — caixa de entrada, sem lançamento manual.Sim — botão Nova NFSe lança e envia.
Permite editar / excluir?Não (a nota pertence à prefeitura).Sim, enquanto a NF não foi emitida.
OndeNotas Fiscais → NF Serviço Tomado.Notas Fiscais → NF Serviço (NFSe Emitida).

A NF Tomado serve para rastreabilidade e conferência fiscal (saber tudo que entrou contra o CNPJ); a NF Emitida serve para operação (emitir, cancelar, anexar a pagamentos).

De onde vêm as notas (como elas aparecem aqui)?​

As notas não vêm por integração de marketplace nem por upload manual. O fluxo é:

  1. Um job interno do idworks executa periodicamente, por empresa cadastrada com o feed habilitado.
  2. Para cada município habilitado na base, o sistema consulta o webservice da prefeitura (ou o Ambiente Nacional ADN para municípios suportados) usando o certificado digital A1 da empresa para se autenticar.
  3. As notas retornadas são gravadas com o XML original e — quando disponível — a DANFSE em PDF.
  4. Notas que já estão no feed são atualizadas (ex.: quando vira cancelada na prefeitura).
  5. Após cada consulta bem-sucedida, o sistema marca a data da última atualização da empresa.

Atraso típico: minutos a algumas horas após a emissão pela prefeitura, dependendo da frequência do job e do desempenho do webservice municipal. Notas emitidas fora do horário do job só aparecem na próxima execução.

O que significa cada status?​

A coluna Status mostra como a nota está no sistema da prefeitura ou no ciclo do ambiente nacional:

StatusSignificado
EmitidaNota emitida e válida na prefeitura/ambiente nacional. É o status inicial e o mais comum no feed.
CanceladaA nota foi cancelada — seja por cancelamento comum, por substituição por outra nota ou por análise fiscal. O sistema registra todos esses eventos como Cancelada e preenche a Dt. cancelamento com a data do evento.

Independente do evento que a prefeitura informa, o feed normaliza a situação da nota para esses dois status. Quando o fornecedor substitui uma nota, a original aparece como Cancelada e a substituta entra no feed como uma nova nota Emitida. As cores separam visualmente: vermelho para Cancelada, azul claro para Emitida.

Como buscar e filtrar notas?​

A tela tem uma gaveta lateral com os filtros principais:

  • Conta — quando a empresa opera com mais de uma conta.
  • Empresa — filtra pelo faturador da nota (CNPJ da filial).
  • Data emissão — intervalo de datas em que a nota foi emitida na prefeitura.
  • Nota fiscal — número da NFSe.
  • Nome do fornecedor — nome ou razão social do emissor.
  • Documento — CPF/CNPJ do fornecedor (digite com ou sem pontuação).
  • Tags — filtra por tags atribuídas à nota.

Clique no ícone de filtro no cabeçalho para abrir a gaveta, combine os filtros e clique em Buscar. A tela paginação carrega até 500 registros por página.

O que aparece em cada coluna da tabela?​

A tabela tem dezenas de colunas (a maioria oculta por padrão, ativáveis pelo seletor de colunas). As principais:

  • Data emissão — data e hora da emissão pela prefeitura.
  • Status — situação atual da nota (Emitida, Cancelada, etc.).
  • R$ valor — valor total do serviço.
  • Nota fiscal — número da nota.
  • Chave de acesso — chave de identificação na prefeitura.
  • Evento — descrição do serviço prestado (do CNAE/lista da prefeitura).
  • Fornecedor — nome do emissor (clique no ícone de olho para abrir o cadastro do fornecedor).
  • Documento — CPF/CNPJ do emissor.
  • Cidade, UF, Cód. ibge — município da emissão.
  • Insc. municipal — inscrição municipal do emissor.
  • Cód. verificação — código de verificação do município.
  • NSU — número sequencial único (controle interno do ambiente nacional).
  • R$ ISS, ISS alíquota, ISS retido — dados de ISS.
  • R$ PIS, R$ COFINS, R$ ir, R$ CSLL, R$ crédito — retenções de tributos federais e crédito da nota.
  • Cód. NFS — código do serviço (CNAE municipal).
  • Dt. cancelamento — preenchida quando a nota foi cancelada.
  • Comentários — observações da nota.
  • Tags — tags atribuídas pelo operador.
  • Empresa, Conta — empresa faturadora e conta no idworks.

Personalize quais colunas aparecem clicando no seletor de colunas no canto superior direito da tabela.

Como baixar o XML de uma nota?​

Na linha da nota, clique no ícone de download de nuvem (tooltip "Realizar Download do arquivo XML"). O navegador inicia o download do arquivo .xml com o conteúdo original retornado pela prefeitura.

O XML é útil para:

  • Conciliação fiscal com o sistema contábil.
  • Importação em outros sistemas (ERP, BI fiscal).
  • Auditoria — é o documento oficial assinado pela prefeitura.

Como visualizar a DANFSE (PDF) de uma nota?​

Na linha da nota, clique no ícone de PDF (tooltip "Visualizar DANFe"). Abre a janela Visualização com a DANFSE renderizada num PDF inline — você pode navegar, salvar ou imprimir pelo próprio visualizador.

A DANFSE vem de dois caminhos diferentes, conforme o sistema do município emissor:

MunicípioDe onde sai o PDF
São Paulo (sistema Prodam) e Barueri (sistema eISS)A prefeitura devolve só o XML. O idworks monta a DANFSE na hora, a partir do XML guardado.
Demais municípios (padrão nacional da NFSe)A DANFSE já vem pronta do ambiente nacional e fica guardada junto com a nota. A janela apenas exibe o arquivo guardado.

Por isso, nas notas do padrão nacional o PDF pode demorar a ficar disponível: se o arquivo ainda não tiver sido guardado quando você clicar, a tela avisa que a DANFSE do padrão nacional está indisponível no armazenamento e mostra a chave de acesso da nota. Nesse caso, aguarde a próxima execução do feed e tente de novo — o XML continua disponível para download e é o documento oficial. Se passar horas assim, acione o suporte com a chave de acesso.

Em quais municípios o feed funciona?​

O feed depende de dois suportes simultâneos:

  1. Suporte do município — a prefeitura precisa expor um webservice de consulta de NFSe recebidas (ou aderir ao Ambiente Nacional ADN). Municípios sem webservice de consulta não entram no feed.
  2. Suporte do idworks — o município precisa estar habilitado internamente na base de cidades suportadas. Os municípios suportados hoje incluem:
    • Ambiente Nacional ADN — cobre os municípios que aderiram à NFSe nacional.
    • São Paulo (sistema Prodam).
    • Barueri (sistema eISS) — consulta as notas recebidas por período, a partir do CPF/CNPJ da sua empresa como tomadora.
    • Outros municípios com webservice próprio adicionados conforme demanda.

Para verificar se um município específico está suportado, abra um chamado no suporte — a lista é atualizada conforme as prefeituras publicam novas APIs ou aderem ao ADN.

Por que uma nota não apareceu no feed?​

Causas mais comuns:

  • Município não suportado — a prefeitura emissora não tem webservice de consulta ou ainda não foi habilitada no idworks.
  • Certificado digital expirado ou não cadastrado — sem certificado válido, o sistema não consegue se autenticar no webservice municipal.
  • Feed da empresa não habilitado — a opção de recebimento de NF Serviço Tomado precisa estar ativa no cadastro da empresa.
  • Nota recém-emitida — o feed roda periodicamente, então notas emitidas há poucos minutos podem ainda não ter sido coletadas.
  • Inscrição municipal divergente — algumas prefeituras só retornam notas para o CNPJ + Inscrição Municipal correta; verifique se a inscrição municipal está cadastrada na empresa.
  • Erro no XML retornado — a nota foi processada mas falhou na validação; aparece com status de erro, ou não aparece se a falha foi no início do processamento.

Quando a nota não aparece após algumas horas, abra um chamado no suporte com a chave de acesso e o CNPJ do fornecedor para investigação.

Por que uma nota cancelada na prefeitura também aparece aqui?​

O feed sincroniza todo o ciclo de vida da nota, não só a emissão. Quando o fornecedor cancela uma nota no portal da prefeitura, na próxima execução do job o idworks recebe o evento de cancelamento e:

  • Atualiza o status da nota para Cancelada.
  • Preenche o campo Dt. cancelamento com a data do evento.
  • Mantém o XML original e adiciona o XML do evento de cancelamento.

Isso é importante para o time fiscal: notas canceladas precisam ser identificadas e desconsideradas no fechamento — o feed mostra a transição completa em vez de apagar a nota.

As notas do feed lançam automaticamente no Contas a Pagar?​

Não. Esta tela é puramente consultiva — não cria contas a pagar nem vincula a uma compra existente. O fluxo de pagamento de uma NF de serviço tomada é separado:

  1. Quando há pedido de compra de serviço ou lançamento manual de contas a pagar, o time financeiro registra o título normalmente em Financeiro → Contas a Pagar.
  2. A NF do feed serve como comprovante fiscal — pode ser baixada (XML) e anexada ao contas a pagar manualmente, ou usada para conferência durante o lançamento.
  3. A conexão entre a NF e o título financeiro acontece pelos dados comuns (CNPJ do fornecedor, valor, data), não por vínculo automático.

Empresas que precisam de vínculo automático geralmente integram o feed com o ERP/BI fiscal via o XML baixado.

Posso editar ou excluir uma nota do feed?​

Não. O feed é um espelho do que está na prefeitura. Os dados da nota não podem ser alterados — qualquer correção precisa ser feita pelo emissor (o fornecedor), no portal da prefeitura. O sistema apenas atualiza o feed na próxima execução do job, refletindo a correção (ou cancelamento + nova nota).

A única ação que o operador pode fazer sobre a nota é atribuir tags (em outras telas relacionadas — não nesta) para classificação interna; o conteúdo fiscal em si permanece imutável.

Como habilitar o recebimento de NF Serviço Tomado?​

A configuração fica no cadastro da empresa, não em parametrizações:

  1. Acesse Configurações → Empresa e abra o cadastro da empresa.
  2. Na aba/seção de configurações fiscais, ative a opção Recebimento de NF Serviço Tomado.
  3. Garanta que o certificado digital A1 está cadastrado e dentro da validade (próxima seção).
  4. Confirme que a Inscrição Municipal está preenchida — necessária para alguns municípios.
  5. Salve.

A partir da próxima execução do job (rotina interna), o sistema começa a consultar as notas para o CNPJ da empresa.

Por que preciso de certificado digital?​

A consulta de NFSe na prefeitura é autenticada pelo certificado digital A1 da empresa — é assim que o sistema da prefeitura sabe que quem está perguntando é a empresa dona daquele CNPJ (e não um terceiro tentando ver notas alheias).

Sem certificado válido:

  • A consulta falha na autenticação.
  • Nenhuma nota é trazida.
  • O cadastro da empresa não consegue salvar a opção de feed ativa (alguns municípios validam na hora).

O certificado é cadastrado em Configurações → Empresa na seção do certificado digital — informe o arquivo .pfx e a senha. O idworks armazena com segurança e usa apenas para autenticar nas consultas oficiais.

O que acontece se o certificado digital expirar?​

O job continua executando, mas todas as consultas para a empresa falham porque o sistema da prefeitura recusa autenticação com certificado vencido. Resultado:

  • Nenhuma nova nota aparece no feed.
  • As notas que já estavam no feed continuam visíveis (não somem), mas ficam desatualizadas — cancelamentos e novos eventos não são sincronizados.
  • A data de última atualização do feed da empresa para de avançar.

Para retomar o feed: cadastre o novo certificado A1 em Configurações → Empresa. As consultas voltam a funcionar na próxima execução do job, e o sistema recupera as notas emitidas durante o período de pausa (dentro da janela de busca padrão, tipicamente os últimos 10 dias — ou 30 dias quando a empresa nunca tinha sincronizado antes).

Resumo de parametrizações​

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. A configuração do feed vive em outras telas:

Onde configurarO que define
Configurações → Empresa (cadastro da empresa)Ativar o recebimento de NF Serviço Tomado, cadastrar o certificado digital A1, preencher a Inscrição Municipal.
Configurações → Empresa (validade do certificado)Atualizar o certificado A1 quando o atual expirar — pré-requisito obrigatório para o feed funcionar.

A lista de municípios suportados é mantida internamente pelo idworks e atualizada conforme as prefeituras publicam novos webservices ou aderem ao Ambiente Nacional ADN. Não é configurável pelo lojista.

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 NF ServiçoAcesso à tela, à busca/filtros e à visualização da DANFSE (PDF). O ícone de PDF não depende de nenhum privilégio adicional.
Baixar XML NFsÍcone de download de nuvem na linha, que baixa o arquivo XML da nota. Sem este privilégio o ícone some e o operador só consegue ver a DANFSE.

Atenção ao procurar o privilégio de download. Na tela de Perfis de Acesso, Visualizar NF Serviço fica no módulo Feed Nota Fiscal Serviço, mas Baixar XML NFs fica no módulo Feed Nota Fiscal (o mesmo do feed de notas de produto). Se você liberar só o módulo de serviço, o download do XML continua bloqueado.

Última atualização em