Roteiro de Configuracao de Web Services e Portal Protheus - ABHIMA
Roteiro de Configuracao de Web Services e Portal Protheus - ABHIMA
Roteiro de Configuracao de Web Services e Portal Protheus - ABHIMA
Ambiente Data da publicao Verses : Planos de Sade : 05/11/04 : Protheus 10 Boletim Data da reviso Pases Bancos de dados : 00003142-07 : 25/09/07 : Brasil : Todos Relacionais
Sistemas operacionais : Windows/Linux Bops Tabelas utilizadas : 00000125669 : QE7, QE8, QEK, QER, QES
Este boletim destina-se aos analistas e tcnicos de infra-estrutura e tem como objetivo estabelecer um roteiro de configurao e de utilizao do Portal Protheus em uma rede corporativa (LAN). Sendo assim, no est vinculado a nenhuma atualizao do Protheus. O Portal Microsiga est disponvel a partir da verso Protheus 10, sendo processado apenas em ambientes que utilizam o TOTVS DBAccess. Importante: Para implementao deste bops imprescindvel que primeiramente o compatibilizador do bops 0000095189 referente a TISS seja executado.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 1
O Web Services utilizado pelo Portal para realizar a interao entre servidores
Ser apresentado a seguir, um roteiro de configurao, de utilizao e habilitao do portal, bem como sobre a infra-estrutura de rede necessria para utilizao do Portal Protheus na internet e um glossrio de termos tcnicos.
Infra-estrutura necessria
Para acessar o Portal Protheus pela Internet, necessrio: Adquirir e registrar um domnio; Exemplo: www.registro.br Possuir dois servidores de DNS, caso no possua, ser necessrio escolher um provedor de hospedagem; Observao: Os servidores de DNS permitem que as demais mquinas conectadas internet consigam acesso ao domnio. Aguardar a confirmao do registro do domnio.
As aplicaes com conectividade na Internet precisam de uma infra-estrutura apropriada e segura. A infra-estrutura do Portal Protheus permite a utilizao de todos os recursos disponveis para segurana de Internet em uso atualmente. Existem dois tipos de seguranas que podem ser adotadas para o Portal Protheus: Segurana Simplificada Segurana Avanada
2 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Domnio prprio apontando para o servidor Web; IP fixo e real; O servidor de Web deve ser separado do servidor Protheus corporativo; O Firewall deve ser implantando antes do servidor Web; Possibilidade de implantao do Portal utilizando um tipo de pgina segura, como por exemplo HTTPS; Ao utilizar o HTTPS, a empresa estar protegendo a: 1 - Garantia de autenticidade da entidade; 2 - Criptografia dos dados entre o cliente e o servidor.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 3
Criao da DMZ - Zona Desmilitarizada; Domnio prprio apontando para o servidor Web; IP Fixo e Real para acessar via Internet; Firewall protegendo a entrada da internet para a DMZ; Firewall protegendo a entrada da DMZ para a rede Corporativa; Criptografia dos dados. Uso de HTTPS tanto para o servidor Web como para o servidor de Web Services.
Tipos de Segurana
Sistmica Infra-estrutura Rede Criptografia de Dados Pontos de Ateno
Sistmica Controle de acesso aos portais por meio de usurios/senha e grupos de acesso; Restrio dos servios e menus que podem ser utilizados; Restrio de quais dados os usurios podem ter acesso (Ex.: Cliente ou Fornecedores).
4 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Infra-estrutura Servidor de Web sem acesso diretamente aos dados; Todos os acessos so feitos por meio do servidor de Web Services que poder estar protegido por um firewall adicional.
Rede Suporte a Firewall (incluindo NAT), tanto entre os servidores Web e o usurio final, como entre os servidores de Web e o servidor de Web Services; Suporte a Proxy autenticados (Ex.: ISA Server, Squid entre outros).
Criptografia de Dados Disponvel entre a comunicao do servidor Web e o servidor de Web Services; Disponvel para ser utilizada entre o servidor Web e o usurio final; Necessita de aquisio de Certificados de Segurana por meio de entidades certificadoras.
Pontos de Ateno
Definio do modelo de segurana a ser seguido de acordo com o tamanho e necessidade do cliente; Ateno especial na definio das regras de acesso (usurio, senha, direitos, etc.).
Licenciamento
Apenas a configurao do Web Services consome licena do tipo Protheus I (Licena exclusiva para o mdulo Web); Em mdia cada 10 usurios conectados no Portal, consumir uma licena no servidor de Web Services; O consumo pode variar de acordo com os usurios e as personalizaes externas. O consumo da banda para acesso est ligado com o design do site, que pode conter textos e imagens.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 5
Procedimento de Configurao
1 passo: Configurao Portais Protheus Web Services
1. No ambiente Configurador, selecione as opes Ambiente/Cadastros/Menus e inclua no menu do ambiente Planos de Sade, a opo de execuo do FATA230 conforme especificaes a seguir: Nome do menu Atualizaes Nome da rotina Web Services
Submenu Portal
Programa FATA230
Tabelas AI7
2. Ainda na opo Menus, inclua no menu do ambiente Planos de Sade, a opo de execuo do FATA220 conforme especificaes a seguir: Nome menu do Nome rotina Direitos da
Submenu Portal
Programa FATA220
Tabelas AI3
Atualizaes
3. Ainda na opo Menus, inclua no menu do ambiente Planos de Sade, a opo de execuo do FATA240 conforme especificaes a seguir: Nome menu do Nome rotina da
Submenu Portal
Programa FATA240
Tabelas AI8
Atualizaes
4. Na opo Menus, inclua no menu do ambiente Planos de Sade, a opo de execuo do PLSA226 conforme especificaes a seguir: Nome menu do Nome rotina Usurios da
Submenu Portal
Programa PLSA226
Tabelas BSW
Atualizaes
6 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
5. No ambiente Configurador, selecione as opes Ambiente/Cadastro/Parmetro e configure o parmetro MV_ PORTAL1 conforme instrues a seguir: Pasta Informaes Parmetro Tipo Contedo MV_PORTAL1 C institucional.txt Pasta Descrio Descrio Informe a localizao, a partir do RootPath do Protheus, onde encontra-se o arquivo com o texto do institucional da Empresa para os portais.
6. Ainda na opo Parmetro, configure o parmetro MV_ PORTAL2 conforme instrues a seguir: Pasta Informaes Parmetro Tipo Contedo
MV_PORTAL2
Descrio
Informe a localizao, a partir do RootPatch do Protheus, do arquivo com o logo da Empresa para apresentao nos portais do sistema.
Importante O parmetro MV_PLSCARD no ser mais utilizado para controlar o uso do carto por meio da WEB. Esta configurao ser feita por meio do campo Tipo Ace. (BSW_TIPCAR) da rotina Usurios (PLSA226);
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 7
aMatrCartao
AaDd(aMatrCartao, SubStr(cMatric,1,17) ) AaDd(aMatrCartao, SubStr(cMatric,17,18) ) AaDd(aMatrCartao, SubStr(cMatric,18,19) ) AaDd(aMatrCartao, SubStr(cMatric,19,20) ) AaDd(aMatrCartao, SubStr(cMatric,20,21) ) AaDd(aMatrCartao, SubStr(cMatric,21,22) ) AaDd(aMatrCartao, SubStr(cMatric,22,23) )
8 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Contem todos os dados do cabealho da guia Contem todos os dados dos itens da guia Se veio de uma importao ou no Qual e o tipo de gravao
Retorna na primeira posio da matriz, sendo uma matriz com o cabealho e na segunda uma matriz com os itens
Observao: Caso o RdMake exista, logo aps o processamento ser exibido no plsxmov.log todos os dados que retornaram pelo ponto de entrada.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 9
10 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Preencha os campos conforme a orientao do help do Assistente de Configurao (tecla [F1]). Observe, porm, o preenchimento dos seguintes campos: Mdulo Web: selecione a opo WS - Protheus 10 Web Service. Habilitar processos na inicializao do Servidor: Selecione a caixa para que os processos sejam inicializados no momento em que o servidor Protheus for carregado.
3. Clique no boto Avanar. Ser apresentada a janela Configurao de Host x Empresas Filiais
4. Preencha os campos dessa janela conforme a orientao do help do Assistente de Configurao (tecla [F1]). Observao Nesta janela, necessrio relacionar o nome do servidor Web/diretrio virtual e as empresas/filiais que iro acess-lo. Exemplos: Ambiente Internet: <www.nomedosite.com.br> Ambiente Intranet: <nomedoservidor> Alm disso, tambm possvel adicionar um diretrio virtual aps o Host separado por barra.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 11
5. Clique no boto Avanar. Ser apresentada a janela Configurao de Usurios para que seja informada a expectativa de usurios que podero acessar o site. Observe:
6. Preencha os campos desta janela conforme a orientao do help do Assistente de Configurao (tecla [F1]). 7. Clique no boto Finalizar para confirmar a configurao.
12 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 13
2. Selecione a pasta Mdulos Web e clique no boto Novo Mdulo. Ser apresentada a janela Configuraes Bsicas do Mdulo.
14 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
3. Preencha os campos conforme a orientao do help do Assistente de Configurao (tecla [F1]). Observe, porm, o preenchimento dos seguintes campos: Mdulo Web: selecione a opo PP - Portal Protheus. URL do Protheus Web Services: deve ser preenchido com a URL utilizada na instalao do mdulo Web Services, precedido por HTTP:// Exemplo: http://<nome do servidor Web> ou <nmero IP>/diretrio virtual (mesmo do Web Services) 4. Clique no boto Avanar. Ser apresentada a janela Configurao de Hosts x Empresas/Filiais.
5. Preencha os campos conforme a orientao do help do Assistente de Configurao (tecla [F1]). Observao: Nesta janela, necessrio relacionar o nome do servidor Web/diretrio virtual e as empresas/filiais que iro acess-lo. Exemplos: Ambiente Internet: <www.nomedosite.com.br> Ambiente Intranet: <nomedoservidor> Alm disso, tambm possvel adicionar um diretrio virtual aps o Host separado por barra.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 15
6. Clique no boto Avanar. Ser apresentada a janela Configurao de usurios para informao da expectativa de usurios que iro acessar o site.
7. Preencha os campos conforme a orientao do help do Assistente de Configurao (tecla [F1]). 8. Clique no boto Finalizar para concluir a configurao do Portal. Importante: a. Aps o trmino da configurao os arquivos de imagens, jspls e estilo devem ser colocados dentro da pasta ..\Web\pp\imagens-pls, localizadas no servidor. b. O arquivo criaobj deve ser colocado na pasta ..\Web\pp localizadas no servidor.
16 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Na janela principal do assistente de configurao, selecione a opo Servidor Internet HTTP/FTP e clique no cone +. A rvore da opo selecionada se expandir e sero apresentadas outras opes.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 17
3. Selecione a opo HTTP e clique no boto Editar Configurao. 4. Ser apresentada a janela Configuraes da Seo
5. Preencha os dados conforme a orientao do help do Assistente de Configurao - (tecla [F1]). 6. Confira os dados e clique no boto Finalizar para confirmar as configuraes.
18 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Procedimentos de implementao
Observao: O compatibilizador U_UPDPLS06 criar automaticamente o menu do portal Plano de Sade. Importante: a. Antes de executar o compatibilizador U_UPDPLS06, imprescindvel que o usurio faa um backup dos seus arquivos de dados (diretrio \PROTHEUS_DATA\DATA, verso 10 e dos arquivos de dados SXs (diretrio\PROTHEUS_DATA\SYSTEM, verso 10). Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados conforme o ambiente de instalao da empresa. b. Essa rotina deve ser executada em modo exclusivo ou seja, nenhum usurio deve estar utilizando o Sistema. c. Realize um backup da base de dados do ambiente, em que o compatibilizador for executado.
d. Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o compatibilizador, certifique-se que esto identificados pelo Nickname. Caso o compatibilizador necessite criar ndices, sero adicionados a partir da ordem original instalada pelo Protheus, o que poder ocasionar a sobre gravao de ndices personalizados caso no estejam identificados pelo Nickname. Ateno! Observe que as tabelas que sero alteradas podem resultar em estouro de espao em disco. Qualquer ajuste que incida alterao em uma tabela no banco de dados criar uma tabela de backup que no ser apagada automaticamente ao finalizar o processo. A tabela de backup mantida por segurana e para possvel conferncia do usurio e no ser apagada. 1. Acesse o Totvs Smart Client e no campo Programa Inicial, digite U_UPDPLS06.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 19
2. Clique sobre o boto OK para continuar. 3. Ao confirmar, ser apresentada uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo exclusivo:
5. Logo aps a confirmao, ser solicitada a confirmao do processo. Clique sobre o boto Sim para executar a atualizao dos dicionrios e da base de dados.
6. Ao confirmar, ser apresentada uma pergunta que indicar qual empresa deve ser ajustada.
20 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
7. Aps atualizar o Sistema, ser apresentada a janela de Atualizao concluda com o histrico (log) de todas as atualizaes processadas conforme seleo do operador. Ressalta-se que neste log somente sero visualizados os campos atualizados pelo programa, se esses campos j existem em seu dicionrio de dados no sero criados pelo programa e no sero apresentados no log da atualizao.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 21
8. 9
Clique sobre o boto Finalizar para sair. Aps concluir o processo de atualizao, acesse o ambiente Planos de Sade.
22 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
1. Acesse o ambiente do Plano de Sade e selecione as opes Atualizaes/Portal/Web Services (FATA230) Ser apresentada a janela Web Services.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 23
2. Clique no boto Automtico. O sistema carregar todos os Web Services que esto no repositrio. Observao: Esta operao pode ser executada vrias vezes, para verificar os Web Services que esto disponveis. 3. Finalizado o processo, clique no boto Sair.
Rotina: Direitos (FATA220) Esta rotina permite a incluso dos usurios e a configurao de seus respectivos direitos de acesso ao portal. 1. No ambiente Plano de Sade, selecione as opes Atualizaes/Portal/Direitos(FATA220) Ser apresentada a janela de manuteno.
24 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 25
3. Preencha somente os dados obrigatrios para identificao do usurio do portal, conforme orientao do help de campo. Observao: Os demais campos no necessitam ser preenchidos, pois no sero utilizados por este portal. 4. Selecione a pasta Direitos e inclua os servios que podero ser utilizados pelo usurio. 5. Clique no boto Carrega Direitos. O sistema carregar todos os servios cadastrados para o usurio. 6. Confira os dados e clique no boto Ok para finalizar.
Rotina: Menu dos Portais (FATA240) Observao: Antes de acessar a rotina do menu dos portais necessrio executar o compatibilizador PORTALUPD, para adequao do processamento da rotina. 1. Acesse o ambiente do Plano de Sade e selecione as opes Atualizaes/Portal/Menu dos Portais (FATA240) Ser apresentada a janela Menu dos Portais.
26 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Selecione o menu desejado e clique no boto Menu. Ser apresentada uma janela com todas as opes do menu.
3. Clique nos botes Incluir, Editar ou Excluir, de acordo com a operao que deseja efetuar. Ser apresentada uma janela para efetuar a operao desejada.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 27
4. Preencha os dados de acordo com orientao do help de campo. Observe, porm, o preenchimento dos seguintes campos: Web Service (AI8_WEBSRV) Informe o nome do WebService para controle da exibio da opo do menu relacionada no portal Observao O controle da exibio da opo do menu realizado em conjunto com a rotina de direitos Rotina (AI8_ROTINA) informe a rotina que ser executada ao selecionar uma opo do menu do portal.
28 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Rotina: Usurio (PLSA226) Esta rotina permite a incluso e configuraes dos usurios que tero acesso ao portal. 1. Selecione as opes Atualizaes/Portal/Usurio(PLSA226); Ser apresentada a janela de manuteno. 2. Selecione o usurio desejado e clique no boto Alterar. Ser apresentada a janela Usurios do Portal Alterar.
3. Altere os dados desejados. Observe, porm o preenchimento do seguinte campo: Acess Portal (BSW_CODACE): - informe/selecione um direito que tenha sido cadastrado anteriormente na rotina de Direitos (FATA220). Tipo Ace. (BSW_TIPCAR): - informe/selecione um tipo de acesso do usurio, sendo: 0-Carto Somente aceita que seja passado o carto magntico do usurio 1-Digitao Somente digitao da matricula do usurio 2-Todos Permite as duas formas, passar o carto ou digitar a matricula. Observao: Ao alterar os dados o sistema solicitar a senha de acesso do usurio. 4. Informe a senha e confirme.. 5. Clique no boto Ok para finalizar.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 29
Rotina: Rda - Cadastro (PLSA360) Esta rotina permite a associao do usurio web rede de atendimento para um local de atendimento 1. Acesse as opes Atualizaes/Rede Atendimento/Rda Cadastro (PLSA360). Ser apresentada a janela de manuteno.
2. Selecione a Rda desejada e clique no boto Complemento. Ser apresentada a janela Rede de Atendimento
30 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
3. Selecione a pasta Local de Atendimento + Acesso Portal. 4. D um duplo clique no browse do folder Acesso Portal. Ser apresentada a janela Acesso Portal Alterar. 5. Preencha os dados conforme orientao do help de campo. Observao: possvel associar um usurio para mais de um local de atendimento ou para mais de um mdico. 6. Clique no boto OK para finalizar.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 31
Procedimento de utilizao
Acesso ao Portal
1. Acesse o navegador de Internet e informe o endereo do portal. Exemplo: http://nome do servidor do portal ou nmero do IP/instncia do portal Ser apresentada a janela de login.
2. Informe o login, a senha de acesso e o tipo de Portal que deseja acessar (Portal PLS). Observao: O parmetro TPACESSO (= 1 desabilita), o qual deve ser incluso no .ini do server do protheus na sesso de configurao da chamada do portal, permitir que o campo Tipo seja omitido, possibilitando que ao efetuar o login, o sistema direcione automaticamente para o Portal PLS.
32 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Observe que neste exemplo o campo Tipo, no est sendo apresentado pelo sistema. Caso seja informado um login e/ou senha invlidos, o sistema apresentar a seguinte mensagem:
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 33
Se houver dvidas ao efetuar o login no portal, clique no cone ?. O sistema apresentar a janela Ajuda. Observe:
34 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
3. Aps efetuar o login com sucesso, ser apresentada a janela de abertura do portal Plano de Sade.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 35
O Portal Plano de Sade permite que sejam realizadas as seguintes operaes: Pr-Atendimento: realiza o pr-atendimento para um paciente. Pacientes: realiza a manuteno do paciente que esta no pr-atendimento Atendimento: realiza o atendimento do paciente em espera Reimpresso de guia: caso seja necessrio imprimir a guia novamente Consulta Solicitao: aps o mdico fazer uma solicitao ser possvel a consulta dos procedimentos. Alterao de senha: altera senha do usurio logado Histrico de Utilizao: mostra o histrico de utilizao do usurio logado Demos. Pagamento: demonstra o pagamento mdico conforme atendimento/faturamento (formato TISS) Analise C. Md.: demonstra a utilizao do mdico atendimento padro TISS Extrato de pagamento: extrato de pagamento mdico conforme atendimento/faturamento Extrato de utilizao: extrato da utilizao do mdico atendimento Opo Logout, retornando direto para a janela de login do usurio do Portal Plano de Sade.
36 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Pr-Atendimento
Para incluir um pr-atendimento para um paciente, siga os procedimentos abaixo: 1. No Portal Plano de Sade selecione as opes Principal/Pr-Atendimento.
Informe a matrcula do usurio do plano de sade ou passe o carto do paciente conforme definido no campo Tipo de Ace. (BSW_TIPCAR) da rotina Usurio (PLSA226). Observao: Para alternar entre um tipo Matrcula e Carto, basta clicar no link Trocar para Carto ou Trocar para Matrcula. Caso tenha sido definido somente um tipo de acesso no ser apresentado o link com a opo de troca do tipo de acesso.
2. Clique no boto confirmar. Observao: Caso seja informada uma matrcula invlida o sistema apresentar a seguinte mensagem:
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 37
4. No campo Prestador, Local de Atendimento e Regime de Atendimento selecione o prestador desejado e clique no boto Incluir O paciente ser mostrado no grid abaixo Observao: Caso haja s um prestador cadastrado na lista, a incluso do pr-atendimento ser realizada automaticamente. 5. Para excluir ou alterar os dados selecione com duplo clique a linha do paciente desejado (no grid) e clique nos botes Alterar ou Excluir.
38 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Pacientes
Para realizar a manuteno do pr-atendimento de um paciente, siga os procedimentos abaixo: 1. Selecione as opes Principal/Pacientes Ser apresentada a janela Pr-Atendimento.
2. Selecione com duplo clique a linha do paciente desejado (no grid) e clique nos botes Alterar ou Excluir. Observao: Essa opo pode ser utilizada nos casos em que houve erro ao cadastrar o pratendimento. Ex: Mdico selecionado errado, paciente desistiu do atendimento, etc.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 39
Atendimento
Esta opo permite que sejam realizados o atendimento de consulta e exames, conforme as opes mostradas no Tipo de Atendimento. 1. Selecione as opes Principal/Atendimento Ser apresentada a janela de atendimento.
2. No campo Tipo de Atendimento selecione o tipo de atendimento que ser realizado. 3. Para concluir o atendimento clique no boto Concluir. 4. Caso queira prosseguir no atendimento, d duplo clique na linha do paciente desejado (no grid) e clique no boto Atendimento O portal apresentar janela de Consulta ou SADT conforme o tipo de atendimento selecionado. 5. Siga os procedimentos do Atendimento de consulta ou Atendimento SADT, conforme a seguir:
40 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Atendimento de consulta
A Guia de Consultas deve ser utilizada exclusivamente na execuo de consultas eletivas sem procedimento e constitui-se no documento padro para solicitao do pagamento. 1. Aps selecionar o tipo de atendimento Consulta na opo Atendimento, ser apresentada a janela Guia de Consulta.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 41
2. Preencha os dados conforme orientaes descritas na tabela a seguir: Dados da autorizao Nm. do Campo 1 2 3 Nome do Campo Registro ANS Nmero da Guia Data de emisso da Guia Descrio Registro na ANS da operadora Obrigatrio Sim Sim Sim
4 5 6 7 8
da
da
Validade da Carteira do beneficirio Nome do beneficirio Nmero do Carto Nacional de Sade do Beneficirio
42 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Cdigo operadora /CNPJ/CPF Nome contratado Cdigo CNES Tipo logradouro Logradouro Nmero Complemento Municpio UF
na
Cdigo na operadora ou CNPJ ou CPF do contratado Nome do contratado Cdigo CNES do prestador contratado
Sim
10 11
do
Sim No
12
de
Tipo de Logradouro conforme tabela de domnio (ANS) Nome do logradouro do endereo do contratado Nmero do endereo do contratado Complemento do endereo do contratado Municpio do contratado Sigla da unidade federativa do contratado Cdigo do municpio da Tabela do IBGE do contratado CEP do contratado
No
13 14 15 16 17
No No No No No
18 19
20
21
Conselho Profissional
Sigla do conselho profissional do executante conforme tabela de domnio (ANS) do Nmero no conselho profissional do executante conforme tabela de domnio (ANS)
Sim
22
Nmero conselho
Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 43
23
UF
Sigla da Unidade Federativa do Conselho Profissional do executante Cdigo da especialidade do contratado conforme tabela de domnio (ANS)
Sim
24
Cdigo CBO-S
No
Hiptese diagnstica: Nesta rea devem ser informadas as hipteses diagnosticas em decorrncia do
atendimento. Os combos dos campos sero alimentados de acordo com a descrio de cada campo. Ao preencher os CIDs ser apresentada uma janela de pesquisa, facilitando o preenchimento dos campos.
25
Tipo de Doena
Tipo
de
No
26
Tempo da doena referido pelo paciente e unidade de tempo: A= anos; M=meses; D=dias
No
27
Indicador Acidente
de
Indica se houve: Acidente de trabalho ou doena relacionada ao trabalho = 0; Acidente de trnsito= 1 Outros acidentes = 2
No
28 29 30 31
Cdigo CID10 do diagnstico principal Cdigo CID10 do segundo diagnstico Cdigo CID10 terceiro diagnstico do
No No No No
44 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
32
Data atendimento
do
Sim
33
Cdigo da Tabela
Cdigo da Tabela utilizada para descrever os procedimentos conforme tabela de domnio (ANS) Cdigo do procedimento realizado Cdigo do consulta: tipo de
Sim
34 35
Sim Sim
Primeira consulta=1 Seguimento=2 Pr-Natal=3 36 Tipo de sada Cdigo do tipo de sada: Retorno= 1 Retorno com SADT= 2 Referncia = 3 Internao = 4 Alta= 5 37 38 Observao Data e assinatura do mdico 39 Data e assinatura do beneficirio /responsvel Observaes Data e assinatura do mdico No No Sim
No
3. Aps preencher todos os dados, clique no boto confirmar. O sistema far o processamento do atendimento, Observe:
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 45
46 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Caso no seja autorizado, o sistema apresentar uma mensagem com as crticas que foram cadastradas no sistema, informando o motivo da no autorizao: Observao: As crticas devem ser cadastradas nos campos Glosa TISS (BCT_GLTISS) e Desc. Glosa (BCT_DESTIS) da rotina Motivos de Criticas (PLSA505), e caso no tenham sido cadastradas sero descritas na seguinte forma: 9999-Cdigo De/Para no cadastrado. O cadastro das crticas deve ser realizado conforme tabela de domnio, encontrada no site da ANS www.ans.gov.br.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 47
4. Clique no boto imprimir. Ser apresentada a janela Comprovante de utilizao de servio (s).
48 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 49
50 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Atendimento de SADT Legenda da Guia de Servio Profissional / Servio Auxiliar Diagnstico e Terapia (SP/SADT)
A Guia de Servios Profissionais / Servio Auxiliar Diagnstico e Terapia (SP/SADT) compreende os processos de autorizao, desde que necessria, e de execuo dos servios. Deve ser utilizada no atendimento a diversos tipos de eventos: remoo, pequena cirurgia, terapias, consulta com procedimentos, exames, atendimento domiciliar, SADT internado ou quimioterapia, radioterapia ou terapia renal substitutiva (TRS). A consulta de referncia (consulta realizada por indicao de outro profissional, para continuidade de tratamento) deve ser preenchida na Guia de SP/SADT. 1. Aps selecionar o tipo de atendimento SADT na opo Atendimentodo portal, ser apresentada a janela Guia de Servios Profissionais / Servio Auxiliar Diagnstico e Terapia (SP/SADT)
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 51
2. Preencha os campos conforme orientaes da tabela a seguir: Dados da autorizao: Ao solicitar um Servio ou OPM ser apresentado o nmero da solicitao no
campo 2, e assim ser possvel a execuo do servio ou da OPM solicitada. Para isto necessrio que no momento da solicitao seja digitado no campo 3 o nmero da Guia Principal e clicar no cone de atualizao a janela para que seja atualizada com os dados para execuo do(s) servio(s) ou OPM(s).
N. do Campo 1 2
Obrigatrio
4 5 6
Sim
8 9 10 11 12
Nmero Carteira Plano Validade Carteira Nome Nmero Carto Nacional Sade
da
Sim Sim
da
Validade da beneficirio
Carteira
do
No Sim No
52 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
13
Cdigo na operadora /CNPJ/CPF Nome do contratado Cdigo CNES Nome do profissional solicitante Conselho profissional Nmero conselho do
Cdigo na operadora ou CNPJ ou CPF do contratado solicitante Nome do contratado solicitante Cdigo CNES solicitante do contratado
Sim
14 15 16
Sim No Obrigatrio apenas quando o campo 14 se referir pessoa jurdica Sim Sim Sim No
17 18 19 20
Sigla do conselho profissional conforme tabela de domnio. Nmero do conselho profissional Sigla da Unidade federativa do Conselho Profissional Cdigo da especialidade conforme tabela de domnio (ANS)
Dados da solicitao / Procedimentos e Exames solicitados / OPM: Nesta rea deve ser informado
o carter da solicitao, o cdigo do Servio ou Opm (por meio do boto de pesquisa do campo 26 ou informando manualmente o cdigo solicitado) e a quantidade de um servio ou procedimento, sendo que o sistema ir sugerir a quantidade1(um), a qual poder ser alterada.
21 22
No Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 53
23
CID10
do
diagnstico
24
Indicao clinica
pelo
25
Cdigo tabela
da
Cdigo da tabela utilizada para descrever os procedimentos solicitados conforme tabela de domnio (ANS) Cdigo do procedimento solicitado Descrio solicitado do procedimento
26 27
No Obrigatrio se pequena cirurgia, terapia, consulta de referncia e alto custo Sim Sim
28 29
um um
30
Sim
31
Sim
54 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
32 33 34 35 36 37 38 39 40
Tipo de logradouro Logradouro Nmero Complemento Municpio UF Cdigo IBGE do municpio CEP Cdigo CNES
Tipo de Logradouro conforme tabela de domnio (ANS) Nome do logradouro Nmero do endereo contratado executante Complemento do endereo contratado executante Municpio executante do do do do
contratado contratado
Sigla da UF executante
Cdigo IBGE do municpio do contratado executante CEP do contratado executante Cdigo CNES executante do contratado
40 a
Cdigo na Operadora / CPF do exec. complementar Nome profissional executante / complementar Conselho profissional
Este campo identifica o profissional executante / complementar em qualquer procedimento no laboratorial Este campo identifica o profissional executante / complementar em qualquer procedimento no laboratorial Sigla do conselho profissional do executante conforme tabela de domnio (ANS)
41
No
42
Obrigatrio quando os campos 30/31 forem pessoa fsica ou quando os campos 40a / 41 forem preenchidos
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 55
43
Nmero Conselho
do
Obrigatrio quando os campos 30/31 forem pessoa fsica ou quando os campos 40a / 41 forem preenchidos
44
UF conselho
Obrigatrio quando os campos 30/31 forem pessoa fsica ou quando os campos 40a /41 forem preenchidos NO
45
Cdigo CBO-S
Cdigo da especialidade do executante conforme tabela de domnio (ANS) Grau de participao do profissional na equipe mdica de acordo com a tabela de domnio (ANS)
45 a
Grau de Participao
Dados do Atendimento: Nesta rea deve ser informado o tipo de atendimento e o tipo de sada
referente ao atendimento.
46
Tipo de atendimento
Cdigo do tipo de atendimento da guia de SP/SADT: Remoo=1 Pequena Cirurgia=2 Terapia=3 Consulta=4 Exame=5 Atendimento Domiciliar=6 SADT Internado=7 Quimioterapia=8 Radioterapia=9 TRS Terapia Renal Substitutiva=10
56 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
47
Indicao Acidente
de
No
48
Tipo de sada
Cdigo do tipo de sada: Retorno= 1 Retorno com SADT= 2 Referncia = 3 Internao = 4 Alta= 5 bito=6
Sim
Consulta de Referncia: Complementa os dados do atendimento. 49 Tipo Doena de Cdigo do Tipo de Doena: Aguda = A Crnica = C 50 Tempo doena referida paciente de pelo Tempo da doena referido pelo paciente e unidade de tempo: A = anos; M = meses; D = dias Procedimentos e exames realizados: Nesta rea deve ser selecionado ou informado manualmente no
campo 55 o cdigo do procedimento que foi previamente solicitado e autorizado. Aps o preenchimento de todos os dados desta rea, clique no boto incluir para que sejam executados os servios ou OPMs.
No
No
51 52 53 54
Data de procedimento
do do do
Sim No No SIM Pelo menos um procedimento deve ser informado SIM Pelo menos um procedimento deve ser informado
Cdigo da tabela utilizada para descrever os procedimentos conforme tabela de domnio (ANS) Cdigo do procedimento realizado
55
Cdigo do procedimento
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 57
56
Descrio do procedimento
Descrio realizado
do
procedimento
57
Quantidade em cobrana de um mesmo servio/procedimento realizado Cdigo da via de acesso nica= U Mesma via=M Diferentes vias= D
58
No
59
Tcnica Utilizada
No
60
% de reduo/ acrscimo no caso de cirurgia mltipla/radiologia de mltiplas reas Valor unitrio em R$ do procedimento/servio realizado Valor total em R$ dos procedimentos/servios realizado Data e assinatura procedimentos em srie. dos
No
61 62 63
No No No
Data e assinatura dos procedimentos em srie. Observao Total Procedimentos Total Taxas e aluguis Total Materiais Total Medicamentos
64 65 66 67 68
Observao Valor em R$ de procedimentos Valor em R$ de taxas e aluguis Valor em R$ de materiais Valor em R$ de medicamentos
No No No No No
69
Total Dirias
Valor em R$ de dirias
No
58 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
70 71
No No
Solicitao dos Servios ou OPM (Dados do Atendimento): 72 73 74 75 76 77 Cdigo Tabela da Cdigo da Tabela de OPM conforme tabela de domnio (ANS) Cdigo da OPM solicitada Descrio OPM solicitada Quantidade de OPM solicitadas Nome do solicitada Fabricante da OPM No No No No No No
Cdigo OPM Descrio OPM Qtde de OPM Fabricante OPM Valor Unitrio(R$)
Solicitao de Servios ou OPM (Dados do Atendimento) 78 79 80 81 82 83 84 85 Cdigo Tabela da Cdigo da Tabela de OPM conforme tabela de domnio (ANS) Cdigo da OPM utilizada Descrio da OPM utilizada Quantidade utilizada de OPM Cdigo de barra identificador da OPM utilizada Valor unitrio em R$ da OPM utilizada Valor total utilizada em R$ da OPM No No No No No No No No
Cdigo OPM Descrio OPM Qtde de OPM Cdigo Barras Valor Unitrio(R$) Valor (R$) Valor OPM (R$) Total Total de
86
No
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 59
87
Data e assinatura do responsvel pela autorizao Data e assinatura do beneficirio ou responsvel Data e assinatura do prestador executante
No
88
No
89
No
Observao: Ao preencher os dados, caso queira cancelar a execuo clique no boto Voltar para retornar para a tela de atendimento 3. Aps preencher todos os dados do atendimento, clique no boto confirmar para finalizar o processo de execuo dos servios ou OPMs. O sistema apresentar uma mensagem de autorizao.
60 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
4. Para impresso do comprovante e necessrio clicar no boto imprimir no final da janela. Observao Esta impresso segue o mesmo padro do comprovante emitido para a guia de consulta. Conforme exemplos anteriores.
Reimpresso de Guias
Opo utilizada para reimprimir um comprovante previamente impresso no atendimento de consulta ou sadt 1. Selecione as opes Principal/Reimpresso de Guias. Ser apresentada a janela Reimpresso de Guias
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 61
2. Preencha os seguintes campos: Matrcula: informe a matricula do usurio. Prestador: selecione o prestador que fez o atendimento. Data da Autorizao: informe a data em que foi autorizado o atendimento. Confira os dados e clique no boto confirmar Ser apresentada uma janela com a guia do atendimento. Conforme imagem abaixo
3. D duplo clique na linha do grid correspondente ao atendimento Ser apresentado o Comprovante de utilizao de servios
62 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Composio da Solicitao
Nesta opo possvel visualizar os procedimentos solicitados para um atendimento. 1. Selecione as opes Principal/Consulta Solicitao Ser apresentada a janela Composio da Solicitao
2. Informe o nmero da solicitao que deseja consultar no campo N da Solicitao. Todos os procedimentos sero exibidos no grid. Observao: O nmero da solicitao fornecido no atendimento de SADT.no campo de nmero 2 no momento do atendimento
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 63
1. No Portal Plano de Sade selecione a opo Manuteno de Usurios/Alterao de Senha. Ser apresentada a janela Manuteno de Usurios
2. Preencha os dados conforme desejado e clique no boto Alterar. Os dados de acesso ao Portal sero alterados.
1. Selecione as opes Manuteno de Usurios/Histrico de Acesso Ser apresentada a janela Histrico de Acesso
64 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Preencha os seguintes campos: Usurio: informe/selecione o cdigo do usurio que deseja consultar/pesquisar. Data De/At: Informe o intervalo de datas que devem ser consideradas na consulta. Hora De/At: Informe o intervalo de horas que devem ser consideradas na consulta
3. Clique no boto Confirmar Ser apresentada a janela com o detalhamento dos acessos do usurio
Demonstrativo de pagamento
Esta opo permite que seja emitido o demonstrativo de pagamento para um determinado prestador conforme atendimento/faturamento. Os Demonstrativos de Pagamento so documentos enviados da operadora para o prestador com a finalidade de fornecer extrato das contas da produo apresentada nas guias em questo.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 65
2. Preencha os parmetros da seguinte forma: Prestador: selecione o prestador para qual deseja emitir o demonstrativo de pagamento. Ano: Informe o ano de competncia que deve ser considerado para emisso do demonstrativo. Ms: informe o ms de competncia que deve ser considerado para emisso do demonstrativo.
3. Confira os parmetros e clique no boto confirmar. Ser exibido o demonstrativo de pagamento para o prestador e data selecionados.
66 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Observao: Na tabela abaixo esto relacionados os campos que so exibidos pelo demonstrativo de pagamento:
Dados da operadora N. do Campo 1 2 3 4 Nome do Campo Registro ANS Nome da operadora CNPJ operadora Nmero do demonstrativo Data emisso do demonstrativo Registro da operadora na ANS Nome da operadora Nmero CNPJ da operadora Nmero identificador demonstrativo do Sim Sim Sim Sim Descrio Obrigatrio
Sim
Dados do prestador 6 Cdigo Prestador / CNPJ / CPF /CNPJ/CPF 7 8 Nome prestador do Nome do prestador Cdigo do Cadastro Nacional de estabelecimentos de sade Sim SIM, se o prestador executante for hospital Cdigo identificador do prestador na operadora ou identificador de pessoa fsica ou pessoa jurdica Sim
Cdigo CNES
Data do pagamento 9 10 Data do pagamento Forma de Pagamento Data para previso do pagamento Indicador da forma pagamento se realizar. 1-Crdito em conta 2- Carteira 3- Boleto bancrio
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 67
Sim o Sim
que
11
Banco
Obrigatrio quando o campo 10 for 1 = Crdito em Conta Obrigatrio quando o campo 10 for 1 = Crdito em Conta No
12
Agncia
13
da /
Nmero da conta corrente na qual o prestador receber a fatura. No caso de pagamentos em cheque informar nmero do mesmo.
Dados do resumo 14 15 Nmero fatura Nmero Lote da do Nmero do documento fiscal Nmero identificador do lote. O lote um nmero que identifica um conjunto de guias para o prestador, enviado por meio das mensagens eletrnicas Operadora. Data de prestador. envio do lote pelo de No Sim
16 17 18 19 20 21 22
Data de envio do lote Nmero protocolo Valor informado Valor processado Valor liberado Valor da glosa Total geral valor informado (R$) do
Valor processado na fatura pela operadora Valor liberado para pagamento pela operadora Valor da glosa Total geral valor informado (R$)
68 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
23
Total geral valor processado (R$) Total geral valor liberado (R$) Total geral glosa (R$) Total valor
Sim
24
Sim
25 26
Total geral glosa (R$) Total valor liberado = Geral valor liberado total geral de glosas sem considerar valores de impostos e demais descontos. Demais descontos ou crditos a serem debitados ou creditados ao valor liberado. Itens devem estar devidamente descritos e valorados linha a linha. Total valor subtrado de todos os descontos. Valor final do demonstrativo.
Sim Sim
27
Sim
28
Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 69
2. Preencha os parmetros da seguinte forma: Prestador: selecione o prestador para qual deseja emitir o demonstrativo de pagamento. Ano: Informe o ano de competncia que deve ser considerado para emisso do demonstrativo. Ms: informe o ms de competncia que deve ser considerado para emisso do demonstrativo.
3. Confira os parmetros e clique no boto confirmar. Ser exibido o demonstrativo de pagamento para o prestador e data selecionado.
4. Clique no boto Imprimir para confirmar a impresso. Observao: Na tabela abaixo esto relacionados os campos que so exibidos pelo demonstrativo de pagamento.
70 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Dados da operadora N. do Campo 1 2 3 4 Nome do Campo Registro ANS Nome da operadora CNPJ operadora Nmero do demonstrativo Data emisso do demonstrativo Registro da operadora na ANS Nome da operadora Nmero CNPJ da operadora Nmero identificador demonstrativo do Sim Sim Sim Sim Descrio Obrigatrio
Sim
Dados do prestador 6 Cdigo Prestador / CNPJ / CPF* Nome prestador do Cdigo identificador do prestador na operadora CNPJ do prestador Nome da operadora Cdigo do Cadastro Nacional de estabelecimentos de sade do prestador Sim
7 8
Cdigo CNES
Dados do lote 9 10 11 Nmero fatura Nmero Lote da do Nmero identificador das faturas que compem o lote Nmero do lote processado Data em que o lote foi enviado operadora No Sim Sim
12 13
do
de
Sim Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 71
14 15
Valor total da glosa do protocolo Cdigo de glosa de protocolo. Aceita N valores para um mesmo protocolo. Nmero identificador das guias que compem o lote Nome do beneficirio dos servios prestados Cdigo identificador do beneficirio na operadora Data de realizao do servio Descrio do servio realizado Cdigo identificador da tabela de valorao Cdigo identificador realizado do servio
Sim No
16
Sim
17 18
No Sim
19 20 21 22 23 24 25 26
Data realizao Descrio do servio Cdigo Tabela Cdigo Servio Grau de participao Qtde executa Valor processado Valor liberado
Cdigo da posio do profissional na equipe Quantidade executada do servio Valor usado como base para o processamento de valores Valor liberado pagamento pela impostos previsto operadora para sem
27 28 29
Valor glosado pela operadora Cdigo da glosa (N valores para um mesmo procedimento) Valor total usado como base para o processamento de valores na guia
Sim No Sim
72 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
30
Valor total previsto para pagamento pela operadora nesta guia sem impostos Valor total glosada pela operadora na guia Cdigo de glosa de guia (N valores para uma mesma guia) Valor total usado como base para o processamento de valores na fatura Valor total previsto para pagamento pela operadora na fatura sem impostos Valor total glosado pela operadora no lote Valor total do Demonstrativo usado como base para o processamento de valores da fatura Valor total do Demonstrativo liberado para pagamento pela operadora no lote sem impostos Valor total do Demonstrativo glosado pela operadora no lote
Sim
31 32 33
No No Sim
Cdigo Glosa Guia Valor processado fatura Valor liberado fatura Valor fatura glosa
34
Sim
35 36
No Sim
37
Sim
38
Valor geral
glosa
No
Extrato de Pagamento
Esta opo permite que seja exibido o extrato de pagamento para um determinado tipo de prestador e autorizao conforme atendimento/faturamento. Selecione as opes Relatrio/Extrato de Pagamento. Ser apresentada a janela de parmetros.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 73
1. Preencha os parmetros da seguinte forma: Prestador: selecione o prestador para qual deseja emitir o extrato de pagamento. Data De/ Data At:: Informe o perodo de competncia que deve ser considerado para emisso do extrato. Guia: informe o tipo de guia que deve ser considerado para emisso do extrato. Autorizao: informe o tipo de autorizao que deve ser considerado para emisso do extrato.
2. Confira os parmetros e clique no boto confirmar. Ser exibido o extrato de pagamento conforme os parmetros informados.
3. Clique no boto Imprimir para confirmar a impresso. Observao: O formato de impresso deste extrato no segue a regra TISS.
74 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Extrato de Utilizao
Esta opo lista todos os atendimentos efetuados pelo prestador. 1. Selecione as opes Relatrio/Extrato de Utilizao. Ser apresentada a janela de parmetros.
2. Preencha os parmetros da seguinte forma: Prestador: selecione o prestador para qual deseja emitir o extrato de pagamento. Data De/ Data At: Informe o perodo de competncia que deve ser considerado para emisso do extrato. Guia: informe o tipo de guia que deve ser considerado para emisso do extrato. Autorizao: informe o tipo de autorizao que deve ser considerado para emisso do extrato.
3. Confira os parmetros e clique no boto confirmar. Ser exibido o extrato de pagamento conforme os parmetros informados.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 75
2. Alterao da tabela no SX7 (Gatinhos): Campo Regra Domnio BE2_CODPRO BR8->BR8_TPPROC BE2_TPPROC
76 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
3. Alterao da tabela no SX7 (Gatinhos): Campo Regra Dominio BEJ_CODPRO BR8->BR8_TPPROC BEJ_TPPROC
4. Alterao da tabela no SX7 (Gatinhos): Campo Regra Dominio BQV_CODPRO BR8->BR8_TPPROC BQV_TPPROC
5. Criao de campos no SX3 (Dicionrio de Dados Campos da tabela): Campo Valid BSW_LOGUSR ExistChav("BSW",M->BSW_LOGUSR,1)
Campo Valid
BSW_SENHA ExistChav("BSW",M->BSW_LOGUSR+M>BSW_SENHA,3)
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 77
78 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 79
80 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 81
Campo Tamanho
BE4_NRDCNV 15
82 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 83
84 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 85
86 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 87
88 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 89
Campo Tamanho
B01_NUMIMP 20
Campo Tamanho
BD5_NUMIMP 20
Campo Tamanho
BD6_NUMIMP 20
Campo Tamanho
BD7_NUMIMP 20
90 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Campo Tamanho
BE4_NUMIMP 20
Campo Tamanho
BEA_NUMIMP 20
Campo Tamanho
BEF_NUMIMP 20
6. Alterao da tabela no SIX (ndices): Tabela Ordem Chave Descrio BSA 2 BSA_FILIAL+BSA_CONTEU Filial + Contedo
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 91
BZI 2 BZI_FILIAL + BZI_CODINT + BZI_CODEMP + BZI_MATRIC + BZI_TIPREG + BZI_DIGITO + BZI_CODUSR + BZI_HORTER Oper. X Usr. + Empresa + Matricula + Tp. Reg + Dig + H Ter + Cod. Usu
92 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
BEA G BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_LOTGUI Operadorda Rda + Cdigo Rda + Lote Guia
BEA H BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_NUMIMP Operadora Rda + Cdigo Rda + Numero Impresso
BE4 B BE4_FILIAL + BE4_OPERDA + BE4_CODRDA + BE4_LOTGUI Operadora Rda + Cdigo Rda + Lote Guia
BB8 4 BB8_FILIAL + BB8_TIPLOG + BB8_CEP + BB8_NR_END + BB8_EST Tip. Logra + Cep + Numero + Estado
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 93
UPDATE BE4??? SET BE4_BAIPES = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 10 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_PARCES = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 11 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_PATNOR = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 12 AND D_E_L_E_T_ = ' ' UPDATE BQV??? SET BQV_DATPRO = BQV_DTENTR WHERE BQV_FILIAL = ' ' AND D_E_L_E_T_ = ' ' UPDATE BQV??? SET BQV_HORPRO = BQV_HRENTR WHERE BQV_FILIAL = ' ' AND D_E_L_E_T_ = ' '
Glossrio
DNS (Domain Name System) - converte nomes Internet em seus nmeros correspondentes e vice-versa. Originalmente, os computadores da Internet eram identificados apenas por nmeros, como 200.252.269.1, porm o DNS permitiu dar nomes aos computadores, como www.microsiga.com.br.
Domnio: um nome que serve para localizar e identificar conjuntos de computadores na Internet. O nome do domnio foi concebido com o objetivo de facilitar a memorizao dos endereos de computadores na Internet. O domnio sempre o nome que aparece direita do smbolo @ (arroba), num endereo eletrnico, e logo em seguida da expresso www.
Environment: Contm informaes dos diretrios de execuo do Protheus 10 Server, as informaes do idioma, interface, diretrios e repositrios e, opcionalmente, as informaes para acesso ao TOTVS DBAccess
Firewall Traduo: parede de fogo ou parede corta-fogo - barreira de segurana (na Internet) que isola partes da rede. Designativo de sistemas de segurana (combinao de programas e equipamentos) criados para proteo de mensagens e transaes, implementados por meio de filtragem da criptografia dos dados em programa de servios pela rede Internet, incluindo variados tipos de controle por software ou hardware, mais especificamente, um dispositivo de hardware dotado de duas placas de rede (uma ligada rede corporativa e outra Internet) rodando software especfico de anlise e roteamento de pacotes de dados; como todo pacote enviado de uma rede para outra passa obrigatoriamente pelo sistema, o firewall tem a oportunidade de analis-lo, determinando se ele representa algum risco e, em caso positivo, descartando-o antes que alcance seu destino.
FTP (File Transfer Protocol): um servio de Internet, cuja finalidade permitir a transferncia de arquivos de qualquer tipo entre dois computadores. Normalmente usado para transferir programas, textos, imagens, etc. de um computador central (servidor) para um usurio remoto (cliente) ou vice-versa. Para acessar um servidor FTP necessrio estar cadastrado como usurio deste, e ter, portanto, um nome de acesso e uma senha (FTP real). Entretanto, h um tipo especial de servidor FTP que permite acesso pblico, sem senhas especiais (FTP annimo).
94 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
HTTP (Hyper Text Transfer Protocol): o protocolo pelo qual o browser e os sites na Internet se comunicam, ou seja, o protocolo que diz ao servidor para mandar pginas da World Wide Web para seu micro. Sempre quando vamos visitar algum site, comeamos pelo endereo com http, esta sigla informa ao computador que este o protocolo que vai definir como os servidores devem transferir entre si comandos ou informaes relativos ao www.
Host: um Hospedeiro, ou seja, um computador servidor designado para hospedar e fornecer pginas HTML, arquivos de execuo e de contedo, banco de dados, e outros fluxos de dados e servios de busca. Tambm pode ser chamado de computador central. o servidor, tambm chamado de n.
IP (Internet Protocol): o protocolo da Internet, que identifica, localiza e estabelece conexo entre computadores ligados na rede corporativa na Internet.
Instncia: Nome utilizado para individualizar as configuraes das instalaes do mdulo Web, assim, se a empresa necessita aplicar diferentes configuraes para um mesmo mdulo Web, possvel instal-lo sob uma nova instncia.
Proxy - Um servidor proxy um programa que armazena localmente objetos Internet para posterior distribuio. Objetos Internet podem ser pginas web, imagens, arquivos de som, programas, etc. Um browser web pode ser configurado para funcionar via servidor proxy. Quando configurado deste modo, sempre que o usurio solicitar um objeto (clicando em um link), o browser ir verificar se este objeto existe no servidor proxy. Se existir, o receber diretamente deste, sem a necessidade de solicit-lo na origem, que pode ser uma conexo lenta. Se no existir, o prprio servidor proxy se encarregar de obt-lo na origem, repassandoo ao usurio e simultaneamente gravando-o. Deste modo, quando um outro usurio solicitar este mesmo objeto, este j estar disponvel no servidor proxy. A grande vantagem do uso de servidores proxy que o browser tende a ficar muito mais rpido, pois muitos objetos (incluindo pginas e as imagens das pginas) que originalmente so acessados por uma conexo internacional, ou congestionada, passam a ser transmitidos por uma conexo local.
RootPath: Indica o diretrio raiz do Protheus 10, a partir do qual todos os diretrios utilizados pelo Protheus sero criados.
URL (Uniform Resource Locator): Padro de endereamento da web. Permite que cada servio/arquivo na Internet tenha um endereo prprio, que consiste de seu nome, diretrio, mquina onde est armazenado e por qual protocolo deve ser transmitido. Por exemplo: http://www.exemplo.com.br
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 95
Web ou WWW: uma simplificao do termo World Wide Web (WWW) que significa Teia de Alcance Mundial, sendo o mais popular dos servios de Internet, porque permite a obteno rpida e fcil de informaes sobre os mais variados assuntos, com imagens e textos, usando um sistema de hipertextos de alcance mundial. Os recursos disponveis no ambiente WWW so referenciados por um tipo especial de endereo, chamado URL.
Web Service: Um web service a maneira prtica e eficaz de comunicao via internet dos aplicativos. Surgiu por um consrcio de empresas lideradas pela Microsoft e IBM, e hoje se tornou um padro do W3C (WorldWide Web Consortium) Os Web Services servem para quase todos os tipos de dados e informaes. Como ele baseado no protocolo SOAP (Simple Object Access Protocol), qualquer plataforma que interprete rotinas HTTP e manipule XML pode utilizar os dados dos web services sem qualquer problema. Como quase sempre os web services utilizam o protocolo HTTP, quase nunca haver surpresas com Firewall quando sua aplicao sair do servidor de aplicao para a verso final do cliente. A Vantagem do web services que todos os dados so trafegados em formato XML. Assim, todos os dados possuem <tags> e isso faz com que tenham consistncia, sem falhas, permitindo a troca de dados mais robustos como Arrays. Alm disso, por trafegar em XML, ele multi-plataforma.
96 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus