Você está na página 1de 94

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

Roteiro de Configurao de Web Services


e Portal Protheus
Ambiente : Planos de Sade Boletim : 00002723-07
Data da publicao : 05/11/04 Data da reviso : 20/09/07
Verses : Protheus 8.11 Pases : Brasil
Sistemas operacionais : Windows/Linux Bancos de dados : Todos
Relacionais
Bops : 00000125669

Tabelas utilizadas : 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 8, sendo processado apenas em
ambientes que utilizam o TOP Connect.
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:

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

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
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 3
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.




4 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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).
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 5
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.









6 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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
Submenu
Nome da
rotina
Programa Tabelas
Atualizaes Portal
Web
Services
FATA230 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 do
menu
Submenu
Nome da
rotina
Programa Tabelas
Atualizaes Portal Direitos FATA220 AI3

3. Ainda na opo Menus, inclua no menu do ambiente Planos de Sade, a opo de execuo
do FATA240 conforme especificaes a seguir:

Nome do
menu
Submenu
Nome da
rotina
Programa Tabelas
Atualizaes Portal
Menu dos
Portais
FATA240 AI8

4. Na opo Menus, inclua no menu do ambiente Planos de Sade, a opo de execuo do
PLSA226 conforme especificaes a seguir:

Nome do
menu
Submenu
Nome da
rotina
Programa Tabelas
Atualizaes Portal Usurios PLSA226 BSW


Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 7
5. No ambiente Configurador, selecione as opes Ambiente/Cadastro/Parmetro e configure o
parmetro MV_ PORTAL1 conforme instrues a seguir:

Pasta Informaes
Parmetro MV_PORTAL1
Tipo C
Contedo 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 MV_PORTAL2
Tipo C
Contedo 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);




8 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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 Contedo da leitura do carto
Retorno:
aMatrCartao
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
Exemplo:
User Function PLSCARD
LOCAL cTrilha := AllTrim(paramixb[1])
LOCAL 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) )
AaDd(aMatrCartao, SubStr(cMatric,23,24) )
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 9
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 Contem todos os dados do cabealho da guia
aItens Contem todos os dados dos itens da guia
limpXml Se veio de uma importao ou no
cTipoGrv Qual e o tipo de gravao
Retorno:
aRetPto
Retorna na primeira posio da matriz, sendo uma matriz com
o cabealho e na segunda uma matriz com os itens
Exemplo:
User Function PLSXMVPR
LOCAL aDad:= paramixb[1]
LOCAL aIte= paramixb[2]
Return( {aDad, aIte} )
Observao:
Caso o RdMake exista, logo aps o processamento ser exibido no plsxmov.log todos os dados
que retornaram pelo ponto de entrada.


10 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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.

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 11
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 8 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.
5. Clique no boto Avanar.

12 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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 Protheus 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>
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 13

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 (Mp8Wizard), acesse o menu Iniciar do
Windows e selecione as opes Protheus 8/Ferramentas/Assistente de Configurao do
Servidor.
Ser apresentada a janela Assistente de Configuraes http

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


2. Selecione a pasta Mdulos Web e clique no boto Novo Mdulo.
Ser apresentada a janela Configuraes Bsicas do Mdulo.

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 15
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.
6. Clique no boto Avanar.

