Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Configurações INI
  3. Configurações Remote
    1. Cadastro de Usuários API
    2. Cadastro de Funcionalidades
    3. Cadastro de Operadoras
    4. Cadastro de Bloqueios BG1 e BG3
    5. Cadastro de Layouts do Cartão
    6. Cadastro Formas de Pagamento
  4. API Primeiro Acesso - createUsernovoUsuario
  5. API Login Beneficiário - authlogin
  6. API Lembrar Reiniciar Senha - rememberPassreiniciarSenha
  7. API Trocar Senha - changePasstrocarSenha
  8. API Extrato de Utilização - exUtilizacaoAPI Extrato de Co-Participação - exCoparticipacaoextrato
  9. API Lista Débitos - listaDebitos
  10. API Detalhe Débito - detalheDebito
  11. API Boleto PDF - boletoPdf
  12. API Extrato Fatura PDF - extratoFaturaPdfAPI Composição Cobrança - composicaoCobranca
  13. Menus
  14. Tabelas Utilizadas


01. VISÃO GERAL

...

  • Consulta do extrato de utilização.Consulta do extrato de /co-participação.


Operações Financeiras:

  • Consulta aos débitos (títulos financeiros).
  • Detalhes do débito.
  • Baixar o PDF da extrato da fatura.
  • Baixar o PDF com o boleto.Consultar a composição de cobrança de uma fatura.


A comunicação entre os sistemas é realizada através de API´s. A documentação técnica dos JSON´s de entrada/saída pode ser encontrada neste link: Definições APIs Mobile Saúde

...

exCoparticipacao
DescriçãoNome da API
API de Segurança para criação de Tokens de Acessotoken
Primeiro Acesso do Beneficiário (criação de login/senha)createUsernovoUsuario
Login beneficiárioauthlogin
Lembrar Reiniciar SenharememberPassreiniciarSenha
Trocar SenhachangePasstrocarSenha
Lista Débitos (títulos SE1 do beneficiário)listaDebitos
Detalhe Débito (informações de um SE1 detalhado)detalheDebito
Download PDF BoletoboletoPDFboletoPdf
Download PDF Extrato FaturaextratoFaturaPDFComposição Cobrança (detalhamento BM1 de um título)composicaoCobrancaextratoFaturaPdf
Extrato de UtilizaçãoexUtilizacaoExtrato de Co-participaçãoextrato

composicaoCobranca


Importante: esta URL com os acessos deve ser informada aos administradores da Mobile Saúde. 

...

Importante: todas as APIs são comunicadas com o verbo Post.


04. API PRIMEIRO ACESSO -

...

novoUsuario


URLhttps://<url>:<porta>/rest/mobileSaude/v1/createUsernovoUsuario

Esta API é responsável pelo cadastro dos beneficiários no acesso a API e Portal do Beneficiário (ambos usarão o mesmo usuário/senha). Os acessos são cadastrados na tabela BSW.

...

Ponto de Entrada: PMOBBE01
Fonte: PMobAutCon
Parâmetros
VariávelTipoObrigatórioDescrição
cCodigoCaracterSimCódigo do registro BSW criado
Retorno
VariávelTipoObrigatórioDescrição
Não há retorno



05. API LOGIN BENEFICIÁRIO -

...

login


URLhttps://<url>:<porta>/rest/mobileSaude/v1/authlogin

Esta API realiza o login de um beneficiário que já tem o cadastro no APP. A API retorna os dados cadastrais do beneficiário:

...

Ponto de Entrada: PMOBBE07
Fonte: PMobBenef
Parâmetros
VariávelTipoObrigatórioDescrição
oBeneficiaryJSON ObjectSimObjeto JSON montado pelo sistema
Retorno
VariávelTipoObrigatórioDescrição
cRedeAtendCaracterNãoMensagem que será apresentada no atributo redeAtendimento.



06. API

...

REINICIAR SENHA -

...

reiniciarSenha


URLhttps://<url>:<porta>/rest/mobileSaude/v1/rememberPassreiniciarSenha

Esta API é responsável para lembrar reiniciar a senha do beneficiário. Ao solicitar uma requisição para esta API, o PLS retornará uma nova senha para o beneficiário., com o mesmo já informando a nova senha. O sistema só realizará a troca de senha se os atributos login, dataNascimento e email informados corretamente.

Bloco de código
titleExemplo
Bloco de código
titleExemplo do json solicitando lembrar a senha
linenumberstrue
collapsetrue
{
  "cpflogin": "9519132902363369527030",
  "dataNascimento": "19581985-11-0506-17",
  "senha": "12345678",
  "email": "[email protected]"
}
Bloco de código
titleExemplo do json com a nova senha
linenumberstrue
collapsetrue
{
    "senha": "148572",
    "alerta": " ",
    "status": true,
    "telefone": " ",
    "enviado": false,
    "email": "[email protected]",
    "login": "95191329023"
}

07. API TROCAR SENHA - changePass


}


07. API TROCAR SENHA - trocarSenha


URLhttps://<url>:<porta>/restURLhttps://<url>:<porta>/rest/mobileSaude/v1/changePasstrocarSenha

Esta API é responsável pela troca de senha dos beneficiários que utilizam o aplicativo.

...

Bloco de código
titleExemplo do json confirmando a troca de senha
linenumberstrue
collapsetrue
{
    "status": true
}


08. API EXTRATO DE UTILIZAÇÃO -

...

extrato


