Integrações — Notas Fiscais (NF-e e NFS-e)

Visão Geral

Esta página reúne as integrações fiscais do Sistema Rabi: a importação da NF-e emitida por fornecedores (para dar entrada de mercadoria no estoque) e a emissão de NFS-e, a Nota Fiscal de Serviço Eletrônica gerada a partir dos pagamentos e do faturamento da clínica.

Importação de NF-e de Fornecedor (#391) ✅ Novo — set/2026

Em produção desde 08/09/2026. Em Compras › Notas Fiscais de Entrada (/portal/compras/nf-fornecedor), é possível importar o XML da NF-e enviada pelo fornecedor (um ou vários arquivos). A partir do arquivo, o sistema:

• Lê os itens da nota fiscal.
• Carrega o estoque com as quantidades recebidas.
• Cria a conta a pagar da nota no módulo Financeiro.
• Vincula ao pedido de compra, quando houver um pedido correspondente.

Tecnologia

• fast-xml-parser — biblioteca para leitura do XML da nota.
• XSD oficial da SEFAZ — validação do XML contra o esquema oficial.
• Leitura de múltiplos itens da nota. ✅ Atualização 13/10: as limitações registradas em 29/09 (só produtos no total, lote vazio, validade padrão, sem parcelas) foram resolvidas em 09/10 — ver abaixo.

Importação completa: estoque e contas a pagar (#629) ✅ Novo — 09/10/2026

• Conferência antes de confirmar: lote, validade e quantidade por lote (dá para adicionar/remover lote), fator de conversão (o fator informado vira padrão para aquele fornecedor e código), depósito por item ("Depósito padrão da nota"), "Motivo da entrada", "Categoria de pagamento" e "Forma de pagamento" ("Sugerida pelo XML"); parcelas das duplicatas do XML editáveis. Validade que não veio no XML aparece como "Não veio no XML — confira". O botão "Confirmar recebimento" só libera quando os totais (Total da nota / Entradas no estoque / Parcelas) fecham.
• Uma entrada no estoque por lote; custo do item = produto + frete + seguro + outras despesas + IPI + ST + FCP-ST + II − desconto; a conta a pagar fecha com o valor total da nota, com as parcelas do XML (ou parcela única).
• Novo — out/2026 Desde 15–22/10 a importação aceita o XML sem o protocolo da SEFAZ.
• A nota precisa ser de venda autorizada e o destinatário, uma empresa cadastrada (há a opção "Conferi e a nota é desta clínica: importar mesmo assim."). XML com assinatura digital inválida é recusado.
• Estornar recebimento (status ESTORNADA): pede o motivo, exige a ação CANCELAR em NOTAS FISCAIS DE ENTRADA (ou administrador), baixa as entradas e inativa a conta a pagar; é bloqueado se o lote já foi consumido/transferido, se há reserva de paciente ou se a conta já tem pagamento.
• Status da nota: RECEBIDA, CONCILIADA, DIVERGENTE, CONFIRMADA, REJEITADA, ESTORNADA. A busca do produto pelo EAN agora é por texto (zeros à esquerda preservados).

Esta importação está diretamente ligada à etapa de Recebimento do Módulo de Compras. Passo a passo, avisos e situações da nota em Compras › Notas Fiscais de Entrada.

Emissão de NFS-e — módulo fiscal completo em produção ✅ Novo — set/2026

🟢 O módulo fiscal de NFS-e está completo em produção: a 1ª fase (emissão) desde setembro/2026 (Sprint 9) e as peças finais (modelos de nota, gestão das notas e onboarding fiscal) desde 22/09/2026. A clínica emite a Nota Fiscal de Serviço Eletrônica direto do Rabi, integrada a agendamento, orçamento e financeiro, já preparada para a Reforma Tributária (IBS/CBS).

O que já está no ar

• Emissão no ato do pagamento (#467) — ao pagar um serviço, o sistema oferece a emissão da nota com os dados do paciente já preenchidos, permitindo tomador diferente do paciente (outro nome/CPF/CNPJ). A nota só é emitida após a confirmação do pagamento.
• Emissão direto do Agendamento e do Orçamento (#594) — o pagamento feito a partir dessas telas também dispara a emissão da nota. ✅ Novo — 26/09/2026 Em orçamento de várias sessões 100% particular com financeiro próprio (orçamentos criados desde 25/09/2026), a nota das sessões sai pelo lado do orçamento, por parcela paga — sem duplicar nota por sessão. Orçamento misto (particular + convênio) ou sem financeiro próprio segue emitindo pela movimentação, como antes. Ver Orçamento › Financeiro único.
• Emissão por convênio (#466) — notas para valores faturados de convênio. Hoje emitida à mão na tela de notas — ver como funciona hoje.
• Processamento assíncrono com acompanhamento (#469) — a emissão roda em segundo plano, com acompanhamento do andamento e idempotência (sem risco de nota duplicada).
• Reforma Tributária IBS/CBS (#470) — cálculo já compatível, com tolerância à transição 2026/2027/2032.
• Configuração fiscal por clínica (#464) — emissor, certificado e ambientes (homologação/produção) configurados por clínica.
• Camada de provedor plugável (#463) — a integração com o emissor municipal é feita via provedor, que pode ser trocado sem alterar o uso no Rabi.
• Ativação opt-in com taxa do módulo (#471) — o módulo é opcional: cada clínica ativa quando quiser e paga a taxa do módulo.

Peças finais — módulo completo em produção desde 22/09/2026 (épico #462) ✅ Novo — 26/09/2026

Concluídas no desenvolvimento em 17/09 e em produção desde 22/09/2026 (conferido no código publicado):

• Modelos de nota configuráveis (#465) — a clínica cria modelos de nota (dados fiscais), define um modelo padrão e pode atribuir modelo específico por serviço: serviços com tributação diferente usam o modelo próprio (definido com o contador). Inclui perfil fiscal por serviço e as tabelas auxiliares LC 116, NBS e CST/cClassTrib.
• Área de gestão/manutenção das notas (#468) — tela Notas NFS-e para acompanhar as notas emitidas (histórico paginado), cancelar, substituir e tratar pendências de emissão. As mesmas ações existem na API externa — ver cancelar e substituir no grupo NFS-e.
• Onboarding fiscal por clínica (#472) — checklist de pré-requisitos para ativar o módulo fiscal: passo a passo guiado que confere o que falta antes de a clínica começar a emitir.

Modelo comercial e provedor

• Integração via provedor: o certificado A1 fica cadastrado no provedor (não no Rabi); o Rabi guarda provedor, chave de API e ambiente. O provedor cuida das regras de cada município.
• Comercial: módulo opcional por clínica (opt-in); a clínica paga o provedor diretamente e a taxa do módulo ao Rabi. Escopo atual: NFS-e de serviço (NF-e de produto fica para o futuro).