Executar Autorização

Caso de Uso

Info

Este caso de uso demonstra como registrar a execução de procedimentos vinculados a uma senha de autorização previamente emitida pela operadora para um determinado paciente.

POST /api/v2/autorizar/execucao-procedimentos

1. Enviar requisição de execução de procedimentos

   Envie uma requisição para o endpoint com os dados da guia e dos procedimentos a executar.

   JSON Original (request)

   {
     "numeroGuiaPrestador": "string",
     "guiaId": "string",
     "unidadeId": "string",
     "pontoAtendimentoId": "string",
     "credencialId": "string",
     "biometriaFacial": null,
     "justificativaSurpassar": null,
     "codigoAplicativo": "string",
     "enviarSms": false,
     "codigoSms": null,
     "descricaoJustificativa": null,
     "obterProcedimentos": true,
     "procedimentos": [
       {
         "quantidadeAprovada": 1,
         "quantidadeExecutada": 1,
         "codigo": "40302040"
       },
       {
         "quantidadeAprovada": 1,
         "quantidadeExecutada": 1,
         "codigo": "40301605"
       }
     ]
   }

   JSON Exemplo (request)

   {
     "numeroGuiaPrestador": "12345678900",
     "guiaId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "unidadeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "pontoAtendimentoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "biometriaFacial": null,
     "justificativaSurpassar": null,
     "codigoAplicativo": "541263",
     "enviarSms": false,
     "codigoSms": null,
     "descricaoJustificativa": null,
     "obterProcedimentos": true,
     "procedimentos": [
       {
         "quantidadeAprovada": 1,
         "quantidadeExecutada": 1,
         "codigo": "40302040"
       },
       {
         "quantidadeAprovada": 1,
         "quantidadeExecutada": 1,
         "codigo": "40301605"
       }
     ]
   }

2. Interpretar a resposta da API

   A seguir, um exemplo de resposta esperada da execução da guia:

   JSON Original (response)

   {
     "sucesso": true,
     "erros": [],
     "data": [
       {
         "resposta": {
           "sucesso": true,
           "isPendente": false,
           "erros": [],
           "numeroGuia": "string",
           "senhaGuia": "string",
           "protocolo": "string",
           "validadeSenha": "2025-06-02T03:00:30.495Z",
           "situacaoAutorizacao": "A",
           "pedirToken": false,
           "guiaId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
           "codigoParceiro": "string",
           "origemPedido": null,
           "guiaImpressao": "base64",
           "reciboImpressao": null,
           "guiaPrestador": "string",
           "guiaParceiro": "string",
           "dataAutorizacao": "2025-06-02T03:00:30.495Z",
           "senhaGuiaPreAutorizada": "string",
           "procedimentosGuia": []
         },
         "numeroAutorizacao": 0,
         "inicioAutorizacao": "2025-06-02T03:00:30.495Z",
         "fimAutorizacao": "2025-06-02T03:00:30.495Z",
         "pdfGuiaAutorizacao": "base64",
         "pdfReciboAutorizacao": "string"
       }
     ]
   }

   JSON Exemplo (response)

   {
     "sucesso": true,
     "erros": [],
     "data": [
       {
         "resposta": {
           "sucesso": true,
           "isPendente": false,
           "erros": [],
           "numeroGuia": "987654321",
           "senhaGuia": "SG12345678",
           "protocolo": "PROTO-202506021707",
           "validadeSenha": "2025-06-02T17:07:52.717Z",
           "situacaoAutorizacao": "A",
           "pedirToken": false,
           "guiaId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
           "codigoParceiro": "PARC-001",
           "origemPedido": null,
           "guiaImpressao": "base64",
           "reciboImpressao": null,
           "guiaPrestador": "PRST-654321",
           "guiaParceiro": "PARC-123456",
           "dataAutorizacao": "2025-06-02T17:07:52.717Z",
           "senhaGuiaPreAutorizada": "PRE-SG98765",
           "procedimentosGuia": [
             {
               "nomeProcedimento": "GLICOSE",
               "codigoTabela": "22",
               "codigoProcedimento": "40302040",
               "quantidade": 1,
               "quantidadeAutorizada": 1,
               "quantidadeExecutada": 1,
               "senhaAutorizacao": null,
               "protocoloAtendimento": null,
               "mnemonico": "GLI",
               "situacaoProcedimento": "A"
             },
             {
               "nomeProcedimento": "TGO",
               "codigoTabela": "22",
               "codigoProcedimento": "40301605",
               "quantidade": 1,
               "quantidadeAutorizada": 1,
               "quantidadeExecutada": 1,
               "senhaAutorizacao": null,
               "protocoloAtendimento": null,
               "mnemonico": "TGO",
               "situacaoProcedimento": "A"
             }
           ]
         },
         "numeroAutorizacao": 1,
         "inicioAutorizacao": "2025-06-02T17:07:52.717Z",
         "fimAutorizacao": "2025-06-02T17:07:52.717Z",
         "pdfGuiaAutorizacao": "base64",
         "pdfReciboAutorizacao": "recibo-pdf-base64"
       }
     ]
   }