📑 Fechar lotes

Agrupa as guias pré-faturadas por convênio e período e fecha o lote para envio.

Dúvidas comuns desta tela — toque numa pergunta e a Helô responde:

Fechar lote de faturamento

Do manual: abrir esta parte no manual completo ›

Agrupamento das guias para envio à operadora. Cada lote representa um período de faturamento (normalmente mensal) para um convênio.

  1. Acessar Fechar Lotes

    URL: http://app.rabisistemas.com.br/portal/faturamento/fechar-lotes

  2. Selecionar convênio e período

    Filtrar por convênio/operadora e período de competência.

  3. Fechar o lote

    Confirmar o fechamento. O lote fica com status "Fechado" aguardando retorno da operadora.

Lição: lote TISS e geração do XML

Do manual: abrir esta parte no manual completo ›

O lote agrupa N guias do mesmo convênio + período, recebe um número sequencial e gera o XML. Ao fechar o lote (HU-002), as guias passam a faturada e ficam bloqueadas para edição isolada. Registra-se número de NFS-e e protocolo.

✅ Atualização 13/10: conferido no código de produção: hoje o sistema não impede editar guia de lote fechado — a trava "proibir edição de lote fechado" entrou e foi revertida em 06/10/2026. Trate o lote fechado como fechado por disciplina: evite alterar guias já faturadas (lembre que o "Replicar ajustes desta guia" também altera guia faturada ou de lote fechado) e, se precisar corrigir, confira o lote e o XML de novo.