URLhttps://<url>:<porta>/rest/mobileSaude/v1/exUtilizacaoextrato

Esta API retorna o extrato de utilização de um beneficiário em um Ano/Mês. Ela retorna a utilização com/sem a co-participação.

Importante: um registro que tem co-participação é apresentado duas vezes no Json de resposta: uma com o valor zerado e outra com o valor apresentado, de acordo como esperado pelo aplicativo da Mobile Saúde.

Bloco de código
titleExemplo do json de solicitação do extrato de utilização
linenumberstrue
collapsetrue
{
	"chaveBeneficiarioTipo": "CPF",
	"matriculaVida": "00000004",
	"multiContract": true,
	"chaveBeneficiario": "44046668458",
	"tipoUsuario" : "T",
	"idPeriodo" : "202006",
	"ano" : "2020",
	"mes" : "06"
}
Bloco de código
titleExemplo do json de retorno com o extrato de utilização
linenumberstrue
collapsetrue
{
    "status": true,
    "extrato": [
        {
    			"valorCoparticipacao": "0.00",
            "valorServico": "0.69",
            "nomeExecutante": "HOSPITAL BOM CLIMA",
            "quantidade": "1.00",
            "codigoContrato": "00010004000002",
            "nomeBeneficiario": "AMANDA BARBARA",
            "codigoEvento": "40303136",
            "descricaoEvento": "SANGUE OCULTO, PESQUISA NAS FEZES",
            "dataAtendimento": "2020-06-08",
            "codigoExecutante": "000004",
            "cpfCnpjExecutante": 34585221000190,
            "codigoTipoServico": "000002",
            "descricaoTipoServico": "EXAMES E TERAPIAS",
            "matriculaBeneficiario": "00010004000002000"
        },
	    {
             {"valorCoparticipacao": "0.21",
            "valorServico": "770.1269",
            "nomeExecutante": "HOSPITAL BOM CLIMA",
            "quantidade": "1.00",
            "codigoContrato": "00010004000002",
            "nomeBeneficiario": "AMANDA BARBARA",
            "codigoEvento": "1010101240303136",
            "descricaoEvento": "CONSULTA EM CONSULTORIOSANGUE OCULTO, PESQUISA NAS FEZES",
            "dataAtendimento": "2020-06-0908",
            "codigoExecutante": "000004",
            "cpfCnpjExecutante": 34585221000190,
            "codigoTipoServico": "000001000002",
            "descricaoTipoServico": "CONSULTASEXAMES E TERAPIAS",
            "matriculaBeneficiario": "00010004000002000"
        },
        {
			"valorCoparticipacao": "0.00",
            "valorServico": "277.4212",
            "nomeExecutante": "HOSPITAL BOM CLIMA",
            "quantidade": "1.00",
            "codigoContrato": "00010004000002",
            "nomeBeneficiario": "AMANDA BARBARA",
            "codigoEvento": "1010601410101012",
            "descricaoEvento": "ACONSELHAMENTOCONSULTA EM GENETICOCONSULTORIO",
            "dataAtendimento": "2020-06-1109",
            "codigoExecutante": "000004",
            "cpfCnpjExecutante": 34585221000190,
            "codigoTipoServico": "000001",
            "descricaoTipoServico": "CONSULTAS",
            "matriculaBeneficiario": "00010004000002000"
        },
		{
             ]
}

Importante: os campos Impr Depend (BA0_MSDEPE) e Exc Pag Bloq (BA0_MSEXPB) afetam diretamente o comportamento desta API, a descrição detalhada destes campos está descrita na sessão 3.c deste documento.

09. API EXTRATO DE CO-PARTICIPAÇÃO - exCoparticipacao

URLhttps://<url>:<porta>/rest/mobileSaude/v1/exCoparticipacao

Esta API retorna o extrato de co-participação de um beneficiário em um Ano/Mês.

Bloco de código
titleExemplo do json de solicitação do extrato de co-participação
linenumberstrue
collapsetrue
{
	"chaveBeneficiarioTipo": "CPF",
	"matriculaVida": "00000004",
	"multiContract": true,
	"chaveBeneficiario": "44046668458",
	"tipoUsuario" : "T",
	"idPeriodo" : "202006",
	"ano" : "2020",
	"mes" : "06"
}
Bloco de código
titleExemplo do json de retorno com o extrato de co-participação
linenumberstrue
collapsetrue
{
    "status": true"valorCoparticipacao": "22.92",
            "valorServico": "77.12",
            "nomeExecutante": "HOSPITAL BOM CLIMA",
    "extrato": [
        {"quantidade": "1.00",
            "valorCoparticipacaocodigoContrato": "0.2100010004000002",
            "valorServiconomeBeneficiario": "0.69AMANDA BARBARA",
            "nomeExecutantecodigoEvento": "HOSPITAL BOM CLIMA10101012",
            "quantidadedescricaoEvento": "1.00CONSULTA EM CONSULTORIO",
            "codigoContratodataAtendimento": "000100040000022020-06-09",
            "nomeBeneficiariocodigoExecutante": "AMANDA BARBARA000004",
            "codigoEventocpfCnpjExecutante": "40303136"34585221000190,
            "descricaoEventocodigoTipoServico": "SANGUE OCULTO, PESQUISA NAS FEZES000001",
            "dataAtendimentodescricaoTipoServico": "2020-06-08CONSULTAS",
            "codigoExecutantematriculaBeneficiario": "00000400010004000002000",
        },
        {
			"cpfCnpjExecutantevalorCoparticipacao": 34585221000190"0.00",
            "codigoTipoServicovalorServico": "0000022.42",
            "descricaoTipoServiconomeExecutante": "EXAMESHOSPITAL EBOM TERAPIASCLIMA",
            "matriculaBeneficiarioquantidade": "000100040000020001.00",
        },
        {"codigoContrato": "00010004000002",
            "valorCoparticipacaonomeBeneficiario": "22.92AMANDA BARBARA",
            "valorServicocodigoEvento": "77.1210106014",
            "nomeExecutantedescricaoEvento": "HOSPITALACONSELHAMENTO BOM CLIMAGENETICO",
            "quantidadedataAtendimento": "1.002020-06-11",
            "codigoContratocodigoExecutante": "00010004000002000004",
            "nomeBeneficiariocpfCnpjExecutante": "AMANDA BARBARA"34585221000190,
            "codigoEventocodigoTipoServico": "10101012000001",
            "descricaoEventodescricaoTipoServico": "CONSULTA EM CONSULTORIOCONSULTAS",
            "dataAtendimentomatriculaBeneficiario": "2020-06-0900010004000002000",
            "codigoExecutante": "000004",}
            "cpfCnpjExecutante": 34585221000190,
            "codigoTipoServico": "000001",
            "descricaoTipoServico": "CONSULTAS",
            "matriculaBeneficiario": "00010004000002000"
        },
        {
   ]
}

Importante: os campos Impr Depend (BA0_MSDEPE) e Exc Pag Bloq (BA0_MSEXPB) afetam diretamente o comportamento desta API, a descrição detalhada destes campos está descrita na sessão 3.c deste documento.


09. API LISTA DÉBITOS - listaDebitos


URLhttps://<url>:<porta>/rest/mobileSaude/v1/listaDebitos

Esta API retorna todos os títulos financeiros (tabela SE1) relacionados ao usuário selecionado.

Bloco de código
titleExemplo do json de solicitação de débitos
linenumberstrue
collapsetrue
{
    "tipoUsuario": "T",
    "chaveBeneficiarioTipo": "CPF",
    "matriculaVida": "00000005",
    "multiContract": true,
    "chaveBeneficiario": "44046668458"
}
Bloco de código
titleExemplo do json com os títulos SE1
linenumberstrue
collapsetrue
{
    "status": true,
    "debitos": [
         "valorCoparticipacao": "0.72", {
            "valorServicodescricao": "2.42",
            "nomeExecutantevalor": "HOSPITAL BOM CLIMA"4866,
            "quantidadetituloId": "1.00"6320,
            "codigoContratotituloCodigo": "00010004000002PLS|000000039| |DP ",
            "nomeBeneficiariocodigoContrato": "AMANDA BARBARA00010004000002",
            "codigoEventotipoCobranca": "10106014D",
            "descricaoEventodataEmissao": "ACONSELHAMENTO GENETICO2020-06-10",
            "dataAtendimentodataVencimento": "2020-06-1110",
            "codigoExecutantesituacao": "000004A",
        },
     "cpfCnpjExecutante   {
            "descricao": 34585221000190"",
            "codigoTipoServicovalor": 216,
            "000001tituloId": 6364,
            "descricaoTipoServicotituloCodigo": "CONSULTASPLS|000000081| |DP ",
            "matriculaBeneficiariocodigoContrato": "0001000400000200000010004000002",
             }
"tipoCobranca": "D",
             ]
}"dataEmissao": "2020-08-28",
            "dataVencimento": "2020-08-28",
            "situacao": "A"
        }
    ]
}

