Autorização

Selecione a credencial

Após a autenticação na API, o próximo passo é selecionar a credencial a ser utilizada neste tópico. Para isso, utilize o método:

Endpoint

GET /api/v2/credenciais

Executar uma autorização

Para obter uma autorização de SP/SADT a exemplo, utilize o endpoint abaixo enviando as informações estruturadas conforme o schema da API.

Endpoint

POST /api/v2/autorizar/sp-sadt

Pré-requisitos

Obtenha unidadeId e pontoAtendimentoId;
Obtenha profissionalExecutanteId;

{
 "credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "numeroCarteira": "string",
 "validadeCarteira": "2025-06-03T02:09:03.127Z",
 "nomeBeneficiario": "string",
 "planoBeneficiario": "string",
 "pacienteNoLocal": "string",
 "guiaPrestador": "string",
 "profissionalExecutanteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "especialidadeExecutanteId": 0,
 "unidadeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "pontoAtendimentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "tipoAcidente": "string",
 "nomeSolicitante": "string",
 "ufSolicitante": "string",
 "crmSolicitante": "string",
 "siglaConselhoSolicitante": "string",
 "regimeAtendimento": "string",
 "tipoAtendimento": "string",
 "observacoes": "string",
 "indicacaoClinica": "string",
 "atendimentoRN": "string",
 "nomeRecemNascido": "string",
 "dataNascimentoRecemNascido": "2025-06-03T02:09:03.127Z",
 "retorno": "string",
 "anexos": [
  {
   "base64": "string",
   "name": "string",
   "contentType": "string"
  }
 ],
 "procedimentos": [
  {
   "nomeProcedimento": "string",
   "codigoProcedimento": "string",
   "quantidade": 0
  }
 ],
 "nomeContato": "string",
 "dddContato": "string",
 "telefoneContato": "string",
 "emailContato": "string",
 "viaCarteira": "string"
}

{
  "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": "MEDICO X",
  "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": "CONTATO X",
  "dddContato": "11",
  "telefoneContato": "999999999",
  "emailContato": "[email protected]"
}

Responses

{
  "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": "JVBERi0xLjMKJcTl8uXrp...",
        "dataAutorizacao": "2025-04-08T00:00:00"
      }
    ]
  }
}

{
"sucesso": true,
"erros": [],
"data": {
"pdfGuia": null,
"autorizacoes": [
  {
    "numeroAutorizacao": 1,
    "sucesso": true,
    "validadeSenha": null,
    "procedimentos": [
      {
        "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
        "codigoProcedimento": "28011368",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": "202505306546516161565",
        "justificativa": "Prestador não credenciado para este procedimento.",
        "mnemonico": null
      },
      {
        "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
        "codigoProcedimento": "28011376",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": "202505306546516161565",
        "justificativa": "Prestador não credenciado para este procedimento.",
        "mnemonico": null
      }
    ],
    "erros": [],
    "numeroGuia": "123456789",
    "senha": "",
    "protocolo": "20240201694651689984",
    "situacaoAutorizacao": "N",
    "guiaId": null,
    "guiaPrestador": null,
    "guiaParceiro": "65465465165168465136",
    "numeroSolicitacao": null,
    "pdfGuiaAutorizacao": "JVBERi0xLjMKJcTl8uXrp...",
    "dataAutorizacao": "2025-04-08T00:00:00 ISO8601"
  }
]
}
}

{
 "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": 0,
      "quantidadeExecutada": 0,
      "senhaAutorizacao": null,
      "protocoloAtendimento": null,
      "justificativa": "Em auditoria médica.",
      "mnemonico": null
     }
    ],
    "erros": [],
    "numeroGuia": "123456789",
    "senha": "12345678",
    "protocolo": "20240201694651689984",
    "situacaoAutorizacao": "Z",
    "guiaId": "c26fde08-1d09-4b4d-aee3-b057a95cba75",
    "guiaPrestador": "12345678",
    "guiaParceiro": "65465465165168465136",
    "numeroSolicitacao": "456",
    "pdfGuiaAutorizacao": "JVBERi0xLjMKJcTl8uXrp...",
    "dataAutorizacao": "2025-04-08T00:00:00 ISO8601"
   }
  ]
 }
}

{
"sucesso": true,
"erros": [],
"data": {
"pdfGuia": null,
"autorizacoes": [
  {
    "numeroAutorizacao": 1,
    "sucesso": true,
    "validadeSenha": null,
    "procedimentos": [
      {
        "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
        "codigoProcedimento": "28011368",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": null,
        "justificativa": "Em auditoria médica.",
        "mnemonico": null
      },
      {
        "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
        "codigoProcedimento": "28011376",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": null,
        "justificativa": "Em auditoria médica.",
        "mnemonico": null
      }
    ],
    "erros": [],
    "numeroGuia": "123456789",
    "senha": "",
    "protocolo": null,
    "situacaoAutorizacao": "R",
    "guiaId": "c26fde08-1d09-4b4d-aee3-b057a95cba75",
    "guiaPrestador": null,
    "guiaParceiro": "65465465165168465136",
    "numeroSolicitacao": null,
    "pdfGuiaAutorizacao": null,
    "dataAutorizacao": "2025-04-08T00:00:00 ISO8601"
  }
]
}
}

{
"sucesso": false,
"erros": [
"Não foi possível recuperar dados para a autorização!"
],
"data": {
"pdfGuia": null,
"autorizacoes": [
  {
    "numeroAutorizacao": 1,
    "sucesso": false,
    "validadeSenha": null,
    "procedimentos": [
      {
        "nomeProcedimento": "TRANSAMINASE OXALACÉTICA",
        "codigoProcedimento": "28011368",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": null,
        "justificativa": null,
        "mnemonico": null
      },
      {
        "nomeProcedimento": "TRANSAMINASE PIRÚVICA",
        "codigoProcedimento": "28011376",
        "quantidade": 1,
        "quantidadeAutorizada": 0,
        "quantidadeExecutada": 0,
        "senhaAutorizacao": null,
        "protocoloAtendimento": null,
        "justificativa": null,
        "mnemonico": null
      }
    ],
    "erros": [],
    "numeroGuia": "",
    "senha": "",
    "protocolo": "",
    "situacaoAutorizacao": "I ou Ç",
    "guiaId": null,
    "guiaPrestador": null,
    "guiaParceiro": "65465465165168465136",
    "numeroSolicitacao": null,
    "pdfGuiaAutorizacao": null,
    "dataAutorizacao": null
  }
]
}
}

Legenda

Situações possíveis para resposta de uma Autorização

Abaixo estão os possíveis valores da propriedade situacaoAutorizacao 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