16 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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.







Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 17
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 (Mp8Wizard), acesse o menu Iniciar do
Windows e selecione as opes Programas/Protheus 8/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.

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

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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 19
Procedimentos de implementao
Observao:
O compatibilizador U_UPDPL076 criar automaticamente o menu do portal Plano de Sade.
Importante:
a. Antes de executar o compatibilizador U_UPDPL076, imprescindvel que o usurio faa
um backup dos seus arquivos de dados (diretrio \PROTHEUS_DATA\DATA, verso 8.11
e dos arquivos de dados SXs (diretrio\PROTHEUS_DATA\SYSTEM, verso 8.11).
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 Protheus Remote e no campo Programa Inicial, digite U_UPDPL076.

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


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 para prosseguir com
a compatibilizao.
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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 21
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.

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

8. Clique sobre o boto Finalizar para sair.
9 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 Protheus Server e o Protheus Remote


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

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.


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


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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 25

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


26 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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.

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 27
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.

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

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.







Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 29
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.

30 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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

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


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.





32 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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.

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


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:


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.


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
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 35
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 Sair, retornando direto para a janela de login do usurio do Portal Plano de
Sade.
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.


36 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Clique no boto confirmar.
Observao:
Caso seja informada uma matrcula invlida o sistema apresentar a seguinte mensagem:

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.

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 37
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 pr-
atendimento. Ex: Mdico selecionado errado, paciente desistiu do atendimento, etc.





38 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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:


Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 39
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.








40 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
2. Preencha os dados conforme orientaes descritas na tabela a seguir:
Dados da autorizao
Nm. do
Campo
Nome do Campo Descrio Obrigatrio
1 Registro ANS
Registro da operadora
na ANS
Sim
2 Nmero da Guia Nmero da Guia Sim
3
Data de emisso
da Guia
Data de emisso da guia Sim
Dados do beneficirio: Os dados abaixo sero apresentados automaticamente de acordo com a
matricula do usurio informada no ato da solicitao.
4
Nmero da
carteira
Nmero do Carto do
Beneficirio
Sim
5 Plano
Nome do Plano do
Beneficirio
Sim
6
Validade da
Carteira
Validade da Carteira do
beneficirio
No
7 Nome Nome do beneficirio Sim
8
Nmero do
Carto Nacional
de Sade
Nmero do Carto
Nacional de Sade do
Beneficirio
No
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.

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 41
9
Cdigo na
operadora
/CNPJ/CPF
Cdigo na operadora ou
CNPJ ou CPF do
contratado
Sim
10
Nome do
contratado
Nome do contratado Sim
11 Cdigo CNES
Cdigo CNES do
prestador contratado
No
12
Tipo de
logradouro
Tipo de Logradouro
conforme tabela de
domnio (ANS)
No
13 Logradouro
Nome do logradouro do
endereo do contratado
No
14 Nmero
Nmero do endereo do
contratado
No
15 Complemento
Complemento do
endereo do contratado
No
16 Municpio Municpio do contratado No
17 UF
Sigla da unidade
federativa do contratado
No
18
Cdigo IBGE do
municpio
Cdigo do municpio da
Tabela do IBGE do
contratado
No
19 CEP CEP do contratado No
20
Nome do
Profissional
executante
Nome do profissional
executante.
Obrigatrio apenas
quando o nome do
contratado no campo
10 se referir pessoa
jurdica
21
Conselho
Profissional
Sigla do conselho
profissional do
executante conforme
tabela de domnio (ANS)
Sim
22
Nmero do
conselho
Nmero no conselho
profissional do
executante conforme
tabela de domnio (ANS)
Sim

42 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
23 UF
Sigla da Unidade
Federativa do Conselho
Profissional do
executante
Sim
24
Cdigo CBO-S

Cdigo da especialidade
do contratado conforme
tabela de domnio (ANS)
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 Tipo de
Doena:
Aguda = A;
Crnica = C
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 de
Acidente
Indica se houve:
Acidente de trabalho
ou doena relacionada
ao trabalho = 0;
Acidente de trnsito= 1
Outros acidentes = 2
No
28 CID-10 Principal Cdigo CID10 do
diagnstico principal
No
29 CID-10 (2) Cdigo CID10 do
segundo diagnstico
No
30 CID-10 (3) Cdigo CID10 do
terceiro diagnstico
No
31 CID-10 (4) Cdigo CID10 do quarto
diagnstico
No
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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 43
32 Data do
atendimento
Data de realizao do
atendimento

Sim
33 Cdigo da Tabela

Cdigo da Tabela
utilizada para descrever
os procedimentos
conforme tabela de
domnio (ANS)
Sim
34 Cdigo do
Procedimento
Cdigo do procedimento
realizado
Sim
35 Tipo de consulta

Cdigo do tipo de
consulta:
Primeira consulta=1
Seguimento=2
Pr-Natal=3
Sim
36 Tipo de sada

Cdigo do tipo de sada:
Retorno= 1
Retorno com SADT= 2
Referncia = 3
Internao = 4
Alta= 5
Sim
37 Observao Observaes No
38 Data e assinatura
do mdico
Data e assinatura do
mdico

No
39 Data e assinatura
do beneficirio
/responsvel
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:




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


Aps o processamento ser apresentada uma mensagem confirmando a autorizao:







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


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.




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



Aps a confirmao, o boto imprimir ser habilitado
4. Clique no boto imprimir.
Ser apresentada a janela Comprovante de utilizao de servio (s).
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 47


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

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


5. Clique no boto Imprimir para impresso do comprovante.






Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 49
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)