Importante:  o campos Exib Tit Pag (BA0_MSTPAG) afeta Importante: os campos Impr Depend (BA0_MSDEPE) e Exc Pag Bloq (BA0_MSEXPB) afetam diretamente o comportamento desta API, a descrição detalhada destes campos está descrita na sessão 3.c deste documento.

10. API LISTA DÉBITOS - listaDebitos

URLhttps://<url>:<porta>/rest/mobileSaude/v1/listaDebitos

Esta API retorna todos os títulos financeiros (tabela SE1) relacionados ao usuário selecionado.

Bloco de código
titleExemplo do json de solicitação de débitos
linenumberstrue
collapsetrue
{
    "tipoUsuario": "T",
    "chaveBeneficiarioTipo": "CPF",
    "matriculaVida": "00000005",
    "multiContract": true,
    "chaveBeneficiario": "44046668458"
}



PONTOS DE ENTRADA


O ponto de entrada PMOBFI01 permite alterar o conteúdo do atributo tipoCobranca:

Ponto de Entrada: PMOBFI01
Fonte: PMobFinMod
Parâmetros
VariávelTipoObrigatórioDescrição
cFormRecCaracterSimForma de Recebimento definido no campo E1_FORMREC
nTituloIdNuméricoNãoRecno do registro SE1
Retorno
VariávelTipoObrigatórioDescrição
cTipoCobrancaCaracterSim

Tipo de cobrança do título sendo:

C = Consignação / desconto em folha
B = Boleto
D = Débito em conta



O ponto de entrada PMOBFI02 permite alterar o conteúdo do atributo situacao:

Ponto de Entrada: PMOBFI02
Fonte: PMobFinMod
Parâmetros
VariávelTipoObrigatórioDescrição
nValorBaseNuméricoNãoValor do título
dVenctoDataNãoData de vencimento
nTituloIdNuméricoNãoRecno do registro SE1
Retorno
VariávelTipoObrigatórioDescrição
cSituacaoCaracterSim

