Você está na página 1de 96

Roteiro de Configurao de Web Services e Portal Protheus

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.

Funo do Portal Protheus via Web Services


O Portal Protheus disponibiliza servios na Web para agilizar e facilitar o compartilhamento de informaes entre seus clientes, fornecedores, parceiros, usurios internos e externos, sendo que, toda comunicao entre os servidores Web e os servidores Corporativos so efetuadas por meio de Web Services. Observe:

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

Segurana Simplificada Requisitos

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

Segurana Avanada - Requisitos

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

Menu dos Portais

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

C Logoinst.gif Pasta Descrio

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

Ponto de entrada para leitura do carto do usurio.


PLSCARD Este ponto de entrada permite que sejam tratadas as informaes das trilhas das carteirinhas, caso a operadora tenha um formato especifico Especificaes do Ponto de Entrada: PLSCARD (cTrilha) --> aMatrCartao Ponto de Chamada: Este ponto de entrada ser utilizado no momento da leitura do carto de identificao do usurio no ato das solicitaes. Parmetros: cTrilha Retorno: Ser tratada a trilha recebida e retornada conforme uma matriz cNumCartao := aMatrCartao[1] - Numero do Carto cNomeCartao := aMatrCartao[2] - Nome do Usurio do Carto cViaCartao := aMatrCartao[3] - Via do Carto cDtValid := aMatrCartao[4] - Data de Validade cLocalCob := aMatrCartao[5] - Local de Cobrana cProduto := aMatrCartao[6] - Produto cAbrange := aMatrCartao[7] - Abrangncia cNatJuri := aMatrCartao[8] - Natureza Jurdica cMsgErro := aMatrCartao[9] - Mensagem de Erro Contedo da leitura do carto

aMatrCartao

Exemplo: User Function PLSCARD


LOCAL cTrilha LOCAL aMatrCartao := AllTrim(paramixb[1]) := {}

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

AaDd(aMatrCartao, SubStr(cMatric,23,24) ) AaDd(aMatrCartao, SubStr(cMatric,24,25) ) AaDd(aMatrCartao, SubStr(cMatric,25,26) ) // // Fim da Rotina // Return(aMatrCartao)

Ponto de entrada para tratamento do processamento de guia.


PLSXMVPR Este ponto de entrada permite que sejam tratadas todas as informaes do cabealho e dos itens da guia que ser processada Especificaes do Ponto de Entrada: PLSXMVPR (aDados,aItens,lImpXml,cTipGrv) --> aRetpro Ponto de Chamada: Este ponto de entrada ser utilizado no momento do processamento da guia no portal e na importao XML. Parmetros: aDados aItens limpXml cTipoGrv Retorno: aRetPto Exemplo: User Function PLSXMVPR
LOCAL aDad:= paramixb[1] LOCAL aIte= paramixb[2] Return( {aDad, aIte} )

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

2 passo: Habilitar os Web Services


Para habilitar o Web Service utilizado pelos servios disponibilizados no Portal, siga os procedimentos abaixo: 1. Na janela principal do Assistente de Configuraes, selecione a pasta Mdulos Web e clique no boto Novo Mdulo.

Ser apresentada a janela Configuraes Bsicas do Mdulo.

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.

3 passo: Verificar as configuraes de HTTP e Web Services


Verifique, se os Web Services foram devidamente instalados, conforme instrues a seguir 1. Inicie o Totvs Application Server. 2. Inicie o navegador de Internet e informe o endereo do servidor de Web Services, conforme exemplo abaixo: http://<nome do servidor Web> ou <nmero do IP>/<diretrio virtual>

12 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

3. Verifique as configuraes e finalize o navegador.

4 passo: Configurar o acesso ao Portal


Com o mdulo Web Services instalado, instale o mdulo do portal, conforme os procedimentos a seguir: 1. Para iniciar o Assistente de Configurao do Servidor (SmartClient), acesse o menu Iniciar do Windows e selecione as opes Protheus 10/Ferramentas/Assistente de Configurao do Servidor. Ser apresentada a janela Assistente de Configuraes http

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

5 passo: Habilitar o servio HTTP


