Índice |
---|
Objetivo
...
Método de construção obrigatória;
O webservice deverá receber a chave os dados necessários para identificação do beneficiário e retornar as suas autorizações e, conforme tipo de usuário, retornar também as autorizações do seu grupo familiar.
Se o beneficiário solicitado for o titular, retornar as suas autorizações e de todo o grupo familiar
Se o beneficiário solicitado for um dependente, retornar apenas as suas próprias autorizações
Opcionalmente, o webservice poderá receber uma data inicial e final e retornar todas as autorizações existentes no período.
Se os parâmetros Data Inicial e Final não forem informados, retorne uma lista com a quantidade de autorizações que desejar, como por exemplo, dos últimos 12 meses.
Parâmetros de entrada
Nota | ||
---|---|---|
| ||
Será adicionado ao corpo da requisição os dados da chave 'Integracao” do beneficiário retornada no login do mesmo. |
Atributo | Critério | Tipo | Descrição | Regra de preenchimento | chaveBeneficiário | M | String|
---|---|---|---|---|---|---|---|
Chave única do beneficiário no seu sistema de gestão. | Formato: texto livre | dataInicial | OP | Date | Data inicial do extrato de autorizações | Formato: YYYY-MM-DD | |
dataFinal | OP | Date | Data final do extrato de autorizações | Formato: YYYY-MM-DD |
...
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
---|---|---|---|---|
status | M | Boolean | True = indica que a requisição foi bem-sucedida False = Indica que a requisição foi mal sucedida IMPORTANTE: caso o beneficiário não tenha nenhuma autorização a ser exibida, retorne TRUE neste método (pois a requisição foi bem sucedida). Nesses casos, o objeto autorizações - documentado mais adiante - deverá ser retornado VAZIO. | True |
motivoCritica | C | String | Quando o status for igual a False, envie nesta propriedade o motivo pelo qual não foi possível realizar a requisição. Este campo é obrigatório quando o status igual a False. | Formato: texto livre. |
autorizacao | C | Array de objetos “autorizacoes” | Retornar uma lista de objetos “autorizacao“ (definição abaixo). |
Definição da estrutura “autorizacao”
Atributo | Critério | Tipo | Descrição | Regra de preeenchimentopreenchimento |
---|---|---|---|---|
chaveAutorizacao | M | String | Chave única de identificação da guia de autorização no seu sistema | Formato: Texto livre. |
beneficiarioMatricula | M | String | Código da matricula do beneficiário da guia | Formato: Texto livre. |
beneficiarioNome | M | String | Nome completo do beneficiário da guia | Formato: Texto livre. |
statusId | M | Integer | Código do status da autorização, conforme tabela de domínio descrita no método statusAutorizacao | Numérico |
dataSolicitacao | M | Date | Data da solicitação | Formato: YYYY-MM-DD |
dataAutorizacao | OP | Date | Data da autorização | Formato: YYYY-MM-DD |
nomePrestador | M | String | Nome do prestador de serviço | Formato: Texto livre. |
especialidade | M | String | Especialidade vinculada ao serviço requisitado | Formato: Texto livre. |
tipoTratamento | M | String | Descrição do tipo de tratamento da guia | Formato: Texto livre. |
numeroPedido | M | String | Número da guia ou do pedido | Formato: Texto livre. |
senha | OP | String | Número da senha de autorização, caso exista | Formato: Texto livre. |
...
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
---|---|---|---|---|
status | M | Boolean | True = indica que a requisição foi bem-sucedida False = Indica que a requisição foi mal sucedida | true |
motivoCritica | C | String | Quando o status for igual a False, envie nesta propriedade o motivo pelo qual não foi possível realizar a requisição. | Este campo é obrigatório quando o status igual a False Formato de texto livre. |
item | C | Array de objetos “item” | Caso o atributo status seja verdadeiro, este atributo torna-se obrigatório |
Definição da estrutura item
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
---|---|---|---|---|
itemId | M | String | Chave única do item da guia de autorização | Formato: texto livre. |
procedimento | M | String | Código do procedimento | Formato: texto livre. |
procedimentoDescricao | M | String | Descrição do procedimento | Formato: texto livre. |
statusId | M | Integer | Descrição do procedimento | Numérico |
quantidadeSolicitada | M | Float | Quantidade solicitada | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) |
quantidadeAutorizada | OP | Float | Quantidade autorizada pela operadora | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) |
dataAutorizacao | OP | Date | Data da autorização do procedimento | Formato: “YYYY-MM-DD“ |
...
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
---|---|---|---|---|
status | M | Boolean | True = indica que a requisição foi bem-sucedida. False = Indica que a requisição foi mal sucedida. | true |
motivoCritica | C | String | Quando o status for igual a False, envie nesta propriedade o motivo pelo qual não foi possível realizar a requisição. | Este campo é obrigatório quando o status igual a False. Formato: “texto livre” |
autorizacaoStatus | C | Array de objetos “autorizacaoStatus” | Caso o atributo status seja verdadeiro este atributo torna-se obrigatório |
Definição da estrutura “autorizacaoStatus”.
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
---|---|---|---|---|
chaveStatus | M | String | Chave única de identificação do status da autorização | Formato: texto livre. |
descricao | M | String | Descrição do status | Formato: texto livre. |
...
Este método irá retornar uma URL ou uma string BASE64 do arquivo PDF da guia completa.
Observação importante: você pode optar por não desenvolver este método e ao invés disso, fornecer uma URL que recebe os mesmos parâmetros via GET ou via POST e retorna um arquivo PDF pronto para que possamos demonstra-lo no app.
...