01. DADOS GERAIS
| Produto: | TOTVS Saúde Planos |
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Saude |
| Módulo: | PTU |
| Função: | A500 |
| Ticket: | |
| Requisito/Story/Issue (informe o requisito relacionado) : | DSAUPC-23115 |
02. SITUAÇÃO/REQUISITO
Devido as alterações da versão PTU 8.2025, foram realizados ajustes no processo de Exportação do leiaute PTU de Cobrança ou Utilização
03. SOLUÇÃO
Atualizado o processo de geração do arquivo PTU de Cobrança ou Utilização para a versão 8.2025 Tipo do Contrato do Beneficiário.
Configuração:
Coloque a API no campo URL Type (BA0_CBTYPE). Exemplo:
No parâmetro MV_PLTPCNB informe qual será a data início da vigência desta funcionalidade. Quando gerado lote com a data inferior a do parâmetro, o sistema se comportará como se não houvesse este processo.
Processo:
Ao carregar os dados das faturas no lote de intercâmbio, o sistema irá consumir a API que verifica o Tipo do Contrato do Beneficiário gravando o status de cada beneficiário do lote no campo Tp.Ctr.Inter(BA1_TPCNIN) . Somente Beneficiários que tem o campo Matrícula Antiga (BA1_MATANT) serão considerados na busca para o lote. Isso porque na API enviamos essas matrículas.
No caso de beneficiários que fazem parte do PEA, o sistema vai verificar a empresa que ele pertence e comparar com o conteúdo do parâmetro MV_PLSCPEA. Sendo PEA, a matrícula que será enviada pela API é a que fica no campo BA1_MATEDI.
No lote de Intercâmbio há o campo Tp.Ctr.Inter (Tipo Contrato intercâmbio) você deve escolher qual será o Tipo de Contrato que pertence este lote. Caso você selecione o Tipo Pré-Estabelecido todos os beneficiários que fazem parte deste lote terá seu tipo de contrato checado e no caso do pré-estabelecido será considerado também os beneficiários com status indeterminado. Caso você selecione a opção Pós-Estabelecido será considerado apenas beneficiários cujo seu produto seja Pós-Estabelecido.
Obs.: Se você estiver gerando um lote Pré (Por exemplo) e algum dos beneficiário que estiver nesse lote seja Pós o sistema irá retirá-lo do lote. Nesse caso basta você gerar um novo lote Pós que ele será considerado.
Lote de intercâmbio gerado com o novo campo.
Ao gerar o lote de intercâmbio, caso a Unimed retorne que há ao menos 1 matrícula inválida entre as enviadas, o sistema irá exibir a tela abaixo apresentando qual é esta matrícula. O lote não será concluído e deve ser gerado novamente após ajuste da matrícula. No exemplo abaixo a matrícula é inválida devido a quantidade de dígitos.
Ao exportar o arquivo PTU de Cobrança ou Utilização, para as movimentações de Pré-Estabelecido e Indeterminado o sistema irá gerar o arquivo com um _pre no final. Para Pós-Estabelecido será gerado _pos. Exemplo:
Importante: Caso haja alguma falha no consumo da API, não será possível gerar o lote de intercâmbio.
Importação PTU de Cobrança ou Utilização
No processo de importação do arquivo PTU de Cobrança ou Utilização nada muda. Agora os arquivos terão em seu nome o _pre para arquivos que tenham apenas movimentações de Pré-Estabelecido e _pos para movimentaçõe Pós-Estabelecida. Exemplo de arquivo:
Alteração de Dicionário:
Novos campos:
| Campo | Tipo | Tamanho | Decimal | Contexto | Propriedade | Título | Descrição | Picture | Validação | Lista de Opções | Usado | Browse | Obrigatório | Modo Edição |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BA1_TPCNIN | Caracter | 1 | 0 | Real | Visualizar | Tp.Ctr.Inter | Tipo Contrato Intercâmbio | @! | PERTENCE("PCI ") | P=Pré-Estabelecido;C=Pós-Estabelecido;I=Indeterminado | Sim | Sim | Não | GetNewPar("MV_PLSUNI", "0") == "1" |
| BA1_DTHRUL | Caracter | 19 | 0 | Real | Visualizar | Ult.Atu.Ctr | Ult.Atualiz.Tipo Contrato | @! | Sim | Sim | Não | GetNewPar("MV_PLSUNI", "0") == "1" | ||
| BTF_TPCNIN | Caracter | 1 | 0 | Real | Alterar | Tp.Ctr.Inter | Tipo Contrato Intercâmbio | @! | PERTENCE("PC ") | P=Pré-Estabelecido/Indeterminado;C=Pós-Estabelecido | Sim | Sim | Não | GetNewPar("MV_PLSUNI", "0") == "1" |
| BTO_TPCNIN | Caracter | 1 | 0 | Real | Visualizar | Tp.Ctr.Inter | Tipo Contrato Intercâmbio | @! | PERTENCE("PC ") | P=Pré-Estabelecido/Indeterminado;C=Pós-Estabelecido | Sim | Sim | Não | GetNewPar("MV_PLSUNI", "0") == "1" |
| BA0_CBTYPE | Caracter | 200 | 0 | Real | Alterar | URL Type | URL Type | @! | Sim | Sim | Não | GetNewPar("MV_PLSUNI", "0") == "1" |
Parâmetro:
| Parâmetro | Tipo | Conteúdo | Descrição |
|---|---|---|---|
| MV_PLTPCNB | Caracter | 20250825 | Início da data de vigência do tratamento para o campo Tipo de Contrato |
04. DEMAIS INFORMAÇÕES
É necessário ter as configurações do CADBENEF de ID_CLIENT. Documentação:
CadBenef Online - Configuração
05. ASSUNTOS RELACIONADOS
Não se aplica