50 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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
Nome do
Campo
Descrio Obrigatrio
1 Registro ANS Registro da Operadora na ANS Sim
2
Nmero da
Guia
Nmero da Guia Sim
3
Nmero da
Guia Principal
Nmero da Guia Principal
Obrigatrio quando
se tratar de
solicitao de SADT
em paciente
internado
4
Data da
Autorizao
Data da Autorizao No
5 Senha Senha de Autorizao No
6
Validade da
Senha
Data de validade da senha No
7
Data de
emisso da
guia
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 Nmero da
Carteira
Nmero do Carto do Beneficirio Sim
9 Plano Nome do Plano do Beneficirio Sim
10 Validade da
Carteira
Validade da Carteira do
beneficirio
No
11 Nome Nome do beneficirio Sim
12 Nmero do
Carto
Nacional de
Sade
Nmero do Carto Nacional de
Sade do Beneficirio
No
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 51
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
Cdigo na operadora ou CNPJ ou
CPF do contratado solicitante
Sim
14 Nome do
contratado
Nome do contratado solicitante Sim
15 Cdigo CNES Cdigo CNES do contratado
solicitante
No
16 Nome do
profissional
solicitante
Nome do profissional solicitante Obrigatrio apenas
quando o campo 14
se referir pessoa
jurdica
17 Conselho
profissional
Sigla do conselho profissional
conforme tabela de domnio.
Sim
18 Nmero do
conselho
Nmero do conselho profissional Sim
19 UF conselho Sigla da Unidade federativa do
Conselho Profissional
Sim
20 Cdigo CBO-S Cdigo da especialidade conforme
tabela de domnio (ANS)
No
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 Data/hora da
solicitao
Data/hora da solicitao No
22 Carter da
solicitao
Cdigo do carter da solicitao:
Eletivo = E
Urgncia/Emergncia = U
Sim

52 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
23 CID10 Cdigo CID10 do diagnstico
principal
Obrigatrio se
solicitao de
pequena cirurgia,
terapias, ou
procedimentos em
srie

24 Indicao
clinica
Deve ser preenchido pelo
profissional solicitante
Obrigatrio se
pequena cirurgia,
terapia, consulta de
referncia e alto
custo
25 Cdigo da
tabela
Cdigo da tabela utilizada para
descrever os procedimentos
solicitados conforme tabela de
domnio (ANS)
No
26 Cdigo do
procedimento
Cdigo do procedimento solicitado No
27 Descrio do
procedimento
Descrio do procedimento
solicitado
Obrigatrio se
pequena cirurgia,
terapia, consulta de
referncia e alto
custo
28 Quantidade
solicitada
Quantidade solicitada de um
mesmo servio/procedimento
Sim
29 Quantidade
autorizada
Quantidade autorizada de um
mesmo servio/procedimento
Sim
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
Cdigo na operadora ou CNPJ ou
CPF do contratado executante
Sim
31 Nome do
contratado
Nome do contratado Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 53
32 Tipo de
logradouro
Tipo de Logradouro conforme
tabela de domnio (ANS)
No
33 Logradouro Nome do logradouro No
34 Nmero Nmero do endereo do
contratado executante
No
35 Complemento Complemento do endereo do
contratado executante
No
36 Municpio Municpio do contratado
executante
No
37 UF Sigla da UF do contratado
executante
No
38 Cdigo IBGE
do municpio
Cdigo IBGE do municpio do
contratado executante
No
39 CEP CEP do contratado executante No
40 Cdigo CNES Cdigo CNES do contratado
executante
Obrigatrio quando
o contratado
executante for
hospital
40 a Cdigo na
Operadora /
CPF do exec.
complementar
Este campo identifica o
profissional executante /
complementar em qualquer
procedimento no laboratorial
No
41 Nome
profissional
executante /
complementar
Este campo identifica o
profissional executante /
complementar em qualquer
procedimento no laboratorial
No
42 Conselho
profissional
Sigla do 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


54 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
43 Nmero do
Conselho
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
45 Cdigo CBO-S

Cdigo da especialidade do
executante conforme tabela de
domnio (ANS)
NO
45 a Grau de
Participao

Grau de participao do
profissional na equipe mdica de
acordo com a tabela de domnio
(ANS)
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

Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 55
47 Indicao de
Acidente
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 de
Doena
Cdigo do Tipo de Doena:
Aguda = A
Crnica = C
No
50 Tempo de
doena
referida pelo
paciente
Tempo da doena referido pelo
paciente e unidade de tempo:
A = anos;
M = meses;
D = dias
No
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.
51 Data Data de realizao do
procedimento
Sim
52 Hora Inicial Hora inicial de realizao do
procedimento
No
53 Hora Final Hora final de realizao do
procedimento
No
54 Cdigo da
tabela
Cdigo da tabela utilizada para
descrever os procedimentos
conforme tabela de domnio (ANS)
SIM Pelo menos um
procedimento deve
ser informado
55 Cdigo do
procedimento
Cdigo do procedimento realizado SIM Pelo menos um
procedimento deve
ser informado

