Biometria na Autorização

Este caso de uso descreve como solicitar a autorização de SP-SADT contendo 2 procedimentos de análises clínicas para o paciente da operadora X, ** PACIENTE X**, com a carteira 12345678900, utilizando o padrão TISS 4.01.00 via WebService SOAP do IntegraDoor.

Este processo envolve uma sequência composta por três etapas principais:

1. pedidoElegibilidadeWS – Verificação de Elegibilidade com Biometria
2. IntegraDoorSDK – Script embarcado que verifica, com base na credencial, se é necessário realizar captura de biometria.
3. solicitacaoProcedimentoWS – Envio da solicitação de autorização de procedimento, após possível coleta biométrica.

Importante!

• É altamente recomendável que o pedidoElegibilidadeWS seja executado antes da solicitacaoProcedimentoWS, caso não deseje executar este passo, apenas omita-o do processo.
• O SDK IntegraDoorSDK deve ser executado logo após a resposta da elegibilidade e antes da chamada ao solicitacaoProcedimentoWS. A exibição do modal de biometria depende da configuração da credencial.

Requisitos

• O acesso ao WS do IntegraDoor deve ter sido ativado para o cliente cadastrado.
• O sistema cliente deve estar autenticado via método suportado.
• A credencial da operadora AMIL deve estar cadastrada e ativa.
• O paciente deve estar com situação de elegibilidade ATIVO.
• Os procedimentos devem estar registrados conforme tabela previamente configurada no IntegraDoor.

Endereço do WebService (IntegraDoor)

https://ws.integradoor.com.br/tiss/v40100/

Exemplo de Requisição SOAP

<?xml version="1.0" ?>
<soapenv:Envelope
    xmlns:ans="http://www.ans.gov.br/padroes/tiss/ansemas" soapenv:encodingStyle="http://www.w3.org/2003/05/soap-encoding"
    xmlns:soapenv="http://ansemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ans:solicitacaoProcedimentoWS>
            <ans:cabecalho>
                <ans:identificacaoTransacao>
                    <ans:tipoTransacao>SOLICITACAO_PROCEDIMENTOS</ans:tipoTransacao>
                    <ans:sequencialTransacao>01010101011</ans:sequencialTransacao>
                    <ans:dataRegistroTransacao>2025-05-24</ans:dataRegistroTransacao>
                    <ans:horaRegistroTransacao>18:47:09.818Z</ans:horaRegistroTransacao>
                </ans:identificacaoTransacao>
                <ans:origem>
                    <ans:identificacaoPrestador>
                        <ans:codigoPrestadorNaOperadora>3fa85f64-5717-4562-b3fc-2c963f66afa6</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>colaborador1</ans:loginPrestador>
                    <ans:senhaPrestador>93d5bb76975b0418fa740eac2cf34b12</ans:senhaPrestador>
                </ans:loginSenhaPrestador>
            </ans:cabecalho>
            <ans:solicitacaoProcedimento>
                <ans:solicitacaoSP-SADT>
                    <ans:cabecalhoSolicitacao>
                        <ans:registroANS>331988</ans:registroANS>
                        <ans:numeroGuiaPrestador>20250501124433</ans:numeroGuiaPrestador>
                    </ans:cabecalhoSolicitacao>
                    <ans:tipoEtapaAutorizacao>2</ans:tipoEtapaAutorizacao>
                    <ans:dadosBeneficiario>
                        <ans:numeroCarteira>12345678900</ans:numeroCarteira>
                        <ans:atendimentoRN>N</ans:atendimentoRN>
                    </ans:dadosBeneficiario>
                    <ans:dadosSolicitante>
                        <ans:contratadoSolicitante>
                            <ans:codigoPrestadorNaOperadora>3fa85f64-5717-4562-b3fc-2c963f66afa6</ans:codigoPrestadorNaOperadora>
                        </ans:contratadoSolicitante>
                        <ans:nomeContratadoSolicitante>MEDICO CLINICO GERAL</ans:nomeContratadoSolicitante>
                        <ans:profissionalSolicitante>
                            <ans:conselhoProfissional>06</ans:conselhoProfissional>
                            <ans:numeroConselhoProfissional>12345</ans:numeroConselhoProfissional>
                            <ans:UF>31</ans:UF>
                            <ans:CBOS>225125</ans:CBOS>
                        </ans:profissionalSolicitante>
                    </ans:dadosSolicitante>
                    <ans:caraterAtendimento>1</ans:caraterAtendimento>
                    <ans:dataSolicitacao>2025-05-24</ans:dataSolicitacao>
                    <ans:indicacaoClinica>Exames de rotina</ans:indicacaoClinica>
                    <ans:procedimentosSolicitados>
                        <ans:procedimento>
                            <ans:codigoTabela>22</ans:codigoTabela>
                            <ans:codigoProcedimento>40304361</ans:codigoProcedimento>
                            <ans:descricaoProcedimento>HEMOGRAMA</ans:descricaoProcedimento>
                        </ans:procedimento>
                        <ans:quantidadeSolicitada>1</ans:quantidadeSolicitada>
                    </ans:procedimentosSolicitados>
                    <ans:procedimentosSolicitados>
                        <ans:procedimento>
                            <ans:codigoTabela>22</ans:codigoTabela>
                            <ans:codigoProcedimento>40302040</ans:codigoProcedimento>
                            <ans:descricaoProcedimento>GLICOSE - JEJUM - S</ans:descricaoProcedimento>
                        </ans:procedimento>
                        <ans:quantidadeSolicitada>1</ans:quantidadeSolicitada>
                    </ans:procedimentosSolicitados>
                </ans:solicitacaoSP-SADT>
            </ans:solicitacaoProcedimento>
            <ans:hash>8247f4062b305a5f221913a31797ee93</ans:hash>
        </ans:solicitacaoProcedimentoWS>
    </soapenv:Body>
