Integração com Overmind (Autorização de Guia / Consulta Elegibilidade)
Manual com objetivo de mostrar as instruções do passo a passo de como realizar a configuração para o bom funcionamento da integração via WEBSERVICE com a OVERMIND para Autorização de Guias dos Convênios.
Versão | Proprietário | Nota | Data |
|---|---|---|---|
1.0 | @Rafael Carvalho | Criação de documento | 30/01/2025 |
1.1 | @Rafael Carvalho | Atualização de Imagens + Inclusão de Instrução para Elegibilidade | 27/03/2025 |
Índice
Conceito da Integração com a OVERMIND
Compreende-se como OVERMIND o sistema responsável pela autorização eletrônica de procedimentos junto às operadoras de saúde, permitindo que laboratórios realizem a comunicação automática para solicitação, consulta e controle das autorizações necessárias à execução dos exames.
Por meio dessa integração, o laboratório passa a realizar, de forma sistematizada e segura, o envio das solicitações de autorização e o recebimento dos retornos (status, liberações, negativas e demais informações), utilizando comunicação via WEB SERVICE, conforme os padrões definidos pela Overmind.
Nesse cenário, a integração com o OVERMIND é dinâmica e totalmente PERSONALIZÁVEL por cliente, permitindo que cada laboratório configure:
As operadoras que utilizarão o OVERMIND;
Os procedimentos/exames que exigem autorização;
As regras específicas de envio, conforme contrato e necessidade operacional.
Essa flexibilidade possibilita que o laboratório tenha total controle sobre quais exames serão submetidos à autorização automática, garantindo conformidade com as exigências das operadoras e maior agilidade no atendimento ao paciente.
Sendo assim, abaixo será demonstrado como realizar a configuração do cadastro de integração com o OVERMIND, passo essencial para viabilizar o processo de autorização eletrônica de exames via sistema.
Configuração do Convênio
Aba TISS
Devemos entrar na Aba “TISS” e realizar as configurações de acordo com o Convênio, como a quantidade de exames por Guia, se gera a guia automaticamente, agrupamento de exames, etc.
Imagem de exemplo de um convênio configurado abaixo:
A imagem acima é apenas um Exemplo, cada convênio/laboratório pode ter suas particularidades e deve ser configurado de acordo com suas particularidades.
Além desse processo, pode ser necessário marcar que alguns campos devem ser obrigatórios na aba “Recepção”, como número de guia, matrícula, etc.
Aba INTEGRAÇÃO
Agora devemos entrar na Aba “INTEGRAÇÃO”, marcar que utiliza a integração com a Overmind, e preencher as URL’s da integração e informar o Login e Senha da integração (Precisa criar um login e senha no ambiente da Overmind, na aba WebService).
Configuração Parâmetros do Sistema
Configurar no menu “Parâmetros do Sistema” → “Integrações” o Código Parceiro (Overmind disponbiliza para o cliente) e URL para solicitação de Procedimento / Consultar Status da GUIA e Elegibilidade, conforme imagem abaixo:
Foi Homologado, com a seguinte URL.
Solicita Procedimento / Consultar Status de GUIA:
⮚ URL de Produção:
https://api.overmind.ai/auth/overmind/v1/
Consulta Elegibilidade:
⮚ URL de Produção:
https://api.overmind.ai/eleg/overmind/v1/
Consultando Elegibilidade
Para consultar a elegibilidade, devemos consultar selecionando o convênio e digitando a matrícula na tela de Cad. Atendimento, conforme exemplo abaixo:
Após preencher os dados e clicar em “Consultar”, será exibido a mensagem com o retorno da integração se está Elegível ou Inelegível.
Inelegível (Exibe modal para alerta):
Só é possível realizar a consulta na CRIAÇÃO de atendimento.
Criando um Atendimento / Autorizando Guia
Manual para apoio ao cadastro de atendimento Cadastro de Atendimentos
Após o preenchimento dos dados do paciente e exames, ao finalizar o atendimento irá perguntar se deseja realizar a autorização WEB, conforme imagens abaixo:
Ao finalizar, poderá ser redirecionado a tela de Painel de Autorização, ou clicar no ícone de Integração na listagem dos atendimentos, conforme imagem abaixo:
Será exibido a listagem das guias do atendimento, e para solicitar a autorização, deverá clicar no mesmo ícone de integração, guia a guia.
Será exibido a mensagem de sucesso/falha de acordo com o retorno da integração, e o status será atualizado.
Sucesso:
Consultando no ambiente da Overmind
Verificar com cliente.
Exemplo estrutura JSON (Conteúdo Tags),
Exemplo Solicitação de Autorização:
{
"cabecalhoPedido": {
"codigoParceiro": "codigolabovermind",
"codigoOperadora": "3",
"origemPedido": "descricao posto"
},
"pedidoAutorizacao": {
"dadosBeneficiario": {
"carteirinha": "1234124313",
"nome": "nomedopaciente",
"rn": false
},
"dadosMedicoSolicitante": {
"conselhoMedico": "CRM",
"ufConselho": "SP",
"numeroConselho": "12345",
"nome": "nomemedico"
},
"tipoSolicitacao": "SADT",
"caraterSolicitacao": "ELETIVO",
"indicacaoClinica": "Exames de rotina",
"dataProcedimento": "26/01/2026",
"token": null,
"procedimentos": [
{
"codigo": "40303039",
"descricao": "COPROLOGICO FUNCIONAL DE FEZES",
"quantidade": "1"
}
],
"codigoAtendimentoOriginal": "001000029",
"codigoGuiaOriginal": "15",
"cid": ""
}
}codigoParceiro= Código do Laboratório na Overmind (Disponibilizado pela Overmind).
codigoOperadora= Código do Convênio na Overmind (Anexo planilha com os códigos, algumas tem mais de uma, nesse caso confirmar com o cliente/overmind qual código utilizar).
origemPedido= Descrição do Posto do atendimento.
dadosBeneficiario → carteirinha= matrícula do prontuário (Código da carteirinha do paciente no convênio).
dadosBeneficiario → nome= Nome do Paciente.
dadosBeneficiario → rn= Recém Nascido (False ou true)
dadosMedicoSolicitante → conselhoMedico= CRM (Fixo atualmente).
dadosMedicoSolicitante → ufConselho= UF do CRM informado no cadastro do Médico.
dadosMedicoSolicitante → numeroConselho= Numero do CRM informado no cadastro do Médico.
dadosMedicoSolicitante → nome= Nome do Médico.
tipoSolicitacao= SADT (Fixo atualmente).
caraterSolicitacao= Eletivo/Urgencia (De acordo com exame se é urgente ou não)
indicacaoClinica= Exames de rotina (Fixo atualmente)
dataProcedimento= data de solicitação do exame.
procedimentos → codigo= Código AMB do exame informado na tabela de preço do plano do convênio.
procedimentos → descricao= Descricao do Exame no SIALAB.
procedimentos → quantidade= Quantidade de Exames solicitados (No caso se tiver agrupamento de código amb).
codigoAtendimentoOriginal= Posto e Amostra do Antedimento no SIALAB.
codigoGuiaOriginal= Código da Guia dos exames no SIALAB.
cid= CID informado no atendimento caso tenha.
Exemplo Consulta:
https://api.overmind.ai/auth/overmind/v1/123456?codigoParceiro=1234
123456= numero da guia.
1234= codigoParceiro.
Conclusão
A integração com o OVERMIND proporciona ao laboratório um processo mais ágil, seguro e padronizado para a solicitação e acompanhamento das autorizações de procedimentos junto às operadoras de saúde. Por meio dessa funcionalidade, é possível reduzir atividades manuais, minimizar erros operacionais e garantir maior conformidade com as regras contratuais estabelecidas.
Com a correta configuração dos parâmetros de integração, o sistema passa a realizar automaticamente o envio das solicitações, bem como o recebimento e tratamento dos retornos de autorização, permitindo um controle eficiente dos status dos exames e maior transparência no fluxo de atendimento.
Ressalta-se a importância de realizar cuidadosamente todas as etapas de configuração descritas neste manual, assegurando que operadoras, exames e regras estejam devidamente parametrizados conforme a necessidade de cada laboratório. Dessa forma, a integração com o OVERMIND se torna uma ferramenta essencial para otimizar processos, melhorar a experiência do paciente e aumentar a eficiência operacional do laboratório.