You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 7
Next »
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
- 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: | | Nome | Tipo | Descrição | Obrigatório |
|---|
| cSQL | Caracter | Query que será executada | Sim |
|
| 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: | | Nome | Tipo | Descrição | Obrigatório |
|---|
| cRet | Caracter | Retorno 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: | | 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 |
|
| 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: | | Nome | Tipo | Descrição | Obrigatório |
|---|
| cRet | Caracter | String manipulada | Sim |
|
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: - No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
- 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.
- 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;
- 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).
- Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
- Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
- 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! |
|---|
- 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.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- 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: - No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
- 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.
- 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;
- 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).
- Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
- Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
- 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! |
|---|
- 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.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
Atualizações do Compatibilizador
1. Criação de Campos no arquivo SX3 – Campos:
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 |
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
|
