Histórico da Página

CONTEÚDO

Visão Geral
Exemplo de utilização
1. Método listarDeclaracoes
  1. Regras de Negocio do Método
  2. EndPoint
  3. Parâmetros de Entrada do Método
  4. Exemplo
  5. Estrutura de Retorno
2. Método declaracaoPdf
  1. Regras de Negocio do Método
  2. EndPoint
  3. Parâmetros de Entrada do Método
  4. Exemplo
  5. Estrutura de Retorno
Tela Declarações Tela Declarações
1. Outras Ações / Ações relacionadas
Tela Declarações Declarações
1. Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL Âncora
VISAO
VISAO

Este documento tem como objetivo demontrar demonstrar a utilização da API Declarações para utilizar na a 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 eventos (itens) e valores relacionados à declaração selecionada.

A API utilizará o padrão REST.

02. EXEMPLO DE UTILIZAÇÃO Âncora
EXEMPLO
EXEMPLO

Segue os Lista de métodos utilizados na API:

declaracoeslistaDeclaracoes: Retorna uma lista de declarações do beneficiário.
pdfDeclaracaodeclaracaoPdf: Retorna uma URL ou um caracter BASE64 contendo o arquivo PDF da declaração.

Abaixo serão apresentados exemplos de cada método.

A autenticação dos métodos listados abaixo é realizado realizada através da Api /token, onde será retornado a chave e token a ser adicionado no header de cada método.

Método

...

listaDeclaracoes
Âncora
DECLARACAO
DECLARACAO

Este método irá retornar a lista com todas as solicitações de autorização do declarações (Carta de Quitação e Declaração anual de Imposto de Renda) solicitadas pelo beneficiário. Será retornado somente o cabeçalho da autorização.

Regras de Negocio do Método Âncora
DECLARACAOREGRA
DECLARACAOREGRA