56 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
56 Descrio do
procedimento
Descrio do procedimento
realizado
SIM, pelo menos um
procedimento
solicitado deve ser
informado
57 Quantidade
Realizada
Quantidade em cobrana de um
mesmo servio/procedimento
realizado
Sim
58 Via de acesso Cdigo da via de acesso
nica= U
Mesma via=M
Diferentes vias= D
No
59 Tcnica
Utilizada
Cdigo da tcnica utilizada
Convencional= C
Vdeolaparoscopia=V
No
60 % de reduo/
acrscimo
% de reduo/ acrscimo no caso
de cirurgia mltipla/radiologia de
mltiplas reas
No
61 Valor
Unitrio(R$)
Valor unitrio em R$ do
procedimento/servio realizado
No
62 Valor total
(R$)
Valor total em R$ dos
procedimentos/servios realizado
No
63 Data e
assinatura dos
procedimentos
em srie.
Data e assinatura dos
procedimentos em srie.
No
64 Observao Observao No
65 Total
Procedimentos
Valor em R$ de procedimentos No
66 Total Taxas e
aluguis
Valor em R$ de taxas e aluguis No
67 Total
Materiais
Valor em R$ de materiais No
68 Total
Medicamentos
Valor em R$ de medicamentos No
69 Total Dirias Valor em R$ de dirias No
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 57
70 Total Gases
Medicinais
Valor em R$ de gases medicinais No
71 Total Geral da
guia
Valor em R$ do total geral No
Solicitao dos Servios ou OPM (Dados do Atendimento):
72 Cdigo da
Tabela
Cdigo da Tabela de OPM
conforme tabela de domnio (ANS)
No
73 Cdigo OPM Cdigo da OPM solicitada No
74 Descrio
OPM
Descrio OPM solicitada No
75 Qtde de OPM Quantidade de OPM solicitadas No
76 Fabricante
OPM
Nome do Fabricante da OPM
solicitada
No
77 Valor
Unitrio(R$)
Valor unitrio em R$ da OPM
utilizada
No
Solicitao de Servios ou OPM (Dados do Atendimento)
78 Cdigo da
Tabela
Cdigo da Tabela de OPM
conforme tabela de domnio (ANS)
No
79 Cdigo OPM Cdigo da OPM utilizada No
80 Descrio
OPM
Descrio da OPM utilizada No
81 Qtde de OPM Quantidade utilizada de OPM No
82 Cdigo de
Barras
Cdigo de barra identificador da
OPM utilizada
No
83 Valor
Unitrio(R$)
Valor unitrio em R$ da OPM
utilizada
No
84 Valor Total
(R$)
Valor total em R$ da OPM
utilizada
No
85 Valor Total
OPM
(R$)
Valor total de OPM em R$ No
86 Data e
assinatura do
solicitante
Data e assinatura do solicitante No

58 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
87 Data e
assinatura do
responsvel
pela
autorizao
Data e assinatura do responsvel
pela autorizao
No
88 Data e
assinatura do
beneficirio ou
responsvel
Data e assinatura do beneficirio
ou responsvel
No
89 Data e
assinatura do
prestador
executante
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:
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 59

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


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

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

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

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

62 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
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.

3. Selecione as opes Manuteno de Usurios/Histrico de Acesso
Ser apresentada a janela Histrico de Acesso


Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 63
4. 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
5. 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

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

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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 65
Observao:
Na tabela abaixo esto relacionados os campos que so exibidos pelo demonstrativo de
pagamento:

Dados da operadora
N. do
Campo
Nome do
Campo
Descrio

Obrigatrio

1 Registro ANS Registro da operadora na ANS Sim
2
Nome da
operadora
Nome da operadora Sim
3
CNPJ
operadora
Nmero CNPJ da operadora Sim
4
Nmero do
demonstrativo
Nmero identificador do
demonstrativo
Sim
5
Data emisso
do
demonstrativo
Data de emisso do demonstrativo Sim
Dados do prestador
6 Cdigo
Prestador /
CNPJ / CPF
/CNPJ/CPF
Cdigo identificador do prestador na
operadora ou identificador de
pessoa fsica ou pessoa jurdica
Sim
7 Nome do
prestador
Nome do prestador Sim
8 Cdigo CNES Cdigo do Cadastro Nacional de
estabelecimentos de sade
SIM, se o
prestador
executante
for hospital
Data do pagamento
9 Data do
pagamento
Data para previso do pagamento Sim
10 Forma de
Pagamento
Indicador da forma que o
pagamento se realizar.
1-Crdito em conta
2- Carteira
3- Boleto bancrio
Sim

