Skip to content

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


Consultar status de uma autorização

O status de uma autorização pode ser obtido por dois métodos distintos da API:

  • ID da Guia: retorna os dados completos da guia pelo ID único gerado pelo IntegraDoor.
  • Identificadores externos: consulta e sincroniza o status a partir do número da guia do prestador/parceiro, número na operadora, senha ou protocolo.

Consultar guia por ID

Endpoint

GET /api/v2/guias/{guiaId}

Parâmetro de caminho:

  • guiaId (UUID, obrigatório): Identificador único da guia gerada pelo IntegraDoor.

Request

Requisição GET sem corpo, informando apenas o parâmetro de caminho guiaId.

Response

{
"sucesso": true,
"erros": [
"string"
],
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"nomeCredencial": "string",
"operadoraId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"codigoOperadora": "string",
"nomeOperadora": "string",
"pacienteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"unidadeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"pontoAtendimentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"profissionalExecutanteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"especialidadeExecutanteId": 0,
"profissionalSolicitanteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"especialidadeSolicitanteId": 0,
"usuarioAlteracaoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"usuarioCancelamentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"usuarioInclusaoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"numeroSolicitacao": "string",
"guiaNaOperadora": "string",
"guiaPrestador": "string",
"guiaParceiro": "string",
"senhaNaOperadora": "string",
"protocolo": "string",
"numeroCarteira": "string",
"nomeBeneficiario": "string",
"planoBeneficiario": "string",
"motivoNegativa": "string",
"mensagensFalha": "string",
"telefoneBeneficiario": "string",
"emailBeneficiario": "string",
"guiaAssinatura": "string",
"nomeProfissionalExecutante": "string",
"tokenAutorizacao": "string",
"tipoGuia": "string",
"nomeTipoGuia": "string",
"situacao": "string",
"nomeSituacao": "string",
"regimeAtendimento": "string",
"tipoConsulta": "string",
"motivoCancelamento": "string",
"tipoAcidente": "string",
"atendimentoRN": "string",
"retorno": "string",
"pacienteNoLocal": "string",
"nomeRecemNascido": "string",
"dataNascimentoRecemNascido": "2026-04-24T19:14:52.057Z",
"observacoes": "string",
"nomeContato": "string",
"dddContato": "string",
"telefoneContato": "string",
"emailContato": "string",
"viaCarteira": "string",
"indicacaoClinica": "string",
"tipoAtendimento": "string",
"regimeInternacao": "string",
"naturezaInternacao": "string",
"previsaoOPME": "string",
"previsaoUsoQuimioterapico": "string",
"telefone": "string",
"guiaAutorizacao": "string",
"diferencaTempoExecucao": "string",
"procedimentos": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"nomeProcedimento": "string",
"codigoProcedimento": "string",
"codigoTabela": "string",
"quantidade": 0,
"quantidadeAutorizada": 0,
"quantidadeExecutada": 0,
"mensagem": "string",
"codigoGlosa": "string",
"senhaAutorizacao": "string",
"situacao": "string",
"mnemonico": "string",
"autorizado": true,
"nomeSituacao": "string"
}
],
"possuiGuiaAssinada": true,
"possuiGuiaAutorizacao": true,
"possuiReciboAutorizacao": true,
"siglaConselhoSolicitante": "string",
"ufSolicitante": "string",
"numeroConselhoSolicitante": "string",
"nomeSolicitante": "string",
"conselhoSolicitanteFallback": "string",
"ufSolicitanteFallBack": "string",
"numeroConselhoSolicitanteFallBack": "string",
"nomeSolicitanteFallBack": "string",
"validadeSenha": "2026-04-24T19:14:52.057Z",
"dataEmissao": "2026-04-24T19:14:52.057Z",
"dataCancelamento": "2026-04-24T19:14:52.057Z",
"dataAssinatura": "2026-04-24T19:14:52.057Z",
"dataHoraInternacao": "2026-04-24T19:14:52.057Z",
"inicioExecucao": "2026-04-24T19:14:52.057Z",
"fimExecucao": "2026-04-24T19:14:52.057Z",
"partesPermitidasAssinatura": [
"string"
],
"permitidoAssinar": true,
"podeCancelarGuia": true,
"podeAnexar": true,
"precisaExecutar": true,
"podeReprocessarBiometria": true,
"podeInserirToken": true,
"podeAtualizarStatus": true
}
}

Consultar status por identificadores externos

Endpoint

GET /api/v2/guias/status

Parâmetros de query:

ParâmetroTipoObrigatórioDescrição
credencialIdUUIDSimID da credencial a ser utilizada.
guiaPrestadorOuParceirostringCondicional*Número da guia do prestador ou parceiro.
guiaOperadorastringCondicional*Número da guia na operadora.
senhaNaOperadorastringCondicional*Senha de autorização na operadora.
protocolostringCondicional*Protocolo de autorização.
carteirastringNãoNúmero de carteira do beneficiário.
sincronizacaostringNãoDefine como o status será obtido:
- Auto (padrão): consulta primeiro no IntegraDoor; se não encontrar, busca na operadora.
- Force: consulta diretamente na operadora em tempo real.
- Local: retorna apenas o que o IntegraDoor já tem salvo.
unidadeIdUUIDNãoUnidade sob a qual o IntegraDoor deverá registrar uma nova guia importada da operadora, caso não seja informado um padrão será provido com base no usuário logado
pontoAtendimentoIdUUIDNãoPonto de atendimento sob o qual o IntegraDoor deverá registrar uma nova guia importada da operadora, caso não seja informado um padrão será provido com base na unidade
executanteIdUUIDNãoExecutante a registrar na guia, se omitido o IntegraDoor utilizará o padrão do cliente
s

