Árvore de páginas

Versões comparadas

Chave

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

...

  1. Visão Geral
  2. Exemplo de utilização
    1. Tela PLPTU001
      1. Outras Ações / Ações relacionadas
      1. Configuração
        1. Endpoint e Autenticação
        2. Certificado Digital
      2. Programa de Menu
      3. Criando Lote de Envio
      4. Status do Lote
        1. Consultar Status
      5. Enviando Beneficiários
        1. Detalhes do Envio
          1. Mensagens de Erro
      Tela PLPTU001
      1. Principais Campos e Parâmetros
    2. Tabelas utilizadas


    01. VISÃO GERAL

    ...

    02. EXEMPLO DE UTILIZAÇÃO

    ...

    a.

    ...

    Configuração

    ...

    i.

    ...

    Endpoint e Autenticação

    Acesse o menu Operadora de Saúde (PLSA010), do módulo Plano de Saúde (SIGAPLS), e seleciona a código da unimed que deseja configurar a integração.

    ...

    Informações
    iconfalse

    URL Token: Endpoint de homologação/produção disponibilizado pela unimed brasil para autenticação. (BA0_UBURL)
    Exemplo: https://gateway-hml.unimed.coop.br/oauth/v1/access-token

    ID Token: Client ID solicitado previamente para Unimed Brasil. (BA0_UBCLID)

    Secret Token : Secret ID solicitado previamente para Unimed Brasil. (BA0_UBCLSC)

    URL CadBenef: Endpoint de homologação/produção do CadBenef-Online. (BA0_CDBURL)
    Exemplo: https://ua-gateway-hml.unimed.coop.br/cadbenef-online/v1/beneficiarios

    ...


    ii. Certificado Digital

    A Unimed Brasil utiliza certificados digitais do tipo ICP-Brasil que funcionam como uma identidade virtual que permite a identificação segura e inequívoca do autor de uma mensagem ou transação.

    ...

    Informações
    iconfalse

    PFX CadBenef:  O nome do certificado com extensão. (BA0_CDBPFX)

    Pass CadBen.:  Senha que será utilizada para a abertura da chave privada. Para uma chave privada que não possua senha deve ser informada uma string vazia. (BA0_CDBPAS)

    ...


    b.

    ...

    Programa de Menu

    Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:

    Dica
    iconfalse

    (mais) Miscelanea

    (mais) Unimed

    (mais) Integrações

    Decrição: CadBenef Online 

    Programa: PLPTU001

    Módulo: Plano de Saúde

    Tipo: Função Protheus

    ...


    c.

    ...

    Criando Lote de Envio

    Na tela inicial será apresentado todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:

    ...

    Dica
    titleLote incluído com sucesso!

    O lote ficará com o status de

    Estado
    subtletrue
    titleRecebido
     ao finalizar a gravação.

    ...

    d.

    ...

    Status do Lote

    Os lotes poderam possuir os seguintes status:

    Informações
    iconfalse

    Estado
    subtletrue
    titleRecebido
    Recebe esse status ao criar o lote.

    Estado
    subtletrue
    colourBlue
    titleProcessando Envio
    Recebe esse status quando estiver enviando os beneficiários para o CadBenef.

    Estado
    subtletrue
    colourRed
    titleFalha de Envio
    Recebe esse status caso algum beneficiário tiver erro no envio.

    Estado
    subtletrue
    colourGreen
    titleFinalizado com sucesso
     Recebe esse status quando todos os beneficiários do lote forem enviados com sucesso.

    Estado
    subtletrue
    colourYellow
    titleFinalizado Parcialmente
     Recebe esse status quando houver beneficiários enviados com sucesso e nenhum com erro de envio.

    ...


    i.

    ...

    Consultar Status

    O botão consultar status, apresenta a quantidade de beneficiários no lote por status, sendo:

    Estado
    subtletrue
    titlePedente de Envio
       
    Estado
    subtletrue
    colourGreen
    titleEnvio Finalizado
       
    Estado
    subtletrue
    colourRed
    titleErro de Envio

    ...


    e.

    ...

    Enviando Beneficiários

    Existem duas formas de enviar o beneficiário para o CadBenef, sendo envio em lote, opção Enviar Lote ou acessando o botão Consultar Beneficiários do lote, na opção Enviar, onde será enviado somente o beneficiário posicionado.

    Quando enviado o lote, o sistema irá processar o envio dos beneficiário de forma assíncrona, o seja, o usuário não precisará esperar terminar o envio. Nesse momento o lote ficará com o status

    Estado
    subtletrue
    colourBlue
    titleProcessando Envio
    .

    ...

    i.

    ...

    Detalhes do Envio

    Através do botão consultar beneficiários, será possivel verificar os Detalhes de Envio de cada beneficiário para o CadBenef:

    ...

    Nota
    titleImportante

    Status: Corresponde ao status de envio do beneficiário, sendo:

    Estado
    subtletrue
    titlePendente de Envio
    Estado
    subtletrue
    colourGreen
    titleEnvio Finalizado
    Estado
    subtletrue
    colourRed
    titleErro de Envio
    .

    Cd. Transac.: Código de Transação do PTU (esse código não irá repetir), através dele será possivel consultar a transação no portal da Unimed Brasil referente ao CadBenef.

    Msg. Envio: Json enviado pelo sistema para o CadBenef.

    Msg. Resp.: Json de resposta do CadBenef.

    ...

    1.

    ...

     Mensagens de Erro

    Quando o beneficiário estiver com o status

    Estado
    subtletrue
    colourRed
    titleErro de Envio
    , será possivel através das mensagens de erro, consultar com mais detalhes as críticas que o sistema encontrou ou que a Unimed Brasil retornou:

    Image Added

    03.

    ...

    Outras Ações / Ações relacionadas

    ...

    TABELAS UTILIZADAS

    • BPW - CadBenef Online - Lote
    • BPY - CadBenef Online - Beneficiário
    • BA1 - Beneficiários
    • BTS - Vidas
    • BA3 - Famílias
    • BA0 - Operadora de Saúde
    • BG9 - Empresas
    • BQC - Subcontratos
    • BI3 - Produto Saúde

    04. TELA XXXXX

    Principais Campos e Parâmetros

    ...

    Card documentos
    InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
    TituloIMPORTANTE!

    ...