Emissão de NFS-e

A NFS-e (Nota Fiscal de Serviços eletrônica) é emitida diretamente a partir de cada fatura do módulo financeiro, integrada ao ADN (Ambiente de Dados Nacional) do padrão nacional nfse.gov.br. Você emite, baixa o DANFSE e o XML, envia ao paciente (por e-mail e WhatsApp, com o PDF), cancela e acompanha o histórico sem sair da Clínica.

Pré-requisitos para emitir

A NFS-e só pode ser emitida quando todas as condições abaixo são atendidas:

• A clínica tem uma configuração de NFS-e ativa (isActive). Sem ela, a emissão retorna "Configuração de NFS-e não encontrada ou inativa para esta clínica".
• A fatura está com status Pago ou Enviado. Faturas em outros status mostram "A fatura precisa estar com status Pago ou Enviado para emitir NFS-e."
• Se a clínica ativou Emitir NFS-e somente após o pagamento (veja a configuração), só faturas Pagas (marcadas como pagas ou conciliadas no extrato) podem ser emitidas. Em uma fatura apenas enviada, o botão Emitir NFS-e não aparece e o bloco mostra "Esta clínica emite NFS-e somente após o pagamento. Marque a fatura como paga ou concilie-a primeiro."
• O valor total da fatura é maior que zero. Faturas zeradas mostram "Fatura com valor zero — NFS-e não pode ser emitida."
• O CPF do responsável financeiro (tomador) e o endereço estão preenchidos (você pode completá-los no próprio momento da emissão).

Você precisa de permissão de escrita em Financeiro para emitir e cancelar; enviar a NFS-e ao paciente é dos administradores. A leitura (download de PDF/XML e histórico) exige apenas permissão de leitura.

Dois modos de emissão

O modo é definido pelo cadastro do paciente, pela opção Emitir NFS-e individual por sessão (nfsePerAppointment):

Emitir por fatura

A descrição padrão é gerada automaticamente a partir das sessões do período, do nome do paciente, do profissional e do CRP/registro. O valor unitário declarado e as datas listadas vêm dos itens da fatura — se as sessões tiverem valores diferentes (serviços com preços distintos), a descrição lista quantidade × valor em vez de um único valor unitário. Créditos reduzem o total, e a nota lista apenas as sessões que cabem no valor líquido faturado. Lançamentos avulsos sem data de sessão (ajustes de importação, por exemplo) entram no valor da nota, mas não são declarados como sessão na descrição. Um administrador pode editá-la antes de confirmar. Se o cadastro do paciente tiver uma observação fiscal (nfseObs), ela aparece em destaque vermelho no topo do diálogo.

Emitir por sessão (por item)

Quando o paciente está marcado como NFS-e por sessão, cada item faturável aparece como um cartão com a data, o valor e a descrição da sessão. Em cada cartão:

• Emitir NFS-e emite a nota daquele item. O diálogo abre para você revisar a descrição e os dados do tomador antes de confirmar.
• Após emitida, o cartão mostra a etiqueta #<número> e os botões de PDF, Gov.br e cancelar. O envio ao paciente é um só para a fatura inteira, no topo da seção (abaixo).
• Itens com erro mostram Tentar novamente; itens cancelados mostram Re-emitir.

O cabeçalho exibe o progresso (ex.: 3/5 emitidas). Quando parte dos itens foi emitida, a fatura fica com status agregado PARCIAL.

Faturas com crédito

Quando a fatura tem um item de crédito (sessão desmarcada de acordo, por exemplo), o valor do crédito é abatido das sessões da mais antiga para a mais recente, e só depois as notas são propostas:

• A sessão coberta pelo crédito aparece com o valor riscado e o aviso "Coberta por crédito da fatura — não gera NFS-e", sem botão de emitir.
• Se o crédito não fecha exatamente com o valor de uma sessão (o crédito vale o preço da sessão que o originou, que pode ser de outro serviço), a sessão seguinte é emitida pelo valor reduzido, com o aviso de quanto foi coberto.
• O contador X/Y emitidas considera apenas as sessões que realmente geram nota.

