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 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.

EntregaIssueFechada em
Guias da mesma autorização agrupam no faturamento — guias vinculadas a uma mesma autorização passam a ser agrupadas ao faturar#41723/07
Impressão da guia exibe os valores de Outras Despesas#41822/07
Correção na conversão de valores R$ 0,00#41920/07
Pré-faturamento: cálculo por pacote, opção "zerar em pacotes" e conversão#44824/07
Autorização vira "faturada" quando alguma guia dela é faturada#45024/07
Importação de XML para fechamento de guias e lotes#35724/07
Comparação com o XML do convênio para baixa#35814/07
Status do faturamento no relatório de pendências#47409/07
Telas de recebimento e devolução de guias com código de barras#350, #349, #334jun/2026

Visão Geral — Fluxo TISS

  1. Atendimento fechado
  2. Pré-Faturamento: revisão + validação de campos obrigatórios ANS
  3. Guia: estrutura completa com paciente + serviços + produtos + taxas + equipamentos
  4. Lote: agrupa N guias por convênio + período
  5. XML TISS: gerado conforme padrão ANS 4.x
  6. Envio à operadora
  7. Retorno com NFS-e + valor
  8. Glosas: itens não pagos → contestar ou aceitar
  9. Contas a Receber: geração automática

1. Pré-Faturamento

Bateria de validação ANTES de enviar à operadora — economiza glosas posteriores.

Endpoints (16 endpoints — módulo grande)

MétodoPathPermissão
GET/VIEW
GET/guiasFilhas/:guiaMaeVIEW
GET/InfoExtras/:guiaMae/:guiaFilhaVIEW
GET/servicoPorGuia/:guiaFilhaVIEW
GET/colaboradores-credenciadosVIEW
PUT/save/:servicoAtendimentoIdUPDATE
PUT/confirmar/:guiaMaeUPDATE
POST/servicoAdd, /produtoAdd, /taxaAddUPDATE
PUT/produtos/InfoExtras/:guiaMaeUPDATE

12 Validações automáticas

  1. Carteirinha do paciente ATIVA e dentro da validade
  2. Procedimento com autorização (se exige)
  3. CBOS do profissional preenchido
  4. CID-10 obrigatório (alguns procedimentos)
  5. Quantidade × valor unitário batem com tabela do convênio
  6. Datas coerentes (atendimento, início, fim)
  7. Guia da operadora preenchida
  8. Indicador acidente (Tabela 87) quando aplicável
  9. Caráter atendimento (Tabela 23)
  10. Código despesa CD (Tabela 25)
  11. Profissional ativo + vinculado ao convênio
  12. 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)

Endpoints (9)

MétodoEndpointFunção
GET/guia/anosPrefaturamentoAnos com guias
GET/guia/guiasFilhasFilhas de uma mãe
GET/guia/preFaturamento/:atendimentoIdGuia por atendimento
GET/guia/prefaturadasLista prefaturadas
GET/guia/lote/:loteIdGuias do lote
GET/guia/:atendimentoId/:servicoId/Detalhe
GET/guia/:atendimentoId/:servicoId/produtosProdutos do serviço
GET/guia/:atendimentoId/:servicoId/taxasTaxas
GET/guia/:atendimentoId/:servicoId/equipamentosEquipamentos

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é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: 3.04.01)
  3. Valida schema XML + obrigatoriedade campos
  4. Gera hash SHA256
  5. Envia (manual ou web-service)
  6. Recebe retorno (NFS-e + valor liquidado)
  7. 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).

Endpoints

MétodoEndpoint
GET/glosas/motivos
GET/glosas/status
GET/glosas/status-valor
GET/glosas/listar
GET/glosas/movimentacoes/:id
POST/glosas/

Status

5. CD — Tabela 25 ANS

Códigos de despesa padronizados pela ANS. Cada Produto vinculado a um CD.

Endpoints

MétodoEndpoint
POST/cd/
GET/cd/

Telas Frontend