A habilitao do servio de HTTP necessria para a instalao do mdulo Web. Durante a instalao de um mdulo Web, caso o servio de HTTP no esteja habilitado, esta operao ser executada automaticamente. Para habilitar o servio Http, siga as seguintes instrues: 1. Para iniciar o Assistente de Configurao do Servidor (SmartClient), acesse o menu Iniciar do Windows e selecione as opes Programas/Protheus 10/Ferramentas/Assistente de Configurao do Servidor. Ser apresentada a janela Assistente de Configuraes http.

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:

4. Uma vez efetuado o procedimento indicado, clique sobre o boto a compatibilizao.

para prosseguir com

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

Selecione uma empresa e clique no boto

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.

Ser apresentada a janela de finalizao.

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.

6 passo: Reiniciar os servios do Protheus


Para carregar todos os Web Services que esto no repositrio, configurar o menu ,e as permisses do usurio, siga os procedimentos abaixo: Execute o TOTVS Application Server e o TOTVS Smart Client

22 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Acesse as opes conforme os procedimentos a seguir: Rotina: Web Services (FATA230)

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

2. Clique no boto Alterar. Ser apresentada a janela Usurio do Portal - Alterar.

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

3. Aps a confirmao da matricula ser apresentada a janela Pr-Atendimento

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

Nmero da Guia Data de emisso da guia

Dados do beneficirio: Os dados abaixo sero apresentados automaticamente de acordo com a


matricula do usurio informada no ato da solicitao.

4 5 6 7 8

Nmero carteira Plano Validade Carteira Nome

da

Nmero do Carto do Beneficirio Nome do Beneficirio Plano do

Sim Sim No Sim No

da

Validade da Carteira do beneficirio Nome do beneficirio Nmero do Carto Nacional de Sade do Beneficirio

Nmero do Carto Nacional de Sade

Dados do contratado: Os dados do contratado solicitante sero apresentados de acordo com o


prestador selecionado, sendo necessrio informar os dados do profissional executante. Sero carregados pelo sistema, somente os profissionais que estiverem previamente cadastrados, podendo ainda ser includo um novo profissional no ato da solicitao. Aps selecionar ou informar o profissional solicitante, os campos 21,22, 23 e 24 sero preenchidos automaticamente. Observao: O boto para incluir o profissional executante ser habilitado somente se o mesmo for pessoa jurdica, caso seja pessoa fsica o prprio prestador ser o profissional executante. Se o prestador tiver mais de uma especialidade cadastrada, o sistema apresentar todas as especialidades disponveis para este profissional no campo 24, sendo possvel selecionar a especialidade necessria para o atendimento.

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

Cdigo IBGE do municpio CEP Nome Profissional executante do

No No Obrigatrio apenas quando o nome do contratado no campo 10 se referir pessoa jurdica

20

Nome do profissional executante.

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

Cdigo do Doena: Aguda = A; Crnica = C

Tipo

de

No

26

Tempo de doena referida pelo paciente

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

CID-10 Principal CID-10 (2) CID-10 (3) CID-10 (4)

Cdigo CID10 do diagnstico principal Cdigo CID10 do segundo diagnstico Cdigo CID10 terceiro diagnstico do

No No No No

Cdigo CID10 do quarto diagnstico

Dados do atendimento / Procedimento realizado: Os dados do atendimento devem ser preenchidos


no ato do atendimento, possibilitando facilidade na pesquisa de localizao do cdigo do procedimento.

44 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

32

Data atendimento

do

Data de realizao do atendimento

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

Cdigo do Procedimento Tipo de consulta

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

Data e assinatura do beneficirio /responsvel

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

Aps o processamento ser apresentada uma mensagem confirmando a autorizao:

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

Aps a confirmao, o boto imprimir ser habilitado

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

Caso o atendimento no tenha sido autorizado, ser apresentada a seguinte janela:

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 49

5. Clique no boto Imprimir para impresso do comprovante.

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

Nome do Campo Registro ANS Nmero Guia da

Descrio Registro da Operadora na ANS Nmero da Guia Sim Sim

Obrigatrio

Nmero da Guia Principal

Nmero da Guia Principal

Obrigatrio quando se tratar de solicitao de SADT em paciente internado No No No

4 5 6

Data da Autorizao Senha Validade Senha Data emisso guia da de da

Data da Autorizao Senha de Autorizao Data de validade da senha

Data de emisso da guia

Sim