Situação do título sendo:

P = A Vencer (em aberto porém ainda não está vencido)
A = Atrasado (em aberto, porém já vencido)
B = Baixado (já foi pago)



O ponto de entrada PMOBFI04 permite alterar a query que será processsada ao realizar a busca dos títulos SE1:

Ponto de Entrada: PMOBFI04
Fonte: PMobFinMod
Parâmetros
VariávelTipoObrigatórioDescrição
cSqlCaracterSimQuery padrão do sistema
lMultiContractBooleanSimIndica o MultiContrato está habilitado
lLoginByCPFBooleanSimIndica se é login por CPF
cChaveBeneficiarioCaracterSimChave do beneficiário enviado no JSON de solicitação.
Retorno
VariávelTipoObrigatórioDescrição
cSqlCaracterSim

Query que será processada



O ponto de entrada PMOBFI05 permite alterar o atributo descricao dos títulos processados:

Ponto de Entrada: PMOBFI05
Fonte: PMobFinMod
Parâmetros
VariávelTipoObrigatórioDescrição
cPrefixoCaracterSimPrefixo do título
cNumCaracterSimNúmero do título
cParcelaCaracterSimParcela do título
cTipoCaracterSimTipo do título
Retorno
VariávelTipoObrigatórioDescrição
cDescricaoCaracterNão

Valor que será apresentado no atributo descricao



10. API DETALHE DÉBITO - detalheDebito


URLhttps://<url>:<porta>/rest/mobileSaude/v1/detalheDebito

Esta API retorna os dados detalhados de um título SE1 do beneficiário selecionado.