66 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
11 Banco Cdigo identificador do banco no
qual prestador receber a fatura
Obrigatrio
quando o
campo 10 for
1 = Crdito
em Conta
12 Agncia Cdigo da agncia na qual o
prestador receber a fatura
Obrigatrio
quando o
campo 10 for
1 = Crdito
em Conta
13 Nmero da
Conta /
Cheque
Nmero da conta corrente na qual o
prestador receber a fatura. No
caso de pagamentos em cheque
informar nmero do mesmo.
No
Dados do resumo
14 Nmero da
fatura
Nmero do documento fiscal No
15 Nmero do
Lote
Nmero identificador do lote. O lote
um nmero que identifica um
conjunto de guias para o prestador,
enviado por meio das mensagens
eletrnicas Operadora.
Sim
16 Data de envio
do lote
Data de envio do lote pelo
prestador.
Sim
17 Nmero do
protocolo
Nmero do protocolo de
recebimento do lote.
Sim
18 Valor
informado
Valor informado na fatura Sim
19 Valor
processado
Valor processado na fatura pela
operadora
Sim
20 Valor liberado Valor liberado para pagamento pela
operadora
Sim
21 Valor da glosa Valor da glosa Sim
22 Total geral
valor
informado
(R$)
Total geral valor informado (R$)

Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 67
23 Total geral
valor
processado
(R$)
Total geral valor processado (R$)

Sim
24 Total geral
valor liberado
(R$)
Total geral valor liberado (R$) Sim
25 Total geral
glosa (R$)
Total geral glosa (R$) Sim
26 Total valor Total valor liberado = Geral valor
liberado total geral de glosas sem
considerar valores de impostos e
demais descontos.
Sim
27 Demais
descontos ou
crditos

Demais descontos ou crditos a
serem debitados ou creditados ao
valor liberado. Itens devem estar
devidamente descritos e valorados
linha a linha.
Sim
28 Total valor
liberado
Total valor subtrado de todos os
descontos. Valor final do
demonstrativo.
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.


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

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.


Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 69
Dados da operadora
N. do
Campo
Nome do
Campo
Descrio

Obrigatrio

1 Registro ANS Registro da operadora na ANS Sim
2
Nome da
operadora
Nome da operadora Sim
3
CNPJ
operadora
Nmero CNPJ da operadora Sim
4
Nmero do
demonstrativo
Nmero identificador do
demonstrativo
Sim
5
Data emisso
do
demonstrativo
Data de emisso do demonstrativo Sim
Dados do prestador
6 Cdigo
Prestador /
CNPJ / CPF*
Cdigo identificador do prestador na
operadora CNPJ do prestador
Sim
7 Nome do
prestador
Nome da operadora Sim
8 Cdigo CNES Cdigo do Cadastro Nacional de
estabelecimentos de sade do
prestador
SIM, se o
prestador
executante
for hospital
Dados do lote
9 Nmero da
fatura
Nmero identificador das faturas
que compem o lote
No
10 Nmero do
Lote
Nmero do lote processado Sim
11 Data de envio
do
Lote
Data em que o lote foi enviado
operadora
Sim
12 Nmero do
protocolo
Nmero do protocolo de
recebimento do lote
Sim
13 Valor
protocolo
Valor total do Protocolo Sim

70 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
14 Valor glosa
protocolo
Valor total da glosa do protocolo Sim
15 Cdigo Glosa
Protocolo
Cdigo de glosa de protocolo.
Aceita N valores para um mesmo
protocolo.
No
16 Nmero da
guia / Senha
Nmero identificador das guias que
compem o lote
Sim
17 Nome do
beneficirio
Nome do beneficirio dos servios
prestados
No
18 Cdigo do
Beneficirio
Cdigo identificador do beneficirio
na operadora
Sim
19 Data
realizao
Data de realizao do servio Sim
20 Descrio do
servio
Descrio do servio realizado No
21 Cdigo Tabela Cdigo identificador da tabela de
valorao
No
22 Cdigo
Servio
Cdigo identificador do servio
realizado
No
23 Grau de
participao
Cdigo da posio do profissional
na equipe
No
24 Qtde executa Quantidade executada do servio Sim
25 Valor
processado
Valor usado como base para o
processamento de valores
Sim
26 Valor liberado

