O faturamento por dentro.
Compare e aja
"Compara as glosas da Unimed e do São José." A IA lê os indicadores, explica o motivo de cada uma e cria a tarefa que ataca a causa.
Gravações do sistema numa clínica de demonstração, com dados fictícios.
Ferramentas MCP
Leitura sem dado do paciente: nome e carteirinha do beneficiário não passam.
Ler
Glosas, prazos de contestação, indicadores, lotes, demonstrativos, recursos e a fila de autorizações.
- vendas_tiss_glosas_find
- vendas_tiss_glosas_sla
- vendas_tiss_glosas_indicadores
- vendas_tiss_lotes_find
- vendas_tiss_demonstrativos_find
- vendas_tiss_recursos_find
- vendas_tiss_autorizacao_board
Configurar
O contrato TISS de cada convênio e a tabela TUSS, com prévia antes de gravar. A busca no TUSS acha o código pelo nome do procedimento.
- vendas_tiss_manage_config
- vendas_tiss_importar_tuss
- vendas_tiss_tuss_lookup
Fora da IA
Gerar recurso, conciliar, mudar a glosa de etapa e montar o lote ficam na Central, com a pessoa.
API REST
Para integração sem IA: token da integração e chamadas HTTP. A referência completa vem com o acesso que a clínica concede.
Lote e guias
Criar o lote, gerar as guias das vendas do convênio e baixar o arquivo no formulário oficial TISS.
- POST /vendas/faturamento-tiss/lotes
- POST /vendas/faturamento-tiss/lotes/{lote_id}/gerar-guias
- GET /vendas/faturamento-tiss/lotes/{lote_id}/xml
Retorno e glosas
Importar o demonstrativo, criar as glosas dele e consultar prazos e indicadores.
- POST /vendas/faturamento-tiss/demonstrativos/importar
- POST /vendas/glosas/conciliar
- GET /vendas/glosas/sla
- GET /vendas/glosas/indicadores
Recurso
Gerar o recurso de uma ou várias glosas do mesmo lote e registrar a resposta da operadora.
- POST /vendas/recursos-glosa
- POST /vendas/recursos-glosa/{recurso_id}/resposta-operadora
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
sla = get(f"{API}/vendas/glosas/sla", token, params={
"janela_alerta_dias": 15,
"incluir_vencidas": False,
})
for g in sla["itens"]:
print(g["protocolo_peg"], g["motivo_codigo"], g["valor_glosado"],
f'{g["dias_restantes"]} dias')Regras e permissões
Etapas com regra
A glosa só anda pelas etapas previstas; transição fora delas é recusada. Um lote tem no máximo um recurso aberto por vez.
O prazo vem do contrato
O prazo de contestação de cada glosa sai da configuração TISS do convênio.
- GET /vendas/faturamento-tiss/config/por-convenio/{convenio_id}
Uma permissão por ação
glosa.list, read, create, update e conciliar; recurso_glosa; lote; demonstrativo.import. O papel de quem pede decide o que passa.
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "Compara as glosas da Unimed e do São José: quanto cada uma glosa e por quê. Responde em tópicos."vendas_tiss_glosas_indicadores
- "Qual é o código TUSS da topografia de córnea?"vendas_tiss_tuss_lookup
- "Quais lotes da Unimed já voltaram da operadora, e quanto foi glosado em cada um?"vendas_tiss_lotes_find
Passo a passo nos manuais
- MAN-AGE-04Autorização do convênio antes do atendimento
- MAN-EXT-01Extensão do navegador para a autorização do convênio
- MAN-VEN-04Faturamento TISS a fundo: configurações, TUSS, montagem da guia, demonstrativo
- MAN-VEN-05Glosas e recurso de glosa
- MAN-VEN-03Convênio na prática: tabela de preço, coparticipação e guia
