Autorização

Caso de Uso:

Solicitar uma autorização utilizando as credenciais da OPERADORA X para o PACIENTE X.

Considere que o sistema do cliente precise criar uma solicitação de autorização para o PACIENTE X na OPERADORA X para dois procedimentos acordados em tabela. Para isso o time de desenvolvimento precisa integrar ao sistema do cliente o método Criar uma autorização de SP/SADT e ainda se preparar para utilizar a coleta de biometria conforme a credencial selecionada.

Importante: Antes de realizar a autorização, é necessário selecionar a credencial. Esse identificador será utilizado na requisição.

Obtenha a credencial da operadora X: Utilize o endpoint:

GET Listar as credenciais do cliente com o parâmetro de busca ?Busca=X para localizar as credenciais disponíveis para essa operadora.

Exemplo de requisição:

curl -X 'GET' \
  'https://api.integradoor.com.br/api/v2/credenciais?Busca=X' \
  -H 'accept: text/plain'

Exemplo de resposta (credencial encontrada):

{
  "sucesso": true,
  "data": {
    "items": [
      {
        "id": "e8d3f894-7f1e-41d0-a9f6-123456789abc",
        "nome": "X ASSISTÊNCIA MÉDICA INTERNACIONAL S/A",
        "codigoPrestador": "112233445566",
        "credencialElegibilityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    ]
  }
}

Montar os dados da requisição Com a credencialId obtida no passo anterior, utilize o monte o metodo para obter uma autorização.

Exemplo de payload:

 {
   "credencialId": "ddbb0f17-095a-4b4c-9fec-04aa52880242",
   "numeroCarteira": "12345678900",
   "validadeCarteira": "2025-04-08T00:00:00",
   "nomeBeneficiario": "PACIENTE X",
   "planoBeneficiario": "",
   "atendimentoRN": "N",
   "nomeRecemNascido": "",
   "dataNascimentoRecemNascido": null,
   "pacienteNoLocal": "N",
   "unidadeId": "308d2b51-b679-4d1e-a59c-391806443e3c",
   "pontoAtendimentoId": "7467d59a-719f-4e77-8fae-b8a3cceac710",
   "nomeSolicitante": "JORGE JOSE",
   "ufSolicitante": "PA",
   "crmSolicitante": "8998774",
   "siglaConselhoSolicitante": "CRM",
   "profissionalExecutanteId": "8f305b18-6954-4c25-ab50-7e7eaa7f7dbe",
   "especialidadeExecutanteId": 16,
   "tipoAcidente": "9",
   "guiaPrestador": "65465165161616156516",
   "regimeAtendimento": "E",
   "tipoAtendimento": "05",
   "observacoes": null,
   "indicacaoClinica": "Exames de rotina",
   "retorno": "N",
   "anexos": [],
   "procedimentos": [
     {
       "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
       "codigoProcedimento": "28011368",
       "quantidade": 1
     },
     {
       "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
       "codigoProcedimento": "28011376",
       "quantidade": 1
     }
   ],
   "nomeContato": "Abraham Lincoln",
   "dddContato": "11",
   "telefoneContato": "999999999",
   "emailContato": "[email protected]"
 }

Informações sobre o payload:

atendimentoRN, default N, quando S deve ser informado o campo nomeRecemNascido e dataNascimentoRecemNascido;
pacienteNoLocal, default N, utilizado para priorizar a fila no Backoffice;
unidadeId e pontoAtendimentoId, devem ser obtidos pelo método Listar Unidades do cliente
profissionalExecutanteId e especialidadeExecutanteId, devem ser obtidos pelo método Listar os profissionais executantes do cliente
tipoAcidente, default 9, segue tabela de domínio ANS
guiaPrestador, quando não informada o IntegraDoor irá gerar um número de guia seguindo o padrão YYMMDDHHMMSS
regimeAtendimento, default E, segue tabela de domínio ANS
tipoAtendimento, default 05, segue tabela de domínio ANS
indicacaoClinica, se não informado o IntegraDoor trará a informação contida nas configurações da credencial
retorno, default N, utilizado essencialmente para consultas médicas
anexos, base64. Aconselhamos fortemente o uso do IntegraDoorSDK para leitura e geração do anexo do pedido médico.

Enviar solicitação de autorização Envie a requisição POST Cria uma autorização de SP/SADT.

Exemplo de requisição:

curl -X 'POST' \
 'https://api-dev.integradoor.com.br/api/v2/autorizar/sp-sadt' \
 -H 'accept: application/json' \
 -H 'Content-Type: application/json' \
 -d '{
     "credencialId": "ddbb0f17-095a-4b4c-9fec-04aa52880242",
     "numeroCarteira": "12345678900",
     "validadeCarteira": "2025-04-08T00:00:00",
     "nomeBeneficiario": "PACIENTE X",
     "planoBeneficiario": "",
     "atendimentoRN": "N",
     "nomeRecemNascido": "",
     "dataNascimentoRecemNascido": null,
     "pacienteNoLocal": "N",
     "unidadeId": "308d2b51-b679-4d1e-a59c-391806443e3c",
     "pontoAtendimentoId": "7467d59a-719f-4e77-8fae-b8a3cceac710",
     "nomeSolicitante": "JORGE JOSE",
     "ufSolicitante": "PA",
     "crmSolicitante": "8998774",
     "siglaConselhoSolicitante": "CRM",
     "profissionalExecutanteId": "8f305b18-6954-4c25-ab50-7e7eaa7f7dbe",
     "especialidadeExecutanteId": 16,
     "tipoAcidente": "9",
     "guiaPrestador": "65465165161616156516",
     "regimeAtendimento": "E",
     "tipoAtendimento": "05",
     "observacoes": null,
     "indicacaoClinica": "Exames de rotina",
     "retorno": "N",
     "anexos": [],
     "procedimentos": [
       {
         "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
         "codigoProcedimento": "28011368",
         "quantidade": 1
       },
       {
         "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
         "codigoProcedimento": "28011376",
         "quantidade": 1
       }
     ],
     "nomeContato": "Abraham Lincoln",
     "dddContato": "11",
     "telefoneContato": "999999999",
     "emailContato": "[email protected]"
   }'

Interpretar a resposta da operadora

 {
   "sucesso": true,
   "erros": [],
   "data": {
     "pdfGuia": "base64 - agregado, quando existir mais de uma guia",
     "autorizacoes": [
       {
         "numeroAutorizacao": 1,
         "sucesso": true,
         "validadeSenha": "2025-05-08T00:00:00",
         "procedimentos": [
           {
             "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
             "codigoProcedimento": "28011368",
             "quantidade": 1,
             "quantidadeAutorizada": 1,
             "quantidadeExecutada": 0,
             "senhaAutorizacao": null,
             "protocoloAtendimento": null,
             "justificativa": null,
             "mnemonico": null
           },
           {
             "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
             "codigoProcedimento": "28011376",
             "quantidade": 1,
             "quantidadeAutorizada": 1,
             "quantidadeExecutada": 0,
             "senhaAutorizacao": null,
             "protocoloAtendimento": null,
             "justificativa": null,
             "mnemonico": null
           }
         ],
         "erros": [],
         "numeroGuia": "123456789",
         "senha": "12345678",
         "protocolo": "2024020169846546846",
         "situacaoAutorizacao": "A",
         "guiaId": "a2df6a10-cb21-429d-9984-67b293cb9e03",
         "guiaPrestador": "123456789",
         "guiaParceiro": "31020259000009500122",
         "numeroSolicitacao": "456",
         "pdfGuiaAutorizacao": "base64 desta guia",
         "dataAutorizacao": "2025-04-08T00:00:00 ISO8601"
       }
     ]
   }
 }

Abaixo estão os possíveis valores da propriedade statusAutorizacao e situacao retornados nas respostas da API, com seus respectivos significados:

Código	Descrição
A	Autorizada
Z	Parcialmente Autorizada
R	Em Análise
N	Negada
K	Pendente de Envio
C	Cancelada
P	Parcialmente Executada
E	Executada
S	Aguardando Anexo
M	Não Processada
I	Inconsistência na operadora
Ç	Inconsistência na operadora
H	Aguardando Biometria
T	Biometria Inválida
X	Aguardando Cancelamento
V	Beneficiário Inválido
W	Aguardando Execução
-	N/A