Valor liberado previsto para
pagamento pela operadora sem
impostos
Sim
27 Valor glosa Valor glosado pela operadora Sim
28 Cdigo glosa Cdigo da glosa (N valores para um
mesmo procedimento)
No
29 Valor
processado
guia
Valor total usado como base para o
processamento de valores na guia
Sim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 71
30 Valor liberado
guia
Valor total previsto para pagamento
pela operadora nesta guia sem
impostos
Sim
31 Valor glosa
guia
Valor total glosada pela operadora
na guia
No
32 Cdigo Glosa
Guia
Cdigo de glosa de guia (N valores
para uma mesma guia)
No
33 Valor
processado
fatura
Valor total usado como base para o
processamento de valores na fatura
Sim
34 Valor liberado
fatura
Valor total previsto para pagamento
pela operadora na fatura sem
impostos
Sim
35 Valor glosa
fatura
Valor total glosado pela operadora
no lote
No
36 Valor
processado
geral
Valor total do Demonstrativo usado
como base para o processamento
de valores da fatura
Sim
37 Valor liberado
geral

Valor total do Demonstrativo
liberado para pagamento pela
operadora no lote sem impostos
Sim
38 Valor glosa
geral
Valor total do Demonstrativo
glosado pela operadora no lote
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.


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


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.
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 73
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.

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

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 BZI
Path \DATA\
Nome BZI010 (Onde 01 o cdigo da empresa)
Descrio Atendimento Web Pacientes
Modo Acesso 1-Compartilhado
Rotina -
2. Alterao da tabela no SX7 (Gatinhos):
Campo BE2_CODPRO
Regra BR8->BR8_TPPROC
Domnio BE2_TPPROC
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 75
3. Alterao da tabela no SX7 (Gatinhos):
Campo BEJ_CODPRO
Regra BR8->BR8_TPPROC
Dominio BEJ_TPPROC
4. Alterao da tabela no SX7 (Gatinhos):
Campo BQV_CODPRO
Regra BR8->BR8_TPPROC
Dominio BQV_TPPROC
5. Criao de campos no SX3 (Dicionrio de Dados Campos da tabela):
Campo BSW_LOGUSR
Valid ExistChav("BSW",M->BSW_LOGUSR,1)

Campo BSW_SENHA
Valid
ExistChav("BSW",M->BSW_LOGUSR+M-
>BSW_SENHA,3)

Campo BE4_EMGEST
Box "1=Sim;0=No"
Titulo "Em Gestao"
Descrio "Em Gestao"
When PLSVLDOBS()

Campo BE4_ABORTO
Tipo C
Box "1=Sim;0=No"
Titulo Aborto
Descrio Aborto
When PLSVLDOBS()


76 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Campo BE4_TRAGRA
Tipo C
Box "1=Sim;0=No"
Titulo Tra. Grav
Descrio Transtorno Materno na Gravidez
When PLSVLDOBS()

Campo BQV_DATPRO
Tipo D
Tamanho 8
Titulo Dt. Proc.
Descrio Data Proc.
Relao
If(Inclui .Or. Empty(BQV->BQV_DATPRO),dDataBase,BQV-
>BQV_DATPRO)
Browse S
Visual V

Campo BQV_HORPRO
Tipo C
Tamanho 4
Titulo Hora proc..
Descrio Hora proc.
Relao
If(Inclui .Or. Empty(BQV-
>BQV_HORPRO),StrTran(Time(),":",""),BQV-
>BQV_HORPRO)
Browse S
Visual V



Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 77
Campo BQV_DTENTR
Titulo Dt. Ent
Browse
Visual
Context
Obrigat

Campo BQV_HRENTR
Titulo Hr. Ent
Browse
Visual
Context
Obrigat

Campo BQV_COMURP
Titulo C.P Puerp.
Descrio Complicao perodo Puerperio
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()

Campo BE4_ATESPA
Titulo RN Sa. Parto
Descrio Atendimento RN sala parto
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()

78 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Campo BE4_COMNAL
Titulo C. Neo Natal
Descrio Complicacao neo natal
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()

Campo BR8_TRAIND
Titulo Tra. Indc.
Descrio Tratamento para Ind. Cli
Tipo C
Tamanho 1
Box 1=Sim;0=No
Relao '0'

Campo BE4_BAIPES
Titulo Baixo Peso
Descrio Baixo Peso
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()

