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

Status: Planejado / em roadmap — issues GitLab #391 (importação de NF-e) e #392 (emissão de NFS-e). Os recursos descritos ainda serão implementados.

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 do faturamento da clínica.

Importação de NF-e de Fornecedor (#391)

Sprint 25 em diante. No módulo de estoque, será possível importar o XML da NF-e enviada pelo fornecedor. A partir do arquivo, o sistema:

Lê os itens da nota fiscal.
Carrega o estoque com as quantidades recebidas.
Atualiza contas a pagar 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.
Tratamento de múltiplos itens, impostos e descontos presentes na nota.

Esta importação está diretamente ligada à etapa de Recebimento do Módulo de Compras. Veja Módulo de Compras e Pedidos — Recebimento.

Emissão de NFS-e (#392)

Sprints 23–26. O sistema passará a emitir a Nota Fiscal de Serviço Eletrônica (NFS-e), no padrão ABRASF / SPED, a partir do faturamento da clínica.

Provedor recomendado: eNotas Gateway, com cobertura de mais de 5.500 municípios.
Configuração em Configurações → Fiscal → NFS-e.
Geração automática após o fechamento do lote, ou geração manual a partir do registro financeiro.
Etapa 2 futura: emissão de NF-e de produto.

NFS-e — detalhamento (jul/2026) 🟠 planejado / em desenvolvimento

Módulo de emissão de NFS-e (Nota Fiscal de Serviço) no Padrão Nacional, já preparado para a Reforma Tributária (IBS/CBS). A clínica emitirá a nota direto do Rabi, integrada a agendamento, atendimento e financeiro.

Emissão no ato do pagamento: ao pagar um serviço com pagamento no ato, o sistema pergunta se deseja emitir a nota e abre a tela já preenchida com os dados do paciente (permite emitir em nome/CPF/CNPJ diferentes). A nota só é emitida após a confirmação do pagamento. Para faturados (convênio), a emissão é sob escolha.
Modelos de nota configuráveis: a clínica cria modelos (dados fiscais) e define um padrão; serviços com tributação diferente usam modelo específico (definido com o contador).
Área de manutenção: acompanhar, cancelar (nível 3), substituir, tratar pendências e obter o link de visualização para o paciente.
Integração via provedor: apenas por integrador — recomendados Focus NFe e PlugNotas; cada clínica escolhe o seu. O certificado A1 fica cadastrado no provedor (não no Rabi); o Rabi guarda só provedor, chave de API e ambiente (homologação/produção). O provedor cuida das regras de cada município.
Comercial: módulo opcional por clínica; a clínica paga o provedor diretamente e a taxa do módulo ao Rabi. Escopo inicial: apenas NFS-e de serviço (NF-e de produto fica para o futuro).