Dados do beneficirio: Os dados abaixo sero apresentados automaticamente de acordo com a


matrcula do usurio informada no ato da solicitao.

8 9 10 11 12

Nmero Carteira Plano Validade Carteira Nome Nmero Carto Nacional Sade

da

Nmero do Carto do Beneficirio Nome do Plano do Beneficirio

Sim Sim

da

Validade da beneficirio

Carteira

do

No Sim No

Nome do beneficirio do de Nmero do Carto Nacional de Sade do Beneficirio

52 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Dados do contratado solicitante: Os dados do contratado solicitante sero apresentados de acordo


com o prestador selecionado, sendo necessrio informar os dados do profissional solicitante. Sero carregados pelo sistema, somente os profissionais que estiverem previamente cadastrados, podendo ainda ser includo um novo profissional no ato da solicitao. Aps selecionar ou informar o profissional solicitante, os campos 17, 18, 19 e 20 sero preenchidos automaticamente. Observao: O boto para incluir o profissional executante ser habilitado somente se o mesmo for pessoa jurdica, caso seja pessoa fsica o prprio prestador ser o profissional executante. Se o prestador tiver mais de uma especialidade cadastrada, o sistema apresentar todas as especialidades disponveis para este profissional no campo 24, sendo possvel selecionar a especialidade necessria para o atendimento.

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

Nome do profissional solicitante

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)

UF conselho Cdigo CBO-S

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

Data/hora da solicitao Carter da solicitao

Data/hora da solicitao Cdigo do carter da solicitao: Eletivo = E Urgncia/Emergncia = U

No Sim

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 53

23

CID10

Cdigo CID10 principal

do

diagnstico

Obrigatrio se solicitao de pequena cirurgia, terapias, ou procedimentos em srie

24

Indicao clinica

Deve ser preenchido profissional solicitante

pelo

Obrigatrio se pequena cirurgia, terapia, consulta de referncia e alto custo No

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

Cdigo do procedimento Descrio do procedimento

No Obrigatrio se pequena cirurgia, terapia, consulta de referncia e alto custo Sim Sim

28 29

Quantidade solicitada Quantidade autorizada

Quantidade solicitada de mesmo servio/procedimento Quantidade autorizada de mesmo servio/procedimento

um um

Dados do Contratado executante: Os dados do contratado solicitante sero apresentados de acordo


com o prestador selecionado, sendo necessrio informar os dados do profissional executantes. Sero carregados pelo sistema, somente os profissionais que estiverem previamente cadastrados, podendo ainda ser includo um novo profissional no ato da solicitao. Observao: O boto para incluir o profissional executante ser habilitado somente se o mesmo for pessoa jurdica, caso seja pessoa fsica o prprio prestador ser o profissional executante.

30

Cdigo na Operadora / CNPJ / CPF Nome do contratado

Cdigo na operadora ou CNPJ ou CPF do contratado executante Nome do contratado

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

No No No No No No No No Obrigatrio quando o contratado executante for hospital No

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

Nmero no conselho profissional do executante conforme tabela de domnio (ANS)

Obrigatrio quando os campos 30/31 forem pessoa fsica ou quando os campos 40a / 41 forem preenchidos

44

UF conselho

Sigla da Unidade Federativa do Conselho Profissional do executante

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

Obrigatrio quando houver procedimentos em equipe

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

SIM, selecionar uma das opes

56 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

47

Indicao Acidente

de

Indica se houve acidente ou doena relacionado: ao trabalho = 0 trnsito= 1 outros = 2

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 Hora Inicial Hora Final Cdigo tabela da

Data de procedimento

realizao realizao realizao

do do do

Sim No No SIM Pelo menos um procedimento deve ser informado SIM Pelo menos um procedimento deve ser informado

Hora inicial de procedimento Hora final de procedimento

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

SIM, pelo menos um procedimento solicitado deve ser informado Sim

57

Quantidade Realizada Via de acesso

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

Cdigo da tcnica utilizada Convencional= C Vdeolaparoscopia=V

No

60

% de reduo/ acrscimo Valor Unitrio(R$) Valor (R$) total

% 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

Total Gases Medicinais Total Geral da guia

Valor em R$ de gases medicinais Valor em R$ do total geral

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$)

Valor unitrio em R$ da OPM utilizada

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

