Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Giovanna Charlo

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Giovanna Charlo

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

TOTVS Saúde Planos

Solucoes_totvs
Solucao

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linha Protheus 

Linhas_totvs

Segmento:

Saude 

Segmentos_totvs
Segmento

Módulo:PTU
Função:A1300
Ticket:

22473076

Issue:DSAUBE-25736


02. SITUAÇÃO/REQUISITO

Houve a necessidade de adequar o produto TOTVS Saúde Planos - Linha Protheus com a versão 2.2025 referente ao CadBenef Online - Serviços de Movimentação Cadastral de Beneficiários, com a entrada em vigor para 14/02/2024.

03. SOLUÇÃO

   Todas as alterações descritas neste documento foram implementadas de acordo com as regras impostas pela Unimed do Brasil em seus manuais e comunicados.

   Para mais informações poderá ser consultado os manuais e comunicados no site http://www.unimed.coop.br/.

Novas Regras

...

PTU Online Versão 2.2025:

Transações que foram alteradas no bloco prestador executante:

  • 00600 – Pedido de Autorização
  • 00605 – Pedido de Complementação de Autorização
  • 00806 – Ordem de Serviço

Manual PTU Online 9.0:

Image Removed

Cobertura Especial Atendimento

Totvs custom tabs box
tabsImplementação/Manutenção de Tags, Remoção Compartilhamento de TagsRisco
idsinclusao,exclusaorisco

Observação: Será obrigatório informar a especialidade do solicitante em guias de SADT ou Internação, para o sistema buscar o CBO do mesmo.

Transações que foram alteradas no bloco prestador Solicitante:

  • 00600 – Pedido de Autorização
  • 00605 – Pedido de Complementação de Autorização
  • 00806 – Ordem de Serviço

Manual PTU Online 9.0:

Image Removed

Prestador Executante

Alterado o nome do bloco de Prestador para Prestador Executante

Totvs custom tabs box items
defaultyes
referenciainclusao

Nos dados do cabeçalho foram realizadas as seguintes mudanças:

Código da Versão do PTU

Prestador Solicitante

Alterado o nome do bloco de Prestador Requisitante para Prestador Solicitante

O bloco do conselho profissional foi movido para dentro do bloco do Prestador Solicitante

contéudo do bloco codigoVersaoPTU.

TagContéudo

codigoVersaoPTU

F”011”


Nos dados do beneficiário foram realizadas as seguintes mudanças:

Código da Unidade Federativa do médico cooperado

Alterado o tipo do bloco codigoUfConselho.

TagCampo do SistemaTipoRegra

codigoUfConselho

BAU_ESTCRUFObrigatório quando indicadorBeneficiarioCooperado = True 

Motivo de exclusão

Alterado o tipo do bloco motivoExclusaoBeneficiario.Adicionado ao bloco o campo numeroCBO de acordo com as regras do Manual do PTU Online 9.0.

TagCampo do SistemaTipoRegra

codigoUnimed

BE1_OPESOL ou BE4_OPESOLCaso o código do prestador solicitante possua letras, o sistema não irá enviar as tags codigoUnimed e codigoPrestador por ser opcional.

codigoPrestador

BB0_CODIGO

nomePrestadorSolic

BE1_NOMSOL ou BE4_NOMSOL

siglaConselho

BE1_SIGLA ou BE4_SIGLA

numeroConselho

BE1_REGSOL ou BE4_REGSOL

unidadeFederativa

BE1_ESTSOL ou BE4_ESTSOL

numeroCBO

BAQ_CBOS

Numero CBO da especialidade do solicitantes na tabela BAQ filtrado através dos campos BE1_ESPSOL ou BE4_ESPSOL.

motivoExclusaoBeneficiario

BG3_CODEDI, BG1_CODEDI ou BQU_CODEDI

UFObrigatório quando dataExclusaoBeneficiario estiver preenchido. 

Novas tags

 Foram incluidas as seguintes tags agrupador principal dadosBeneficiario:

TagContéudoRegra

valorMensalidade


Calculada baseada no mês e ano atual.

rendaMensal

BA3_VALSAL


carteirinhaAnterior

BA1_MATANTMandatório em casos de transferência de código de
benefciciário.

idFilho

BTS_UNIVER, BTS_DEFFIS ou "Outros"

Obrigatório sempre que o código do dependente for 10, 70 ou 75 e que tenha atingido a maioridade. 

