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 }}{ "sucesso": true, "erros": [], "data": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "credencialId": "a1b2c3d4-1111-2222-3333-444455556666", "nomeCredencial": "Credencial Exemplo", "operadoraId": "b2c3d4e5-2222-3333-4444-555566667777", "codigoOperadora": "AMIL", "nomeOperadora": "OPERADORA X", "pacienteId": "c3d4e5f6-3333-4444-5555-666677778888", "unidadeId": "d4e5f6a7-4321-8765-dcba-fe9876543210", "pontoAtendimentoId": "e5f6a7b8-5555-6666-7777-888899990000", "profissionalExecutanteId": "f6a7b8c9-6666-7777-8888-999900001111", "especialidadeExecutanteId": 16, "profissionalSolicitanteId": "a7b8c9d0-7777-8888-9999-000011112222", "especialidadeSolicitanteId": 16, "usuarioAlteracaoId": "b8c9d0e1-8888-9999-0000-111122223333", "usuarioCancelamentoId": null, "usuarioInclusaoId": "c9d0e1f2-9999-0000-1111-222233334444", "numeroSolicitacao": "SOL-123456", "guiaNaOperadora": "12345678900", "guiaPrestador": "0203213232", "guiaParceiro": "PAR-987654", "senhaNaOperadora": "12345678", "protocolo": "PROT-001", "numeroCarteira": "CART-12345678900", "nomeBeneficiario": "PACIENTE X", "planoBeneficiario": "PLANO PREMIUM", "motivoNegativa": null, "mensagensFalha": null, "telefoneBeneficiario": "11999999999", "guiaAssinatura": null, "nomeProfissionalExecutante": "DR. FULANO DE TAL", "tokenAutorizacao": null, "tipoGuia": "S", "nomeTipoGuia": "Guia SPSADT", "situacao": "A", "nomeSituacao": "Autorizada", "regimeAtendimento": "A", "tipoConsulta": null, "motivoCancelamento": null, "tipoAcidente": "9", "atendimentoRN": "N", "retorno": "N", "pacienteNoLocal": "S", "nomeRecemNascido": null, "dataNascimentoRecemNascido": null, "observacoes": "Exames de rotina", "nomeContato": "CONTATO X", "dddContato": "11", "telefoneContato": "999999999", "viaCarteira": "1", "indicacaoClinica": "Paciente com histórico de hipertensão", "tipoAtendimento": "05", "regimeInternacao": null, "naturezaInternacao": null, "previsaoOPME": "N", "previsaoUsoQuimioterapico": "N", "telefone": "1133334444", "guiaAutorizacao": null, "diferencaTempoExecucao": null, "procedimentos": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "nomeProcedimento": "TRANSAMINASE OXALACÉTICA", "codigoProcedimento": "28011368", "codigoTabela": "22", "quantidade": 1, "quantidadeAutorizada": 1, "quantidadeExecutada": 0, "mensagem": null, "codigoGlosa": null, "senhaAutorizacao": null, "situacao": "A", "mnemonico": "TGO", "autorizado": true, "nomeSituacao": "Autorizado" } ], "possuiGuiaAssinada": false, "possuiGuiaAutorizacao": true, "possuiReciboAutorizacao": false, "siglaConselhoSolicitante": "CRM", "ufSolicitante": "SP", "numeroConselhoSolicitante": "123456", "nomeSolicitante": "DR. SOLICITANTE X", "conselhoSolicitanteFallback": null, "ufSolicitanteFallBack": null, "numeroConselhoSolicitanteFallBack": null, "nomeSolicitanteFallBack": null, "validadeSenha": "2026-05-24T00:00:00.000Z", "dataEmissao": "2026-04-24T10:30:00.000Z", "dataCancelamento": null, "dataAssinatura": null, "dataHoraInternacao": null, "inicioExecucao": null, "fimExecucao": null, "partesPermitidasAssinar": [ "PRESTADOR" ], "permitidoAssinar": true, "podeCancelarGuia": true, "podeAnexar": true, "precisaExecutar": true, "podeReprocessarBiometria": false, "podeInserirToken": false, "podeAtualizarStatus": false }}Consultar status por identificadores externos
Endpoint
GET /api/v2/guias/status
Parâmetros de query:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
credencialId | UUID | Sim | ID da credencial a ser utilizada. |
guiaPrestadorOuParceiro | string | Condicional* | Número da guia do prestador ou parceiro. |
guiaOperadora | string | Condicional* | Número da guia na operadora. |
senhaNaOperadora | string | Condicional* | Senha de autorização na operadora. |
protocolo | string | Condicional* | Protocolo de autorização. |
carteira | string | Não | Número de carteira do beneficiário. |
sincronizacao | string | Não | Define 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. |
unidadeId | UUID | Não | Unidade 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 |
pontoAtendimentoId | UUID | Não | Ponto 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 |
executanteId | UUID | Não | Executante 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,senhaNaOperadoraouprotocolo.
*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=AutoAuthorization: Bearer {seu_token}GET /api/v2/guias/status?credencialId=a1b2c3d4-1111-2222-3333-444455556666&guiaPrestadorOuParceiro=0203213232&sincronizacao=AutoAuthorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...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 }}{ "sucesso": true, "erros": [], "data": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "credencialId": "a1b2c3d4-1111-2222-3333-444455556666", "nomeCredencial": "Credencial Exemplo", "operadoraId": "b2c3d4e5-2222-3333-4444-555566667777", "codigoOperadora": "AMIL", "nomeOperadora": "OPERADORA X", "pacienteId": "c3d4e5f6-3333-4444-5555-666677778888", "unidadeId": "d4e5f6a7-4321-8765-dcba-fe9876543210", "pontoAtendimentoId": "e5f6a7b8-5555-6666-7777-888899990000", "profissionalExecutanteId": "f6a7b8c9-6666-7777-8888-999900001111", "especialidadeExecutanteId": 16, "profissionalSolicitanteId": "a7b8c9d0-7777-8888-9999-000011112222", "especialidadeSolicitanteId": 16, "usuarioAlteracaoId": "b8c9d0e1-8888-9999-0000-111122223333", "usuarioCancelamentoId": null, "usuarioInclusaoId": "c9d0e1f2-9999-0000-1111-222233334444", "numeroSolicitacao": "SOL-123456", "guiaNaOperadora": "12345678900", "guiaPrestador": "0203213232", "guiaParceiro": "PAR-987654", "senhaNaOperadora": "12345678", "protocolo": "PROT-001", "numeroCarteira": "CART-12345678900", "nomeBeneficiario": "PACIENTE X", "planoBeneficiario": "PLANO PREMIUM", "motivoNegativa": null, "mensagensFalha": null, "telefoneBeneficiario": "11999999999", "guiaAssinatura": null, "nomeProfissionalExecutante": "DR. FULANO DE TAL", "tokenAutorizacao": null, "tipoGuia": "S", "nomeTipoGuia": "Guia SPSADT", "situacao": "A", "nomeSituacao": "Autorizada", "regimeAtendimento": "A", "tipoConsulta": null, "motivoCancelamento": null, "tipoAcidente": "9", "atendimentoRN": "N", "retorno": "N", "pacienteNoLocal": "S", "nomeRecemNascido": null, "dataNascimentoRecemNascido": null, "observacoes": "Exames de rotina", "nomeContato": "CONTATO X", "dddContato": "11", "telefoneContato": "999999999", "viaCarteira": "1", "indicacaoClinica": "Paciente com histórico de hipertensão", "tipoAtendimento": "05", "regimeInternacao": null, "naturezaInternacao": null, "previsaoOPME": "N", "previsaoUsoQuimioterapico": "N", "telefone": "1133334444", "guiaAutorizacao": null, "diferencaTempoExecucao": null, "procedimentos": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "nomeProcedimento": "TRANSAMINASE OXALACÉTICA", "codigoProcedimento": "28011368", "codigoTabela": "22", "quantidade": 1, "quantidadeAutorizada": 1, "quantidadeExecutada": 0, "mensagem": null, "codigoGlosa": null, "senhaAutorizacao": null, "situacao": "A", "mnemonico": "TGO", "autorizado": true, "nomeSituacao": "Autorizado" } ], "possuiGuiaAssinada": false, "possuiGuiaAutorizacao": true, "possuiReciboAutorizacao": false, "siglaConselhoSolicitante": "CRM", "ufSolicitante": "SP", "numeroConselhoSolicitante": "123456", "nomeSolicitante": "DR. SOLICITANTE X", "conselhoSolicitanteFallback": null, "ufSolicitanteFallBack": null, "numeroConselhoSolicitanteFallBack": null, "nomeSolicitanteFallBack": null, "validadeSenha": "2026-05-24T00:00:00.000Z", "dataEmissao": "2026-04-24T10:30:00.000Z", "dataCancelamento": null, "dataAssinatura": null, "dataHoraInternacao": null, "inicioExecucao": null, "fimExecucao": null, "partesPermitidasAssinar": [ "PRESTADOR" ], "permitidoAssinar": true, "podeCancelarGuia": true, "podeAnexar": true, "precisaExecutar": true, "podeReprocessarBiometria": false, "podeInserirToken": false, "podeAtualizarStatus": false }}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ó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 |