6.1 Fluxo do XML (HU-007)

  1. Cria o lote com as guias selecionadas.
  2. Gera o XML conforme a versão TISS configurada no convênio (ex.: 3.04.01 / 4.03.00) e o tipo de guia (consulta, SP/SADT, internação).
  3. Valida o schema do XML e a obrigatoriedade dos campos.
  4. Gera o hash SHA256.
  5. Envia: hoje a clínica sobe o XML no portal/canal da operadora e registra o protocolo no Rabi (envio automático por webservice — lote, demonstrativos, recurso de glosa — é roadmap, épico #618).
  6. Recebe o retorno com nota fiscal/protocolo e valor liquidado da operadora.
  7. Gera as contas a receber via /lote/gerar-contas-receber.

O XML pode ser baixado, pré-visualizado, editado manualmente e ter o hash recalculado. O arquivo fica anexado ao lote e pode ser re-emitido.

Lote TISS

Do manual: abrir esta parte no manual completo ›

Agrupa N guias por convênio + período. Gera XML, envia, controla retorno.

Novo — out/2026 Desde 23/10/2026 o valor do lote é o total da guia calculado pelo servidor (igual ao XML e ao contas a receber).

Endpoints

MétodoEndpointPermissão
GET/lote/ADMINISTRAR LOTE / VIEW
POST/lote/FATURAMENTO / CREATE
PUT/lote/:loteIdADMINISTRAR LOTE / UPDATE
DELETE/lote/:loteId/abrirADMINISTRAR LOTE / DELETE
POST/lote/gerar-contas-receberFATURAMENTO / CREATE

XML TISS — Endpoints específicos

MétodoEndpointFunção
GET/xml/:loteId?Download XML
GET/xml/:loteId/visualizarPreview formatado
PUT/xml/editadoSalvar edição manual
GET/xml/:loteId/refazer_hashRecalcular hash

Fluxo XML

  1. Cria lote com guias selecionadas
  2. Gera XML conforme TISS (versão configurada do convênio, ex.: TISS 4.03.00)
  3. Valida schema XML + obrigatoriedade campos
  4. Gera hash SHA256
  5. A clínica envia o XML à operadora pelo portal/canal da operadora e registra o protocolo no Rabi (🟠 envio automático por webservice TISS = roadmap, Sprint 14 — 09–16/out, #620 do épico #618; em 15/10 só a fase 1 — elegibilidade — entrou em produção; Novo — out/2026 desde 23/10 a tela Retorno da operadora está no ar em primeira versão, em validação — ver TISS fases 2 a 4). Convênio que não recebe XML: ver Faturamento sem XML. Na importação de XML externo, a situação/protocolo/data de envio também podem ser registrados (#630).
  6. Recebe retorno (NFS-e + valor liquidado)
  7. Gera contas a receber via /lote/gerar-contas-receber
  8. Novo — out/2026 Quando o convênio paga: baixa em Recebimentos de convênio (demonstrativo importado ou digitado)

Calendário de faturamento: conferir, fechar, gerar

Do manual: abrir esta parte no manual completo ›

O erro clássico do faturamento é deixar tudo para a semana da entrega. O ritual semanal distribui o trabalho: toda semana você confere e fecha alguma coisa, e a semana da janela de cada convênio vira só o "apertar o botão".

💰 Como o Rabi chega ao preço? Os valores das guias ficam congelados no momento do atendimento — se a tabela do convênio mudou depois, use Atualizar Valores em Massa na conferência do pré-faturamento. Os 3 níveis de conversão por convênio, as 3 linhas de cada item (4 na coluna Valor do serviço, com a Σ — ✅ em produção desde 24/09) e o modo pacote estão explicados na nova área Preços e Conversão de Valores.
✅ Atualização 24/09 Série de regras de preço toda em produção: taxas, produtos e subserviços sempre entram na guia com as próprias conversões (só ficam fora sem "Utiliza" ou zerados em pacote de preço fechado); "Zerar valor em pacotes" é por item, sem cascata; a linha de procedimento do XML leva só o valor do próprio serviço. ✅ em produção desde 24/09 Na aba Serviços do convênio, a coluna Valor do serviço tem a 4ª linha Σ = total do serviço no convênio (o que o convênio paga = receita do Farol = total da guia); a linha ✅ "0,00 (sem preço próprio: itens cobrados à parte)" em serviço que soma itens sem valor combinado não é erro — o medicamento e a aplicação saem nas áreas deles do XML. A explicação do 0,00 aparece ao passar o mouse na linha ✅; um texto visível na própria linha chega no próximo ajuste. Lembre: valor combinado não é pacote — sem Pacote marcado no convênio, os itens somam por cima. Ao conferir o primeiro lote depois de 23/09, confira serviços de preço fixo com composição — ver a Árvore de decisão de preços. 🟠 Roadmap S14 (09–16/out): envio de lote e demonstrativos por webservice com as operadoras (#618).
PassoOnde no RabiComo fazerDica de produtividade
1. Conferir as guias no pré-faturamento Menu Faturamento → Pré-faturamento
/portal/guia2/list/pre-faturamento		 Filtre por convênio e período, abra as guias e revise: números de guia/autorização/senha, procedimentos, valores contra a tabela do convênio, CBOS, CID-10 e anexos. O sistema roda as validações da ANS e aponta o que falta. O salvamento é garantido — o Rabi confirma de fato a gravação de cada ajuste — e as anulações de produto/serviço/taxa são mantidas entre as sessões de conferência. ✅ Novo — 02/10/2026 A lista "pendentes" mostra só Atendido e Atendido com pendência; use o filtro novo "Pré-faturadas" para rever ou reabrir as já pré-faturadas. Consulta de retorno aparece com o chip RETORNO ("não gera valor"). Confira por convênio, na ordem do calendário: primeiro o convênio cuja janela abre antes. Guia conferida hoje é glosa evitada no mês que vem.
2. Corrigir guias em lote Pré-faturamento → correção em lote (por serviço, convênio e período) Quando o mesmo erro se repete em várias guias (ex.: código de serviço errado para um convênio no mês inteiro), use a correção de guias em lote em vez de abrir uma a uma. Antes de corrigir uma guia manualmente, pergunte-se: "esse erro está em quantas guias?" Se a resposta for "várias", vá direto para a correção em lote. ✅ Novo — 09/10/2026 Para guias mãe/filhas, o Editar Guia tem a caixa "Replicar para as outras guias ao salvar" (produtos e taxas): inclui o que falta e anula o que sobra nas outras guias do grupo — guia faturada ou com lote fechado também é alterada, então use antes de fechar o lote.
3. Fechar o lote na semana da janela Menu Faturamento → Fechar Lotes
/portal/faturamento/fechar-lotes		 Selecione o convênio e o período de competência e feche o lote. O Rabi agrupa automaticamente as guias da mesma autorização, só permite inserir guias em lotes abertos, e grava um snapshot da quantidade faturada no fechamento — o retrato do que foi enviado fica preservado para auditoria. Feche o lote apenas quando a conferência do passo 1 estiver completa. ✅ Correção — 13/10/2026 Hoje o sistema ainda permite editar guia de lote fechado (uma trava foi testada em 06/10 e desfeita no mesmo dia) — por isso, combine com a equipe que guia de lote fechado só se altera reabrindo o lote em Administrar Lote, com permissão.
4. Gerar o XML TISS e o PDF por guia No lote fechado: gerar XML TISS + PDF/digitalização completa dos documentos por guia Gere o XML na versão TISS configurada para o convênio, valide e confira o hash. Novo — out/2026 Desde 27–28/10/2026, em Administrar Lotes a versão do XML é escolhida por lote (botão "Baixar XML (versão)"; sem versão escolhida aparece "Selecione a versão do XML") — confira a versão que a operadora pede antes de baixar. No Ajustar Lote, imprimir outras despesas sai na guia da própria linha. Gere também o PDF completo por guia (guia + anexos digitalizados) quando a operadora exigir documentação junto do XML. Envie pelo portal/canal da operadora (ou o meio previsto em contrato) e registre o protocolo no Rabi. 🟠 Roadmap O envio do lote por webservice direto do Rabi, com protocolo e status automáticos, está na Sprint 14 (épico #618 / #620). ✅ Atualização 15/10 a 1ª fase da integração TISS (#619) entrou em 15/10, mas só com a verificação de elegibilidade e o Log de integração TISS; o envio do lote por webservice (#620) segue roadmap. O gerador de XML já passou por uma bateria de correções (quantidades, taxas, OPME, pacotes) — mesmo assim, revise a prévia antes do envio: o custo de conferir é minutos; o de reenviar, um mês. ✅ Novo — 23/09/2026 O campo tipoAtendimento do XML usa o tipo de atendimento efetivo do convênio (coluna Tipo de Atendimento da aba Serviços), e valor 0,00 configurado no convênio sai como zero de verdade no XML, no pré-faturamento e nas contas a receber ("zero é zero" — ver Preços e Conversão de Valores).
5. Registrar o envio em Administrar Lote Menu Lote → Administrar Lote
/portal/lote/administrar-lote		 Marque o lote como recebido pela operadora, registre a data e o protocolo de entrega. É daqui que você reemite o XML ou exporta a lista de guias. Novo — out/2026 Desde 22/10 lote enviado não reabre e guia com contas a receber gerado ou em lote enviado não é mais editável — confira tudo antes de enviar. Convênio que recebe por portal ou papel: use o Envio sem XML. Protocolo registrado no dia do envio = defesa pronta se a operadora alegar entrega fora do prazo. Com o protocolo de entrega preenchido, a guia sai da lista de divergência atendido × faturado (02/10).
6. Gerar as contas a receber Menu Lote → Gerar Contas a Receber
/portal/lote/gerar-contas-a-receber		 Gere os lançamentos de contas a receber do lote. Novo — out/2026 Desde 23–24/10 o valor do lote é o total da guia calculado pelo servidor — o mesmo do XML e do contas a receber (respeita zero, retorno e preço do produto); se a sua soma der diferente, vale o do sistema. Na janela de vários lotes, guias que já têm conta a receber não podem ser marcadas (selo "Conta a receber já gerada"); se der erro, a janela fica aberta com a mensagem; no sucesso aparece "Contas a receber geradas com sucesso!". Eles aparecem no Financeiro (Registros, filtro "A Receber") com as parcelas e o vencimento previsto pelo prazo de pagamento do convênio. ✅ Novo — 29/09/2026 Desde 28/09 a conta a receber de convênio usa o centro de custo padrão definido nos Parâmetros (e teve valores/unidade corrigidos) — confira se o centro de custo padrão da clínica está preenchido, porque é ele que alimenta o DRE gerencial por centro de custo. ✅ Novo — 12/10/2026 A conta caixa vem da Conta de recebimento do convênio ou, se vazia, da Conta Padrão de Recebimento de Convênios (Parâmetros › Financeiro). Sem nenhuma das duas, a geração dá erro — o sistema não cria mais conta sozinho. Faça isso no mesmo dia do envio. Lote enviado sem contas a receber geradas é dinheiro que ninguém está esperando — e que ninguém vai cobrar.
7. Registrar a NFS-e / protocolo fiscal do ciclo ✅ Novo — set/2026 Módulo fiscal do Rabi (NFS-e) Com o módulo fiscal ativo (opt-in), a NFS-e é emitida de dentro do próprio Rabi — módulo fiscal completo em produção: emissão por convênio e no ato do pagamento, de forma assíncrona; cancelar/substituir e pendências na tela Notas NFS-e. Registre no ciclo do lote a nota/protocolo correspondente ao faturamento. Veja o módulo fiscal em detalhe. Nota vinculada ao ciclo do lote = conciliação fiscal sem caça a protocolo no fim do trimestre. Sem o módulo ativo, registre o número da nota emitida externamente no lançamento financeiro.
✅ Novidades da Sprint 7 nesta fase ✅ Novo — ago/2026

✅ Atualização 15/10 Desde 15/10 a guia-mãe é sempre definida (fim das guias órfãs: a guia mais antiga não anulada vira a mãe; agendamento cancelado/remarcado/falta não é mãe); autorização editada ou aprovada depois do atendimento preenche os campos vazios das guias (fora de lote fechado); e Criar Guia no pré-faturamento pede a autorização quando o convênio exige autorização prévia do serviço. Salvar glosa exige a permissão GLOSAS UPDATE e editar o XML exige UPDATE em Administrar Lote ou Faturamento.

Localizar guia pelo número (mãe e filha) já está disponível (#421) — ache a guia direto pelo número em vez de filtrar por convênio/período. A tela de lotes agora vem ordenada decrescente (#581) — os lotes mais recentes primeiro. E a reconciliação do pré-faturamento foi entregue (#568/#569, épico #572): o sistema cruza autorizado × agendado × atendido × faturado, mostra as divergências numa área fixa e permite faturar a diferença sem apagar o histórico. Em produção desde ago/2026.

Não achou o que precisava?
Pergunte à Helô com as suas palavras, veja a Central de Ajuda ou escreva para o suporte: contato@rabisistemas.com.br.