Valor total de OPM em R$

86

Data e assinatura do solicitante

Data e assinatura do solicitante

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

Data e assinatura do responsvel pela autorizao

No

88

Data e assinatura do beneficirio ou responsvel

No

89

Data e assinatura do prestador executante

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.

Caso a solicitao no seja autorizada o sistema apresentar um mensagem com o motivo:

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

4. Clique no boto impimir para confirmar a impresso

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

Manuteno de Usurios Alterao de Senha


Opo disponvel para que o usurio logado possa alterar a senha de acesso.

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.

Manuteno de Usurios - Histrico de Acesso


Opo disponvel para verificar quando e onde um determinado usurio se logou.

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.

1. Selecione as opes Relatrios/Demos. Pagamento Ser apresentada a janela de parmetros

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.

4. Clique no boto Imprimir para confirmar a impresso.

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

Data de emisso do demonstrativo

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

Cdigo identificador do banco no qual prestador receber a fatura

Obrigatrio quando o campo 10 for 1 = Crdito em Conta Obrigatrio quando o campo 10 for 1 = Crdito em Conta No

12

Agncia

Cdigo da agncia na qual prestador receber a fatura

13

Nmero Conta Cheque

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

Sim Sim Sim Sim Sim Sim Sim

Nmero do protocolo recebimento do lote. Valor informado na fatura

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

Total geral valor processado (R$)

Sim

24

Total geral valor liberado (R$)

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

Demais descontos ou crditos

Sim

28

Total valor liberado

Sim

Demonstrativo de Anlise da Conta Mdica


Esta opo permite que seja emitido o demonstrativo de anlise da conta mdica de acordo com o prestador e data desejada. Os Demonstrativos de Anlise de Conta Mdica so documentos enviados da operadora para o prestador com a finalidade de fornecer informaes detalhadas sobre o processamento do lote de guias de faturamento enviado pelo prestador. A partir deste demonstrativo possvel que o prestador faa uma previso das contas a serem pagas pela operadora e solicitar reviso de possveis glosas, baseando-se em detalhes do processamento das guias.

1. Selecione as opes Relatrios/Anlise C. Md.. Ser apresentada a janela de Parmetros.

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

Data de emisso do demonstrativo

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

Sim SIM, se o prestador executante for hospital

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

Data de envio do Lote

12 13

Nmero protocolo Valor protocolo

do

Nmero do protocolo recebimento do lote Valor total do Protocolo

de

Sim Sim

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 71

14 15

Valor glosa protocolo Cdigo Glosa Protocolo Nmero da guia / Senha

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

Nome do beneficirio Cdigo do Beneficirio

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

Sim No No No No Sim Sim Sim

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 glosa Cdigo glosa Valor processado guia

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 liberado guia Valor guia glosa

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

Valor processado geral Valor liberado geral

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

4. Clique no boto Imprimir para confirmar a impresso.

Observao: O formato de impresso deste extrato no segue a regra TISS.

Ajustes efetuados pelo compatibilizador


O compatibilizador UPDPL076 criar/ atualizar os seguintes itens: 1. Criao da tabela no SX2 (Dicionrio de Dados): Prefixo Path Nome Descrio Modo Acesso Rotina BZI \DATA\ BZI010 (Onde 01 o cdigo da empresa) Atendimento Web Pacientes 1-Compartilhado -

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)

Campo Box Titulo Descrio When

BE4_EMGEST "1=Sim;0=No" "Em Gestao" "Em Gestao" PLSVLDOBS()

Campo Tipo Box Titulo Descrio When

BE4_ABORTO C "1=Sim;0=No" Aborto Aborto PLSVLDOBS()

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 77

Campo Tipo Box Titulo Descrio When

BE4_TRAGRA C "1=Sim;0=No" Tra. Grav Transtorno Materno na Gravidez PLSVLDOBS()

Campo Tipo Tamanho Titulo Descrio Relao Browse Visual

BQV_DATPRO D 8 Dt. Proc. Data Proc. If(Inclui .Or. Empty(BQV->BQV_DATPRO),dDataBase,BQV>BQV_DATPRO) S V

Campo Tipo Tamanho Titulo Descrio Relao Browse Visual

