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.
4 módulos NOVOS: Pré-Faturamento + Guia + Lote + Glosas + CD (Tabela 25 ANS). Documentação completa.
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 (caráter 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.
🟠 Segue no roadmap: a importação de NF de fornecedor (#391) continua planejada para a Sprint 9 (04–11/set) — ainda não disponível.
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 |
🟠 Ainda roadmap (não entregue): a NFS-e — núcleo e conclusão na Sprint 9 (04–11/set). 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 acidente (Tabela 87) quando aplicável
- 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.
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: 3.04.01)
- Valida schema XML + obrigatoriedade campos
- Gera hash SHA256
- Envia (manual ou web-service)
- Recebe retorno (NFS-e + valor liquidado)
- Gera contas a receber via
/lote/gerar-contas-receber
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.
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/ |
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