Faturamento Avançado TISS
📚 Referência completa e treinamento: este módulo tem uma lição detalhada de certificação — passo a passo de todas as telas, campos e regras.
5 módulos NOVOS: Pré-Faturamento + Guia + Lote + Glosas + CD (Tabela 25 ANS). Documentação completa.
Novidades de 16 a 30/10/2026 Novo — out/2026
Conferido no sistema em produção em 30/10/2026.
- Várias guias de uma vez Novo — out/2026 (29/10) — ver Criar várias guias de uma vez.
- Versão do XML por lote Novo — out/2026 (27–28/10) — em Administrar Lotes a versão do XML TISS é escolhida por lote: botão "Baixar XML (versão)" (sem versão escolhida: "Selecione a versão do XML"). Em Ajustar Lote, imprimir outras despesas sai na guia da própria linha. Ver Financeiro › Versão do XML por lote.
- Recebimentos de convênio (#686) Novo — out/2026 — Faturamento › Recebimentos de convênio (
/portal/faturamento/recebimentos-convenio, permissão de Glosas): Novo recebimento por Importar arquivo (XML TISS do demonstrativo, CSV/XLSX ou PDF; layout cadastrado na 1ª vez, com Testar com arquivo) ou Digitar (pagador + "Buscar guias"). O sistema casa cada linha com a guia; as não achadas ficam pendentes (casar à mão, ignorar, editar, Recasar). Conferir faturado/pago/glosa/valor no banco, data e conta → Baixar: contas a receber pagas (parcial deixa saldo), glosa registrada com motivo (vai para Glosas), guia Paga / Paga parcial / Glosada. Recorrer da glosa cria a guia de recurso; Estornar (ação Estornar + motivo); Cancelar. A busca automática "pela API do convênio" ainda não funciona (prevista). Passo a passo em Financeiro › Como dar baixa no pagamento do convênio. - Faturamento sem XML (#687) Novo — out/2026 — subaba Faturamento do convênio (forma de envio XML/Portal/Papel, intermediador, endereço do portal, periodicidade); no lote fechado (Administrar Lotes) botão Envio sem XML: espelho de digitação (XLSX), "Marcar todas como digitadas", Registrar envio (data, remessa/protocolo, competência e, por guia, digitada/recusada/pendente com o número do portal e o valor), faturado × digitado; registrado, o lote não aceita guia nova. Relatório
/portal/faturamento/faturamento-sem-xml. Passo a passo em Financeiro › Como faturar convênio que não recebe XML. - TISS por webservice — fases 2 a 4 (#620/#622/#623) Novo — out/2026 — menu Faturamento › Retorno da operadora (lote, demonstrativos, autorização online, recurso de glosa); telas desde 22/10, servidor desde 23/10. Primeira versão no ar, em validação: nem toda operadora funciona igual — mantenha o envio do XML pelo portal como caminho de segurança. Ver Retorno da operadora.
- Pré-faturamento Novo — out/2026 (19–20/10) — campo Local da guia (só unidades do convênio); Criar Guia sem autorização prévia avisa e deixa seguir; Pré-Faturar exige autorização, com diálogo para vincular; a autorização chega ao pré-faturamento (guias órfãs corrigidas).
- Lote enviado não reabre; guia travada Novo — out/2026 (22/10) — guia com contas a receber gerado ou em lote enviado não é mais editável, e lote enviado não reabre.
- Glosas Novo — out/2026 — lançar glosa manual numa cobrança que já tem valor recebido dá "Complete a baixa em Faturamento > Recebimentos de convênio"; o Relatório agregado de glosas calcula o glosado como faturado − pago. Ver Glosas.
- Administrar Lote e Gerar Contas a Receber Novo — out/2026 (23–24/10) — o valor do lote passou a ser o total da guia calculado pelo servidor (o mesmo do XML e do contas a receber; respeita zero, retorno e preço do produto — antes era uma soma feita na tela); na janela de vários lotes, guias com conta a receber não podem ser marcadas (selos "Conta a receber já gerada" e "Contas já geradas"); erro mantém a janela aberta com a mensagem; sucesso: "Contas a receber geradas com sucesso!"; a coluna XML deixou de ficar fixa; glosa repetida: "Este serviço já foi glosado anteriormente. Não é possível aplicar nova glosa." — ver Financeiro › Lote e contas a receber.
- Atendimento sem agendamento Novo — out/2026 (23/10) — a guia sai igual à de um atendimento agendado (valor pela regra do Farol, produtos e taxas da composição, retorno zerado); se o usuário escolheu "Prosseguir sem autorização", a autorização é exigida no pré-faturamento — ver Pacientes › Novo Atendimento.
- NFS-e Novo — out/2026 — em produção com o NotaPlano; nota do convênio/faturado continua manual, pela tela Emitir NFS-e. Ver como funciona hoje.
Criar várias guias de uma vez Novo — out/2026
Em produção desde 29/10/2026.
- Criar Guia: dá para repetir em outras datas — o sistema cria uma guia por data, limitado ao saldo e à validade da autorização.
- Pré-faturamento: botão "Repetir em outras datas".
- Produtos e taxas: adicione vários de uma vez, num diálogo só.
Útil para tratamentos em série (sessões). Se alguma data passar do saldo ou da validade da autorização, ela não é criada — confira a autorização antes.
Novidades de 13 a 15/10/2026 ✅ Novo — 15/10/2026
Conferido no sistema em produção em 15/10/2026.
- Integração TISS por webservice — fase 1 (elegibilidade) (#619) ✅ Novo — 15/10/2026 — opcional e por operadora: aba "Integração TISS" na operadora (credenciais, certificado, endereços dos webservices, Testar conexão), botão "Verificar elegibilidade" no Agendamento e no Acolhimento e tela "Log de integração TISS"; permissões
TISS_INTEGRACAOeTISS_ELEGIBILIDADE— ver Configurações › Integração TISS. 🟠 Roadmap envio de lote, demonstrativos com baixa automática, autorização online e recurso de glosa por webservice (#620–#623, Sprint 14) ainda não funcionam: o lote continua saindo em XML para envio pelo portal/canal da operadora. Novo — out/2026 Atualização 23/10: Faturamento › Retorno da operadora no ar em primeira versão, em validação — ver TISS fases 2 a 4. - "Criar Guia" (pré-faturamento) pede autorização ✅ Novo — 15/10/2026 — quando o convênio marca o serviço com autorização prévia, criar a guia faz as mesmas checagens do agendamento: autorização aprovada (ou com termo), saldo e guia aberta. A validação de serviço sem preço fixo foi corrigida.
- Guia-mãe sempre com raiz ✅ Novo — 15/10/2026 — fim das guias órfãs: a guia mais antiga não anulada vira a mãe; agendamento cancelado/remarcado/falta não é mais mãe; ao vincular guia, a filha mais antiga assume; excluir a mãe dá nova mãe ao grupo (com correção diária automática). Autorização editada ou aprovada depois do atendimento preenche as guias (só campos vazios, fora de lote fechado); serviço adicionado à mão pega senha/guia/protocolo/datas da autorização.
- "Replicar ajustes desta guia" revisado ✅ Novo — 13/10/2026 — também no Fechar Lotes (ajuste de lista) — ver Replicar ajustes.
- Referências oficiais de produto (#662, 1ª fase) ✅ Novo — 15/10/2026 — com política de referência no convênio, código, descrição e preço do produto podem vir da publicação oficial (nível 2) na guia e no XML; o XML descarta itens das tabelas 05 e 12 — use 20 (medicamentos) ou 19 (materiais). A carga de preços pela tela ainda está indisponível — ver Estoque › Referências oficiais.
- Permissões (#667, 14/10) ✅ Novo — 14/10/2026 — salvar glosa exige GLOSAS › Alterar; editar XML exige Alterar em Administrar Lote ou Faturamento.
Novidades de outubro/2026 ✅ Novo — 13/10/2026
O que entrou em produção no Faturamento entre 01/10 e 13/10/2026 (conferido no sistema em produção em 13/10).
- Filtro "Pré-faturadas" (#647) ✅ Novo — 02/10/2026 — na lista de guias do Pré-faturamento, o filtro "pendentes" mostra só Atendido e Atendido com pendência; o novo filtro "Pré-faturadas" serve para rever ou reabrir as guias já pré-faturadas; "Todos" continua mostrando tudo. Glosas em recurso e o autocomplete de paciente seguem o mesmo critério. Na Fila de Atendimento, a guia pré-faturada sai do aviso de divergências ("a ajustar") — o registro continua no histórico. Não é mais preciso ignorar à mão as guias já pré-faturadas nessas listas.
- Divergência atendido × faturado (#648) ✅ Novo — 02/10/2026 — a divergência fica visível até a guia ser faturada em lote com protocolo de entrega preenchido; depois sai da lista (protocolo vazio conta como sem protocolo). O registro continua no histórico.
- Autorização de guia já pré-faturada/faturada (#649) ✅ Novo — 08/10/2026 — sai da aba "Autorizadas" do painel de pendências da Agenda quando a guia mãe está pré-faturada, faturada ou em lote, e não pode mais receber sessões: "A guia desta autorização já foi pré-faturada/faturada; peça nova autorização." Guia reaberta volta a aparecer; guia filha fechada com a mãe aberta não tira a autorização da lista.
- "Replicar ajustes desta guia" ✅ Novo — 09/10/2026 — no Editar Guia (Pré-faturamento e Fechar lotes), a caixa "Replicar para as outras guias ao salvar" copia os produtos e taxas desta guia para as outras do grupo mãe/filhas: inclui o que falta e anula o que sobra. Guia anulada não é alterada; guia faturada ou com lote fechado é alterada — confira antes de marcar (ajuste de 13/10). Novo — out/2026 Desde 22/10, guia com contas a receber gerado ou em lote enviado não é mais editável. O Editar Guia também acompanha a renumeração da guia (06/10).
- Retorno não gera valor (#645) ✅ Novo — 05/10/2026 — atendimento marcado como retorno sai com serviço, taxas e produtos zerados no pré-faturamento, no lote/XML e no repasse (decidido por serviço). Na lista de guias aparece o chip "RETORNO" ("Consulta de retorno — não gera valor"). A detecção automática vale para o agendamento feito pela tela; retornos marcados pela IA, pelo agendamento online e por encaixe adicional não são detectados — confira-os antes de faturar. Ver Agendamento.
- Repasse sobre zero e sobre o líquido ✅ Novo — 02–06/10/2026 — serviço zerado (0,00 gravado) no pré-faturamento gera repasse sobre zero; valor vazio continua usando o cadastro (#646, para atendimentos desde 01/08/2026). O repasse de serviço é calculado sobre o valor líquido (total − desconto); valor fixo continua fixo.
- XML SP/SADT ✅ Novo — 07/10/2026 — o campo
tipoConsultasó é enviado quando otipoAtendimentoé 04. - Nome social ✅ Novo — 05/10/2026 — o nome social do paciente vai automaticamente no campo Nome Social da guia/XML TISS.
- Importação de XML TISS (#630) ✅ Novo — 01/10/2026 — situação/protocolo/data de envio do lote, "Desvincular guia" na Auditoria e filtros na lista de movimentações — ver Financeiro › Importar XML TISS.
- Conta de recebimento do convênio ✅ Novo — 12/10/2026 — Gerar Contas a Receber do lote usa a conta do convênio (aba Dados) ou a conta padrão dos Parâmetros › Financeiro; sem nenhuma, dá erro (não cria mais conta sozinho). Na Conciliação Bancária, o crédito do extrato pode dar a baixa no título do lote com o valor creditado (a diferença segue para glosa).
- Custos extras do convênio (#655) ✅ Novo — 12/10/2026 — entram só no Farol (projeção): não mudam guia, XML, lançamento nem repasse pago.
- Edição de lote fechado continua permitida — a trava "proibir edição de lote fechado" entrou e foi revertida no mesmo dia (06/10). Novo — out/2026 Atualização 22/10: lote enviado não reabre e guia com contas a receber gerado ou em lote enviado não é mais editável.
- 🟠 Roadmap Integração TISS por webservice (épico #618 — Sprint 14, 09–16/10, sprint atual): ainda não disponível; o lote continua saindo em XML para envio pelo portal/canal da operadora. ✅ Atualização 15/10 a fase 1 (elegibilidade, #619) entrou em produção — ver TISS fase 1; lote, demonstrativos, autorização e recurso (#620–#623) seguem roadmap.
⚠️ Subserviços na guia: desde 02/10 o agendamento, o acolhimento, o orçamento e a autorização mostram o quadro "Subserviços", com campo opcional de autorização do subserviço (#641). A autorização própria do subserviço não é obrigatória hoje (a exigência foi desativada em 03/10) e não há confirmação de que a guia/pré-faturamento liste os subserviços com autorização e senha próprias — confira no faturamento se a operadora exige.
Novidades de setembro/2026 ✅ Novo — set/2026
Entregas do ciclo de setembro/2026 no Faturamento. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
⚠️ Mudança de regra importante: o pré-faturamento NÃO baixa mais o estoque. Gerar o pré-faturamento deixou de sensibilizar (baixar) o saldo de estoque. Antes, gerar o pré-faturamento mexia no saldo dos produtos; agora não mexe mais. Se a sua rotina de conferência de estoque considerava essa baixa, revise o procedimento.
- Código 23 volta a ser "Exame" + novo código "Exame Ambulatorial" — o código 23 do Tipo de Atendimento voltou a se chamar "Exame" e foi criado o novo código "Exame Ambulatorial".
- Número de guia duplicado voltou a ser bloqueado — o bloqueio de número de guia duplicado foi restaurado (revert): o sistema volta a impedir duas guias com o mesmo número.
- NF-e — integração (#147) — a integração de NF-e concluiu o desenvolvimento em 03/09/2026. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Correção: campo "Política de Preço" exibia "null" (#615) ✅ Novo — set/2026 — o campo Política de Preço do produto no convênio exibia "null" em vez do valor; corrigido. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Zero é zero no pré-faturamento e nas contas a receber ✅ Novo — 23/09/2026 — valor
0,00configurado no convênio vale como preço zero de verdade (não é mais tratado como "campo vazio") também no pré-faturamento, nas contas a receber geradas do lote e no XML. Campo vazio é o que faz o sistema descer de nível na conversão — ver Preços e Conversão de Valores. - tipoAtendimento do XML vem do convênio ✅ Novo — 23/09/2026 — o campo
tipoAtendimentodo XML TISS passa a usar o tipo de atendimento efetivo do convênio (linha ✅ da coluna Tipo de Atendimento na aba Serviços do convênio); quando o convênio não define um, vale o do cadastro do serviço. - ✅ Novo — 29/09/2026 Correções de 28/09 em produção: a conta a receber de convênio gerada pelo faturamento usa o centro de custo padrão dos Parâmetros e teve valores/unidade corrigidos; a seleção de especialidade no pré-faturamento foi corrigida.
- 🟠 Roadmap — Integração TISS com as operadoras por webservice (épico #618, Sprint 14 — 09–16/out): fundação com configuração por operadora e log de transações (#619); envio de lote por webservice com protocolo e status automático (#620); demonstrativos de análise de conta e pagamento com baixa automática da conta a receber (#621); autorização online (#622); recurso de glosa e cancelamento de guia/lote por webservice (#623). Ainda NÃO disponível — hoje o lote continua sendo gerado em XML TISS para envio à operadora. Ver Roadmap. ✅ Atualização 15/10 a fundação #619 (configuração por operadora, log e elegibilidade) está em produção desde 15/10 — ver TISS fase 1; #620–#623 seguem roadmap.
✅ em produção desde 23/09 a linha de procedimento do XML usa o valor do próprio serviço (valor combinado do convênio, senão o do cadastro; zero se o serviço "soma itens" e não tem valor combinado) — não a soma com produtos e taxas, que vão para as próprias áreas do XML com as próprias conversões. Quem soma tudo é só o Farol.
✅ 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 ✅ mostra "0,00 (sem preço próprio: itens cobrados à parte)" em serviço que soma itens sem valor combinado — não é erro: na guia, a linha do procedimento sai 0 e medicamento e aplicação saem nas áreas deles. 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. ✅ regra vigente Valor combinado não é pacote: sem Pacote marcado na linha do serviço no convênio, os itens somam por cima do valor combinado.
✅ em produção desde 23/09 Taxas, produtos e subserviços sempre entram na guia, cada um com as próprias conversões — "Definir preço do serviço pelos itens" decide só o valor próprio do serviço; um item só fica fora sem Utiliza ou zerado em pacote de preço fechado. ✅ em produção desde 24/09 Zerar valor em pacotes é por item e não desce em cascata: subserviço zerado perde só o próprio valor; os itens dentro dele seguem cada um o seu "Zerar". Regra passo a passo na Árvore de decisão de preços.
✅ 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 ✅ mostra "0,00 (sem preço próprio: itens cobrados à parte)" em serviço que soma itens sem valor combinado — não é erro: na guia, a linha do procedimento sai 0 e medicamento e aplicação saem nas áreas deles. 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. ✅ regra vigente Valor combinado não é pacote: sem Pacote marcado na linha do serviço no convênio, os itens somam por cima do valor combinado.
✅ em produção desde 23/09 Taxas, produtos e subserviços sempre entram na guia, cada um com as próprias conversões — "Definir preço do serviço pelos itens" decide só o valor próprio do serviço; um item só fica fora sem Utiliza ou zerado em pacote de preço fechado. ✅ em produção desde 24/09 Zerar valor em pacotes é por item e não desce em cascata: subserviço zerado perde só o próprio valor; os itens dentro dele seguem cada um o seu "Zerar". Regra passo a passo na Árvore de decisão de preços.
💰 Como o Rabi chega ao preço de cada item (3 níveis de conversão, serviço composto, pacotes): veja a nova área Preços e Conversão de Valores.
✅ Novo — set/2026 A importação de NF-e de fornecedor (#391) está em produção desde 08/09/2026 — o XML da nota carrega o estoque e o contas a pagar. ✅ Atualização 13/10 Desde 09/10/2026 (#629) a importação tem conferência antes de confirmar (lote, validade, fator de conversão, depósito, parcelas), conta a pagar com o valor total da nota e estorno do recebimento — as limitações antigas não valem mais. Passo a passo em Compras › Notas Fiscais de Entrada.
Novidades de agosto/2026 ✅ Novo — ago/2026
Entregas do ciclo de agosto/2026 no Faturamento (issues fechadas no GitLab). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
Sprint 7 (25–28/08): Glosas completas + reconciliação do pré-faturamento ✅ Novo — ago/2026
Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- GLOSAS — rework completo (26/08): fluxos de registro unificados + histórico corrigido (#585); baixa/glosa automática a partir do retorno TISS real (#586); relatório agregado de glosas por convênio/motivo/período (#587); status de guia unificados — 3 mecanismos viraram 1 (#588). Detalhes na seção 4.
- Reconciliação do pré-faturamento (25–26/08, épico #572 concluído): reconciliação autorizado × agendado × atendido × faturado (#568); área fixa de divergências + faturar a diferença sem apagar o histórico (#569).
- Localizar guia pelo número (mãe e filha) (#421, 25/08).
- Tela de lotes ordenada decrescente (#581, 28/08).
- Fix do relatório de repasse (guias diretas) (#584, 26/08).
Pré-faturamento: salvar garantido
- Salvar garantido no pré-faturamento (#519, 29/07): corrigido o bug em que a tela dizia que salvou mas não salvava — agora o que você salva fica salvo de verdade.
XML TISS: 5 correções — o XML agora sai correto
Cinco bugs do XML TISS foram corrigidos em 30/07, mais um consolidado do cálculo/geração (#530). Em resumo, o XML enviado às operadoras agora sai correto:
- Quantidade e valor unitário (#525): quantidadeExecutada e valorUnitario saem corretos no XML.
- Tabela ANS da taxa (#526): o codigoTabela ANS da taxa sai correto.
- Materiais não viram OPME (#527): material deixou de ser classificado indevidamente como OPME.
- Valor zerado respeitado (#528): item com valor zerado não volta a ser cobrado no XML.
- Regra de pacote (somarItens) (#529): a regra somarItens dos pacotes é aplicada corretamente.
- Consolidado do cálculo/geração do XML (#530): revisão geral que fecha o pacote de correções acima.
Bugs urgentes corrigidos (13–24/08)
Quatro correções urgentes do Faturamento fechadas na segunda quinzena de agosto. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Erro ao gerar hash de XML (#578, 14/08): corrigido o erro que deixava o sistema parado ao gerar o hash do XML.
- Anulação mantida no pré-faturamento (#579, 14/08): o pré-faturamento passa a manter a anulação de produto/serviço/taxa.
- Guia CASSI/lote zerada (#580, 14/08): corrigida a guia/lote CASSI que saía zerada.
- Inserir guia em lote mostra só lotes abertos (#582, 23/08): ao inserir uma guia em lote, a lista agora exibe apenas lotes abertos.
Demais entregas de agosto
| Entrega | Issue | Fechada em |
|---|---|---|
| PDF/digitalização completa dos documentos por guia para envio às operadoras | #451 | 30/07 |
| Correções na tela da guia | #449 | 29/07 |
| Registros saem da guia quando o status é faturado | #213 | 03/08 |
| Snapshot da quantidade faturada no fechamento do lote | #562 | 10/08 |
| Corrigir guias em lote por serviço/convênio/período | #420 | 10/08 |
| Importar XML de faturamento de outro sistema — casamento automático + área de conciliação | #436 | 07/08 |
| Vínculo registro financeiro ↔ agendamento ↔ guia na importação + backfill dos vínculos | #422, #423 | 31/07, 12/08 |
✅ Novo — 30/09/2026 Importação de XML TISS no Financeiro — parte corrigida (#631, em produção desde 29/09/2026). Na importação de XML TISS no Financeiro (botão Importar XML em Registros Financeiros e Conciliação XML Externo), o lançamento usa sempre o valorTotalGeral da guia (antes, guia com valor só em "outras despesas" entrava com R$ 0,00 e "sucesso"); lote em que nenhuma guia tem valor é bloqueado antes de gravar; há avisos por guia (guia sem valorTotalGeral e guia cuja soma dos itens não bate com o total); excluir uma importação libera o número do lote para reimportar, respeitando o convênio, e as guias dela deixam de aparecer como pendência. ✅ Atualização 13/10 #630 fechada em 01/10: situação/protocolo de envio do lote, "Desvincular guia" e filtros da lista em produção. O casamento automático de guias e a duplicação de pendências não aparecem como corrigidos: leia os avisos por guia; depois de excluir uma importação, confira o saldo A Receber; se o casamento automático não casar, vincule manualmente. Ver Financeiro › Importar XML TISS.
🎉 NFS-e — MÓDULO FISCAL COMPLETO EM PRODUÇÃO desde 22/09/2026 (épico #462): ✅ Novo — 26/09/2026 a 1ª fase (emissão no ato do pagamento — inclusive direto do agendamento/orçamento —, por convênio, assíncrona, IBS/CBS, ativação opt-in por clínica) está em produção desde a Sprint 9; as últimas peças — modelos de nota configuráveis (#465), área de gestão/manutenção das notas — cancelar, substituir, pendências (#468) — e checklist de onboarding fiscal (#472) — estão em produção desde 22/09. Cancelar e substituir nota funcionam na tela (Notas NFS-e) e pela API externa (
POST /nfse/notas/{id}/cancelar e /substituir). Ver Notas Fiscais. Glosas e reconciliação do pré-faturamento (Sprint 7) já foram entregues — veja acima.
Novidades de julho/2026 ✅ Novo — jul/2026
Entregas do ciclo de julho/2026 no Faturamento (issues fechadas no GitLab). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
| Entrega | Issue | Fechada em |
|---|---|---|
| Guias da mesma autorização agrupam no faturamento — guias vinculadas a uma mesma autorização passam a ser agrupadas ao faturar | #417 | 23/07 |
| Impressão da guia exibe os valores de Outras Despesas | #418 | 22/07 |
| Correção na conversão de valores R$ 0,00 | #419 | 20/07 |
| Pré-faturamento: cálculo por pacote, opção "zerar em pacotes" e conversão | #448 | 24/07 |
| Autorização vira "faturada" quando alguma guia dela é faturada | #450 | 24/07 |
| Importação de XML para fechamento de guias e lotes | #357 | 24/07 |
| Comparação com o XML do convênio para baixa | #358 | 14/07 |
| Status do faturamento no relatório de pendências | #474 | 09/07 |
| Telas de recebimento e devolução de guias com código de barras | #350, #349, #334 | jun/2026 |
Visão Geral — Fluxo TISS
- Atendimento fechado
- Pré-Faturamento: revisão + validação de campos obrigatórios ANS
- Guia: estrutura completa com paciente + serviços + produtos + taxas + equipamentos
- Lote: agrupa N guias por convênio + período
- XML TISS: gerado conforme padrão ANS 4.x
- Envio à operadora
- Retorno com NFS-e + valor
- Glosas: itens não pagos → contestar ou aceitar
- Contas a Receber: geração automática
1. Pré-Faturamento
Bateria de validação ANTES de enviar à operadora — economiza glosas posteriores.
✅ Novo — set/2026 Gerar o pré-faturamento não baixa mais o saldo de estoque — ver novidades de setembro/2026.
Endpoints (16 endpoints — módulo grande)
| Método | Path | Permissão |
|---|---|---|
| GET | / | VIEW |
| GET | /guiasFilhas/:guiaMae | VIEW |
| GET | /InfoExtras/:guiaMae/:guiaFilha | VIEW |
| GET | /servicoPorGuia/:guiaFilha | VIEW |
| GET | /colaboradores-credenciados | VIEW |
| PUT | /save/:servicoAtendimentoId | UPDATE |
| PUT | /confirmar/:guiaMae | UPDATE |
| POST | /servicoAdd, /produtoAdd, /taxaAdd | UPDATE |
| PUT | /produtos/InfoExtras/:guiaMae | UPDATE |
12 Validações automáticas
- Carteirinha do paciente ATIVA e dentro da validade
- Procedimento com autorização (se exige)
- CBOS do profissional preenchido
- CID-10 obrigatório (alguns procedimentos)
- Quantidade × valor unitário batem com tabela do convênio
- Datas coerentes (atendimento, início, fim)
- Guia da operadora preenchida
- Indicador de acidente (Tabela 36) quando aplicável; código de cada item com a tabela de referência correta (Tabela 87 — "tabela de tabelas": tabela própria, Brasíndice, SIMPRO…)
- Caráter atendimento (Tabela 23)
- Código despesa CD (Tabela 25)
- Profissional ativo + vinculado ao convênio
- Equipamentos/produtos consumidos lançados (warning)
2. Guia TISS
Cada atendimento que vai a convênio precisa de uma Guia TISS estruturada conforme padrão ANS.
Estrutura (DTO 126 linhas)
- Dados paciente + carteirinha
- Serviços (com código TISS/TUSS)
- Produtos consumidos (com conversão)
- Taxas (sala, equipamento)
- Equipamentos utilizados
- Profissional (CBOS, CRM)
- Números: guia, guia mãe, guia operadora, autorização, senha
Endpoints (9)
| Método | Endpoint | Função |
|---|---|---|
| GET | /guia/anosPrefaturamento | Anos com guias |
| GET | /guia/guiasFilhas | Filhas de uma mãe |
| GET | /guia/preFaturamento/:atendimentoId | Guia por atendimento |
| GET | /guia/prefaturadas | Lista prefaturadas |
| GET | /guia/lote/:loteId | Guias do lote |
| GET | /guia/:atendimentoId/:servicoId/ | Detalhe |
| GET | /guia/:atendimentoId/:servicoId/produtos | Produtos do serviço |
| GET | /guia/:atendimentoId/:servicoId/taxas | Taxas |
| GET | /guia/:atendimentoId/:servicoId/equipamentos | Equipamentos |
Hierarquia Mãe/Filha
Cirurgias têm guia mãe + filhas (anestesia, diárias). Numeração: mãe = G123, filhas = G123.01, G123.02.
3. Lote TISS
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étodo | Endpoint | Permissão |
|---|---|---|
| GET | /lote/ | ADMINISTRAR LOTE / VIEW |
| POST | /lote/ | FATURAMENTO / CREATE |
| PUT | /lote/:loteId | ADMINISTRAR LOTE / UPDATE |
| DELETE | /lote/:loteId/abrir | ADMINISTRAR LOTE / DELETE |
| POST | /lote/gerar-contas-receber | FATURAMENTO / CREATE |
XML TISS — Endpoints específicos
| Método | Endpoint | Função |
|---|---|---|
| GET | /xml/:loteId? | Download XML |
| GET | /xml/:loteId/visualizar | Preview formatado |
| PUT | /xml/editado | Salvar edição manual |
| GET | /xml/:loteId/refazer_hash | Recalcular hash |
Fluxo XML
- Cria lote com guias selecionadas
- Gera XML conforme TISS (versão configurada do convênio, ex.: TISS 4.03.00)
- Valida schema XML + obrigatoriedade campos
- Gera hash SHA256
- 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).
- Recebe retorno (NFS-e + valor liquidado)
- Gera contas a receber via
/lote/gerar-contas-receber - Novo — out/2026 Quando o convênio paga: baixa em Recebimentos de convênio (demonstrativo importado ou digitado)
4. Glosas
Operadora glosou um item (recusou pagamento)? Sistema permite contestar (recurso) ou aceitar (gera estorno).
✅ Rework de Glosas ENTREGUE (Sprint 7, 26/08) ✅ Novo — ago/2026: fluxos de registro unificados + histórico corrigido (#585); baixa/glosa automática a partir do retorno TISS real (#586); relatório agregado de glosas por convênio/motivo/período (#587); status de guia unificados — 3 mecanismos viraram 1 (#588). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
Novo — out/2026 Desde 23/10/2026 a baixa do pagamento do convênio e o registro da glosa com motivo são feitos em Faturamento › Recebimentos de convênio (importar o demonstrativo ou digitar → conferir → Baixar; "Recorrer da glosa" cria a guia de recurso; "Estornar" desfaz). Lançar glosa à mão numa cobrança que já tem valor recebido dá "Complete a baixa em Faturamento > Recebimentos de convênio". O Relatório agregado de glosas calcula o glosado como faturado − pago. A baixa pela tela Glosas (valor pago por item) continua para os casos antigos.
✅ Atualização 13/10 Ao registrar glosa pela tela Glosas, a baixa ainda é feita só na primeira parcela da movimentação — confira títulos com mais de uma parcela. Desde 12/10 a baixa grava quem a registrou. Na Conciliação Bancária, "Baixar e conciliar" num título de lote baixa o valor creditado e a diferença segue para glosa.
Endpoints
| Método | Endpoint |
|---|---|
| GET | /glosas/motivos |
| GET | /glosas/status |
| GET | /glosas/status-valor |
| GET | /glosas/listar |
| GET | /glosas/movimentacoes/:id |
| POST | /glosas/ |
Status
- PENDENTE — recebida do retorno, ainda não tratada
- EM_RECURSO — contestada, aguarda resposta operadora
- RECUPERADA — recurso aceito, voltou a pagar
- ACEITA — clínica aceitou (gera estorno)
- DEFINITIVA — operadora manteve glosa após recurso
5. CD — Tabela 25 ANS
Códigos de despesa padronizados pela ANS. Cada Produto vinculado a um CD.
Endpoints
| Método | Endpoint |
|---|---|
| POST | /cd/ |
| GET | /cd/ |
Recebimento das guias físicas pelo faturamento
Quando a recepção entrega as guias em papel ao faturamento, o faturamento registra o que chegou (e o que devolveu) pelo leitor de código de barras. São duas telas do menu Faturamento.
Recebimento de Guias (scanner)
Faturamento › Recebimento de Guias abre o Scanner de Guias, com duas abas: Recebimento e Devolução.
- Escolha a aba. Com o cursor no campo "Código de Barras / Número da Guia", passe o leitor em cada guia (ou digite o número e tecle Enter).
- Cada leitura entra na lista com Código Lido, Nº Guia Mãe, Paciente, Convênio, Serviço, Status e Horário, e um ícone: verde = guia localizada; vermelho = guia não encontrada no sistema; amarelo (na devolução) = a guia existe, mas não foi registrada como recebida pelo faturamento.
- Guia lida duas vezes na mesma sessão, ou já registrada como Recebida/Devolvida, gera aviso e não entra de novo.
- Envie uma guia pelo ícone da linha ou marque várias (Sel. válidas ajuda) e clique em "Enviar". Só guias válidas podem ser enviadas; use Remover para tirar leituras erradas.
As leituras ficam guardadas enquanto a aba do navegador estiver aberta — se recarregar a página, a lista volta.
Histórico de Recebimentos
Faturamento › Histórico de Recebimentos lista o que já foi registrado no scanner: Nº Guia, Paciente, Convênio, Serviço, Status Recebimento (Recebido ou Devolvido), Status da Guia, Registrado por, data e hora do registro e da última atualização. Filtre pelas colunas para achar uma guia.
Lista antiga de Pré-Faturamentos
As rotas /portal/faturamento/pre-faturamento e /portal/guia/list/pre-faturamento abrem a lista antiga "Pré-Faturamentos" — atendimentos com serviços pendentes de pré-faturamento (Data do Atendimento, Paciente, Colaborador, Convênio, Guia, Status), com as Guias Filhas e o botão "Pré-Faturar". O menu Faturamento › Pré Faturamento abre a tela atual (/portal/guia2/list/pre-faturamento), que é a recomendada — veja Pré-Faturamento.
Inserir guia (tela fora do menu)
A rota /portal/faturamento/inserir abre um formulário de guia com os blocos da guia TISS (Dados do Beneficiário, Dados do Contratado, Dados do Atendimento — Procedimento Realizado) e o botão "Imprimir Guia". Ela não aparece no menu. As guias do dia a dia nascem do atendimento e são conferidas no Pré-Faturamento.
Telas Frontend
/portal/guia2/list/pre-faturamento— lista pré-faturamento/portal/guia/buscar— buscar guias/portal/guia/inserir— criar guia/portal/guia/pre-faturamento— histórico/portal/lote/fechar-lote— fechar lote/portal/lote/administrar-lote— administrar/portal/lote/gerar-contas-a-receber— gerar contas/portal/glosas— gestão de glosas- Novo — out/2026
/portal/faturamento/recebimentos-convenio— Recebimentos de convênio (baixa do demonstrativo) - Novo — out/2026
/portal/faturamento/faturamento-sem-xml— relatório Faturamento sem XML - Novo — out/2026 Faturamento › Retorno da operadora — TISS por webservice (primeira versão, em validação)