BQV_HORPRO C 4 Hora proc.. Hora proc. If(Inclui .Or. Empty(BQV>BQV_HORPRO),StrTran(Time(),":",""),BQV>BQV_HORPRO) S V

78 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Browse Visual Context Obrigat

BQV_DTENTR Dt. Ent

Campo Titulo Browse Visual Context Obrigat

BQV_HRENTR Hr. Ent

Campo Titulo Descrio Tipo Tamanho Box When

BQV_COMURP C.P Puerp. Complicao perodo Puerperio C 1 1=Sim;0=No PLSVLDOBS()

Campo Titulo Descrio Tipo Tamanho Box When

BE4_ATESPA RN Sa. Parto Atendimento RN sala parto C 1 1=Sim;0=No PLSVLDOBS()

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 79

Campo Titulo Descrio Tipo Tamanho Box When

BE4_COMNAL C. Neo Natal Complicacao neo natal C 1 1=Sim;0=No PLSVLDOBS()

Campo Titulo Descrio Tipo Tamanho Box Relao

BR8_TRAIND Tra. Indc. Tratamento para Ind. Cli C 1 1=Sim;0=No '0'

Campo Titulo Descrio Tipo Tamanho Box When

BE4_BAIPES Baixo Peso Baixo Peso C 1 1=Sim;0=No PLSVLDOBS()

Campo Titulo Descrio Tipo Tamanho Box When

BE4_PARCES Parto Cesrio Parto Cesrio C 1 1=Sim;0=No PLSVLDOBS()

80 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Descrio Tipo Tamanho Box When

BE4_PATNOR Parto Normal Parto Normal C 1 1=Sim;0=No PLSVLDOBS()

Campo Titulo Descrio Tipo Tamanho Box

BB8_CARSOL Car. Solic. Carter da Solicitao C 1 E=Eletivo;U=Urgncia/Emergncia

Campo Titulo Descrio Tipo Tamanho Box Browse Visual Context

BCT_DESTIS Desc. Glosa Descrio Glosa TISS C 100 E=Eletivo;U=Urgncia/Emergncia S A R

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 81

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BEA_LOTGUI Lot Guia XML Numero Lote Guia XML C 12 S A R

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BEA_ARQIMP Arq.Imp XML Arquivo Importao XML C 55 S A R

Campo Tamanho

BE4_NRDCNV 15

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BE4_LOTGUI Lot Guia XML Numero Lote Guia XML C 12 S A R

82 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BE4_ARQIMP Arq.Imp XML Arquivo Importao XML C 55 S A R

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BD5_LOTGUI Lot Guia XML Numero Lote Guia XML C 12 S A R

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BD6_LOTGUI Lot Guia XML Numero Lote Guia XML C 12 S A R

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 83

Campo Titulo Descrio Tipo Tamanho Browse Visual Context

BD7_LOTGUI Lot Guia XML Numero Lote Guia XML C 12 S A R

Campo Titulo Descrio Tipo Tamanho Visual

BQV_NUMIMP Nr. Impresso Numero do Impresso C 20 V

Campo Titulo Descrio Tipo Tamanho Visual

BEJ_NUMIMP Nr. Impresso Numero do Impresso C 20 V

Campo Titulo Descrio Tipo Tamanho Visual Box

BE2_TPPROC Tipo Proced Tipo de Procedimento C 1 V 0=Procedimento;1=Material;2=Medicamento;3=Taxas; 4=Dirias; 5=rtese/Prtese;6=Pacote;7=Gases Medicinais;8=Aluguis

84 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Descrio Tipo Tamanho Visual Box

BEJ_TPPROC Tipo Proced Tipo de Procedimento C 1 V 0=Procedimento;1=Material;2=Medicamento;3=Taxas;4=Dirias; 5=rtese/Prtese;6=Pacote;7=Gases Medicinais;8=Aluguis

Campo Visual Relao

BE2_DATPRO V If(Inclui .Or. Empty(BE2->BE2_DATPRO),dDataBase,BE2>BE2_DATPRO)

Campo Titulo Descrio Tipo Tamanho Visual Relao

BEJ_DATPRO Dt. Proc. Data Proc. D 8 V If(Inclui .Or. Empty(BEJ->BEJ_DATPRO),dDataBase,BEJ>BEJ_DATPRO)

