Lição: Faturamento TISS e Glosas

1. Objetivo do módulo e onde fica

O Faturamento é o que transforma atendimentos realizados em cobrança para o convênio, seguindo o padrão TISS da ANS. O caminho é: conferir as guias (pré-faturamento), agrupá-las em lote, gerar o XML TISS, enviar à operadora, tratar as glosas (itens recusados) e gerar as contas a receber no Financeiro.

Onde fica (menu / rotas):

2. TISS e TUSS — o que são

TISS (Troca de Informações em Saúde Suplementar) é o protocolo de comunicação entre a clínica (prestador) e as operadoras de plano de saúde, regulamentado pela ANS. TUSS (Terminologia Unificada da Saúde Suplementar) padroniza os códigos de procedimentos, materiais, medicamentos e taxas. O Rabi gera as guias TISS no padrão ANS e exporta o XML de cobrança por lote, usando os códigos TUSS.

Tabelas de domínio adotadas: Procedimentos Médicos, Materiais, Medicamentos, Taxas e Diárias (todas versionadas pela ANS) e CBOS (estática). O sistema mantém versões das tabelas para compatibilidade retroativa em auditorias.

3. Fluxo completo do faturamento TISS

1. Atendimento fechado — os procedimentos viram linhas de guia.
2. Pré-faturamento — revisão e validação dos campos obrigatórios da ANS.
3. Guia TISS — estrutura com paciente, serviços, produtos, taxas e equipamentos.
4. Lote — agrupa N guias por convênio + período.
5. XML TISS — gerado no padrão ANS, com hash SHA256.
6. Envio à operadora.
7. Retorno com nota fiscal/protocolo e valor liquidado da operadora.
8. Glosas — itens não pagos: contestar (recurso) ou aceitar.
9. Contas a receber — geradas automaticamente e acompanhadas no Financeiro.

4. Pré-faturamento (HU-001)

É a bateria de conferência antes de enviar à operadora — evita glosas depois. O faturista abre a lista de guias ainda não faturadas, filtra por convênio e período, revisa números (guia, autorização, senha), ajusta valores e anexa documentos. Ao confirmar, a guia fica pré-faturada e elegível para entrar em lote.

4.1 As 12 validações automáticas

1. Carteirinha do paciente ativa e dentro da validade.
2. Procedimento com autorização (quando exige).
3. CBOS do profissional preenchido.
4. CID-10 obrigatório (alguns procedimentos).
5. Quantidade × valor unitário batem com a tabela do convênio.
6. Datas coerentes (atendimento, início, fim).
7. Guia da operadora preenchida.
8. Indicador de acidente (Tabela 36) quando aplicável; tabela de referência de cada item (Tabela 87) coerente com o código.
9. Caráter do atendimento (Tabela 23).
10. Código de despesa CD (Tabela 25).
11. Profissional ativo e vinculado ao convênio.
12. Equipamentos/produtos consumidos lançados (aviso).

5. Guia TISS (estrutura mãe/filha)

Cada atendimento que vai a convênio precisa de uma Guia TISS estruturada: dados do paciente + carteirinha, serviços (com código TISS/TUSS), produtos consumidos, taxas, equipamentos, profissional (CBOS, CRM) e os números (guia, guia mãe, guia operadora, autorização, senha).

Hierarquia mãe/filha: cirurgias têm uma guia mãe e guias filhas (anestesia, diárias). A numeração segue o padrão: mãe = G123, filhas = G123.01, G123.02.

6. Lote TISS e geração do XML

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.

7. Administrar lote (HU-003)

Acompanhamento do lote depois de fechado: marcar como recebido pelo convênio (data de recebimento), editar protocolo/NFS-e, reabrir o lote (se permitido), exportar a lista de guias e re-emitir o XML. Desde 22/10/2026 o lote enviado não reabre, e guia com contas a receber gerado ou em lote enviado não é mais editável. Para convênio sem XML, o lote fechado tem o botão Envio sem XML (ver Faturamento sem XML). ✅ Novo — 23/10/2026