</soapenv:Envelope>

Exemplo de Resposta (Autorização Aprovada)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ans="http://www.ans.gov.br/padroes/tiss/schemas">
  <soapenv:Body>
    <ans:autorizacaoProcedimentoWS>
      <ans:autorizacaoProcedimento>
        <ans:numeroGuiaPrestador>20250501124433</ans:numeroGuiaPrestador>
        <ans:numeroGuiaOperadora>678901234</ans:numeroGuiaOperadora>
        <ans:senha>AUT123456789</ans:senha>
        <ans:dataAutorizacao>2025-05-29</ans:dataAutorizacao>
        <ans:validadeAutorizacao>2025-06-29</ans:validadeAutorizacao>
        <ans:procedimentosAutorizados>
          <ans:procedimento>
            <ans:codigoTabela>22</ans:codigoTabela>
            <ans:codigoProcedimento>40304361</ans:codigoProcedimento>
            <ans:descricaoProcedimento>HEMOGRAMA</ans:descricaoProcedimento>
            <ans:quantidadeAutorizada>1</ans:quantidadeAutorizada>
          </ans:procedimento>
          <ans:procedimento>
            <ans:codigoTabela>22</ans:codigoTabela>
            <ans:codigoProcedimento>40302040</ans:codigoProcedimento>
            <ans:descricaoProcedimento>GLICOSE - JEJUM - S</ans:descricaoProcedimento>
            <ans:quantidadeAutorizada>1</ans:quantidadeAutorizada>
          </ans:procedimento>
        </ans:procedimentosAutorizados>
      </ans:autorizacaoProcedimento>
    </ans:autorizacaoProcedimentoWS>
  </soapenv:Body>
</soapenv:Envelope>

Exemplo de Resposta (Glosa ou Erro)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ans="http://www.ans.gov.br/padroes/tiss/schemas">
  <soapenv:Body>
    <ans:mensagemErroProcessamento>
      <ans:codigoErro>301</ans:codigoErro>
      <ans:descricaoErro>Quantidade de procedimentos excede o limite permitido para a operadora</ans:descricaoErro>
    </ans:mensagemErroProcessamento>
  </soapenv:Body>
</soapenv:Envelope>

Observações

• A requisição pode conter de 1 a 100 procedimentos, conforme a conduta previamente cadastrada no IntegraDoor para a operadora utilizado.
• O campo codigoProcedimento deve conter os códigos válidos para análises clínicas conforme tabela confgurada no IntegraDoor.
• O cabeçalho deve respeitar a estrutura definida no layout TISS 4.01.00.
• Independentemente da versão do TISS utilizada pelo parceiro, o IntegraDoor exige que os XMLs sejam enviados na versão 4.01.00. O sistema fará a adaptação automática para o formato necessário à operadora de destino.

Integração com SDK de Biometria

Antes da solicitação de autorização, o sistema cliente deve executar o SDK do IntegraDoor para captura do dado biométrico.

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.

Info

Se não forem fornecidos parâmetros de autenticação, o usuário será redirecionado para realizar login no IntegraDoor.

Embed

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

Script de Execução

  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('Erro na captura de biometria', error);
  });
  IntegraDoorSDK.Bio.on("completed", function (data) {
    console.log('Captura concluída', data);
  });

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

  getById('btnEnviar').addEventListener('click', function () {
      IntegraDoorSDK.Bio.iniciarCaptura(getValue('credencialId'), getValue('carteira'));
  });

<div>
  <input type="text" id="credencialId" placeholder="ID da Credencial" />
  <input type="text" id="carteira" placeholder="Número da Carteira" />
  <button id="btnEnviar">Iniciar Captura</button>
</div>

Evento de resposta do SDK

No evento completed iremos retornar o resultado com o seguinte schema:

{
  "type": "object",
  "$defs": {
    "BiometryType": {
      "type": "string",
      "enum": ["00", "01", "02", "03", "04", "05", "06", "07", "08", "09"],
      "description": "Tipo de biometria conforme especificação TISS 4.01.00 e extensões para operadoras fora do padrão: '01' (Tarja magnética), '02' (Código de barras), '03' (Cartão de identificação físico), '04' (QR code), '05' (Impressão digital), '06' (Leitura facial), '07' (Leitura de íris), '08' (Leitura da geometria da mão), '09' (Cartão de identificação virtual), '00' (Nenhuma)."
    }
  },
  "properties": {
    "biometriaRealizada": {
      "type": "boolean",
      "description": "Indica se a biometria foi realizada."
    },
    "tipoBiometria": {
      "$ref": "#/$defs/BiometryType"
    },
    "sucessoBiometria": {
      "type": "boolean",
      "description": "Indica se a biometria foi validada com sucesso."
    },
    "enviarNaAutorizacao": {
      "type": ["object", "null"],
      "description": "Dados a serem enviados na autorização, ou null se não necessário.",
      "properties": {
        "tipo": {
          "$ref": "#/$defs/BiometryType"
        },
        "dados": {
          "type": "string",
          "pattern": "^[A-Za-z0-9+/=]+$",
          "description": "Dados biométricos codificados em base64."
        }
      },
      "required": ["tipo", "dados"],
      "additionalProperties": false
    }
  },
  "required": ["biometriaRealizada", "tipoBiometria", "submetida", "enviarNaAutorizacao"],
  "additionalProperties": false
}