A quantidade de anos que o sistema irá listar nas declarações deverá ser informado no campo Qt. Anos Dec (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 No campo List. Decla. (BA0_MSDECD no ) no cadastro da operadora, deverá ser preenchido as informado os tipos de 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 Âncora
DECLARACAOENDPOINT
DECLARACAOENDPOINT

Url	Método	Header Content-Type	Descrição
https://<url>:<porta>/rest/mobileSaude/v1/declaracoeslistaDeclaracoes	POST	application/json	Retorna uma lista de declarações

Parâmetros de Entrada do Método Âncora
DECLARACAOPARAMETROS
DECLARACAOPARAMETROS

Parâmetro	Obrigatório	Tipo	Descrição
chaveBeneficiario	SimNão	Caracter	Chave do Beneficiário (CPF ou Matricula)
chaveBeneficiarioTipo	SimNão	Caracter	Tipo de Login do Beneficiário (CPF ou Matricula)
multiContract	SimNão	Lógico	Utilização de Multi Contratos pelo Beneficiário
matriculaContrato	Sim	Caracter	Matricula do Beneficiário

Exemplo Âncora
DECLARACAOEXEMPLO
DECLARACAOEXEMPLO

Bloco de código

language	c#
theme	Midnight
title	Request body
linenumbers	true
collapse	true

{
    "chaveBeneficiarioTipo": "CPF",
    "multiContract": truefalse,
    "chaveBeneficiario": "71461963990",
    "matriculaContrato": "7646163309000011008000013019"
}

Bloco de código

language	c#
theme	Midnight
title	API Retorno - Sucesso
linenumbers	true
collapse	true

{
    "status": true,
    "tiposDeclaracoestipoDeclaracoes": [
        {
            "declaracoes": [
                {
                    "nomeDeclaracaonome": "2021-00010050000002004",
                    "codigoContrato": "00010050000002",
        Imposto de Renda",
            "idDeclaracaodeclaracoes": "2021:IRPF:00010050000002004"
                },[
                {
                    "nomeDeclaracaonome": "20202021-0001005000000200400011008000013019",
                    "codigoContratoidDeclaracao": "000100500000022021:IRPF:00011008000013019",
                    "idDeclaracaocodigoContrato": "2020:IRPF:0001005000000200400011008000013"
                },
                {
                    "nomeDeclaracaonome": "20192020-0001005000000200400011008000013019",
                    "codigoContrato": "00010050000002",
                    "idDeclaracao": "20192020:IRPF:00010050000002004"
                }
            ],
            "nome": "Imposto de Renda"
00011008000013019",
              },
        {
            "declaracoes": [
                {
                    "nomeDeclaracao": "2021-00010050000002004",
                    "codigoContrato": "0001005000000200011008000013",
                    "idDeclaracao": "2021:CQ:00010050000002004"
                },
                {
                    "nomeDeclaracaonome": "20202019-0001005000000200400011008000013019",
                    "codigoContrato": "00010050000002",
                    "idDeclaracao": "20202019:CQIRPF:00010050000002004"
                },
                {00011008000013019",
                    "nomeDeclaracaocodigoContrato": "2019-0001005000000200400011008000013",
                    "codigoContrato": "00010050000002",}
                    "idDeclaracao": "2019:CQ:00010050000002004"
    ]
            },
            ],{
            "nome": "Carta de Quitação"
        },
        {
            "declaracoes": [
                {
                    "nomeDeclaracaonome": "2021-00010050000008002",
                    "codigoContrato": "0001005000000800011008000013019",
                    "idDeclaracao": "2021:IRPF:00010050000008002"
                },
                {
                    "nomeDeclaracao": "2020-00010050000008002"CQ:00011008000013019",
                    "codigoContrato": "0001005000000800011008000013",
                    "idDeclaracao": "2020:IRPF:00010050000008002"
                },
                {
                    "nomeDeclaracaonome": "20192020-0001005000000800200011008000013019",
                    "codigoContrato": "00010050000008",
                    "idDeclaracao": "20192020:IRPFCQ:00010050000008002"
                }
            ],
            "nome": "Imposto de Renda"
00011008000013019",
            },
        {
            "declaracoes": [
                {
                    "nomeDeclaracao": "2021-00010050000008002",
                    "codigoContrato": "00010050000008",
                    "idDeclaracao": "2021:CQ:00010050000008002"00011008000013"
                },
                {
                    "nomeDeclaracaonome": "20202019-0001005000000800200011008000013019",
                    "codigoContrato": "00010050000008",
                    "idDeclaracao": "20202019:CQ:00010050000008002"
                },
                {
                    "nomeDeclaracao": "2019-00010050000008002"00011008000013019",
                    "codigoContrato": "00010050000008",
                    "idDeclaracao": "2019:CQ:0001005000000800200011008000013"
                }
            ],
            "nome": "Carta de Quitação"
        }
    ]
}

Bloco de código

language	c#
theme	Midnight
title	Retorno API - Falha
linenumbers	true
collapse	true

{
    "status": false,
    "motivoCritica": "Nenhum beneficiário encontrado para os parâmetros informados."
}

Estrutura de Retorno Âncora
DECLARACAORETORNO
DECLARACAORETORNO

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
tipoDeclaracaotipoDeclaracoes	Array	Lista de objetos de “tipoDeclaracao“
nome (Objeto tipoDeclaracaotipoDeclaracoes)	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

...

declaracaoPdf
Âncora
PDF
PDF

Este método irá retornar uma URL ou um caracter BASE64 contendo o arquivo PDF da declaração.

Aviso

title	Em Construção

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.

Regras de Negocio do Método Âncora
PDFREGRA
PDFREGRA

Esse método irá receber a chave de identificação da declaração que foi retornado no método declaracoes listaDeclaracoes. A Chave deverá conter o ano, tipo da declaração a ser gerada , e a matricula do beneficiário.

Através da configuração da Mobile Saúde Modo PDF (BA0_MSPDFM) 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 URL PDF (BA0_MSPDFU) o caminho para acessar pela internet.

Endpoint Âncora
PDFENDPOINT
PDFENDPOINT

Url	Método	Header Content-Type	Descrição
https://<url>:<porta>/rest/mobileSaude/v1/pdfDeclaracaodeclaracaoPdf	POST	application/json	Retorna a declaração em PDF

Parâmetros de Entrada do Método Âncora
PDFPARAMETROS
PDFPARAMETROS

Parâmetro	Obrigatório	Tipo	Descrição
idDeclaracao	Sim	Caracter	Chave de identificação da declaração no sistema (Ano + Declaração + Matricula)

Exemplo Âncora
PDFEXEMPLO
PDFEXEMPLO

Bloco de código

language	c#
theme	Midnight
title	Request body
linenumbers	true
collapse	true

{
    "idDeclaracao": "20202021:CQIRPF:0001005000000800200011008000013019"
}

Bloco de código

language	c#
theme	Midnight
title	API Retorno - Sucesso
linenumbers	true
collapse	true

{
    "status": true,
    "url": "c:\\protheus12127\\protheus_data\\web\\pp\\imagens-pls\\relatorios\\impostoRenda.pdf",
    "base64": ""
}

Bloco de código

language	c#
theme	Midnight
title	Retorno API - Falha
linenumbers	true
collapse	true

{
    "status": false,
    "motivoCritica": "Não foi possível gerar o PDF"
}

Estrutura de Retorno Âncora
PDFRETORNO
PDFRETORNO

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

Card documentos

Informacao	A impressão do PDF da Carta de Quitação utiliza o ponto de entrada PLSQTDEB, por tanto é necessário compila-lo no ambiente. O mesmo estar disponível para download no portal do cliente. Lembrando que o Ponto de entrada deverá retornar um array nesse formato: {,T,, "", "nomeArquivo.PDF"}
Titulo	Importante!

03. TELA DECLARAÇÕES Âncora
TELADECLARACOES1
TELADECLARACOES1

Outras Ações / Ações relacionadas

Âncora

	TELADECLARACOES1
	TELADECLARACOES1

Ação	Descrição
Não se aplica	Não se aplica

04. TELA DECLARAÇÕES Âncora
TELADECLARACOES2
TELADECLARACOES2

Principais Campos e Parâmetros

...

do TOTVS Saúde Planos Linha Protheus

Âncora

	TELADECLARACOES2
	TELADECLARACOES2

Indica se o acesso a Mobile Saúde é Multi Contrato

Campo	Descrição
Campo	Descrição
BA0_MSTLOG	Informar o tipo de acesso de login na API da mobile saúde
BA0_MSMULT
BA0_MSPDFM	Informe se o download dos PDF´s das API´s Mobile Saúde será via download através de um URL HTTP ou o arquivo será transmitido via Base 64 no JSON de resposta.
BA0_MSPDFU	Informe a URL HTTP para download dos arquivos PDF´s na integração com a Mobile Saúde quando selecionado a opção via URL.
BA0_MSDECL	Indica Indica a quantidade de anos que o sistema irá listar nas declarações. Exemplo: caso seja informado o valor 3, o sistema irá listar as declarações dos últimos 3 anos.
BA0_MSDECD	Indica as declarações que serão utilizadas na API. Imposto de renda: IRPF, carta de quitação : CQ, ambos: IRPF,CQ (Obrigatório utilizar a virgula para separar as declarações)ou ambas.

05. TABELAS UTILIZADAS Âncora
TABELAS
TABELAS

SE1 - Contas a Receber
SE5 - Movimentação Bancaria
BBT - Títulos Gerados
BM1 - Composição da Cobrança
B44 - Autorização Reembolso
BA0 - Cadastro de Operadoras

...

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

CONTEÚDO

Parâmetros de Entrada do Método

Exemplo

Estrutura de Retorno

Parâmetros de Entrada do Método

Exemplo

Estrutura de Retorno

01. VISÃO GERAL Âncora
VISAO
VISAO

02. EXEMPLO DE UTILIZAÇÃO Âncora
EXEMPLO
EXEMPLO

Método

listaDeclaracoes
Âncora
DECLARACAO
DECLARACAO

Regras de Negocio do Método Âncora
DECLARACAOREGRA
DECLARACAOREGRA

Endpoint Âncora
DECLARACAOENDPOINT
DECLARACAOENDPOINT

Parâmetros de Entrada do Método Âncora
DECLARACAOPARAMETROS
DECLARACAOPARAMETROS

Exemplo Âncora
DECLARACAOEXEMPLO
DECLARACAOEXEMPLO

Estrutura de Retorno Âncora
DECLARACAORETORNO
DECLARACAORETORNO

Método

declaracaoPdf
Âncora
PDF
PDF

Regras de Negocio do Método Âncora
PDFREGRA
PDFREGRA

Endpoint Âncora
PDFENDPOINT
PDFENDPOINT

Parâmetros de Entrada do Método Âncora
PDFPARAMETROS
PDFPARAMETROS

Exemplo Âncora
PDFEXEMPLO
PDFEXEMPLO

Estrutura de Retorno Âncora
PDFRETORNO
PDFRETORNO

03. TELA DECLARAÇÕES Âncora
TELADECLARACOES1
TELADECLARACOES1

04. TELA DECLARAÇÕES Âncora
TELADECLARACOES2
TELADECLARACOES2

05. TABELAS UTILIZADAS Âncora
TABELAS
TABELAS

Árvore de páginas

Histórico da Página

Versões comparadas

Chave

CONTEÚDO

01. VISÃO GERAL ÂncoraVISAOVISAO

02. EXEMPLO DE UTILIZAÇÃO ÂncoraEXEMPLOEXEMPLO

Método

listaDeclaracoes ÂncoraDECLARACAODECLARACAO

Regras de Negocio do Método ÂncoraDECLARACAOREGRADECLARACAOREGRA

Endpoint ÂncoraDECLARACAOENDPOINTDECLARACAOENDPOINT

Parâmetros de Entrada do Método ÂncoraDECLARACAOPARAMETROSDECLARACAOPARAMETROS

Exemplo ÂncoraDECLARACAOEXEMPLODECLARACAOEXEMPLO

Estrutura de Retorno ÂncoraDECLARACAORETORNODECLARACAORETORNO

Método

declaracaoPdf ÂncoraPDFPDF

Regras de Negocio do Método ÂncoraPDFREGRAPDFREGRA

Endpoint ÂncoraPDFENDPOINTPDFENDPOINT

Parâmetros de Entrada do Método ÂncoraPDFPARAMETROSPDFPARAMETROS

Exemplo ÂncoraPDFEXEMPLOPDFEXEMPLO

Estrutura de Retorno ÂncoraPDFRETORNOPDFRETORNO

03. TELA DECLARAÇÕES ÂncoraTELADECLARACOES1TELADECLARACOES1

04. TELA DECLARAÇÕES ÂncoraTELADECLARACOES2TELADECLARACOES2

05. TABELAS UTILIZADAS ÂncoraTABELASTABELAS

01. VISÃO GERAL Âncora
VISAO
VISAO

02. EXEMPLO DE UTILIZAÇÃO Âncora
EXEMPLO
EXEMPLO

listaDeclaracoes
Âncora
DECLARACAO
DECLARACAO

Regras de Negocio do Método Âncora
DECLARACAOREGRA
DECLARACAOREGRA

Endpoint Âncora
DECLARACAOENDPOINT
DECLARACAOENDPOINT

Parâmetros de Entrada do Método Âncora
DECLARACAOPARAMETROS
DECLARACAOPARAMETROS

Exemplo Âncora
DECLARACAOEXEMPLO
DECLARACAOEXEMPLO

Estrutura de Retorno Âncora
DECLARACAORETORNO
DECLARACAORETORNO

declaracaoPdf
Âncora
PDF
PDF

Regras de Negocio do Método Âncora
PDFREGRA
PDFREGRA

Endpoint Âncora
PDFENDPOINT
PDFENDPOINT

Parâmetros de Entrada do Método Âncora
PDFPARAMETROS
PDFPARAMETROS

Exemplo Âncora
PDFEXEMPLO
PDFEXEMPLO

Estrutura de Retorno Âncora
PDFRETORNO
PDFRETORNO

03. TELA DECLARAÇÕES Âncora
TELADECLARACOES1
TELADECLARACOES1

04. TELA DECLARAÇÕES Âncora
TELADECLARACOES2
TELADECLARACOES2

05. TABELAS UTILIZADAS Âncora
TABELAS
TABELAS