Histórico da Página
...
- Visão Geral
- Exemplo de utilização
- Tela Declarações
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela Declarações
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
Este documento tem como objetivo orientar a utilização da API Declarações para utilizar na integração do TOTVS Saúde Planos Linha Protheus com a Mobile Saúde, onde será disponibilizado ao beneficiário as declarações (Carta de Quitação e Declaração anual de Imposto de Renda) contendo relação de itens e valores relacionados à declaração selecionada.
A API utilizará o padrão REST.
02. EXEMPLO DE UTILIZAÇÃO
...
A autenticação dos métodos listados abaixo é realizado através da Api /token, onde será retornado a chave e token a ser adicionado no header de cada método.
Método declaracoes
Este método irá retornar a lista com todas as solicitações de autorização do beneficiário. Será retornado somente o cabeçalho da autorização.
Regras de Negocio do Método
A quantidade de anos que o sistema irá listar nas declarações deverá ser informado no campo BA0_MSDECL no cadastro da operadora. Exemplo: caso seja informado o valor 3, o sistema irá listar as declarações dos últimos 3 anos.
Através do campo BA0_MSDECD no cadastro da operadora, deverá ser preenchido as declarações que serão utilizadas na API. Para imposto de renda, o valor IRPF, para carta de quitação o valor CQ. para adicionar as duas declarações deverá preencher o valor: IRPF,CQ (Obrigatório utilizar a virgula para separar as declarações).
Login realizado por CPF, o sistema irá listar as declarações de todos os contratos vinculado aquele CPF.
Login realizado por matricula, o sistema irá listar somente as declarações daquele contrato.
Endpoint
Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
| https://<url>:<porta>/rest/mobileSaude/v1/declaracoes | POST | application/json | Retorna uma lista de declarações |
Parâmetros de Entrada do Método
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| chaveBeneficiario | Sim | Caracter | Chave do Beneficiário (CPF ou Matricula) |
| chaveBeneficiarioTipo | Sim | Caracter | Tipo de Login do Beneficiário (CPF ou Matricula) |
| multiContract | Sim | Lógico | Utilização de Multi Contratos pelo Beneficiário |
Exemplo
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"chaveBeneficiarioTipo": "CPF",
"multiContract": true,
"chaveBeneficiario": "76461633090"
} |
...
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"status": false,
"motivoCritica": "Nenhum beneficiário encontrado para os parâmetros informados."
} |
Estrutura de Retorno
| Atributo | Tipo | Descrição |
|---|---|---|
| status | Lógico | True: Indica que a requisição foi bem-sucedida False: Indica que a requisição foi mal sucedida |
| motivoCritica | Caracter | Motivo pelo qual não foi possível realizar a requisição, quando o status for igual a False |
| tipoDeclaracao | Array | Lista de objetos de “tipoDeclaracao“ |
| nome (Objeto tipoDeclaracao) | Caracter | Nome que identifica a lista de declaração |
| declaracoes | Array | Lista de objetos de “declaracoes“ |
| nome (Objeto declaracoes) | Caracter | Nome que identifica a declaração (Ano + Matricula do Beneficiário) |
| idDeclaracao | Caracter | Chave de identificação da declaração no sistema (Ano + Declaração + Matricula) |
| codigoContrato | Caracter | Código do Contrato do Beneficiário (Operadora + Empresa + Matricula) |
Método PdfDeclaracao
Este método irá retornar uma URL ou um caracter BASE64 contendo o arquivo PDF da declaração.
| Aviso | ||
|---|---|---|
| ||
No momento o método que retorno o arquivo gerado PDF das declaração esta sendo desenvolvido, tanto a geração do Imposto de Renda como a Carta de Quitação por utilizar tecnologias antigas para geração do relatório. Estamos trabalhando na revitalização dos mesmo para uma melhor entrega. |
...
Através da configuração da Mobile Saúde no cadastro da operadora, pelo campo BA0_MSPDFM, será definido o tipo de PDF que será gerado (URL ou base64). Quando utilizado via URL, deverá informar no campo BA0_MSPDFU o caminho para acessar pela internet.
Endpoint
| Url | Método | Header Content-Type | Descrição |
|---|---|---|---|
| https://<url>:<porta>/rest/mobileSaude/v1/pdfDeclaracao | POST | application/json | Retorna a declaração em PDF |
Parâmetros de Entrada do Método
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| idDeclaracao | Sim | Caracter | Chave de identificação da declaração no sistema (Ano + Declaração + Matricula) |
Exemplo
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"idDeclaracao": "2020:CQ:00010050000008002"
} |
...
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"status": false,
"motivoCritica": "Não foi possível gerar o PDF"
} |
Estrutura de Retorno
| Atributo | Tipo | Descrição |
|---|---|---|
| status | Lógico | True: Indica que a requisição foi bem-sucedida False: Indica que a requisição foi mal sucedida |
| motivoCritica | Caracter | Motivo pelo qual não foi possível realizar a requisição, quando o status for igual a False |
| base64 | Caracter em base64 | Conteúdo binário do tipo base64, do arquivo PDF da declaração. |
| url | Caracter | URL completo do arquivo PDF informado no cadastro da Operadora |
03. TELA DECLARAÇÕES
Outras Ações / Ações relacionadas
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas