Notas fiscais

Documentos > Notas fiscais (/fiscal-documents) reúne as "Notas recebidas contra as empresas do espaço" — as NF-e (produto) e NFS-e (serviço) que os seus fornecedores emitiram contra os CNPJs cadastrados. Elas entram sozinhas pelas integrações ou pela mão, e a partir daqui você as concilia e transforma em título.

observação

Aqui é a nota que VOCÊ recebe, não a que você emite. O Financeiro não emite nem cancela nota fiscal — ele guarda, lê e concilia o que chega. Cancelar ou reemitir é sempre do lado de quem emitiu.

De onde vem cada nota

Origem	Como entra	Como aparece
nfe.io	captura automática das NFS-e de serviço recebidas	notas de Serviço, prontas na lista
Importação de XML	você envia os arquivos em "Importar XML"	um XML ou um ZIP com o mês inteiro
SEFAZ	busca por chave de acesso	a nota puxada da SEFAZ pela chave

dica

Um ZIP com o mês inteiro funciona. Em "Importar XML" você pode soltar um pacote com vários XMLs de uma vez — o que já existe é ignorado, e só o que é novo entra.

Encontrar uma nota

A busca no topo aceita "Buscar por chave, número ou emitente". As abas separam por tipo — Todas, Serviço e Produto — e os filtros recortam o que importa:

Filtro	O que mostra
Sem empresa vinculada	notas cujo CNPJ do tomador não casou com nenhuma empresa
Com título gerado	notas que já viraram conta a pagar
Sem título gerado	notas que ainda não viraram título
Data de criação	quando a nota entrou no espaço

Cada nota mostra a situação — Autorizada, Cancelada ou Indefinida — e, quando só o resumo da nota é conhecido, o marcador Resumo.

informação

Resumo é uma nota sem o detalhe. A SEFAZ entrega ao destinatário só o cabeçalho da NF-e até você manifestar — sem itens nem duplicatas. Uma nota Resumo aparece na lista, mas não tem os itens para conferir nem parcelas para gerar título.

A empresa vinculada

A nota é ligada a uma empresa do espaço pelo CNPJ do tomador. Quando nenhum CNPJ cadastrado casa, ela fica Sem empresa vinculada — previsto, não erro: a nota pode ter sido emitida contra um CNPJ que você ainda não cadastrou, ou contra um CPF.

Na tela da nota, quando não há vínculo, um botão revincula — útil depois de cadastrar a empresa que faltava.

Ler a nota

Ao abrir uma nota você vê:

• Prestador e Tomador — razão social, CNPJ e endereço de cada lado.
• Valores e impostos — valor do serviço, base de cálculo, ISS e os impostos retidos (IRRF, PIS, COFINS, CSLL, INSS), com o valor líquido.
• Serviço (NFS-e) ou Itens (NF-e) — a descrição e os códigos fiscais, ou a lista de produtos.
• Duplicatas e Contas a pagar — as parcelas da nota e os títulos já gerados a partir dela.

Virar conta a pagar

A partir das duplicatas da nota você gera as contas a pagar — uma por parcela. Notas sem duplicata usam a data de vencimento que você informar na geração. O que já foi gerado aparece na aba Contas a pagar da nota, e o filtro Com título gerado separa na lista o que já foi convertido do que ainda falta.

Baixar os arquivos

Ação	O que faz
Copiar XML	copia o XML da nota para a área de transferência
Baixar XML	baixa o XML guardado da nota
Baixar todas	gera um ZIP com os XMLs de todas as notas do filtro atual

aviso

Nem toda nota tem XML guardado. Uma nota Resumo pode não ter o XML — nesse caso "Baixar XML" fica indisponível e o rótulo mostra "Sem XML guardado".

Pela API

As notas fiscais também são expostas, somente leitura, na API v1 sob o escopo finance.fiscal_documents:

• Listar notas fiscais — página paginada, com filtros por empresa, tipo, situação, origem, chave, número e data.
• Obter nota fiscal por ID — a nota individual.

O xml_download_url que a API devolve aponta para o recurso de anexos, então baixar os bytes do XML exige também o escopo finance.attachments.

Relacionado

• Comprovantes — a prova do pagamento que sai
• Anexos — onde os arquivos das notas ficam guardados
• Contas a pagar — para onde a nota vira título
• Integrações — a captura das NFS-e pela nfe.io