Bloco de código
titleExemplo do json de solicitação de detalhe de um débito
linenumberstrue
collapsetrue
{
    "tituloId": 6353,
    "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de resposta com os detalhes de um débito
linenumberstrue
collapsetrue
{
    "status": true,
    "detalhes": [
        {
Bloco de código
titleExemplo do json com os títulos SE1
linenumberstrue
collapsetrue
{
    "status": true,
    "debitos": [
        {
            "descricao": "",
            "valor": 4866,
            "tituloId": 6320,
            "tituloCodigo": "PLS|000000039| |DP ",
            "codigoContrato": "00010004000002",
            "tipoCobranca": "D",
            "dataEmissao": "2020-06-10",
            "dataVencimento": "2020-06-10",
            "situacao": "A"
        },
        {
            "descricao": "",
            "valor": 216,
            "tituloId": 6364,
            "tituloCodigosituacao": "PLS|000000081| |DP A",
            "codigoContratovalor": 578,
            "00010004000002valorAtualizado": [],
            "tipoCobrancatextoConfirmacao": "D",
            "dataEmissaodataVencimento": "2020-0806-2810",
            "dataVencimentoimprimeBoleto": "2020-08-28N",
            "situacaotipoCobranca": "AD",
             }
    ]
}

Importante:  o campos Exib Tit Pag (BA0_MSTPAG) afeta diretamente o comportamento desta API, a descrição detalhada destes campos está descrita na sessão 3.c deste documento.

PONTOS DE ENTRADA

O ponto de entrada PMOBFI01 permite alterar o conteúdo do atributo tipoCobranca:

...

"observacao": "",
            "cedenteNome": "OPERADORA 417505",
            "linhaDigitavel": "00190500954014481606906809350314337370000000100",
            "dataPagamento": ""
        }
    ]
}


Importante: O atributo linhaDigitavel deve ser gerado através do ponto de entrada PMOBFI03:

Fonte: PMobFinMod
Parâmetros
Variável
ParâmetroTipoObrigatórioDescrição
cFormRec
cPrefixoCaracter
SimForma de Recebimento definido no campo E1_FORMREC
NãoPrefixo do título
cNumeroCaracter
nTituloIdNumérico
Não
Recno
Número do
registro SE1
título
Retorno
cParcela
Variável
Caracter
Tipo
Não
ObrigatórioDescriçãocTipoCobranca
Parcela do título
cTipoCaracter
Sim

Tipo de cobrança do título sendo:

C = Consignação / desconto em folha
B = Boleto
D = Débito em conta

O ponto de entrada PMOBFI02 permite alterar o conteúdo do atributo situacao:

...

Situação do título sendo:

P = A Vencer (em aberto porém ainda não está vencido)
A = Atrasado (em aberto, porém já vencido)
B = Baixado (já foi pago)

NãoTipo do título
cBancoCaracterNãoNúmero do banco
cFormRecCaracterNãoForma de recebimento
cAgenciaCaracterNãoNúmero da agência
cContaCaracterNãoNúmero da conta
cDigitoCaracterNãoDígito verificador da conta
cNossoNumCaracterNãoNosso número
nValLiquiNuméricoNãoValor líquido
cCartCaracterNãoNúmero da Carteira 
cMoedaCaracterNãoTipo da Moeda
cEspecCaracterNãoMáscara da Moeda R$
cAceiteCaracterNãoAceito
nTituloId

Numérico

NãoRecno do título
Retorno
Parâmetro

O ponto de entrada PMOBFI04 permite alterar a query que será processsada ao realizar a busca dos títulos SE1:

Ponto de Entrada: PMOBFI04Fonte: PMobFinModParâmetrosVariável
TipoObrigatórioDescrição
cSql
cCodbarCaracterSim
Query padrão do sistemalMultiContractBooleanSimIndica o MultiContrato está habilitadolLoginByCPFBooleanSimIndica se é login por CPFcChaveBeneficiarioCaracterSimChave do beneficiário enviado no JSON de solicitação.RetornoVariávelTipoObrigatórioDescriçãocSqlCaracterSim

Query que será processada

O ponto de entrada PMOBFI05 permite alterar o atributo descricao dos títulos processados:

...

Valor que será apresentado no atributo descricao

Retorne a linha digitável


11. API BOLETO PDF - boletoPdf


URLhttps://<url>:<porta>/rest/mobileSaude/v1/boletoPdf

Esta API retorna o PDF referente ao boleto de uma fatura. O boleto pode ser disponibilizado de duas maneiras: informando uma URL para download do arquivo PDF ou codificado em Base 64 através do JSON de resposta. O campo Modo PDF (BA0_MSPDFM) indica o modo que o arquivo será disponibilizado.

Caso seja selecionado o modo de download seja via download HTTP, a URL onde os arquivos PDF´s são disponibilizados devem ser informados no campo URL PDF (BA0_MSPDFU)

Importante: para disponibilizar o download via HTTP é necessário configurar o Portal/Webservice no INI do ambiente. Mais informações de como configurar o ambiente podem ser encontradas neste link: Configurar Portais e Webservices. A recomendação é gerar os arquivos PDFs na pasta \web\pp\imagens-pls\relatorios dentro de seu rootpath.

O Plano de Saúde SIGAPLS, tem um modelo básico de PDF para o boleto. Caso deseje customizar o PDF, a customização pode ser realizada através do ponto de entrada PL580BOL.

Documentação técnica do Ponto de Entrada: TVBPA7_DT_Ponto_de_Entrada_PL580BOL

11. API DETALHE DÉBITO - detalheDebito

URLhttps://<url>:<porta>/rest/mobileSaude/v1/detalheDebito

Esta API retorna os dados detalhados de um título SE1 do beneficiário selecionado.

Bloco de código
titleExemplo do json de solicitação de detalhe de um débitoboleto PDF
linenumberstrue
collapsetrue
{
    "tituloId": 6353,
    "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de resposta com os detalhes de um débitoretorno com a URL para baixar o PDF de Boleto
linenumberstrue
collapsetrue
{
    "status": true,
    "detalhesurl": [
        {
            "situacao": "A",
        "http://spon019400235:87/pp/imagens-pls/relatorios/boletosc006450.pdf",
    "valorbase64": 578,
            "valorAtualizado": [],
            "textoConfirmacao": "",
            "dataVencimento": "2020-06-10",
            "imprimeBoleto": "N",
            "tipoCobranca": "D"
}


12. API EXTRATO FATURA PDF - extratoFaturaPdf


URLhttps://<url>:<porta>/rest/mobileSaude/v1/extratoFaturaPdf

Similar a API de Boletos, esta retorna o PDF referente ao extrato de uma fatura. As recomendações relacionadas a disponibilização do PDF são as mesmas da sessão 12 - API BOLETO PDF - boletoPdf deste documento. 

O Plano de Saúde SIGAPLS, tem um modelo básico de PDF para o extrato. Caso deseje customizar o PDF, a customização pode ser realizada através do ponto de entrada PL580BOL.

Documentação técnica do Ponto de Entrada: TVBPA7_DT_Ponto_de_Entrada_PL580BOL.

Bloco de código
titleExemplo do json de solicitação de extrato PDF
linenumberstrue
collapsetrue
{
	"tituloId": 6353,
     "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de retorno com a URL para baixar o PDF de Extrato
linenumberstrue
collapsetrue
{
    "observacaostatus": ""true,
            "cedenteNomeurl": "OPERADORA 417505http://spon019400235:87/pp/imagens-pls/relatorios/boletosc006560.pdf",
            "linhaDigitavel": "00190500954014481606906809350314337370000000100",
            "dataPagamento": ""
        }
    ]
}

Importante: O atributo linhaDigitavel é obrigatório e deve ser gerado através do ponto de entrada PMOBFI03:

...

Numérico

...

12. API BOLETO PDF - boletoPdf

URLhttps://<url>:<porta>/rest/mobileSaude/v1/boletoPdf

Esta API retorna o PDF referente ao boleto de uma fatura. O boleto pode ser disponibilizado de duas maneiras: informando uma ULR para download do arquivo PDF ou codificado em Base 64 através do JSON de resposta. O campo Modo PDF (BA0_MSPDFM) indica o modo que o arquivo será disponibilizado.

Caso seja selecionado o modo de download seja via download HTTP, a URL onde os arquivos PDF´s são disponibilizados devem ser informados no campo URL PDF (BA0_MSPDFU)

Importante: para disponibilizar o download via HTTP é necessário configurar o Portal/Webservice no INI do ambiente. Mais informações de como configurar o ambiente podem ser encontradas neste link: Configurar Portais e Webservices. A recomendação é gerar os arquivos PDFs na pasta \web\pp\imagens-pls\relatorios dentro de seu rootpath.

O Plano de Saúde SIGAPLS, tem um modelo básico de PDF para o boleto. Caso deseje customizar o PDF, a customização pode ser realizada através do ponto de entrada PL580BOL.

Documentação técnica do Ponto de Entrada: TVBPA7_DT_Ponto_de_Entrada_PL580BOL.

Bloco de código
titleExemplo do json de solicitação de boleto PDF
linenumberstrue
collapsetrue
{
    "tituloId": 6353,
    "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de retorno com a URL para baixar o PDF de Boleto
linenumberstrue
collapsetrue
{
    "status": true,
    "url": "http://spon019400235:87/pp/imagens-pls/relatorios/boletosc006450.pdf",
    "base64": ""
}

13. API EXTRATO FATURA PDF - extratoFaturaPdf

URLhttps://<url>:<porta>/rest/mobileSaude/v1/extratoFaturaPdf

Similar a API de Boletos, esta retorna o PDF referente ao extrato de uma fatura. As recomendações relacionadas a disponibilização do PDF são as mesmas da sessão 12 - API BOLETO PDF - boletoPdf deste documento. 

O Plano de Saúde SIGAPLS, tem um modelo básico de PDF para o extrato. Caso deseje customizar o PDF, a customização pode ser realizada através do ponto de entrada PL580BOL.

Documentação técnica do Ponto de Entrada: TVBPA7_DT_Ponto_de_Entrada_PL580BOL.

Bloco de código
titleExemplo do json de solicitação de extrato PDF
linenumberstrue
collapsetrue
{
	"tituloId": 6353,
     "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de retorno com a URL para baixar o PDF de Extrato
linenumberstrue
collapsetrue
{
    "status": true,
    "url": "http://spon019400235:87/pp/imagens-pls/relatorios/boletosc006560.pdf",
    "base64": ""
}

14. API COMPOSIÇÃO COBRANÇA - composicaoCobranca

URLhttps://<url>:<porta>/rest/mobileSaude/v1/composicaoCobranca

Esta API traz o detalhamento dos valores de uma cobrança. O detalhamento é baseada na tabela BM1 - Composição da Cobrança.

Bloco de código
titleExemplo do json retornando a Composição de Cobrança
linenumberstrue
collapsetrue
{
	"tituloId": 6353,
    "tituloCodigo": "PLS|000000071| |DP "
}
Bloco de código
titleExemplo do json de resposta com a Composição da Cobrança
linenumberstrue
collapsetrue
{
    "status": true,
    "composicao": [
        {
            "eventos": [
                {
                    "valor": 578,
                    "observacao": "1013-PRODUTO COBRANCA RETROATIVA",
                    "codigoVerba": "101",
                    "descricaoVerba": "PRODUTO/PLANO (MENSALIDADE)",
                    "debitoCredito": "D"
                }
            ],
            "valorTotal": 578,
            "nomeBeneficiario": "COBRANCA RETROATIVA",
            "grauDependencia": "T",
            "matriculaBeneficiario": "00018989000001012"
        }
    ]
}

15. MENUS

Adicione os menus abaixo:

...

16. TABELAS UTILIZADAS

  • Dicionário SX2:

...

  • Dicionário SIX:

...

"base64": ""
}



13. MENUS

Adicione os menus abaixo:

MenuNome RotinaFunção
Atualizações / Mobile SaúdeCad. Usuários APIPLSA99C
Atualizações / Mobile SaúdeFuncionalidadesPLSA99D


14. TABELAS UTILIZADAS


  • Dicionário SX2:
X2_CHAVEX2_NOMEX2_MODOX2_MODOUNX2_MODOEMPX2_UNICO
B7XCad Funcional - Mobile SaudeCompartilhadoExclusivoExclusivoB7X_FILIAL + B7X_CODOPE + B7X_CODIGO
B7YUsuarios da API - Mobile SaudeCompartilhadoExclusivoExclusivoB7Y_FILIAL + B7Y_CODOPE + B7Y_CLIID
BJZTokens Conced - Mobile SaudeCompartilhadoExclusivoExclusivoBJZ_FILIAL + BJZ_CODOPE + BJZ_TOKEN
BJVCache Requisic - Mobile SaudeCompartilhadoExclusivoExclusivoBJV_FILIAL + BJV_CODOPE + BJV_LOGIN + BJV_ATIVO


  • Dicionário SIX:
INDICEORDEMCHAVEDESCRICAO
B7X1B7X_FILIAL + B7X_CODOPE + B7X_CODIGOOperadora + Codigo da funcionalidade
B7Y1B7Y_FILIAL + B7Y_CODOPE + B7Y_CLIIDOperadora + Client ID
BJZ1BJZ_FILIAL + BJZ_CODOPE + BJZ_TOKENOperadora + Token
BJZ2BJZ_FILIAL + BJZ_CODOPE + BJZ_CLIID + BJZ_SECRETOperadora + Client ID + Secret Key
BJZ3BJZ_FILIAL + BJZ_CODOPE + BJZ_TOKEN + BJZ_ATIVOOperadora + Token + Ativo
BJV1BJV_FILIAL + BJV_CODOPE + BJV_LOGIN + BJV_ATIVOOperadora +Login + Ativo


  • Dicionário SX3:

Tabela B7X:

X3_CAMPOX3_ORDEMX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
B7X_FILIAL01Caracter80FilialFilial do Sistema@! Não



NãoVisualReal
B7X_CODOPE02Caracter40Codigo OperCódigo Operadora@! SimPlsIntPad()


NãoVisualReal
B7X_CODIGO03Caracter30Cod. FuncCódigo Funcionalidade@! Sim



SimAlterarReal
B7X_DESCRI04Caracter1000DescricaoDescrição@! Sim



SimAlterarReal
B7X_ATIVO05Caracter10AtivoAtivo@! Sim0=Não;1=Sim


SimAlterarReal
B7X_OCULTO06Caracter10Func OcultaFunc Oculta@! Sim0=Não;1=Sim


SimAlterarReal
B7X_MSGBLO07Caracter700Msg BloqueioMsg Bloqueio@! Sim


M->B7X_ATIVO == "0"SimAlterarReal


Tabela B7Y:

X3_CAMPOX3_ORDEMX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
B7Y_FILIAL01Caracter80FilialFilial do Sistema@! Não



NãoVisualReal
B7Y_CODOPE02Caracter40Codigo OperCódigo Operadora@! SimPlsIntPad()


NãoVisualReal
B7Y_USRID03Caracter30Cod. UsuarioCódigo Usuário@! SimGetSx8Num ("B7Y","B7Y_USRID")


SimVisualReal
B7Y_NOME04Caracter1000Nome UsuarioNome Usuário@! Sim



SimAlterarReal
B7Y_DESCRI05Caracter2500Desc UsuarioDescrição do Usuário@! Sim



NãoAlterarReal
B7Y_STATUS06Caracter10AtivoAtivo@! Sim"1"Pertence('01')0=Não;1=Sim
SimAlterarReal
B7Y_CLIID07Caracter1000Cliente IDCliente ID
SimP99CGerCli()


NãoVisualReal
B7Y_SECRET08Caracter 1000Secret KeySecret Key
SimP99CKeyGen(.F.)


NãoVisualReal


Tabela BJZ

  • Dicionário SX3:

Tabela B7X:

X3_CAMPOX3_ORDEMX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
B7X
BJZ_FILIAL01Caracter80FilialFilial do Sistema@! Não



NãoVisualReal
B7X

BJZ_CODOPE02Caracter40Codigo OperCódigo Operadora@! SimPlsIntPad()


NãoVisualReal
B7X

BJZ_
CODIGO
TOKEN03
03Caracter30Cod. FuncCódigo Funcionalidade@! SimSimAlterarRealB7X_DESCRI04
Caracter1000
Descricao
Token Gerado
Descrição
Token Gerado@! Sim
Sim




NãoAlterarReal
B7X

BJZ_ATIVO
05
04Caracter10AtivoAtivo
@! Sim0=Não;1=SimSimAlterarRealB7X_OCULTO06Caracter10Func OcultaFunc Oculta@! Sim0=Não;1=SimSimAlterarRealB7X_MSGBLO07Caracter700Msg BloqueioMsg Bloqueio
@! Sim
M->B7X_ATIVO == "0"


0=Não;1=Sim
Não
Sim
AlterarReal

Tabela B7Y:

...


BJZ_DATBLO05Data80Data BloquData Bloqueio
Sim



NãoAlterarReal
BJZ_CLIID06Caracter1000Client IDClient ID@! Sim



NãoAlterarReal
BJZ_SECRET07Caracter1000Secret KeySecret Key@! Sim



NãoAlterarReal
BJZ_DTEXPI08Data80Data ExpiraData Expiracao
Sim



NãoAlterarReal
BJZ_HREXPI09Caracter50Hora ExpirHora Expiracao@! Sim



NãoAlterarReal


Tabela BJV:

X3_CAMPOX3_ORDEMX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BJV_FILIAL01Caracter80FilialFilial do Sistema@! Não



NãoVisualReal
BJV_CODOPE02Caracter40Codigo OperCódigo Operadora@! SimPlsIntPad()


NãoVisualReal
BJV_LOGIN03Caracter500LoginLogin@! Sim



NãoAlterarReal
BJV_DTVALI04Data80Data ValidData Validade
Sim



NãoAlterarReal
BJV_HRVALI05Caracter50Hora ValidHora Validade@! Sim



NãoAlterarReal
BJV_ATIVO06Caracter10AtivoAtivo@! Sim

0=Não;1=Sim
NãoAlterarReal
BJV_CACHE07Memo100CacheCache
Sim



NãoAlterarReal


Tabela BA0:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3X3_FOLDER
BA0_MSTLOGCaracter10Mobile LoginMobile Login@! Não'1'Pertence('12')1=CPF;2=Matricula
NãoAlterarReal
4
BA0_MSMULTCaracter10MulticontratMobile Multicontrato@! Sim'1'Pertence('01')0=Não;1=Sim
NãoAlterarReal
4
BA0_MSCACHCaracter10Mobile CacheMobile Cache@! Sim'1'Pertence('01')0=Não;1=Sim
NãoAlterarReal
4
BA0_MSCONJCaracter10Cod ConjugeCódigo Cônjuge Mobile

...

Tabela BJZ:

Hora Expiracao
X3_CAMPOX3_ORDEMX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BJZ_FILIAL01Caracter80FilialFilial do Sistema@! NãoNãoVisualRealBJZ_CODOPE02Caracter40Codigo OperCódigo Operadora@! SimPlsIntPad()NãoVisualRealBJZ_TOKEN03Caracter1000Token GeradoToken Gerado@! SimNãoAlterarRealBJZ_ATIVO04Caracter10AtivoAtivo@! Sim0=Não;1=SimNãoAlterarRealBJZ_DATBLO05Data80Data BloquData BloqueioSimNãoAlterarRealBJZ_CLIID06Caracter1000Client IDClient ID@! SimNãoAlterarRealBJZ_SECRET07Caracter1000Secret KeySecret Key@! SimNãoAlterarRealBJZ_DTEXPI08Data80Data ExpiraData ExpiracaoSimNãoAlterarRealBJZ_HREXPI09Caracter50Hora Expir@! Sim



NãoAlterarReal

Tabela BJV:

...

Tabela BA0:

...

B37PLS4
BA0_MSCONTCaracter10Contato TitContato Titular@! Sim'0'Pertence('01')0=Não;1=Sim
NãoAlterarReal
4
BA0_MSENDCaracter10Ender TitEndereço Titular@! Sim'0'Pertence('01')0=Não;1=Sim
NãoAlterarReal
4
BA0_MSDEPECaracter10Impr DependImprime Dependentes@! Sim'0'Pertence('01')0=Não;1=Sim
NãoAlterarReal
4
BA0_MSEXPBCaracter10Exc Pag BloqExclui Pagam. Bloqueado@! Sim'1'Pertence('01')0=Não;1=Sim

AlterarReal
4
BA0_MSTPAGCaracter10Exib Tit PagExibe Títulos Pagos@! Sim'1'Pertence('01')0=Não;1=Sim

AlterarReal
4
BA0_MSPDFMCaracter10Modo PDFModo PDF@! Sim
Pertence('12')1=URL;2=Base 64

AlterarReal
4
BA0_MSPDFUCaracter2540URL PDFURL PDF@! Sim


M->BA0_MSPDFM == '1'
AlterarReal
4
BA0_MSACESCaracter60Acess PortalAcess Portal@! Sim
Vazio() .Or. ExistCpo("AI3",M->BA0_MSACES)


AlterarRealAI34
BA0_MSPERFCaracter60Perf. AcessoPerf. Acesso@! Sim
Vazio() .Or. ExistCpo("B7I",M->BA0_MSPERF)


AlterarRealBA0B7I4
BA0_MSGUIANumérico20Qt. Meses G.Quantidade de Meses Guia99Sim



NãoAlterarReal
4
BA0_MSDECLNumérico20Qt. Anos DecQuantidade Anos Declarac.99Sim



NãoAlterarReal
4
BA0_MSDECDCaracter10List. Decla.Lista de Declaracoes@! Sim

0=Ambas;1=Imposto de Renda;2=Carta de Quitação
NãoAlterarReal
4
BA0_MSUNDOCaracter2540URL DocumentURL Documento @!Sim



NãoAlterarReal
4
BA0_MSURSTCaracter2540URL StatusEndpoint Atualiza Status@!Sim



NãoAlterarReal
4


Tabela BT6:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BT6_LCVIRTCaracter100Layout CartLayout do Cartão@! Sim



NãoAlterarReal


Tabela BI3:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BI3_LCVIRTCaracter100Layout CartLayout do Cartão@! Sim



NãoAlterarReal


Tabela BQC:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BQC_LCVIRTCaracter100Layout CartLayout do Cartão@! Sim



NãoAlterarReal


Tabela BA3:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BA3_LCVIRTCaracter100Layout CartLayout do Cartão@! Sim



NãoAlterarReal


Tabela BA1

...

Tabela BT6:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BT6
BA1_LCVIRTCaracter100Layout CartLayout do Cartão@! Sim



NãoAlterarReal


Tabela BI3BQL:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BI3
BQL_
LCVIRT
CODMOBCaracter
10
10
Layout CartLayout do Cartão
Cod MobileCódigo Mobile@! Sim
Vazio() .Or. Pertence('123')1=Consignacao / Desconto em folha;2=Boleto;3=Debito em conta
NãoAlterarReal


Tabela BQCBG1:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BQC
BG1_
LCVIRT
LOGINCaracter
10
10
Layout CartLayout do Cartão
Acao LoginAção Login@! Sim

1=Permite login;2=Impede login
NãoAlterarReal


Tabela BA3BG3:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BA3
BG3_
LCVIRT
LOGINCaracter
10
10
Layout CartLayout do Cartão
Acao LoginAção Login@! Sim

1=Permite login;2=Impede login
NãoAlterarReal


Tabela BA1BBA:

X3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3
BA1_LCVIRT
BBA_IDOPERNumérico40Id OperadoraID da Operadora Integ.9999Sim



NãoAlterarReal
BBA_MSHASHCaracter
10
1000
Layout CartLayout do Cartão@! 
HashHash da Solicitação
Sim



NãoAlterarReal

...



  • Dicionário SXB:
X3
XB_
CAMPO
ALIAS
X3
XB_TIPO
X3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICX3_PICTUREX3_USADOX3_RELACAOX3_VALIDX3_CBOXX3_WHENX3_BROWSEX3_VISUALX3_CONTEXTX3_F3BQL_CODMOBCaracter101Cod MobileCódigo Mobile@! SimVazio() .Or. Pertence('123')1=Consignacao / Desconto em folha;2=Boleto;3=Debito em contaNãoAlterarReal
  • Dicionário SX3:

16. TABELAS UTILIZADAS

XB_SEQXB_COLUNAXB_DESCRIXB_CONTEM
BA0B7I101DBPerfis de AcessoB7I
BA0B7I20101Sequencial+Tipo por.
BA0B7I40101SequencialB7I_CODSEQ
BA0B7I40102DescriçãoB7I_DESCRI
BA0B7I501

B7I_CODSEQ
BA0B7I601

B7I->B7I_TIPPOR == "3"


15. IMPLEMENTAÇÃO FUTURA

  • Implementação futura1212



HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>