8. Contas a Receber (HU-004) — não é uma tela do Faturamento

9. Recebimento e baixa (HU-005)

Quando o pagamento chega (do convênio ou do paciente), o operador seleciona a parcela em aberto e informa: valor recebido, data, forma de pagamento, conta/caixa, multa/juros/desconto, anexando o comprovante. Em pagamento parcial, a parcela permanece em aberto com o saldo restante. O estorno só é permitido ao Gerente Financeiro.

✅ Atualização 13/10: desde 12/10 (#650) o estorno é feito pelo botão "Estornar" no Histórico da Conta (valor até o pago; motivo com no mínimo 5 caracteres): lança o inverso e a parcela original fica no histórico. Quem pode: o estorno é feito pelo líder: exige a ação Estornar (CONTAS CAIXAS) e alçada Nível 2 ou 3; o administrador também pode (a ação Estornar ninguém recebe sozinho — o administrador libera no perfil). Excluir movimentação com parcela paga passou a ser bloqueado: o caminho é o estorno. "Gerente Financeiro" é um nome de perfil, não uma regra do sistema.

9.1 Recebimentos de convênio (#686) ✅ Novo — 23/10/2026

Desde 23/10/2026 o pagamento do convênio é baixado em Faturamento › Recebimentos de convênio (permissão de Glosas). É o caminho novo; a baixa pela tela Glosas (valor pago por item) continua só para os casos antigos.

1. Clique em Novo recebimento e escolha:
   • Importar arquivo — XML TISS do demonstrativo, CSV/XLSX ou PDF. Na 1ª vez de cada layout, cadastre o layout e use Testar com arquivo;
   • Digitar — escolha o pagador e clique em Buscar guias.
   A busca automática pela API do convênio está prevista (ainda não funciona).
2. O sistema acha a guia de cada linha. O que não achar fica pendente: case à mão, ignore, edite ou use Recasar. O número dado pelo portal no envio sem XML ajuda a achar a guia.
3. Confira os totais (faturado, pago, glosa, valor no banco), informe a data do pagamento e a conta e clique em Baixar.
4. Efeito: contas a receber pagas (pagamento parcial deixa o saldo em aberto), glosa registrada com motivo e enviada para Glosas, guia como Paga, Paga parcial ou Glosada.
5. Recorrer da glosa cria a guia de recurso; Estornar desfaz a baixa (exige a ação Estornar e motivo); Cancelar descarta o recebimento.

Efeitos em outras telas: lançar glosa manual numa cobrança que já tem valor recebido dá o erro "Complete a baixa em Faturamento > Recebimentos de convênio"; o relatório agregado de glosas calcula o glosado como faturado − pago.

10. Glosas — contestar ou aceitar

Quando a operadora glosa um item (recusa o pagamento), o sistema permite contestar (abrir recurso) ou aceitar (gera estorno). A tela fica em /portal/glosas. Desde 23/10/2026 a glosa nasce na baixa do pagamento em Recebimentos de convênio (com motivo) e, dali, vai para Glosas, onde se recorre. ✅ Novo — 23/10/2026

No cadastro do convênio ficam configurados o limite de recurso de glosa e o prazo de recurso de glosa (em dias) — respeite esses prazos para não perder o direito de contestar. Para alterá-los, abra o convênio e clique em Liberar para edição (desde 29/09/2026 o convênio existente abre em modo consulta, #632).

11. CD — Tabela 25 da ANS

Os Códigos de Despesa (CD) são padronizados pela ANS (Tabela 25). Cada Produto do estoque deve estar vinculado a um CD para entrar corretamente na guia e no XML.

12. Permissões necessárias

Modelo atual: papel (Role) + ações VIEW/CREATE/UPDATE/DELETE por área (na tela redesenhada em 15–16/10: Visualizar / Criar / Editar / Total). Exemplos no faturamento:

Por perfil: o Faturista cria e ajusta pré-faturamento/lote e gera XML; o Gerente de Faturamento também exclui e reabre; o Financeiro/Caixa registra as baixas (o estorno é feito pelo líder: exige a ação Estornar (CONTAS CAIXAS) e alçada Nível 2 ou 3; o administrador também pode — desde 12/10, #650); o Auditor apenas consulta.

13. Erros comuns e como resolver

Novidades de julho/2026 ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Guias da mesma autorização agrupadas (#417) — o faturamento agrupa as guias que pertencem à mesma autorização.
• Outras Despesas na impressão da guia (#418) — as Outras Despesas passam a sair na impressão.
• Conversão R$ 0 corrigida (#419) — o cálculo de conversão que resultava em R$ 0 foi corrigido.
• Cálculo por pacote / "zerar em pacotes" (#448) — tratamento correto de itens faturados em pacote.
• Importação de XML para fechamento (#357) e comparação com o XML do convênio para baixa (#358).
• Status no relatório de pendências (#474).
• Telas de código de barras para recebimento e devolução de guias (#334/#349/#350).
• Bugs #386 e #387 corrigidos (validação de sessões e campo preFaturada das autorizações pré-faturadas).

Novidades de agosto/2026 ✅ Novo — ago/2026

Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• XML TISS corrigido — 5 bugs (#525–#529) + consolidado do cálculo/geração (#530): quantidadeExecutada/valorUnitario (#525), codigoTabela ANS da taxa (#526), material como OPME (#527), valor zerado que voltava a ser cobrado (#528) e regra somarItens de pacote (#529).
• Salvar garantido no pré-faturamento (#519) — corrigido o bug "diz que salvou mas não salva".
• PDF/digitalização completa dos documentos por guia (#451) — para envio às operadoras.
• Corrigir guias em lote (#420) — por serviço, convênio e período.
• Importar XML de faturamento de outro sistema (#436) — casamento automático + área de conciliação. ✅ Novo — 29/09/2026 Em revisão (#630/#631, Sprint 12): a importação de XML TISS no Financeiro está sendo retestada na versão atual (não é erro confirmado). ✅ Novo — 30/09/2026 Atualização 30/09 — parte corrigida em produção desde 29/09/2026 (#631 fechada): 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 ("Importação não realizada para não gerar lançamento de R$ 0,00"); há avisos por guia (não bloqueiam) para guia sem valorTotalGeral e para guia cuja soma dos itens não bate com o valorTotalGeral; excluir uma importação libera o número do lote para reimportar, respeitando o convênio, e as guias da importação excluída deixam de aparecer como pendência. #630 segue aberta (casamento automático de guias, filtros da lista, saldo A Receber ao excluir). Orientação temporária ajustada: testar primeiro com poucos arquivos numa conta caixa separada; ler os avisos por guia; conferir o saldo A Receber depois de excluir uma importação; o casamento automático pode não casar — vincular manualmente quando preciso; boa prática: não importar o mesmo arquivo duas vezes.
• Snapshot da quantidade faturada no fechamento do lote (#562).
• Registros saem da guia quando o status é faturado (#213) e correções na tela da guia (#449).
• Bugs urgentes corrigidos (13–24/08): erro ao gerar o hash do XML que parava o sistema (#578); o pré-faturamento passa a manter a anulação de produto/serviço/taxa (#579); guia CASSI/lote que saía zerada corrigida (#580); inserir guia em lote agora mostra somente lotes abertos (#582).
• Rework completo de Glosas (25–28/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) e status de guia unificados — 3 mecanismos viraram 1 (#588).
• Reconciliação do pré-faturamento (épico #572 concluído): reconciliação autorizado × agendado × atendido × faturado (#568) e área fixa de divergências, com opção de faturar a diferença sem apagar o histórico (#569).
• Localizar guia pelo número (#421) — busca direta da guia (mãe e filha) pelo número.
• Tela de lotes ordenada decrescente (#581) — os lotes mais recentes aparecem primeiro.
• Correção no relatório de repasse (#584) — guias diretas passam a entrar corretamente.

Novidades de setembro/2026 ✅ Novo — set/2026

Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Código 23 volta a ser "Exame" + novo "Exame Ambulatorial": na guia, o código 23 do Tipo de Atendimento voltou a se chamar "Exame" e foi criado o novo código "Exame Ambulatorial" — use cada um conforme o tipo do atendimento (não confundir com a Tabela TISS 23, de caráter do atendimento).
• Número de guia duplicado VOLTOU a ser bloqueado: a liberação anterior foi revertida — o sistema volta a impedir duas guias com o mesmo número.
• NF-e de fornecedor ENTREGUE (#391) ✅ Novo — set/2026: em Compras › Notas Fiscais de Entrada, importe o XML da nota do fornecedor e, ao Confirmar Recebimento, o sistema dá entrada no estoque e cria a conta a pagar. Limitações atuais (lote, validade padrão, conta a pagar sem parcelas/vencimento, total só dos produtos) — ver a lição de Estoque; melhorias = #629 (roadmap). ✅ Atualização 13/10: as melhorias (#629) estão em produção desde 09/10 — lote e validade da nota, parcelas das duplicatas, conta a pagar com o total da nota e estorno do recebimento. Saiu do roadmap. (A integração de NF-e em si, #147, havia sido concluída no desenvolvimento em 03/09.)
• tipoAtendimento do XML vem do convênio (em produção desde 23/09/2026): a aba Serviços do convênio converte também o Tipo de Atendimento (3 linhas 🔒/🔁/✅) — o tipo efetivo do convênio é o que vai para o atendimento, o pré-faturamento e o campo tipoAtendimento do XML TISS.
• ✅ Novo — 29/09/2026 Correções de 28/09/2026: a conta a receber de convênio gerada no faturamento passa a usar o centro de custo padrão dos Parâmetros (com correção de valores/unidade), e a seleção de especialidade no pré-faturamento foi corrigida.
• Zero é zero no pré-faturamento e nas contas a receber (em produção desde 23/09/2026): valor convertido 0,00 é preço zero de verdade em todas as telas — inclusive pré-faturamento, contas a receber e XML; só o campo vazio faz o sistema descer de nível na conversão. O bug que tratava 0,00 do serviço como vazio foi corrigido.

Novidades de outubro/2026 (01–13/10) ✅ Novo — out/2026

Conferidas no código de produção em 13/10/2026.

• Retorno sem valor (#645, desde 05/10): retorno dentro do prazo do convênio (mesmo serviço, mesmo profissional, serviço com Retorno marcado no convênio) nasce com serviço e taxas zerados; pré-faturamento, lote/XML e repasse saem com 0, e a lista de guias do pré-faturamento mostra o chip "RETORNO" ("Consulta de retorno — não gera valor"). O repasse do retorno é decidido por serviço. Retornos da IA, do online e do encaixe adicional não são detectados — confira e marque à mão.
• Filtro "Pré-faturadas" (#647, desde 02/10): o filtro "pendentes" da lista de guias mostra só Atendido e Atendido com pendência; as guias pré-faturadas ficam no filtro novo "Pré-faturadas" (para rever ou reabrir) e saem do banner de divergências "a ajustar" da Fila de Atendimento. "Todos" continua mostrando tudo.
• Divergência atendido × faturado (#648): a guia sai do banner quando está em lote com protocolo de entrega preenchido; o registro continua no histórico.
• Replicar ajustes desta guia (09/10 e 13/10): no Editar Guia (pré-faturamento e Fechar lotes), a caixa "Replicar para as outras guias ao salvar" cola produtos e taxas desta guia nas 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 — use com cuidado. O Editar Guia também acompanha a renumeração da guia.
• Importação de XML TISS (#630) 🟡 Parcial: em produção desde 01/10 — no modal "Importar XML TISS", a Situação de envio do lote (Enviado / Sem envio / A conferir), o Protocolo de envio e a data; na Conciliação XML Externo › Auditoria, a coluna/filtro Envio (individual ou em massa); Desvincular guia restaura o estado anterior ao casamento; filtros de data, valor e conta caixa na lista de movimentações; importação sem convênio identifica pelo registro ANS do XML. Continue com cautela no casamento automático guia × atendimento (não confirmado como resolvido): vincule manualmente o que não casar.
• XML SP/SADT (07/10): o campo tipoConsulta só é enviado quando o tipoAtendimento é 04.
• Autorização de guia fechada (#649): depois de pré-faturada ou faturada, a guia não recebe mais sessões — a autorização sai das "Autorizadas" e é preciso pedir nova.
• Subserviços (#641): aparecem no agendamento e na autorização com autorização própria opcional; não foi confirmada mudança no pré-faturamento/guia para listar subserviços — confira se a operadora exige.
• Exclusão de produto e taxa em uso (#626, desde 02/10): bloqueada — o item não some mais da guia sem aviso.
• Conta de recebimento do convênio (#650, desde 12/10): nova na aba Dados do convênio; o Gerar Contas a Receber do lote usa essa conta ou a "Conta Padrão de Recebimento de Convênios" dos Parâmetros › Financeiro — sem nenhuma das duas, responde erro (a conta não é mais criada sozinha). Na Conciliação Bancária (OFX), o título de lote de convênio pode ser baixado com o valor creditado, e a diferença segue para glosa.
• Conflito de edição (#640): pré-faturamento e lote recusam gravar por cima do que outra pessoa alterou ("Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar.").

Novidades de 13–15/10/2026 ✅ Novo — 15/10/2026

Conferidas no código de produção em 15/10/2026.

• "Criar Guia" pede autorização (15/10): no pré-faturamento, criar guia de serviço que o convênio marca com autorização prévia passa pelas 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. Mudou em 19–20/10: o Criar Guia agora só avisa e deixa seguir; a exigência passou para o Pré-Faturar. ✅ Novo — 23/10/2026
• Guia-mãe sempre com raiz (15/10): fim das guias órfãs — a guia mais antiga não anulada vira a mãe; agendamento cancelado, remarcado ou com falta não é mais mãe; ao vincular guia, a filha mais antiga assume; excluir a mãe dá nova mãe ao grupo. Um job diário corrige o que ficou para trás.
• Autorização depois do atendimento preenche as guias: autorização editada ou aprovada depois do atendimento completa os campos vazios das guias (fora de lote fechado); serviço adicionado à mão pega senha, guia, protocolo e datas da autorização.
• Integração TISS — fase 1 (#619, desde 15/10): aba "Integração TISS" na operadora, botão "Verificar elegibilidade" no agendamento/acolhimento e a tela Configurações › Log de integração TISS. O lote continua sendo enviado pela clínica no portal/canal da operadora: envio de lote e protocolo (#620), demonstrativos com baixa/glosa automáticas (#621), autorização online (#622) e recurso de glosa/cancelamento (#623) seguem 🟠 Roadmap (Sprint 14). Atualização 23/10: as fases 2–4 ganharam a tela Faturamento › Retorno da operadora (telas 22/10, servidor 23/10) — primeira versão no ar, em validação (#620/#622/#623 abertas); não conte que todas as operadoras funcionam. ✅ Novo — 23/10/2026
• Permissões que passaram a valer (13–14/10): salvar glosa exige GLOSAS UPDATE (o botão segue a permissão); editar XML exige UPDATE em Administrar Lote ou em Faturamento. Quem tem só VIEW consulta, mas não salva.
• Replicar ajustes desta guia foi revisado (13/10) e o Fechar Lotes ganhou ajuste de lista.

Novidades de 16–23/10/2026 ✅ Novo — 23/10/2026

Conferidas no código de produção em 23/10/2026.

• Recebimentos de convênio (23/10, #686): baixa do pagamento pelo demonstrativo importado ou digitado — ver 9.1.
• Pré-faturamento (19–20/10): campo Local da guia (só as 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).
• Regras de 22/10: guia com contas a receber gerado ou em lote enviado não é editável; lote enviado não reabre; "Preencher Valor Pago" usa a data de hoje.
• Retorno da operadora (TISS fases 2–4): lote, demonstrativos, autorização online e recurso de glosa — primeira versão no ar, em validação. A fase 1 (Verificar elegibilidade, #619) já estava.
• Relatórios › Pareto (21/10): Convênios, Itens faturados e Glosas por motivo/convênio/serviço (bruto × líquido, líquido desconta glosa) — ver a lição de Relatórios.

Faturamento sem XML (#687, 23/10) ✅ Novo — 23/10/2026

Para convênio que recebe por portal ou papel:

1. No convênio (Liberar para edição), subaba Faturamento: forma de envio (XML, Portal ou Papel), intermediador (associação ou cooperativa, se houver), endereço do portal e periodicidade (ex.: quinzenal).
2. Feche o lote normalmente. Em Administrar Lotes, no lote fechado, clique em Envio sem XML.
3. Baixe o espelho de digitação (XLSX com o que o portal pede) e digite as guias no portal; depois, "Marcar todas como digitadas".
4. Clique em Registrar envio: data, nº da remessa/protocolo, competência e, por guia, digitada/recusada/pendente, com o número dado pelo portal e o valor. A tela mostra faturado × digitado.
5. Depois de registrado, o lote não aceita guia nova. Acompanhe em Faturamento › Faturamento sem XML. O número do portal ajuda a achar a guia quando o pagamento chegar (Recebimentos de convênio).

Novidades de 23–24/10/2026 — Administrar Lote e contas a receber ✅ Novo — 26/10/2026

Conferidas no código de produção em 26/10/2026.

• Valor do lote = total da guia calculado pelo servidor — o mesmo valor do XML e do contas a receber (respeita zero, retorno e preço do produto). Antes era uma soma feita na tela, que podia divergir.
• Janela de vários lotes (gerar contas a receber): guias que já têm conta a receber não podem ser marcadas; selos "Conta a receber já gerada" (na guia) e "Contas já geradas" (no lote). Se der erro, a janela fica aberta com a mensagem (antes fechava como se tivesse dado certo). No sucesso: "Contas a receber geradas com sucesso!".
• A coluna XML deixou de ficar fixa e não cobre mais Data de Recebimento e Convênio.
• Glosa repetida: aplicar glosa num serviço já glosado mostra "Este serviço já foi glosado anteriormente. Não é possível aplicar nova glosa." (antes era um erro genérico).

14. 🟠 Planejado (roadmap)

Pontos-chave

• Fluxo: atendimento → pré-faturamento → guia → lote → XML TISS → envio → glosas → contas a receber.
• Pré-faturamento roda 12 validações ANS antes do envio (economiza glosas).
• Guias podem ser mãe/filha (cirurgias): G123, G123.01...
• Fechar o lote bloqueia as guias para edição isolada. ✅ Atualização 13/10: no sistema atual a edição de guia de lote fechado continua permitida (trava revertida em 06/10) — não altere guias já faturadas sem conferir lote e XML. Desde 22/10: guia com contas a receber gerado ou em lote enviado não é editável e o lote enviado não reabre. ✅ Novo — 23/10/2026
• O XML tem hash SHA256 e usa a versão TISS configurada no convênio.
• Contas a Receber vive no Financeiro, não em uma tela do Faturamento.
• ✅ Novo — 26/10/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); guia com conta a receber já gerada não pode ser marcada de novo; glosa repetida no mesmo serviço é recusada.
• Glosa: PENDENTE → EM_RECURSO → RECUPERADA / ACEITA / DEFINITIVA.
• Novidades de jul/2026: agrupamento por autorização (#417), Outras Despesas na impressão (#418), conversão corrigida (#419), pacotes (#448), importação/comparação de XML (#357/#358), status no relatório de pendências (#474) e telas de código de barras (#334/#349/#350).
• Novidades de ago/2026: 5 bugs do XML TISS corrigidos (#525–#529, consolidado #530), salvar garantido no pré-faturamento (#519), PDF por guia (#451), correção de guias em lote (#420), importação de XML de outro sistema com conciliação (#436), snapshot da quantidade faturada no fechamento do lote (#562), bugs urgentes #578/#579/#580/#582 corrigidos, localizar guia pelo número (#421), lotes em ordem decrescente (#581) e fix do relatório de repasse (#584).
• Rework de Glosas ENTREGUE (ago/2026): fluxos de registro unificados (#585), baixa/glosa automática a partir do retorno TISS (#586), relatório agregado por convênio/motivo/período (#587) e status de guia unificados (#588).
• Reconciliação do pré-faturamento ENTREGUE (ago/2026): autorizado × agendado × atendido × faturado (#568), área fixa de divergências e faturar diferença sem apagar histórico (#569, épico #572).
• Novidades de set/2026: pré-faturamento NÃO baixa mais o estoque (mudança de regra — o saldo só se movimenta pelo consumo real), código 23 volta a ser "Exame" + novo código "Exame Ambulatorial", número de guia duplicado voltou a ser bloqueado e a importação de NF de fornecedor (#391) foi ENTREGUE (XML do fornecedor carrega estoque + contas a pagar).
• Desde 23/09/2026: o tipoAtendimento do XML é o tipo efetivo definido no convênio (coluna de 3 linhas na aba Serviços) e 0,00 é preço zero em todas as telas (pré-faturamento, contas a receber e XML) — só campo vazio desce de nível. Também em produção (23–24/09): a linha de procedimento do XML traz o valor do próprio serviço, sem somar produtos/taxas (quem soma é só o Farol); os itens sempre entram nas próprias áreas do XML (fora só sem Utiliza ou zerados em pacote fechado — Zerar por item, sem cascata); e os textos finais (nome, código, tabela 87) saem convertidos.
• Valor combinado NÃO é pacote (regra vigente): guia com preço fechado exige Pacote no serviço (marcação por convênio) + Zerar nos itens inclusos. Linha de procedimento 0,00 em serviço que soma itens sem valor combinado não é erro; desde 24/09 (em produção), a linha Σ da coluna Valor mostra o total da guia para o serviço (= receita do Farol).
• NFS-e — MÓDULO FISCAL COMPLETO EM PRODUÇÃO desde 22/09/2026 (épico #462): emissão no pagamento (inclusive direto do Agendamento/Orçamento), por convênio, assíncrona, IBS/CBS, opt-in por clínica (1ª fase, desde set) + modelos de nota (#465), tela Notas NFS-e com cancelar/substituir/pendências (#468) e onboarding fiscal (#472), desde 22/09. Desde 24/09, no orçamento 100% particular com financeiro próprio, a NFS-e das sessões sai por parcela paga, pelo lado do orçamento.
• Conferência do que vai na guia: seta de expandir o serviço (#625, concluído em 25/09) com o Motivo de cada item que fica fora. Hoje excluir produto/taxa é livre e tira a receita da guia sem aviso (bloqueio = #626, roadmap). ✅ Atualização 13/10: bloqueio em produção desde 02/10.
• Importação de XML TISS no Financeiro: desde 29/09/2026 (#631) o lançamento usa o valorTotalGeral da guia, lote sem nenhum valor é bloqueado, há avisos por guia (sem valor / soma dos itens diferente) e excluir a importação libera o número do lote. ⚠️ #630 segue em revisão: teste com poucos arquivos numa conta caixa separada, leia os avisos por guia, confira o A Receber após excluir uma importação e vincule manualmente o que o casamento automático não casar.
• ✅ Novo — out/2026 Desde 01–13/10: retorno sem valor com chip RETORNO (#645); filtro "Pré-faturadas" (#647); divergência sai com protocolo de entrega (#648); "Replicar ajustes desta guia" (altera também guia faturada/de lote fechado); envio do lote, Desvincular guia e filtros na importação de XML TISS (#630 parcial — cautela no casamento automático); conta de recebimento do convênio para o Gerar Contas a Receber (#650).
• ✅ Novo — 23/10/2026 Pagamento do convênio: Recebimentos de convênio (importar ou digitar → casar → Baixar; glosa com motivo vai para Glosas; Estornar desfaz). Convênio por portal/papel: subaba Faturamento + botão Envio sem XML (espelho de digitação, Registrar envio). Pré-Faturar exige autorização; Criar Guia só avisa. Retorno da operadora (TISS 2–4) em validação.
• ✅ Novo — 15/10/2026 Desde 13–15/10: "Criar Guia" exige autorização quando o convênio pede (desde 19–20/10 só avisa; a exigência ficou no Pré-Faturar); guia-mãe sempre com raiz (fim das guias órfãs); autorização posterior preenche os campos vazios das guias; salvar glosa exige GLOSAS UPDATE e editar XML exige UPDATE em Administrar Lote/Faturamento; integração TISS fase 1 = só elegibilidade (#619) — o lote segue enviado pela clínica.

O que a prova vai cobrar

• A ordem correta das etapas do fluxo TISS.
• O que o pré-faturamento valida e por que ele reduz glosas.
• Os status da glosa e a diferença entre contestar (recurso) e aceitar (estorno).
• Que a baixa/glosa é automática a partir do retorno TISS (#586) e que existe relatório agregado de glosas por convênio/motivo/período (#587) — entregues em ago/2026.
• Que a reconciliação do pré-faturamento compara autorizado × agendado × atendido × faturado e permite faturar a diferença sem apagar o histórico (#568/#569).
• Que, desde set/2026, o pré-faturamento NÃO baixa mais o estoque — a resposta antiga ("o pré-faturamento sensibiliza o saldo") está desatualizada.
• Que a NFS-e é um módulo fiscal COMPLETO EM PRODUÇÃO desde 22/09/2026 (épico #462) — emissão (no pagamento, por convênio, assíncrona, opt-in) e as peças finais (modelos de nota #465, gestão das notas #468 com cancelar/substituir/pendências na tela e na API, onboarding fiscal #472); as respostas antigas ("NFS-e é só roadmap", "está em conclusão" ou "as peças finais só existem no desenvolvimento") estão desatualizadas.
• Que Contas a Receber é gerado automaticamente e aparece no Financeiro.
• O significado de TISS × TUSS e das tabelas ANS (23, 25, 36, 87).
• Que, desde 23/09/2026, a linha de procedimento do XML traz o valor do próprio serviço (não a soma) e que produtos/taxas saem nas próprias áreas do XML — quem soma tudo é o Farol.
• Que a importação de XML TISS no Financeiro lança o valorTotalGeral de cada guia, bloqueia o lote em que nenhuma guia tem valor e mostra avisos por guia que precisam ser lidos (#631, em produção desde 29/09/2026); #630 parcial (01/10): envio do lote, Desvincular guia e filtros em produção; só o casamento automático guia × atendimento ainda pede cautela.
• Que a linha de procedimento 0,00 em serviço que soma itens (sem valor combinado) não é erro, e que o valor combinado sozinho não fecha pacote — preço fechado na guia exige Pacote + Zerar nos itens inclusos.
• ✅ Novo — out/2026 Que retorno dentro do prazo não gera valor (guia e repasse com 0, chip RETORNO), que as guias pré-faturadas ficam no filtro "Pré-faturadas" e que o Gerar Contas a Receber exige conta de recebimento no convênio ou nos Parâmetros.
• ✅ Novo — 23/10/2026 Como se baixa o pagamento do convênio em Recebimentos de convênio (e o erro "Complete a baixa em Faturamento > Recebimentos de convênio"), o fluxo do Faturamento sem XML, que o lote enviado não reabre e que o Pré-Faturar exige autorização.
• ✅ Novo — 26/10/2026 Que o valor do lote é o total da guia calculado pelo servidor (igual ao XML e ao contas a receber) e que guia com conta a receber já gerada não pode ser marcada de novo na janela de vários lotes.
• ✅ Novo — 15/10/2026 Que o "Criar Guia" do pré-faturamento avisa (desde 19–20/10; antes exigia) autorização quando o convênio marca o serviço com autorização prévia; que a integração TISS por webservice em produção (fase 1, #619) cobre só a elegibilidade — o envio do lote ainda é feito pela clínica no portal da operadora; e quais permissões salvam glosa e editam XML.