Linha Microsiga Protheus

Page tree

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


No Plano de Saúde (SIGAPLS), acesse Miscelânea / Unimed / Exportação / PTU 1300, informe os parâmetros abaixo para gerar o arquivo:


Pergunta:

Descrição:

Layout PTU A1300

Informe o layout/versão vigente para exportação.

Unimed Origem

Informe o código da Unimed Origem para geração do arquivo

Unimed DestinoInforme o código da Unimed Destino do arquivo (padrão é a Unimed do Brasil 0999)
Tipo de Movimentação

Informe qual será o tipo do arquivo gerado:

  • Cadastro de Beneficiários Ativos;
  • Cadastro Completo;
  • Movimentação Periódica;
  • Somente Exclusões (a partir da Versão 10.0).
Data InicialInforme a data inicial de Inclusão/Alteração/Exclusão dos beneficiários que serão incluídos no arquivo (exceto Cadastro Completo).
Data FinalInforme a data final de Inclusão/Alteração/Exclusão dos beneficiários que serão incluídos no arquivo (exceto Cadastro Completo).
Diretório de GravaçãoInforme o diretório onde será gravado o arquivo A1300.
Ano Ref. ContagemInforme o Ano Base para realização da Contagem de Beneficiários
Mês Ref. ContagemInforme o Mês Base para realização da Contagem de Beneficiários
Grupo/empresa DeInforme o código da Empresa Inicial (BA1_CODEMP)
Grupo/empresa Ate

Informe o código da Empresa Final (BA1_CODEMP)

Contrato DeInforme o código do Contrato Inicial (BA1_CONEMP)
Contrato Ate
Informe o código do Contrato Final (BA1_CONEMP)
SubContrato DeInforme o código do SubContrato Inicial (BA1_SUBCON)
SubContrato AteInforme o código do SubContrato Final (BA1_SUBCON)



Pontos 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
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

Na versão 10.0 foi implementado o novo registro R316 - Inativação do Beneficiário. Este registro é gerado quando selecionado as opções Cadastro Completo, Movimentação Periódica e Somente Exclusões.

Quando selecionado Cadastro Completo e Movimentação Periódica, o registro R316 será posteriormente a todos os beneficiários:

Quando selecionado a opção Somente Exclusões, o sistema vai gerar somente os registros R301, R316 e R319:

O registro R307 - Dados de Compartilhamento de Risco também foi reformulado, ele agora permite enviar N registros para o mesmo beneficiário (um beneficiário pode ser repassado habitualmente para N Operadoras).

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


  • Tabela BC4 - Redes de Atendimento Fluxo:

Campo

BC4_MOTSUB

Tipo

Caracter

Tamanho

2

Decimal

0

Formato

@!

Título

Motiv.Subst.

Descrição

Motivo de Substituição

Nível


Usado

Não

Obrigatório

Não

Browse

Não

Opções

#PLSMOTSUB()

When

BAU->BAU_TIPPRE = 'HOS'

Relação


Val. Sistema


Help

Informe o motivo de substituição



Campo

BC4_OFICIO

Tipo

Caracter

Tamanho

10

Decimal

0

Formato

@!

Título

Oficio

Descrição

Oficio

Nível


Usado

Não

Obrigatório

Não

Browse

Não

Opções


When

BAU->BAU_TIPPRE = 'HOS'

Relação


Val. Sistema


Help

Informe o ofício.


  • Tabela BI3 - Produtos de Saúde

Campo

BI3_CODPTU

Tipo

Caracter

Tamanho

3