Exemplo: uma fatura de três sessões de R$ 590 com um crédito de R$ 590 vale R$ 1.180 e gera duas notas de R$ 590 — a sessão mais antiga é a coberta.

Status da NFS-e

DANFSE (PDF) e XML

Para uma NFS-e EMITIDA, o bloco oferece dois caminhos de download do PDF:

• PDF — gera o DANFSE localmente a partir dos dados e do XML armazenados, com QR Code de verificação. É o caminho padrão e mais rápido.
• Gov.br — busca o DANFSE diretamente no ADN/nfse.gov.br. Use quando precisar do documento oficial direto da fonte. Se o servidor do ADN estiver indisponível, o sistema avisa para tentar novamente em alguns minutos.

O XML assinado fica armazenado junto à emissão e é exportável no download em massa (veja abaixo). O nome do arquivo segue o padrão NFS-e-<número>-<nome-do-paciente>.pdf.

Todas as NFS-e de uma fatura

Com emissão por sessão, uma fatura tem uma NFS-e para cada sessão. Na lista de faturas, na seção NFS-e por sessão da fatura e na aba Financeiro do paciente, você baixa todas de uma vez: em um único PDF (uma nota por página, na ordem de emissão, arquivo NFS-e-<nome-do-paciente>-<ano>-<mês>.pdf) ou separadas em um ZIP. Com uma nota só, o download é o PDF dessa nota. Esse PDF é sempre gerado localmente; para a versão do Gov.br, use o botão de cada nota.

Enviar ao paciente

A NFS-e vai ao paciente com o PDF — em anexo no e-mail e como documento no WhatsApp, nunca como link — do mesmo jeito que a fatura: um Conferir e enviar com as pessoas e os canais, e o envio na fila. Ela vai para as mesmas pessoas da fatura: quem está marcado em Cobrança no cadastro do paciente, ou o contato principal se ninguém estiver. O responsável financeiro (tomador) da nota não muda e não depende de quem recebe o envio: a nota pode estar no nome do pai e ir também para a mãe. Uma fatura com várias notas (uma por sessão) manda todas as notas autorizadas em um PDF só, numa única mensagem. O passo a passo, o envio em lote e o que acontece depois estão em Enviar a NFS-e para o paciente.

Os canais são os que NFS-e tem ligados em Configurações → Notificações. No WhatsApp a nota sai num modelo aprovado pela Meta com o PDF anexado; enquanto a Meta não aprova esse modelo no número que envia, a nota sai só por e-mail — não há volta para o antigo link de 7 dias. O texto do e-mail é editável em Notificações → NFS-e.

Agendar o envio

No Conferir e enviar da NFS-e, ou no envio em lote (Enviar NFS-e (N)), escolha Agendar envio e informe a data (DD/MM/AAAA) e o horário (HH:mm, horário da clínica — o fuso definido em Configurações → Geral; por padrão, Brasília), de 5 minutos a 30 dias à frente — por exemplo, no domingo à noite para segunda, 08:00. No lote, o mesmo horário vale para todas as notas.

• A lista de faturas mostra NFS-e agendada · seg 03/11 08:00 na coluna NF, e o bloco da NFS-e mostra o horário com o link Cancelar agendamento (depois que o envio começou, não dá mais para cancelar).
• Há um agendamento por fatura: agendar de novo substitui o horário, e Enviar NFS-e agora cancela o agendamento e envia na hora.
• Na hora marcada valem as regras daquele momento: sem NFS-e autorizada, ou com a nota já enviada, nada sai; o PDF traz as notas autorizadas naquele momento; os canais são conferidos de novo. A mensagem pode sair até 1 ou 2 minutos depois do horário.
• O agendamento, a troca de horário, o cancelamento e o envio não feito (com o motivo) ficam no histórico da fatura.

