Pular para o conteúdo
Módulo 4 · Passo 14 de 18

Registrar no Hub a nota emitida na prefeitura

Quando a NFS-e precisou sair pelo portal da prefeitura, registre a nota no Hub com o XML ou o PDF, para as notas de saída baterem com a prefeitura e a nota não ser emitida duas vezes.

Disponível em: Todos os planos Atualizado em 2026-10-28
Financeiro para franqueados 14/18
← Financeiro para franqueados
Módulos da trilha
1. A estrutura da empresa
2. Onde nasce a receita
3. O dia a dia do contas a pagar e a receber
4. Nota e cobrança
5. Ler os números com o dono
Primeiros passos
O Hub
Apps
Cadastros
Tesouraria
Vendas
Fiscal
Resultados Econômico-Financeiros
Integrações

Etapa 1 de 2

Registre a nota

A nota que saiu pelo portal da prefeitura entra no Hub com o XML ou o PDF.

  1. No Fiscal, abra Notas de saída e clique em Registrar nota emitida fora.

  2. Em Escolha o XML ou o PDF da nota, envie o arquivo, com até 10 MB.

  3. Com XML, confira os Campos lidos do XML. Com PDF, preencha os campos que o Hub pede.

  4. Faça isso no mesmo dia da emissão.

  5. A nota registrada aparece com a origem Manual e a situação Registrada. O faturamento da venda continua na fila: não emita.

Etapa 2 de 2

Quando a nota foi cancelada na prefeitura

A nota do Hub cancelada direto no portal: registre o cancelamento no Fiscal.

  1. Em Notas de saída, clique na nota. O Hub abre o faturamento dela.

  2. Na aba Notas fiscais, clique na nota.

  3. Escolha Registrar cancelamento feito na prefeitura. Esse botão depende de permissão.

  4. Envie o PDF e o XML da nota cancelada e informe a Data do cancelamento e o Motivo.

  5. O Hub guarda os arquivos junto com a nota. A origem do cancelamento fica Na prefeitura, registro manual.

Precisa de mais? Abra um chamado dentro do Hub.

Ler este passo a passo em texto

O caminho normal é emitir a NFS-e pelo Fiscal. Às vezes isso não dá a tempo: a prefeitura está lenta, um erro do provedor ainda não foi resolvido, e o cliente precisa da nota hoje. Nesses casos a nota sai pelo portal da prefeitura, e o Hub precisa saber disso. Sem o registro, o Hub não sabe que a nota existe, e alguém pode emitir a mesma nota de novo dias depois.

O Hub precisa ser o espelho do que está na prefeitura: toda nota que existe lá tem de estar registrada aqui.

Antes de começar

  • A permissão Registrar NFS-e emitida fora do Hub no app Fiscal. Sem ela, o botão não aparece.
  • O XML ou o PDF da nota emitida na prefeitura, com até 10 MB. Com o XML, o Hub lê os campos sozinho. Com o PDF, você informa o número, a série, a data de emissão, o valor, o CPF ou CNPJ e o nome do tomador e, se tiver, o código de verificação.

Quando emitir fora do Hub

Emitir pelo portal da prefeitura é exceção, não atalho. Antes de ir para lá:

SituaçãoO que fazer
A emissão está demorando no fim ou no começo do mêsEspere. Nessas datas a prefeitura fica sobrecarregada, e uma nota que leva segundos pode levar minutos
A prefeitura recusou com um erro que você não entendeAbra um chamado pelo botão Suporte. Cada prefeitura responde do seu jeito, e o time ajuda a ler o erro
O cliente precisa da nota hoje e o erro não vai ser resolvido a tempoEmita pelo portal da prefeitura e registre no Hub logo em seguida

Registre a nota

  1. No Fiscal, abra Notas de saída e clique em Registrar nota emitida fora.
  2. Em Escolha o XML ou o PDF da nota, envie o arquivo.
  3. Com XML, confira os Campos lidos do XML. Com PDF, preencha os campos que o Hub pede.
  4. Clique em Registrar nota.

Faça isso no mesmo dia da emissão.

O registro guarda a nota, mas não fecha o faturamento da venda: ele continua na fila do Faturamento. Não emita esse faturamento, ou a mesma nota sai duas vezes. Para tirá-lo da fila, peça a quem tem a permissão Descartar e reativar faturamentos no Fiscal.

Quando a nota foi cancelada na prefeitura

O caminho inverso também existe: se uma nota emitida pelo Hub foi cancelada direto no portal da prefeitura, registre o cancelamento no Fiscal, para o Hub não continuar mostrando a nota como válida.

  1. Em Notas de saída, clique na nota. O Hub abre o faturamento dela.
  2. Na aba Notas fiscais, clique na nota e escolha Registrar cancelamento feito na prefeitura.
  3. Na janela Registrar cancelamento, envie o PDF e o XML da nota cancelada, informe a Data do cancelamento e o Motivo e clique em Registrar cancelamento. O Hub guarda os arquivos junto com a nota.

Esse botão também depende de permissão: Registrar cancelamento de NFS-e feito na prefeitura.

Como saber que deu certo

Em Notas de saída, a nota registrada aparece com a origem Manual e a situação Registrada. Um cancelamento registrado mostra Na prefeitura, registro manual como origem do cancelamento.

Problemas comuns

SintomaCausa provávelO que fazer
O botão Registrar nota emitida fora não apareceFalta a permissão no FiscalPeça ao administrador do app
A mesma nota existe duas vezes na prefeituraO faturamento da venda foi emitido pelo Hub depois de a nota ter saído pelo portalCancele a nota duplicada na prefeitura e registre o cancelamento no Fiscal
O faturamento da venda continua em A faturar depois do registroO registro não se liga ao faturamentoNão emita. Peça para descartar o faturamento a quem tem a permissão
O valor emitido no Hub não bate com o da prefeituraNota emitida fora e não registradaCompare Notas de saída com o portal e registre as que faltam

Próximo passo

Para o caminho normal de emissão, veja Fiscal: emitir a nota e responder pelas que chegam.

Não resolveu?

Abra um chamado pelo botão de suporte dentro do Hub. Nosso time responde e, quando é problema de produto, ele vira uma correção rastreável.

Abrir o Hub