Linha Microsiga Protheus

Page tree

Versions Compared

Old Version 4

changes.mady.by.user Renan Sakai de Almeida

Saved on

compared with

New Version 5

changes.mady.by.user Renan Sakai de Almeida

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

PTU A1300 - Cadastro Nacional de Beneficiários

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Saúde

Módulo:

SIGAPLS

Rotina:

Rotina

Nome Técnico

Exportação A1300

PLSUA1300

País(es):

Brasil

Banco(s) de Dados:

Todos relacionados

Tabelas Utilizadas:

BA1 - Usuários

BA3 - Famílias Usuários

BI3 - Produtos de Saúde

BTS - Vidas

BG9 - Grupos Empresas

B5F - Repasse Pós/Habitual

Sistema(s) Operacional(is):

Todos



Descrição

O PTU A1300 tem pôr objetivo enviar a movimentação cadastral de usuários para atualização do Cadastro Nacional de Beneficiários. O arquivo pode gerar a movimentação:

  • Cadastro de Beneficiários Ativos;
  • Cadastro Completo;
  • Movimentação Periódica;
  • Somente Exclusões (a partir da Versão 10.0).


Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.



Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).


CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
    (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:


Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:


 

CONFIGURAÇÃO DE MENUS

 

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu

Informe o Menu em que estará localizada a rotina

Submenu

Informe o Submenu em que estará localizada a rotina

Nome da Rotina

Informe o Título da rotina

Programa

Informe o Fonte da rotina

Módulo

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Tipo

Informe a Função



Procedimento para Utilização


 O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

A versão vigente é a 10.0. Verificar o quadro Versões abaixo com os passos para aplicação da Versão 10.0


Vídeo

  • Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.


Título do Vídeo:

Disponibilizado pelo Marketing.

Introdução:

Disponibilizado pelo Marketing.

Passo a Passo:

Capturar diretamente do sistema.

Finalização:

Disponibilizado pelo Marketing.



Ponto de Entrada

Ponto de Entrada:PL1300QRY

Descrição:

O ponto de entrada PL1300QRY permite que o usuário manipule a Query padrão da rotina PLSUA1300. Esta query define os beneficiários que serão processados no arquivo A1300.

Localização:

Miscelânea/ Edi-Exportação/ Layout A1300

Programa Fonte:

PLSUA1300.PRW

Função:

GA1300A

Parâmetros:

Nome

Tipo

Descrição

Obrigatório

 cSQL

Caracter

Query que será executada

Sim

Retorno:
NomeTipoDescriçãoObrigatório
cSQLCaracterQuery que será executadaSim

 


Ponto de Entrada:PL1300TAG

Descrição:

O ponto de entrada PL1300TAG permite manipular Tag´s na geração do arquivo PTU A1300.

Localização:

Miscelânea/ Edi-Exportação/ Layout A1300

Programa Fonte:

PLSUA1300.PRW

Função:

GA1300A

Parâmetros:

Nome

Tipo

Descrição

Obrigatório

aDados

Array

paramixb[1] - cTag 
paramixb[2] - Recno do registro BA1 posicionado

Sim

Retorno:
NomeTipoDescriçãoObrigatório
cRetCaracterRetorno para a tag em questão
Sim

 



Ponto de Entrada:PL1300CONT

Descrição:

O ponto de entrada PL1300CONT permite manipular os contadores do registro "R318 - Contagem de Beneficiários" do arquivo PTU A1300.

Localização:

Miscelânea/ Edi-Exportação/ Layout A1300

Programa Fonte:

PLSUA1300.PRW

Função:

Contagem

Parâmetros:

Nome

Tipo

Descrição

Obrigatório

aQtd

Array

[1]nPF_CO_LOC - Número de Beneficiários ativos Pessoa Física com contrato em Custo Operacional não repassado 
[2]nPF_PP_LOC - Número de Beneficiários ativos Pessoa Física com contrato em Pré Pagamento não repassado 
[3]nPJ_CO_LOC - Número de Beneficiários ativos Pessoa Jurídica com contrato em Custo Operacional não repassado 
[4]nPJ_PP_LOC - Número de Beneficiários ativos Pessoa Jurídica com contrato em Pré Pagamento não repassado 
[5]nPF_REP_CO - Número de Beneficiários ativos Pessoa Física repassados para outra Unimed em Custo Operacional 
[6]nPF_REP_PP - Número de Beneficiários ativos Pessoa Física repassados para outra Unimed em Pré Pagamento 
[7]nPJ_REP_CO - Número de Beneficiários ativos Pessoa Jurídica repassados para outra Unimed em Custo Operacional 
[8]nPJ_REP_PP - Número de Beneficiários ativos Pessoa Jurídica repassados para outra Unimed em Pré Pagamento 
[9]nPF_REC_CO - Número de Beneficiários ativos Pessoa Física recebidos de outra Unimed em Custo Operacional 
[10]nPF_REC_PP - Número de Beneficiários ativos Pessoa Física recebidos de outra Unimed em Pré Pagamento 
[11]nPJ_REC_CO - Número de Beneficiários ativos Pessoa Jurídica recebidos de outra Unimed em Custo Operacional 
[12]nPJ_REC_PP - Número de Beneficiários ativos Pessoa Jurídica recebidos de outra Unimed em Pré Pagamento

Sim

Retorno:
NomeTipoDescriçãoObrigatório
cQtd
aQtdArray[1]nPF_CO_LOC - Número de Beneficiários ativos Pessoa Física com contrato em Custo Operacional não repassado 
[2]nPF_PP_LOC - Número de Beneficiários ativos Pessoa Física com contrato em Pré Pagamento não repassado 
[3]nPJ_CO_LOC - Número de Beneficiários ativos Pessoa Jurídica com contrato em Custo Operacional não repassado 
[4]nPJ_PP_LOC - Número de Beneficiários ativos Pessoa Jurídica com contrato em Pré Pagamento não repassado 
[5]nPF_REP_CO - Número de Beneficiários ativos Pessoa Física repassados para outra Unimed em Custo Operacional 
[6]nPF_REP_PP - Número de Beneficiários ativos Pessoa Física repassados para outra Unimed em Pré Pagamento 
[7]nPJ_REP_CO - Número de Beneficiários ativos Pessoa Jurídica repassados para outra Unimed em Custo Operacional 
[8]nPJ_REP_PP - Número de Beneficiários ativos Pessoa Jurídica repassados para outra Unimed em Pré Pagamento 
[9]nPF_REC_CO - Número de Beneficiários ativos Pessoa Física recebidos de outra Unimed em Custo Operacional 
[10]nPF_REC_PP - Número de Beneficiários ativos Pessoa Física recebidos de outra Unimed em Pré Pagamento 
[11]nPJ_REC_CO - Número de Beneficiários ativos Pessoa Jurídica recebidos de outra Unimed em Custo Operacional 
[12]nPJ_REC_PP - Número de Beneficiários ativos Pessoa Jurídica recebidos de outra Unimed em Pré Pagamento
Sim



Ponto de Entrada:PLS500RP

Descrição:

A função do ponto de entrada PLS500RP é retirar os caracteres especiais remanescentes e específicos, após passar pela rotina padrão. Está localizado na função que retira os caracteres especiais dos campos que possuem formatação na rotina de exportação do PTU A500/A700.

Localização:

Miscelânea/ Edi-Exportação/ Layout A1300

Programa Fonte:

PLSUA1300.PRW

Função:

RetPonto

Parâmetros:

Nome

Tipo

Descrição

Obrigatório

cExp

Caracter

String a ser manipulada

Sim

Retorno:
NomeTipoDescriçãoObrigatório
cRetCaracterString manipuladaSim

Versões

Versão 10.0

Passos para aplicar a versão 10.0:

Aplicação de Layouts

É necessário aplicar o layout A1300D através da rotina Aplicação Lay-out (PLSPTUAPL).

Aplicação de Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o UPDPLSI6 é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório  \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.


Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.


Contate o Help Desk Framework EM CASO DE DÚVIDAS!


  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o U_UPDPLSI5 no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 11/05/2018.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.


Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o UPDPLSI6 é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório  \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.


Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.


Contate o Help Desk Framework EM CASO DE DÚVIDAS!


  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o U_UPDPLSI6 no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 17/05/2018.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.


Atualizações do Compatibilizador


1. Criação de Campos no arquivo SX3 – Campos:

  • Tabela BA1 - Usuários:


Campo

BA1_TIPTEL

Tipo

Caracter

Tamanho

1

Decimal

0

Formato

@!

Título

Tipo Telef.

Descrição

Tipo Telefone

Nível


Usado

Não

Obrigatório

Não

Browse

Não

Opções

1=Residencial;2=Profissional;3=Celular

When


Relação


Val. Sistema

Pertence('123') .Or. Vazio()

Help

Informe o tipo de telefone


  • Tabela BTS -Vidas:


Campo

BTS_TIPTEL

Tipo

Caracter

Tamanho

1

Decimal

0

Formato

@!

Título

Tipo Telef.

Descrição

Tipo Telefone

Nível


Usado

Não

Obrigatório

Não

Browse

Não

Opções

1=Residencial;2=Profissional;3=Celular

When


Relação


Val. Sistema

Pertence('123') .Or. Vazio()

Help

Informe o tipo de telefone


  • Tabela B5F - Repasse Pós/Habitual:


Campo

B5F_MATHAB

Tipo

Caracter

Tamanho

15

Decimal

0

Formato

@!

Título

Matric.Hab.

Descrição

Matrícula Habitual

Nível


Usado

Não

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Matricula assumida na Operadora Habitual