Os detalhes estão em Agendar o envio da NFS-e.

Cancelar uma NFS-e

Somente notas com status EMITIDA podem ser canceladas.

Marcar como emitida externamente

Se a nota já foi emitida em outro sistema (fora da Clínica), você pode registrar isso sem chamar o ADN:

• Em uma fatura ainda sem NFS-e, clique em Já emitida externamente. O status passa para NFS-e emitida externamente (EMITIDA_EXTERNA). Nesse caso não há XML/PDF disponível no sistema — apenas o registro do fato.
• Para reverter, clique em Desmarcar, e a fatura volta a permitir emissão normal.

Histórico de emissões

Em qualquer fatura com integração de NFS-e, clique em Ver histórico de emissões para abrir o log de comunicações com o ADN (até os 50 registros mais recentes). Cada linha mostra:

• A operação (Emissão ou Cancelamento), com indicador verde (sucesso) ou vermelho (erro).
• Data e hora (DD/MM/AAAA HH:mm).
• O código HTTP de retorno e a duração da chamada em milissegundos.
• A mensagem de erro, quando houver.

Se não houver comunicações registradas, aparece "Nenhum registro de comunicação com o ADN."

Download em massa (ZIP do período)

Na lista Financeiro → Faturas, depois de selecionar um mês, use o botão Exportar:

• NFS-e PDFs (ZIP)... — os DANFSE em PDF (por fatura e por sessão).
• NFS-e XMLs (ZIP)... — os XMLs assinados.

As duas opções abrem um diálogo onde você escolhe quais notas entram no pacote.

Baixar só as notas novas

Quem emite conforme o pagamento cai vive o mesmo problema todo mês: no dia 05 entram dez pagamentos, você emite dez notas e baixa o pacote; no dia 10 entram mais vinte, você emite mais vinte — e o pacote vem com as trinta. As dez do dia 05 vão repetidas, e sobra a você lembrar a partir de qual paciente ainda não enviou.

O diálogo oferece três recortes:

O nome do arquivo registra o recorte: nfse-xml-Set-2026-novas.zip para as notas novas, nfse-pdf-Set-2026-a-partir-de.zip para o corte por data e nfse-xml-Set-2026.zip para o pacote completo.

O que entra e o que não entra

O pacote inclui apenas notas com status EMITIDA que tenham XML armazenado. Ficam de fora, e por isso não aparecem na contagem de pendentes:

• notas marcadas como emitidas externamente, que não têm documento no sistema;
• notas emitidas antes de a Clínica passar a guardar o XML;
• notas sem data de emissão registrada — raras, e resultado de um cancelamento antigo. Ficam de fora de propósito: a Clínica só entrega no pacote o que consegue marcar como baixado depois, para nenhuma nota voltar em todo download sem nunca sair da fila.

Se alguma nota não puder ter o DANFSE gerado, o pacote sai sem ela e a tela avisa "N nota(s) não puderam ser geradas e continuam pendentes de download" — elas seguem na lista de pendentes, em vez de sumirem em silêncio.

Quando não há nada novo, o botão fica desabilitado com o aviso "nada novo — já baixou tudo deste período". Isso é o estado bom, não um erro.

Se o pacote sair vazio, a mensagem diz "tudo deste período já foi baixado em XML ou PDF (a marca vale para os dois)" — o lembrete existe porque baixar um formato marca a nota para o outro também.

Solução de problemas

• "Configuração de NFS-e não encontrada ou inativa" — ative a configuração fiscal em Configuração fiscal.
• "Informe o CPF do responsável financeiro" — preencha o CPF do tomador no diálogo de emissão.
• "Endereço do tomador é obrigatório" — preencha Rua, Bairro e CEP.
• "Erro do ADN: …" — falha retornada pelo padrão nacional. Confira certificado/credenciais e use Tentar Novamente.
• Erro ao baixar do Gov.br — o ADN pode estar temporariamente indisponível; tente o botão PDF (geração local) ou aguarde alguns minutos.