01 – Filho Universitário
02 – Deficiente
99 – Outros

Manual PTU Online Versão 2.2025:

Image Added

Produto Agregado

No agrupador secundário produtoAgregado, em dadosBeneficiario, foram incluidas as tags:

TagCampo do SistemaRegra

indicadorCompartilhamento 

Quando BA1_OPEORI for diferente do que BA1_OPEDES é igual .T.Se o beneficiário for de compartilhamento de risco,preencher com TRUE (1) 

codigoUnimedDestino

Op. Destino (BA1_OPEDES)



Obrigatório quando beneficiário tiver Produto Agregado

tipoProduto

Cod EDI (BI3_CODPTU)

codigoPlanoDestino

Quando houver compartilhamento de risco é o campo Cod EDI (BI3_CODPTU) buscado pelo campo Prod.Interc. (BA1_PLAINT)

Caso contrário faz referência ao campo Cod EDI (BI3_CODPTU) buscado pelo campo Cód.Plano (BA1_CODPLA)

dataRepasseUnimedDestino 

Quando houver compartilhamento de risco é o campo Data Repasse (BA1_DATREP)

Caso contrário faz referência ao campo Dt. Inclusão (BA1_DATINC)

dataInicioVigenciaProduto

Data Base  (BF4_DATBAS)

dataFimVigenciaProduto

Dt. Bloqueio (BF4_DATBLO)


dataBaseCarencia

Dt. Carência (BA1_DATCAR)

Obrigatório quando beneficiário tiver Produto Agregado 

Manual PTU Online Versão 2.2025:

Image Added


Mudanças no agrupador (dadosEmpresaContratante),referentes aos dados da empresa:

Data de Inclusão e Exclusão da Empresa na Umined.

Inclusão das seguintes tags:Adicionado ao bloco o campo numeroCBO de acordo com as regras do Manual do PTU Online 9.0

TagCampo do SistemaRegra
numeroCBO

dataInclusaoEmpresaUnimed 

BAQ
BQC_
CBOS
Numero CBO da especialidade do executante na tabela BAQ filtrado através dos campos BE1_CODESP ou BE4_CODESP.
DATCONObrigatorio quando Produtos 

dataExclusaoEmpresaUnimed

BQC_DATBLO

Manual PTU Online Versão 2.2025:

Image Added

Endereços 

Na agrupadora segundária endereco,  foi realizado a mudanças no tamanho das seguintes tags:Adicionado tag no xml que indica cobertura especial de atendimento, o mesmo será enviado somente para a versão superior a 4.00.00 da TISS.

TagCampo do SistemaTamanhoRegra
idCoberturaEspecial

logradouroPrincipal

BE1_COBESP ou BE4_COBESP

Transações que sofreram alterações:

BQC_LOGRAD80

Obrigatório quando indicadores estiverem preenchidos:

indicadorAutoGestao /indicadorPlanoAcidenteTrabalho / indicadorPlanoSaudeOcupacional / indicadorPlanoAPS

complementoLogradouro 

BQC_COMPLE80

bairro

