Produto:

TOTVS - Gestão de Planos de Saúde

Ocorrência:

Como configurar a emissão de boletos no A500

Passo a passo:

Boletos – A500

A partir da versão 12.1.4 foi implementado na geração do A500,o projeto de impressão de boletos de cobrança, podendo iniciar a geração de suas faturas a partir do Gestão de Planos, sendo utilizadas para pagamento por seus contratantes. Para o funcionamento deste, são necessárias algumas configurações que serão detalhadas neste documento.

Este é um material de apoio que deve ser utilizado em conjunto com o Boletim Técnico expedido para a implementação de Boletos:

GPS0030_HRC_Exportacao_A500_Boletos_Boletim_Tecnico

1. Menus
Deve-se proceder com a atualização de menus, através da importação do arquivo “men_hfp.d”.

2. Manutenção Parâmetros Globais Sistema (PR1410P)
Verificar se o caminho informado na variável “Endereço serviço Jboss” está informado correto.

Importante:

1 - Eleger um diretório compartilhado no servidor da operadora e compartilhar na rede para os usuários. Ou seja, todos os usuários e servidor devem ter acesso e permissão de controle total do diretório.
2 - Na variável “Diretório Relatórios” informar a pasta compartilhada para o repositório do arquivo. É importante que este diretório seja parametrizado de acordo com o sistema operacional utilizado pelo servidor onde o AppServer é executado.
Exemplo: Supondo que a pasta temporária definida seja “C:\temp” de um servidor chamado “londres”. Caso o servidor que esteja executando o JBoss tem instalado o Windows, a configuração ficará “\\londres\temp”. Caso o servidor que esteja executando o JBoss tem instalado o Linux, a configuração ficará “/mnt/temp”.

2.1 Propriedades do Servidor
É necessário parametrizar as variáveis abaixo no datasul_framework.properties dentro da pasta “<Caminho-do-JBoss>\server\<instância>\conf\datasul\datasul_framework.properties.”
O arquivo datasul_framework.properties deve conter as variáveis de SSO conforme imagem abaixo:

Caso não contenha pode copiar a informação abaixo, porém lembre-se de ajustar os endereços e credenciais
#+----------------------------------------------------------+
#| CONFIGURACOES SSO                                                                                                                                                         
#+----------------------------------------------------------+
sso.java.naming.factory.initial=com.datasul.framework.sso.SSOLoginInitialContextFactory
sso.java.naming.provider.url=cordas.jv01.local:1099
sso.java.naming.security.principal=super
sso.java.naming.security.credentials=super
sso.java.naming.security.protocol=josso

Configurar o diretório compartilhado de repositório do arquivo.

Dois fatores importantes neste cadastro:

1 ) O diretório parametrizado para o shared.dir do datasul_framework.properties e o Diretório Relatórios parametrizado no PR1410P deverão apontar para a mesma pasta/diretório.

2) Observar se o report.dir está parametrizado corretamente no .properties, este diretório deve ser diferente do shared.dir. Recomenda-se utilizar report.dir=${war.dir}

Após efetuar as parametrizações do arquivo Datasul.framework.properties reiniciar o sistema. Executar as configurações abaixo para funcionar o boleto.
Para saber se o WebService está ativo e respondendo pode acessar a seguinte URL:
http://<SERVIDOR_DO_TOTVS11>:<PORTA>/healthmanagementwebservices/HealthManagementService?wsdl

Exemplo:
http://cordas.jv01.local:8080/healthmanagementwebservices/HealthManagementService?wsdl

Ao acessar esse link, deve exibir algo como:

Ao efetuar a parametrização nos parâmetros globais, configurar o layout do boleto.

Importante:
                Para configuração da sso.java.naming.provider.url  no arquivo datasul_framework.properties.
                Deverá ser preenchido com o caminho do Jboss e a porta que está parametrizada na tag service-config, quando name="jboss:service=Naming", no arquivo ports-bindings.xml que está presente no diretório binding da raiz do diretório do Jboss.

Em destaque diretório raiz do Jboss.

Em destaque a pasta binding

Em destaque o arquivo ports-dindings.xml

Em destaque, tag e porta correta.

3. Cadastro de Layout – Boleto

Deixa marcado o parâmetro “Utilizar este layout para a geração do PTU” para gerar o arquivo do A500.
Obs: O arquivo de “layoutParametrizacaoBoleto.xml” encontra-se dentro da pasta LAP do servidor, não é obrigatório carregar o arquivo pdf, somente o XML. 

Melhoria Implementada a partir da mídia 12.1.7:
Importante: Antes de executar a atualização é recomendável realizar o backup do banco de dados bem como dos arquivos do Sistema (executáveis,.dlls e arquivos de configuração).Realizar a atualização antes no ambiente de homologação e posterior a devida validação, no ambiente de produção.

1. Em "Manutenção Parâmetros Globais do Sistema PR1410P " foram reorganizadas as parametrizações de "Endereço do Serviço do JBOSS" e "Diretório Temporário de Relatório", de maneira que ambas sejam solicitadas em uma mesma tela:

2. A partir da informação do "Endereço Serviço Jboss" o sistema realizará a validação de comunicação com o Webservice informado (evitando divergências na geração de relatórios e demais processos que necessitam destes serviços), exibindo inconsistência e não prosseguindo no cadastro em caso de parametrização incorreta:

3. Com o endereço do serviço informado, o sistema buscará a informação do diretório configurado no "jboss" como "shared.dir" e exibirá no campo "Dir. Config Jboss". Esta informação será importante na configuração dos demais campos solicitados.

4. Serão habilitados os campos "Dir. Comp. Servidor (Windows)" e "Dir. Comp.Servidor (Linux)", que substituem o campo "Diretório Temporário de Relatório" com a informação do campo "Dir. Config Jboss" (shared.dir do jboss), conforme a nomenclatura utilizada para acessar o diretório pelo "Windows" e pelo "Linux", dessa forma garante que não ocorrerão incompatibilidades para geração de relatórios, boletos e uploads de arquivos através de processos que executam estas ações através de client e appserver com sistemas operacionais diferentes.
5. Quando a operadora não possuir sistema operacional linux, não é necessário a configuração do campo.
6. Ao término da configuração do diretório Windows e Linux o sistema realizará a validação do mesmo, através de chamada dos webservices correspondentes e retornarão inconsistência caso a configuração esteja incorreta:
7. A imagem abaixo apresenta inconsistência ao informar um diretório incorreto.

8. A imagem abaixo apresenta a mensagem exibida caso a informação de caminho é diferente ao parametrizado no jboss.

9. A imagem abaixo apresenta a mensagem exibida caso o diretório está sem permissão de escrita.