PTU A100/A200 - Movimentação Cadastral de Beneficiários no Intercâmbio
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||||||
Segmento: | Saúde | ||||||||||
Módulo: | SIGAPLS | ||||||||||
Rotina: |
| ||||||||||
País(es): | Brasil | ||||||||||
Tabelas envolvidas: | BA1 - Beneficiários B5F - Beneficiários Habituais | ||||||||||
Banco(s) de Dados: | Todos relacionados | ||||||||||
Sistema(s) Operacional(is): | Todos |
Descrição
O PTU A100 tem como objetivo a Movimentação cadastral de Beneficiários de compartilhamento de risco da Unimed Origem (detentora do contrato) para a Unimed Destino (onde o beneficiário terá o atendimento). No caso de Federações intermediando este compartilhamento de risco, os arquivos devem ser enviados um para cada Unimed de destino final.
O PTU A200 envia o retorno da movimentação cadastral dos Beneficiários de compartilhamento de risco da Unimed Destino para a Unimed Origem, informando se os dados da movimentação recebida não tiveram erros. No caso de haverem Federações intermediando este compartilhamento de risco, os arquivos devem ser enviados um para cada Unimed de destino final.
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
Exportação PTU A100
No Plano de Saúde (SIGAPLS), acesse Miscelânea / Unimed / Exportação / PTU A100
Pergunta: | Descrição |
Empresa Inicial | Informar o código da Empresa Inicial (BA1_CODEMP). |
Empresa Final | Informar o código da Empresa Final (BA1_CODEMP). |
Movimento Inicial | Informar a data de vigência inicial (B5F_VIGINI). |
Movimento Final | Informar a data de vigência final(B5F_VIGINI). |
Tipo de Envio | Informar o conteúdo a ser escrito no campo TP_MOV do PTU A100. |
Diretório de Gravação | Informar o diretório onde será gravado o arquivo. |
Layout | Informar o layout/versão vigente para exportação. |
Operadora Destino De | Informar o código da Operadora Inicial(B5F_OPEHAB). |
Operadora Destino Até | Informar o código da Operadora Final(B5F_OPEHAB). |
Tipo de Contrato | Informe o tipo de contrato. Ao selecionar 1-Pré-Pagamento serão considerado os campos BA1_OPEORI e BA1_OPEDES para o envio. Ao selecionar 2-Pós-Pagamento será considerada toda a estrutura de tabela B5F. |
Importação PTU A100
No Plano de Saúde (SIGAPLS), acesse Miscelânea / Unimed / Importação / PTU A100
Pergunta: | Descrição |
Layout | Informar o layout/versão vigente para importação. |
Diretório | Informar o diretório onde está o arquivo. |
Tp Bloq Usu Bloq | Informar o tipo de bloqueio para usuário com data de exclusão |
Tp Bloq Importação | Informar o tipo de bloqueio para usuário importado sem data de exclusão (inclusão/alteração) |
Dt Bloq Importação | Informar a data do bloqueio |
Após informar as perguntas, a rotina irá ler o arquivo e listar os beneficiários em uma tela.
O usuário deverá informar os campos de Empresa, Contrato, Sub-Contrato e Produto que são onde os beneficiários serão incluídos.
Ao confirmar, automaticamente será gerado o PTU A200 no mesmo diretório do PTU A100 importado.
Importação PTU A200
No Plano de Saúde (SIGAPLS), acesse Miscelânea / Unimed / Importação / PTU A200(PLSP200)
Pergunta: | Descrição |
Layout | Informar o layout/versão vigente para importação. |
Diretório | Informar o diretório onde está o arquivo. |
Excluir Importação | Informar se deseja realizar a reversão de uma importação de arquivo do A200. |
Após a importação, os registros da tabela de Beneficiários habituais (compartilhamento de risco) terão seu registro atualizado com as informações do arquivo.
Pontos de Entrada
Nome: | PLSUA1MT | |||||||||
Descrição: | Este Ponto Entrada permite a alteração da matricula do beneficiário para exportação do PTU A100 | |||||||||
Localização: | Ao exportar o PTU A100 | |||||||||
Programa Fonte: | PLSUA100 | |||||||||
Função: | ProcA100 | |||||||||
Parâmetros |
| |||||||||
Retorno: |
|
Parâmetros
Itens/Pastas | Descrição |
Nome: | MV_PLCDTIT |
Tipo: | Caracter |
Cont. Por.: | |
Descrição: | Código indicador do titular do contrato.. Exemplo "T" |
Itens/Pastas | Descrição |
Nome: | MV_PLCDDEP |
Tipo: | Caracter |
Cont. Por.: | "D" |
Descrição: | Código indicador do dependente do contrato |
Itens/Pastas | Descrição |
Nome: | MV_PLCDTGP |
Tipo: | Caracter |
Cont. Por.: | |
Descrição: | Grau de parentesco do titular. |
CONFIGURAÇÃO DE MENUS
- 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 | Miscelanea |
Submenu | Unimed |
Submenu | Importação |
Nome da Rotina | PTU A200 |
Programa | PLSP200 |
Módulo | Plano de Saúde |
Atualizações do Compatibilizador
1. Criação de Campos no arquivo SX3 – Campos:
- Tabela B5F - Repasse Pós/Habitual:
Campo | B5F_OPEHAB |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Oper. Destin |
Descrição | Operadora Destino |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Val. Sistema | ExistCPO("BA0") .And. P272VldFie() |
Help | Informe a Operadora Destino |
Campo | B5F_OPEORI |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Oper. Origem |
Descrição | Operadora Origem |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Val. Sistema | ExistCPO("BA0") .And. P272VldFie() |
Help | Informe a Operadora Origem |
Campos do Manual PTU Batch vs Campos do Protheus
Tipo de Registro | Campo PTU | Sequencia | Campo Protheus |
---|---|---|---|
R102 | NM_EMPR_CO | 5 | BG9_DESCRI |
R102 | CD_CGC_CPF | 8 | A1_CGC |
R102 | DS_END_PRI | 10 | A1_END ou BA0_END |
R102 | NR_CEP | 13 | A1_CEP |
R102 | CD_MUNIC | 22 | A1_MUN(Utiliza para ver regra Protheus x PTU) |
R102 | NR_END | 25 | A1_END ou BA0_NUMEND |
R102 | NM_EMPR_AB | 26 | BG9_NREDUZ |
R103 | CD_PLANO_O | 3 | BI3_CODIGO |
R103 | DS_PLANO_O | 4 | BI3_DESCRI |
R103 | DT_INCL_UN | 6 | BI3_DATINC |
R103 | DT_EXCL_UN | 7 | BI3_DATBLO |
R103 | TP_CONTRAT | 8 | BI3_NATJCO |
R103 | TP_ABRANGE | 9 | BI3_ABRANG(Utiliza para ver regra Protheus x PTU) |
R103 | CD_OPE_ANS | 11 | BA0_SUSEP |
R103 | CD_PRD_ANS | 12 | BI3_SUSEP |
R103 | ID_PLANO | 13 | BI3_APOSRG(Utiliza para ver regra Protheus x PTU) |
R103 | CD_PLANO_I | 14 | BI3_CODPTU |
R104 | CD_UNI | 3 | BA1_CODINT |
R104 | ID_BENEF | 5 | BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO ou Ponto de Entrada "PLSUA1MT" |
R104 | CD_FAMI | 6 | BA1_MATRIC |
R104 | NM_BENEF_4 | 7 | BTS_NOMCAR |
R104 | DT_NASC_4 | 9 | BA1_DATNAS |
R104 | TP_SEXO_4 | 10 | BA1_SEXO |
R104 | CD_CGCCPF4 | 11 | BA1_CPFUSR |
R104 | CD_ECIVIL | 14 | BA1_ESTCIV |
R104 | DT_INCL_04 | 15 | BA1_DATINC |
R104 | DT_EXCL_04 | 16 | BCA_DATA |
R104 | CD_DEPE | 18 | BA1_TIPREG e BA1_GRAUPA(Utiliza para ver regra Protheus x PTU) |
R104 | NR_MATRICU | 20 | BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO |
R104 | CD_LCAT | 22 | BA1_OPEDES |
R104 | DT_REPASSE | 26 | BA1_DATREP |
R104 | DT_FIM_REP | 27 | B5F_VIGFIM |
R104 | DT_INCL_PL | 28 | BA1_DATREP |
R104 | CD_PLANO_O | 30 | BI3_CODIGO |
R104 | ID_BENEF_T | 32 | BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO |
R104 | NM_COMPL_B | 33 | BA1_NOMUSR |
R104 | CARTAO_NAC | 34 | BTS_NRCRNA |
R104 | NM_MAE | 35 | BA1_MAE |
R104 | PIS_PASEP | 36 | BA1_PISPAS |
R104 | CD_PLANO_I | 37 | BI3_CODPTU |
R104 | SEG_PLANO | 38 | BI6_CODEDI |
R104 | EXCL_RN412 | 40 | BCA_SOL412 |
R107 | D_END_PRI7 | 3 | BA1_ENDERE + BA1_NR_END |
R107 | DS_BAIRRO7 | 4 | BA1_BAIRRO |
R107 | NR_CEP_07 | 5 | BA1_CEPUSR |
R107 | DS_CIDADE7 | 6 | BA1_MUNICI |
R107 | CD_UF_7 | 7 | BA1_ESTADO |
R107 | NR_DDD_7 | 8 | BA1_DDD |
R107 | NR_FONE_7 | 11 | BA1_TELEFO |
R107 | NR_END_7 | 12 | BA1_NR_END |
R108 | CD_CODIGO | 3 | BF3_CODDOE |
R108 | DT_FIM_CAR | 4 | BF3_DATCPT |
Versões
Versão 10.0
Passos para aplicar a versão 10.0:
Aplicação de Layouts
É necessário aplicar os layouts A100F e A200C 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 UPDPLSI5 é 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:
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.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o UPDPLSI5 é 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:
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.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Atualizações do Compatibilizador
1. Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B5F | Repasse Pós/Habitual | C | N |
2. Criação de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo | B5F_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Filial |
Descrição | Filial do Sistema |
Nível | |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Filial do sistema |
Campo | B5F_OPEORI |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Oper. Origem |
Descrição | Operadora Origem |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | ExistCpo("BA0") |
Help | Código da Operadora Origem |
Campo | B5F_DESORI |
Tipo | Caracter |
Tamanho | 60 |
Decimal | 0 |
Formato | @! |
Título | Desc Origem |
Descrição | Descrição Origem |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | ALLTRIM(POSICIONE("BA0",1,XFILIAL("BA0")+B5F->B5F_OPEORI,"BA0_NOMINT")) |
Val. Sistema | |
Help | Código da Operadora Origem |
Campo | B5F_OPEHAB |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Oper. Destino |
Descrição | Operadora Destino |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | ExistCpo("BA0") |
Help | Código da Operadora Destino |
Campo | B5F_DESHAB |
Tipo | Caracter |
Tamanho | 60 |
Decimal | 0 |
Formato | @! |
Título | Desc Habitua |
Descrição | Descrição Habitual |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | ALLTRIM(POSICIONE("BA0",1,XFILIAL("BA0")+B5F->B5F_OPEHAB,"BA0_NOMINT")) |
Val. Sistema | |
Help | Código da Operadora Habitual |
Campo | B5F_CODINT |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Cód. Operadora |
Descrição | Código Operadora |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_CODINT |
Val. Sistema | |
Help | Código da Operadora na Matricula |
Campo | B5F_CODEMP |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Cód. Empresa |
Descrição | Código Empresa |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_CODEMP |
Val. Sistema | |
Help | Código da Empresa na Matricula |
Campo | B5F_MATRIC |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Matrícula |
Descrição | Matrícula |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_MATRIC |
Val. Sistema | |
Help | Código da matrícula da família. |
Campo | B5F_TIPREG |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Tp. Registro |
Descrição | Tipo Registro |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_TIPREG |
Val. Sistema | |
Help | Código da matrícula da família. |
Campo | B5F_DIGITO |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Dígito |
Descrição | Dígito |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_DIGITO |
Val. Sistema | |
Help | Código do dígito na Matricula |
Campo | B5F_MATANT |
Tipo | Caracter |
Tamanho | 17 |
Decimal | 0 |
Formato | @! |
Título | Mat.Sist.Ant. |
Descrição | Mat.Sistema Antigo |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_MATANT |
Val. Sistema | |
Help | Matrícula no sistema antigo |
Campo | B5F_NOMUSR |
Tipo | Caracter |
Tamanho | 70 |
Decimal | 0 |
Formato | @! |
Título | Nome Usuário |
Descrição | Nome Usuário |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | BA1->BA1_NOMUSR |
Val. Sistema | |
Help | Nome do beneficiário. |
Campo | B5F_VIGINI |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Formato | |
Título | Vigência Ini |
Descrição | Data Vigência Inicial |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Data da vigência inicial. |
Campo | B5F_VIGFIM |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Formato | |
Título | Vigência Fim |
Descrição | Data Vigência Final |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Data da vigência final |
Campo | B5F_STATUS |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | |
Título | Status |
Descrição | Status |
Nível | |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | 1=Pend.Envio;2=Enviado;3=Acatado;4=Rejeitado;5=Recebido |
When | |
Relação | IIF(!INCLUI,"1",B5F->B5F_STATUS) |
Val. Sistema | |
Help | Status do envio. |
Campo | B5F_CODRET |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Cod Ret A200 |
Descrição | Cod Ret A200 |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Codigo do Retorno do A200. |
Campo | B5F_MSGRET |
Tipo | Caracter |
Tamanho | 80 |
Decimal | 0 |
Formato | @! |
Título | Desc Ret A200 |
Descrição | Desc Ret A200 |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Mensagem de retorno do A200 |
Campo | B5F_ARQEDI |
Tipo | Caracter |
Tamanho | 50 |
Decimal | 0 |
Formato | @! |
Título | Arq.Import. |
Descrição | Arquivo Importado |
Nível | |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Arquivo de importacao. |