BQC_BAIRRO45
  • 00600 – Pedido de Autorização
    • 00806 – Ordem de Serviço

    Manual PTU Online 9Versão 2.02025:

    Image RemovedImage Added

    Saúde Ocupacional

    Para preencher a tag saúde ocupacional, deverá ser informado o campo BE1_TIPATE ou BE4_TIPATE da guia de Atendimento, sendo:

    Tipo de Atendimento do SistemaEnviando no PTU

    14 Saúde Ocupacional - Admissional

    1 = Admissional

    15 Saúde Ocupacional - Demissional

    2 = Demissional

    16 Saúde Ocupacional - Periódico

    3 = Periódico

    17 Saúde Ocupacional - Retorno ao Trabalho

    4 = Retorno ao Trabalho

    18 Saúde Ocupacional - Mudança de Função

    5 = Mudança de Função

    19 Saúde Ocupacional - Promoção a Saúde

    6 = Promoção a Saúde


    Telefones

    Inclusão de um novo bloco nomeado como "telefone" disposto na agrupadora dadosEmpresaContratante.

    TagCampo do SistemaTamanhoRegra

    tipoTelefone

    		BQC_TIPTEL80

    1 – Residencial
    2 – Profissional
    3 – Celular

    Quando telefone de empresa, valor do campo deverá ser 2 

    ddd

    		BQC_DDD80


    Obrigatório se tipoTelefone = 1, 2 ou 3 

    numero

    		BQC_TEL45

    ramal



    		Não Utilizado.

    Manual PTU Online Versão 2.2025:

    Image Added


    Mudanças no agrupador (dadosPlano),referentes aos dados da plano:

    AdmBeneficios

    Inclusão de novas regras referentes as seguintes tags:

    TagCampo do SistemaRegra

    cnpjAdmBeneficios

    		BQC_CNPADM

    Obrigatório quando tipoContratacao = 3

    e (Coletivo por Adesão) e protocoloProspeccao ou
    protocoloContrato preenchido 

    nomeAdmBeneficios

    		BQC_RAZSBE

    nomeFantasiaAdmBeneficios

    		BQC_SEASPL

    Manual PTU Online Versão 2.2025:

    Image AddedImage AddedImage Added

     Registro ANS da Administradora Beneficios 

    Adicionado a tag de Registro ANS da AdministradoraBeneficios 

    TagCampo do SistemaRegra

    registroANSAdmBeneficios

    		BQC_RECANS

    Obrigatório quando tipoContratacao = 3 

     e (Coletivo por Adesão) e protocoloProspeccao ou
    protocoloContrato preenchido 

    Manual PTU Online Versão 2.2025:

    Image Added


    Coberturas

    As tags de carências, passou a ser nomeadas como "coberturas". Dessa forma, serão preenchidas de acordo com a cobertura do nível configurado.

    TagCampo do SistemaRegra

    tipoCobertura


    Obrigatório se Beneficiário possuir Cobertura 

    dataFimCobertura

    BFE_DATCAR ou BA1_DATCAR 

    Obrigatório se campo tipoCobertura estiver
    preenchido

    Obs: O contéudo do tipoCobertura/dataFimCobertura será preenchido a partir do cadastro referente a cobertura. Considerando que a cobertura do beneficiário pode ser parametrizada nos seguintes níveis: 

    • Grupo Familiar (BA1): Grupos de Cobertura Usuários (BFE).
    • Grupo Familiar (BA3): Grupos de Cobertura Famílias (BFC).
    • Grupo Empresa - SubContrato (BQC): Empresa Grupo de Cobertura (BT7).
    • Produto Saúde (BI3): Planos e Grupos de Cobertura (BRV).

    Manual PTU Online Versão 2.2025:

    Image Added

    Carências

    Inclusão das tags de Carências.

    TagCampo do SistemaRegra

    tipoCarencia

    BDL_CODEDI

    Obrigatório se Beneficiário possuir Carencia

    dataFimCarencia

    BFO_DATCAR ou BA1_DATCAR

    Obrigatório se campo tipoCarencia estiver
    preenchido

    Obs: O contéudo do tipoCarencia/dataFimCarencia será preenchido a partir do cadastro referente a carência. Considerando que a carência do beneficiário pode ser parametrizada nos seguintes níveis: 

    • Grupo Familiar (BA1): Classe de Carência do Usuário (BFO).
    • Grupo Familiar (BA3): Classes Carências da Família (BFJ).
    • Grupo Empresa - SubContrato (BQC): Subcont x Prod x Classe Car (BA6).
    • Produto Saúde (BI3): Produtos da Classe Carência (BAN).

    Manual PTU Online Versão 2.2025:

    Image Added

    Transações que sofreram alterações::

    • 00600 – Pedido de Autorização
    • 00806 – Ordem de Serviço

    Manual PTU Online 9.0:

    Image Removed

    Descrição do Serviço

    A Tag descricaoServico será enviado somente quando o evento for uma codificação genérica, de acordo com os parâmetros:

    ParâmetroDescriçãoMV_PLMEDPT MedicamentoMV_PLMATPT MaterialMV_PLTAXPT TaxasMV_PLOPMPT Opme

    Transações que sofreram alterações:

    • 00600 – Pedido de Autorização
    • 00501 – Resposta de Pedido de Autorização
    • 00404 – Resposta de Auditoria
    • 00605 – Pedido de Complementação de Autorização
    • 00361 – Resposta do Status da Transação
    • 00806 – Ordem de Serviço
    • 00804 – Autorização de Ordem de Serviço

    Manual PTU Online 9.0:

    Image Removed

    Nome Social

    Adicionado no sistema o envio e o recebimento do nome social do beneficiário, caso o beneficiário não possua nome social (BA1_NOMSOC), a tag não será enviada.

    Transações que sofreram alterações:

    • 00501 – Resposta de Pedido de Autorização
    • 00413 – Resposta da Consulta de Dados do Beneficiário
    • 00806 – Ordem de Serviço

    Manual PTU Online 9.0:

    Image Removed

    Idade do Beneficiário

    Adicionado no sistema o envio da tag de idade do beneficiário (nrIdade), a idade do mesmo será calculado através do campo BA1_DATNAS.

    Transações que sofreram alterações:

    • 00501 – Resposta de Pedido de Autorização
    • 00413 – Resposta da Consulta de Dados do Beneficiário

    Manual PTU Online 9.0:

    Image Removed

    Especificação do Material Solicitado

    Realizado a alteração do nome da tag que descreve o material solicitado nas guias de OPME, essa tag será enviada através do campo B4A_ESPMAT.

    Transações que sofreram alterações:

    • 00600 – Pedido de Autorização
    • 00605 – Pedido de Complementação de Autorização
    • 00806 – Ordem de Serviço

    Manual PTU Online 9.0:

    Image Removed

    Realizado a remoção das seguintes tags na nova versão do PTU Online:

    Totvs custom tabs box items
    defaultno
    referenciaexclusao
    TagTransação

    tipoCliente

    Pedido de Autorização (00600)

    Resposta de Pedido de Autorização (00501)

    Pedido de Insistência (00302)

    Resposta de Auditoria (00404)

    Pedido de Complementação de Autorização (00605)

    Cancelamento (00311)

    Confirmação (00309)

    Erro Inesperado (00310)

    Status da Transação (00360)

    Resposta do Status da Transação (00361)

    Consulta de Dados do Beneficiário (00412)

    Resposta da Consulta de Dados do Beneficiário (00413)

    Consulta Prestador (00418)

    Resposta da Consulta de Prestador (00419)

    Requisição de Contagem de Beneficiários (00430)

    Resposta de Requisição de Contagem de Beneficiários (00431)

    Comunicação de Decurso de Prazo (00700)

    Comunicação de internação ou alta do beneficiário (00750)

    Ordem de Serviço (00806)

    Resposta de Ordem de Serviço (00807)

    Autorização de Ordem de Serviço (00804)

    Consultas transações Respondidas pelo WSD (01100)

    Resposta da Consultas transações Respondidas pelo WSD (01101)

    numeroViaCartao

    Pedido de Autorização (00600)

    Resposta da Consulta de Dados do Beneficiário (00413)

    Comunicação de internação ou alta do beneficiário (00750)

    Ordem de Serviço (00806)

    codigoEspecialidadeMedica

    Pedido de Autorização (00600)

    Pedido de Complementação de Autorização (00605)

    Ordem de Serviço (00806)

    idAcidente

    Pedido de Autorização (00600)

    Ordem de Serviço (00806)

    idAnexo

    Pedido de Autorização (00600)

    Pedido de Complementação de Autorização (00605)

    Ordem de Serviço (00806)

    tpSexo

    Pedido de Autorização (00600)

    Pedido de Complementação de Autorização (00605)

    Resposta do Status da Transação (00361)

    nrIdade

    Pedido de Autorização (00600)

    Pedido de Complementação de Autorização (00605)

    idOrdemServicoPedido de Autorização (00600)
    valorUnitarioServico

    Pedido de Autorização (00600)

    Pedido de Complementação de Autorização (00605)

    Ordem de Serviço (00806)

    dtNasc

    Resposta de Pedido de Autorização (00501)

    Resposta do Status da Transação (00361)

    dataNascimento

    Consulta de Dados do Beneficiário (00412)

    nomeBeneficiarioConsulta de Dados do Beneficiário (00412)
    ultimoSobrenomeBeneficiarioConsulta de Dados do Beneficiário (00412)
    numeroCNSConsulta de Dados do Beneficiário (00412)
    nomeResposta da Consulta de Dados do Beneficiário (00413)
    nomeEmpresaResposta da Consulta de Dados do Beneficiário (00413)
    nomePlanoResposta da Consulta de Dados do Beneficiário (00413)
    nomePrestadorRequisitanteOrdem de Serviço (00806)
    siglaConselhoRequisitanteOrdem de Serviço (00806)
    numeroConselhoRequisitanteOrdem de Serviço (00806)
    unidadeFederativaRequisitanteOrdem de Serviço (00806)
    nomePrestadorResposta de Ordem de Serviço (00807)
    codigoUnimedSolicitanteResposta da Consultas transações Respondidas pelo WSD (01101)
    dataSolicitacaoResposta da Consultas transações Respondidas pelo WSD (01101)
    descricaoServicoResposta da Consultas transações Respondidas pelo WSD (01101)

    ...

    risco

    No Compartilhamento de Risco, ocorreu as seguintes mudanças:

    Indicador da geração código no cartão beneficiario

    Remoção da Regra da tag indicadorGeracaoCodigo.

    TagRegra 

    indicadorGeracaoCodigo

    		Quando tipoCompartilhamentoRisco preenchido como P, esse campo terá valor fixo igual a True;

    Obs: Indica se Unimed Origem é a responsavel pela geração código no cartão beneficiario

    Manual PTU Online Versão 2.2025:

    Image Added


    Indicador de suspensão atendimento para compartilhamento de riscos 

    Inclusão de nova tag em dadosBeneficiario.

    TagContéudo do sistemaRegra

    indicadorSuspensaoAtendimento


    		Indicador de suspensão atendimento para compartilhamento de riscos 

    Manual PTU Online Versão 2.2025:

    Image Added


    Ocorreu mudanças na agrupador dadosPessoa:

    Gênero Social do Beneficiário

    Mudança da Regra, na tag generoSocial.

    TagContéudo do sistemaRegra

    generoSocial

    		BTS_GENSOCF = Feminino
    M = Masculino
    N = Não binário

    Manual PTU Online Versão 2.2025:

    Image Added

    Código da Unidade Federativa da carteira de identidade

    Mudança no tipo, na tag "uf" do agrupador "rg".

    TagContéudo do sistemaTipo

    uf

    		BTS_RGESTAN

    Manual PTU Online Versão 2.2025:

    Image Added


     Complementos Cadastrais 

    Tipo de Residência

    Na agrupadora segundária enderecos, ocorreu a inclusão de nova regra na tag tipoResidencia.

    TagContéudo do sistemaRegra

    tipoResidencia

    		BTS_RESEXT

    1 – Brasil
    2 – Exterio

    Obrigatório quando indicadores estiverem preenchidos:

    indicadorAutoGestao/indicadorPlanoAcidenteTrabalho /indicadorPlanoSaudeOcupacional/indicadorPlanoAPS

    Manual PTU Online Versão 2.2025:

    Image Added

    Endereços

    Na agrupadora segundária enderecos,  foi realizado a mudanças no tamanho das seguintes tags:

    TagCampo do SistemaTamanhoRegra

    logradouro

    		BA1_ENDERE ou BTS_ENDERE80


    Obrigatorio no caso do tipoResidencia = 1

    bairro

    		BA1_BAIRRO ou BTS_BAIRRO45

    complemento

    		BA1_COMEND ou BTS_COMEND80

    Manual PTU Online Versão 2.2025:

    Image Added


    Atualização de Dicionário de Dados

    Cadastro do Grupo Empresa - SubContrato

    Inclusão na tabela SX3 (Campos):

    Campo

    Tipo

    Tamanho

    Decimal

    Titulo

    Descrição

    Picture

    Usado

    Validação

    Cbox 

    Exibe Browser

    Folder

    Visual

    Contexto

    Help

    BQC_DDD   Caracter30DDDCodigo do DDD999Sim

    		Não5AlterarReal

    Código do DDD referente ao Telefone.

    BQC_TIPTELCaracter10Tipo TelefonTipo Telefone@!SimPertence('123') .Or. Vazio()

    1=Residencial.

    2=Profissional.

    3=Celular.

    		Não5AlterarReal

    Tipo de telefone:

    Residencial, Profissional, ou Celular.


    Card documentos
    InformacaoAs alterações de dicionário referente a essa implementação estarão disponíveis através de pacote de expedição contínua do plano de saúde com data igual ou superior 13/02/2025.
    TituloImportante

    ...

    Para mais informações de como utilizar essa funcionalidade, acesse a documentação de referência: CadBenef Online - Movimentação Cadastral de Beneficiarios - PLPTU001

    05. ASSUNTOS RELACIONADOS

      Manual do PTU de Integrações 8.0



    Templatedocumentos