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 Destino | Informe 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 Inicial | Informe a data inicial de Inclusão/Alteração/Exclusão dos beneficiários que serão incluídos no arquivo (exceto Cadastro Completo). |
Data Final | Informe 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ção | Informe o diretório onde será gravado o arquivo A1300. |
Ano Ref. Contagem | Informe o Ano Base para realização da Contagem de Beneficiários |
Mês Ref. Contagem | Informe o Mês Base para realização da Contagem de Beneficiários |
Grupo/empresa De | Informe o código da Empresa Inicial (BA1_CODEMP) |
Grupo/empresa Ate
| Informe o código da Empresa Final (BA1_CODEMP) |
Contrato De | Informe o código do Contrato Inicial (BA1_CONEMP) |
Contrato Ate
| Informe o código do Contrato Final (BA1_CONEMP) |
SubContrato De | Informe o código do SubContrato Inicial (BA1_SUBCON) |
SubContrato Ate | Informe 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: | 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
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: - 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
|
- 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 |