Campo BE4_PARCES
Titulo Parto Cesrio
Descrio Parto Cesrio
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()





Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 79
Campo BE4_PATNOR
Titulo Parto Normal
Descrio Parto Normal
Tipo C
Tamanho 1
Box 1=Sim;0=No
When PLSVLDOBS()


Campo BB8_CARSOL
Titulo Car. Solic.
Descrio Carter da Solicitao
Tipo C
Tamanho 1
Box E=Eletivo;U=Urgncia/Emergncia


Campo BCT_DESTIS
Titulo Desc. Glosa
Descrio Descrio Glosa TISS
Tipo C
Tamanho 100
Box E=Eletivo;U=Urgncia/Emergncia
Browse S
Visual A
Context R








Campo BEA_LOTGUI

80 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Titulo Lot Guia XML
Descrio Numero Lote Guia XML
Tipo C
Tamanho 12
Browse S
Visual A
Context R


Campo BEA_ARQIMP
Titulo Arq.Imp XML
Descrio Arquivo Importao XML
Tipo C
Tamanho 55
Browse S
Visual A
Context R


Campo BE4_NRDCNV
Tamanho 15


Campo BE4_LOTGUI
Titulo Lot Guia XML
Descrio Numero Lote Guia XML
Tipo C
Tamanho 12
Browse S
Visual A
Context R
Campo BE4_ARQIMP
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 81
Titulo Arq.Imp XML
Descrio Arquivo Importao XML
Tipo C
Tamanho 55
Browse S
Visual A
Context R


Campo BD5_LOTGUI
Titulo Lot Guia XML
Descrio Numero Lote Guia XML
Tipo C
Tamanho 12
Browse S
Visual A
Context R


Campo BD6_LOTGUI
Titulo Lot Guia XML
Descrio Numero Lote Guia XML
Tipo C
Tamanho 12
Browse S
Visual A
Context R






Campo BD7_LOTGUI

82 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Titulo Lot Guia XML
Descrio Numero Lote Guia XML
Tipo C
Tamanho 12
Browse S
Visual A
Context R


Campo BQV_NUMIMP
Titulo Nr. Impresso
Descrio Numero do Impresso
Tipo C
Tamanho 20
Visual V


Campo BEJ_NUMIMP
Titulo Nr. Impresso
Descrio Numero do Impresso
Tipo C
Tamanho 20
Visual V


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

Campo BEJ_TPPROC
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 83
Titulo Tipo Proced
Descrio Tipo de Procedimento
Tipo C
Tamanho 1
Visual V
Box
0=Procedimento;1=Material;2=Medicamento;3=Taxas;4=Dirias;
5=rtese/Prtese;6=Pacote;7=Gases Medicinais;8=Aluguis


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


Campo BEJ_DATPRO
Titulo Dt. Proc.
Descrio Data Proc.
Tipo D
Tamanho 8
Visual V
Relao
If(Inclui .Or. Empty(BEJ->BEJ_DATPRO),dDataBase,BEJ-
>BEJ_DATPRO)


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


Campo BZI_FILIAL

84 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Titulo Filial
Descrio Filial do Sistema
Tipo C
Tamanho 2



Campo BZI_CODINT
Titulo Operadora
Descrio Operadora
Tipo C
Tamanho 4
Visual V


Campo BZI_CODEMP
Titulo Cod. Empresa
Descrio Cod. Empresa
Tipo C
Tamanho 4
Visual V
Browse S


Campo BZI_MATRIC
Titulo Matricula
Descrio Matricula
Tipo C
Tamanho 6
Visual V


Campo BZI_TIPREG
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 85
Titulo Tp. Registro
Descrio Tp. Registro
Tipo C
Tamanho 2
Visual V


Campo BZI_DIGITO
Titulo Digito
Descrio Digito
Tipo C
Tamanho 1
Visual V


Campo BZI_NOMUSR
Titulo Nome Usurio
Descrio Nome Usurio
Tipo C
Tamanho 50
Visual V
Browse S


Campo BZI_OPERDA
Titulo Oper. RDA
Descrio Operadora RDA
Tipo C
Tamanho 4
Visual V
Browse S

Campo BZI_CODRDA

86 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Titulo Cdigo RDA
Descrio Cdigo RDA
Tipo C
Tamanho 6
Visual V
Browse S


Campo BZI_NOMRDA
Titulo Nome RDA
Descrio Nome RDA
Tipo C
Tamanho 40
Visual V
Browse S


