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. Status mais comum no feed.
CanceladaNota emitida foi cancelada na prefeitura. Marcada com a data de cancelamento.
SubstituídaNota foi substituída por outra (a substituta também aparece no feed).
ConferidaOperações que usam o controle de conferência fiscal — nota já passada pelo time financeiro.
PendenteEstado transitório enquanto o sistema ainda está processando a nota.
ErroFalha no processamento do XML (chave inválida, schema rejeitado, etc.).

Cada município (e o ambiente nacional ADN) tem seu próprio conjunto exato de status, então a lista mostra exatamente o que a prefeitura informou. As cores ajudam a separar visualmente: vermelho para situações que exigem atenção (cancelada, substituída, erro), azul/laranja para situações em conferência, azul claro para emitida/conferida.

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.

Nem toda nota tem PDF disponível: prefeituras que usam o Ambiente Nacional ADN (CityCode 0 — padrão da NFSe nacional) já fornecem a DANFSE em PDF pronta, mas algumas prefeituras com webservice próprio (São Paulo/Prodam, por exemplo) só retornam o XML — nesses casos o PDF é renderizado sob demanda pelo idworks a partir do XML.

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).
    • 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, à visualização da DANFSE (PDF) e ao download do arquivo XML.