Skip to content
Documentação IntegraDoor

Biometria na Elegbilidade

Biometria na Elegbilidade

Verificação de Elegibilidade com IntegraDoorSDK

O sistema cliente realiza uma chamada ao WebService SOAP do IntegraDoor para verificar a elegibilidade de um beneficiário. A chamada utiliza a credencial previamente cadastrada, contendo login, senha (em MD5) e código do prestador. Após o recebimento da resposta da requisição, o sistema executa obrigatoriamente o script de decisão denominado IntegraDoorSDK.

Esse script é responsável por determinar, com base nas configurações da credencial utilizada, se o modal embarcado de biometria será ou não exibido ao usuário. A exibição do modal ocorre somente se a credencial estiver marcada como exigente de biometria.

Fluxo de Execução

  1. O sistema cliente envia a requisição pedidoElegibilidadeWS em conformidade com o padrão TISS 4.01.00.
  2. A requisição inclui:
    • O código do prestador (GUID da credencial);
    • Login e senha do usuário autenticado no IntegraDoor, com a senha criptografada em MD5.
  3. Após o retorno da resposta de elegibilidade, o cliente executa o script IntegraDoorSDK.
  4. O IntegraDoorSDK consulta a configuração da credencial utilizada e decide se:
    • Exibe o modal embarcado de biometria;
    • Ou prossegue automaticamente, sem exibição do modal.

Regras de Exibição do Modal

SituaçãoExibe modal
Credencial exige biometriaSim
Credencial não exige biometriaNão
Retorno de elegibilidade recebidoExecuta IntegraDoorSDK para decisão

O IntegraDoorSDK é sempre responsável por essa decisão e deve ser executado logo após o recebimento da resposta da verificação de elegibilidade.

Exemplo de Requisição

pedidoElegibilidadeWS (SOAP TISS 4.01.00)

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://ansemas.xmlsoap.org/soap/envelope/" xmlns:ans="http://www.ans.gov.br/padroes/tiss/ansemas" soapenv:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
   <soapenv:Body>
      <ans:pedidoElegibilidadeWS>
         <ans:cabecalho>
            <ans:identificacaoTransacao>
               <ans:tipoTransacao>VERIFICA_ELEGIBILIDADE</ans:tipoTransacao>
               <ans:sequencialTransacao>20250529170001</ans:sequencialTransacao>
               <ans:dataRegistroTransacao>2025-05-29</ans:dataRegistroTransacao>
               <ans:horaRegistroTransacao>17:00:01.000-03:00</ans:horaRegistroTransacao>
            </ans:identificacaoTransacao>
            <ans:origem>
               <ans:identificacaoPrestador>
                  <ans:codigoPrestadorNaOperadora>GUID_CREDENCIAL_AMIL</ans:codigoPrestadorNaOperadora>
               </ans:identificacaoPrestador>
            </ans:origem>
            <ans:destino>
               <ans:registroANS>123456</ans:registroANS>
            </ans:destino>
            <ans:Padrao>4.01.00</ans:Padrao>
            <ans:loginSenhaPrestador>
               <ans:loginPrestador>fulano_login</ans:loginPrestador>
               <ans:senhaPrestador>md5_senha_fulano</ans:senhaPrestador>
            </ans:loginSenhaPrestador>
         </ans:cabecalho>
         <ans:pedidoElegibilidade>
            <ans:dadosPrestador>
               <ans:codigoPrestadorNaOperadora>GUID_CREDENCIAL_AMIL</ans:codigoPrestadorNaOperadora>
            </ans:dadosPrestador>
            <ans:numeroCarteira>12345678900</ans:numeroCarteira>
         </ans:pedidoElegibilidade>
         <ans:hash>d25c4a2c293e73020a64220632bafe64</ans:hash>
      </ans:pedidoElegibilidadeWS>
   </soapenv:Body>
</soapenv:Envelope>

respostaElegibilidadeWS (SOAP TISS 4.01.00)

<S:Envelope xmlns:S="http://ansemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <respostaElegibilidadeWS xmlns="http://www.ans.gov.br/padroes/tiss/ansemas">
         <cabecalho>
            <identificacaoTransacao>
               <tipoTransacao>SITUACAO_ELEGIBILIDADE</tipoTransacao>
               <sequencialTransacao>013424</sequencialTransacao>
               <dataRegistroTransacao>2025-03-06</dataRegistroTransacao>
               <horaRegistroTransacao>23:46:24</horaRegistroTransacao>
            </identificacaoTransacao>
            <origem>
               <registroANS>123456</registroANS>
            </origem>
            <destino>
               <identificacaoPrestador>
                  <codigoPrestadorNaOperadora>123456789</codigoPrestadorNaOperadora>
               </identificacaoPrestador>
            </destino>
            <Padrao>4.01.00</Padrao>
         </cabecalho>
         <respostaElegibilidade>
            <reciboElegibilidade>
               <registroANS>123456</registroANS>
               <numeroCarteira>12345678900</numeroCarteira>
               <nomeBeneficiario> PACIENTE X</nomeBeneficiario>
               <respostaSolicitacao>S</respostaSolicitacao>
            </reciboElegibilidade>
         </respostaElegibilidade>
         <hash>95e60710613d58a8c44855fcfbb2a9bc</hash>
      </respostaElegibilidadeWS>
   </S:Body>
</S:Envelope>

Execução do IntegraDoorSDK

Parâmetros

  • data-in-apikey: Opcional, API-Key fornecida pelo IntegraDoor.
  • data-in-bearer: Opcional, Bearer token gerado ao executar os endpoints de autenticação.
  • data-in-logo: Opcional, URL da logo a utilizar no processo do IntegraDoorSDK.
<div
  data-in-apikey="{api-key}"
  data-in-bearer="{bearer-token}"
  data-in-logo="https://http.dog/302.jpg"
></div>
<script src="https://web.integradoor.com.br/embed-bio.js"></script>

Exemplo de uso

  IntegraDoorSDK.Bio.on("ready", function () {
    console.log('Pronto para iniciar captura de biometria');
  });
  IntegraDoorSDK.Bio.on("capturing", function () {
    console.log('IntegraDoor iniciou captura de biometria');
  });
  IntegraDoorSDK.Bio.on("error", function (error) {
    console.log('IntegraDoor detectou algum erro (implementação incorreta ou erro na captura de biometria)', error);
  });
  IntegraDoorSDK.Bio.on("completed", function (data) {
    console.log('IntegraDoor completou captura da biometria', data);
  });


  function getById(id) {
      return document.getElementById(id);
  }
  function getValue(id) {
      return getById(id).value;
  }


  getById('btnEnviar').addEventListener('click', function () {
      // Chamar este método sempre após a verificação de elegibilidade.
      // O IntegraDoor será iniciado e a interface será exibida para início da captura caso necessário.
      IntegraDoorSDK.Bio
          .iniciarCaptura(getValue('credencialId'), getValue('carteira'));
  });