Linha Datasul

Árvore de páginas


CONTEÚDO

  1. Visão Geral
    1. Rota
    2. Parâmetros de Entrada
    3. Retorno
  2. Regras de Negócio Aplicadas
  3. Exemplo de Utilização


01. VISÃO GERAL

O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração com o APP da Unimed Brasil.

A API Extrato INSS(Medico/INSSCompetencias) tem por objetivo retornar as últimas seis (6) competências referente ao extrato de contas do médico.

A API foi desenvolvida seguindo as definições disponibilizadas no Swagger da Unimed Brasil:

a. Rota

/Medico/v1/INSSCompetencias

b. Parâmetros de Entrada

Esta API não exige parâmetros de entrada.

c. Retorno

O objeto Json de retorno da API possui a seguinte estrutura:

{
  "Result": "Domínio: 0 = Erro na execução do serviço, 1 = Processamento Ok",
  "Message": "Mensagem de retorno que deverá ser exibida ao usuário (obrigatória em caso de erro, ou seja, Result = 0)",
  "Data": [
    {
      "id": "Campo de identificação da competência",
      "nome": "Descrição da competência que será exibida no aplicativo"
    }
  ],
  "DebugMessage": "string"
}

03. REGRAS DE NEGÓCIO APLICADAS

A API retorna uma lista contendo as últimas seis (6) competências referente ao demonstrativo de INSS do médico

04. EXEMPLO DE UTILIZAÇÃO

Se a requisição ocorrer no dia 04/08/2021, por exemplo, então a API irá retornar:

{
    "Result": 1,
    "Data": [
        {
            "id": "08/2021",
            "nome": "08/2021"
        },
        {
            "id": "07/2021",
            "nome": "07/2021"
        },
        {
            "id": "06/2021",
            "nome": "06/2021"
        },
        {
            "id": "05/2021",
            "nome": "05/2021"
        },
        {
            "id": "04/2021",
            "nome": "04/2021"
        },
        {
            "id": "03/2021",
            "nome": "03/2021"
        }
    ],
    "DebugMessage": "",
    "Message": ""
}