Campo Titulo Descrio Tipo Tamanho Visual Box

BQV_TPPROC Tipo Proced Tipo de Procedimento C 1 V 0=Procedimento;1=Material;2=Medicamento;3=Taxas;4=Dirias; 5=rtese/Prtese;6=Pacote;7=Gases Medicinais;8=Aluguis

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 85

Campo Titulo Descrio Tipo Tamanho

BZI_FILIAL Filial Filial do Sistema C 2

Campo Titulo Descrio Tipo Tamanho Visual

BZI_CODINT Operadora Operadora C 4 V

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_CODEMP Cod. Empresa Cod. Empresa C 4 V S

Campo Titulo Descrio Tipo Tamanho Visual

BZI_MATRIC Matricula Matricula C 6 V

86 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Descrio Tipo Tamanho Visual

BZI_TIPREG Tp. Registro Tp. Registro C 2 V

Campo Titulo Descrio Tipo Tamanho Visual

BZI_DIGITO Digito Digito C 1 V

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_NOMUSR Nome Usurio Nome Usurio C 50 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_OPERDA Oper. RDA Operadora RDA C 4 V S

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 87

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_CODRDA Cdigo RDA Cdigo RDA C 6 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_NOMRDA Nome RDA Nome RDA C 40 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_CODLOC Cdigo Local Cdigo Local C 3 V S

88 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_DATCHE Data Atendim Data Atendim D 8 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_HORCHE Hr Chegada Hora de Chegada C 5 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_HORTER Hr. Termino Hora Termino do Atendimen C 5 V S

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_CODUSR Cod Usurio Cdigo do Usurio C 6 V S

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 89

Campo Titulo Descrio Tipo Tamanho Visual Browse

BZI_TRILHA Trilha Carto Trilha Carto C 200 V S

Campo Tamanho

B01_NUMIMP 20

Campo Titulo Descrio Tipo Tamanho

B02_NUMIMP Nr. Impresso Numero do Impresso C 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 Campo Tamanho Titulo Descrio

BE1_NUMIMP 20 BE2_NUMIMP 20 Nr. Impresso Numero do Impresso

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

Tabela Ordem Chave Descrio

BA0 3 BA0_FILIAL+BA0_CODCLI+BA0_LOJCLI Cod.Cliente+Loja

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 91

Tabela Ordem Chave Descrio Tabela Ordem Chave Descrio

BA0 4 BA0_FILIAL+BA0_CGC CGC BA0 5 BA0_FILIAL + BA0_SUSEP Registro ANS

Tabela Ordem Chave Descrio

BAQ 4 BAQ_FILIAL + BAQ_CODINT + BAQ_CBOS Operadora + CBOS

Tabela Ordem Chave Descrio

BZI 1 BZI_FILIAL + BZI_CODUSR + BZI_HORTER Cod Login Web + Hor Termino

Tabela Ordem Chave Descrio

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

Tabela Ordem Chave Descrio

BZI 3 BZI_FILIAL + BZI_DATCHE Data de Chegada

92 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus

Tabela Ordem Chave Descrio

BZI 4 BZI_FILIAL + BZI_CODRDA + BZI_CODLOC Cdigo da Rda + Local de Atendimento

Tabela Ordem Chave Descrio

BEA G BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_LOTGUI Operadorda Rda + Cdigo Rda + Lote Guia

Tabela Ordem Chave Descrio

BEA H BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_NUMIMP Operadora Rda + Cdigo Rda + Numero Impresso

Tabela Ordem Chave Descrio

BE4 B BE4_FILIAL + BE4_OPERDA + BE4_CODRDA + BE4_LOTGUI Operadora Rda + Cdigo Rda + Lote Guia

Tabela Ordem Chave Descrio

BB8 4 BB8_FILIAL + BB8_TIPLOG + BB8_CEP + BB8_NR_END + BB8_EST Tip. Logra + Cep + Numero + Estado

7. Querys que foram executadas para ajustar a base:


UPDATE BE4??? SET BE4_EMGEST = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 1 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_ABORTO = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 2 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_TRAGRA = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 6 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_COMURP = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 7 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_ATESPA = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 8 AND D_E_L_E_T_ = ' ' UPDATE BE4??? SET BE4_COMNAL = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 9 AND D_E_L_E_T_ = ' '

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