Campo BZI_CODLOC
Titulo Cdigo Local
Descrio Cdigo Local
Tipo C
Tamanho 3
Visual V
Browse S










Campo BZI_DATCHE
Titulo Data Atendim
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 87
Descrio Data Atendim
Tipo D
Tamanho 8
Visual V
Browse S


Campo BZI_HORCHE
Titulo Hr Chegada
Descrio Hora de Chegada
Tipo C
Tamanho 5
Visual V
Browse S


Campo BZI_HORTER
Titulo Hr. Termino
Descrio Hora Termino do Atendimen
Tipo C
Tamanho 5
Visual V
Browse S


Campo BZI_CODUSR
Titulo Cod Usurio
Descrio Cdigo do Usurio
Tipo C
Tamanho 6
Visual V
Browse S


Campo BZI_TRILHA

88 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Titulo Trilha Carto
Descrio Trilha Carto
Tipo C
Tamanho 200
Visual V
Browse S



Campo B01_NUMIMP
Tamanho 20


Campo B02_NUMIMP
Titulo Nr. Impresso
Descrio Numero do Impresso
Tipo C
Tamanho 20


Campo BD5_NUMIMP
Tamanho 20


Campo BD6_NUMIMP
Tamanho 20


Campo BD7_NUMIMP
Tamanho 20




Campo BE1_NUMIMP
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 89
Tamanho 20
Campo BE2_NUMIMP
Tamanho 20
Titulo Nr. Impresso
Descrio Numero do Impresso


Campo BE4_NUMIMP
Tamanho 20


Campo BEA_NUMIMP
Tamanho 20


Campo BEF_NUMIMP
Tamanho 20

6. Alterao da tabela no SIX (ndices):
Tabela BSA
Ordem 2
Chave BSA_FILIAL+BSA_CONTEU
Descrio Filial + Contedo

Tabela BA0
Ordem 3
Chave BA0_FILIAL+BA0_CODCLI+BA0_LOJCLI
Descrio Cod.Cliente+Loja


Tabela BA0

90 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
Ordem 4
Chave BA0_FILIAL+BA0_CGC
Descrio CGC
Tabela BA0
Ordem 5
Chave BA0_FILIAL + BA0_SUSEP
Descrio Registro ANS

Tabela BAQ
Ordem 4
Chave BAQ_FILIAL + BAQ_CODINT + BAQ_CBOS
Descrio Operadora + CBOS

Tabela BZI
Ordem 1
Chave BZI_FILIAL + BZI_CODUSR + BZI_HORTER
Descrio Cod Login Web + Hor Termino

Tabela BZI
Ordem 2
Chave
BZI_FILIAL + BZI_CODINT + BZI_CODEMP + BZI_MATRIC +
BZI_TIPREG + BZI_DIGITO + BZI_CODUSR + BZI_HORTER
Descrio
Oper. X Usr. + Empresa + Matricula + Tp. Reg + Dig + H Ter
+ Cod. Usu

Tabela BZI
Ordem 3
Chave BZI_FILIAL + BZI_DATCHE
Descrio Data de Chegada
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 91

Tabela BZI
Ordem 4
Chave BZI_FILIAL + BZI_CODRDA + BZI_CODLOC
Descrio Cdigo da Rda + Local de Atendimento

Tabela BEA
Ordem G
Chave BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_LOTGUI
Descrio Operadorda Rda + Cdigo Rda + Lote Guia

Tabela BEA
Ordem H
Chave BEA_FILIAL + BEA_OPERDA + BEA_CODRDA + BEA_NUMIMP
Descrio Operadora Rda + Cdigo Rda + Numero Impresso

Tabela BE4
Ordem B
Chave BE4_FILIAL + BE4_OPERDA + BE4_CODRDA + BE4_LOTGUI
Descrio Operadora Rda + Cdigo Rda + Lote Guia

Tabela BB8
Ordem 4
Chave
BB8_FILIAL + BB8_TIPLOG + BB8_CEP + BB8_NR_END +
BB8_EST
Descrio 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_ = ' '

92 Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus
UPDATE BE4??? SET BE4_COMNAL = 1 WHERE BE4_FILIAL = ' ' AND BE4_TIPNAS = 9 AND D_E_L_E_T_ = ' '
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 8 Server, as
informaes do idioma, interface, diretrios e repositrios e, opcionalmente, as informaes
para acesso ao TOPConnect.

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
Boletim Tcnico Planos de Sade Roteiro de configurao de Web Services e Portal Protheus 93
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).

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, repassando-
o 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 8, 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


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

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.