*Ao menos um campo identificador da guia deve ser informado: guiaPrestadorOuParceiro, guiaOperadora, senhaNaOperadora ou protocolo.

*Para melhor resultado, deve-se informar todos os campos disponíveis, incluindo a carteira do paciente.


Request

GET /api/v2/guias/status?credencialId={credencialId}&guiaPrestadorOuParceiro={guiaPrestadorOuParceiro}&sincronizacao=Auto
Authorization: Bearer {seu_token}

Response

{
"sucesso": true,
"erros": [
"string"
],
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"nomeCredencial": "string",
"operadoraId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"codigoOperadora": "string",
"nomeOperadora": "string",
"pacienteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"unidadeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"pontoAtendimentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"profissionalExecutanteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"especialidadeExecutanteId": 0,
"profissionalSolicitanteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"especialidadeSolicitanteId": 0,
"usuarioAlteracaoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"usuarioCancelamentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"usuarioInclusaoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"numeroSolicitacao": "string",
"guiaNaOperadora": "string",
"guiaPrestador": "string",
"guiaParceiro": "string",
"senhaNaOperadora": "string",
"protocolo": "string",
"numeroCarteira": "string",
"nomeBeneficiario": "string",
"planoBeneficiario": "string",
"motivoNegativa": "string",
"mensagensFalha": "string",
"telefoneBeneficiario": "string",
"emailBeneficiario": "string",
"guiaAssinatura": "string",
"nomeProfissionalExecutante": "string",
"tokenAutorizacao": "string",
"tipoGuia": "string",
"nomeTipoGuia": "string",
"situacao": "string",
"nomeSituacao": "string",
"regimeAtendimento": "string",
"tipoConsulta": "string",
"motivoCancelamento": "string",
"tipoAcidente": "string",
"atendimentoRN": "string",
"retorno": "string",
"pacienteNoLocal": "string",
"nomeRecemNascido": "string",
"dataNascimentoRecemNascido": "2026-04-24T19:14:52.046Z",
"observacoes": "string",
"nomeContato": "string",
"dddContato": "string",
"telefoneContato": "string",
"emailContato": "string",
"viaCarteira": "string",
"indicacaoClinica": "string",
"tipoAtendimento": "string",
"regimeInternacao": "string",
"naturezaInternacao": "string",
"previsaoOPME": "string",
"previsaoUsoQuimioterapico": "string",
"telefone": "string",
"guiaAutorizacao": "string",
"diferencaTempoExecucao": "string",
"procedimentos": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"nomeProcedimento": "string",
"codigoProcedimento": "string",
"codigoTabela": "string",
"quantidade": 0,
"quantidadeAutorizada": 0,
"quantidadeExecutada": 0,
"mensagem": "string",
"codigoGlosa": "string",
"senhaAutorizacao": "string",
"situacao": "string",
"mnemonico": "string",
"autorizado": true,
"nomeSituacao": "string"
}
],
"possuiGuiaAssinada": true,
"possuiGuiaAutorizacao": true,
"possuiReciboAutorizacao": true,
"siglaConselhoSolicitante": "string",
"ufSolicitante": "string",
"numeroConselhoSolicitante": "string",
"nomeSolicitante": "string",
"conselhoSolicitanteFallback": "string",
"ufSolicitanteFallBack": "string",
"numeroConselhoSolicitanteFallBack": "string",
"nomeSolicitanteFallBack": "string",
"validadeSenha": "2026-04-24T19:14:52.046Z",
"dataEmissao": "2026-04-24T19:14:52.046Z",
"dataCancelamento": "2026-04-24T19:14:52.046Z",
"dataAssinatura": "2026-04-24T19:14:52.046Z",
"dataHoraInternacao": "2026-04-24T19:14:52.046Z",
"inicioExecucao": "2026-04-24T19:14:52.046Z",
"fimExecucao": "2026-04-24T19:14:52.046Z",
"partesPermitidasAssinar": [
"string"
],
"permitidoAssinar": true,
"podeCancelarGuia": true,
"podeAnexar": true,
"precisaExecutar": true,
"podeReprocessarBiometria": true,
"podeInserirToken": true,
"podeAtualizarStatus": true
}
}

Legenda

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

Abaixo estão os possíveis valores da propriedade situacao (Código) e nomeSituacao (Descrição) retornados nas respostas da API, com seus respectivos significados:

CódigoDescrição
AAutorizada
ZParcialmente Autorizada
REm Análise
NNegada
KPendente de Envio
CCancelada
PParcialmente Executada
EExecutada
SAguardando Anexo
MNão Processada
IInconsistência na operadora
ÇInconsistência na operadora
HAguardando Biometria
TBiometria Inválida
XAguardando Cancelamento
VBeneficiário Inválido
WAguardando Execução
-N/A