Essa Integração tem o objetivo de enviar o Pré-Cadastro dos beneficiários que se encontram no produto TOTVS Saúde Planos Linha Protheus para a API Cadbenef da Unimed do Brasil, utilizando a rotina de Integrações (Integrações TOTVS Saúde Planos Linha Protheus).
A Integração do Pré-Cadastro de Beneficiários deverá ser incluída na tela de Integrações (Item 03 da documentação de Integrações TOTVS Saúde Planos Linha Protheus), com o preenchimento dos seguintes campos:
| Campos | Ação |
|---|---|
| Alias Prima. | Preencher BA1 |
| EndPoint | Endpoint de Produção informado no Manual de PTU Integrações no item: Serviço Pré Cadastro Beneficiarios cadBenef - PTU A1300 |
| Classe STAMP | Preencher com: PLPtuStpPCad |
| Classe Comu. | Preencher com: PLPtuJsPCad |
| Login Auten. | Login de autenticação gerado no GIU |
| Senha Auten. | Senha de autenticação gerado no GIU |
| EndPoint Aut. | Endpoint de Produção informado no Manual de PTU Integrações no item: Serviços para integração GIU – Gestão Institucional Unimed, SubItem: Autenticação de uma Conta de Serviço. |
| Perg. Gerar | Preencher com: PLPTUCADBE |
A Classe PLPtuStpPCad será responsável por buscar novos beneficiários cadastrados na tabela BA1 pela coluna BA1_PTUCAD, para gravação dos pedidos na tela de Integrações (Item 04 da documentação de Integrações TOTVS Saúde Planos Linha Protheus), para posteriormente comunicar com a API de Pré-Cadastro do Beneficiário cadBenef. A periocidade da busca é configurada de acordo com o schedule.
A classe PLPtuJsPCad, será responsável pela montagem do JSON para comunicar com a API de Pré-Cadastro do Beneficiário cadBenef. O JSON será enviado conforme exemplo abaixo:
{
"message":"Criar Beneficiario",
"listaBeneficiarios":[
{
"dadosUnimed":{
"codUnimed":"0001"
},
"dadosContratante":{
"cpfCnpj":"99999999999999",
"nomeContratante":"EMPRESA JURIDICA TESTE"
},
"dadosPessoa":{
"nome":"BENEFICIARIO TESTE",
"nomeSocial":"BENEFICIARIO SOCIAL TESTE",
"genero":"F",
"generoSocial":"F",
"dtNascimento":"20100101",
"cpf":"99999999999",
"cns":"999999999999999"
},
"dadosBeneficiario":{
"cdCarteiraTitular":"00011008000005016",
"dependencia":"00",
"dataInclusao":"20230101"
},
"dadosPlano":{
"dtValidadeCartao":"20270112",
"viaCartao":"1",
"dtInicioVigencia":"20010101",
"tpAbrangencia":1,
"tpAcomodacao":"B",
"tpContratacao":3,
"tpContrato":"P",
"segmentacao":"02",
"idRegPlanoANS":1,
"registroANS":"123456",
"cdRede":"TST01",
"cdLcat":0,
"nomeProduto":"PRODUTO EXEMPLO 1"
},
"listaAbrangencias":[
{
"cdMunic": 3548500,
"cdUF": 11
}
],
"listaCarencias":[
{
"tpCobertura":"1",
"DtFimCarencia":"20220512"
},
]
}
]
}
|
Para alterar o JSON, poderá ser utilizado o Ponto de Entrada PLMPJSBE (DT PE Manipular JSON de Envio de Beneficiários).
Após realizar a criação do Dicionário principal (Item 07 da documentação de Integrações TOTVS Saúde Planos Linha Protheus), vamos atualizar as seguintes tabelas para adaptar a API de Pré Cadastro do Beneficiário.
Atualização do Arquivo SX3 (Campo):
| Tabela | Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Inicializador Padrão | Consulta Padrão | cBox | Usado | Exibe Browser | Visual? | Contexto | Obrigatório | When |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BA1 | BA1_PTUCAD | C | 1 | 0 | Cad. Ben PTU | Cad.Benef na UNIMED | @! | "0" | 0=Nao Cadastrado;1=Pre Cadastrado;2=Cadastro Completo | Sim | Sim | Alterar | Real | ||||
| Tabela | Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Inicializador Padrão | Consulta Padrão | cBox | Usado | Exibe Browser | Visual? | Contexto | Obrigatório | When |
| B7E | B7E_UNIME | C | 1 | 0 | é Unimed? | Integração Unimed? | @! | "2" | 1=Sim;2=Nao | Sim | Não | Alterar | Real | Não | |||
| B7E | B7E_QTLOTE | N | 2 | Qtd. Lote | Qtd. Max. Lote | @!99 | 1 | Sim | Não | Alterar | Real | Não | |||||
Atualização do Arquivo SX1 (Pergunte):
| Grupo | Ordem | Pergunta | Variável | Tipo | Tamanho | Decimal | Objeto | Consulta Padrão |
|---|---|---|---|---|---|---|---|---|
| PLPTUCADBE | 01 | Grupo/Empresa De ? | MV_PAR01 | C | 4 | 0 | 1 - Edit | B7APLS |
| PLPTUCADBE | 02 | Grupo/Empresa Ate ? | MV_PAR02 | C | 4 | 0 | 1 - Edit | B7APLS |
| PLPTUCADBE | 03 | Matricula De ? | MV_PAR03 | C | 6 | 0 | 1 - Edit | BA1PLS |
| PLPTUCADBE | 04 | Matricula Ate ? | MV_PAR04 | C | 6 | 0 | 1 - Edit | BA1PLS |
| PLPTUCADBE | 05 | Data Inclusao De ? | MV_PAR05 | D | 8 | 0 | 1 - Edit | |
| PLPTUCADBE | 06 | Data Inclusao Ate ? | MV_PAR06 | D | 8 | 0 | 1 - Edit |
Outras Ações / Ações relacionadas
| Ação | Descrição |
|---|---|
| Consultar Pedidos | Através dessa opção, será possível visualizar os pedidos da Integração posicionada, ao clicar será aberto um outro browser com os pedidos. |
| Comunicar Pedidos | Através dessa opção, será possível realizar a comunicação de todos os pedidos, com o status pendente de envio e erro de envio da Integração posicionada. |
| Gerar Pedidos em Massa | Através dessa opção, será possível gerar uma carga de pedidos para a Integração posicionada, utilizando os filtros previamente selecionados. |
| Gerar Pedidos pelo STAMP | Através dessa opção, será possível gerar uma carga de pedidos para a Integração posicionada, utilizando os filtros previamente selecionados. |
Principais Campos e Parâmetros
| Campo | Descrição | Preenchimento |
|---|---|---|
Operadora | Código da Operadora do sistema. | Obrigatório, Preenchimento automático de acordo com a Integração posicionada. |
| Codigo Integ. | Código Incremental das Integrações. | Obrigatório, Preenchimento automático de acordo com a Integração posicionada. |
| Cod. Pedido | Código Incremental dos pedidos. | Obrigatório, Preenchimento automático. |
| Alias Prima. | Tabela do cadastro que será utilizada para envio. | Obrigatório, Preenchimento automático de acordo com a Integração posicionada. |
| Chave | Chave de busca do registro de acordo com o Alias Primário. | Obrigatório, deverá ser informado o índice de busca do Alias Primário, por exemplo: Cadastro de Beneficiários, BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO |
| Dt. Inclusão | Data de inclusão do pedido. | Obrigatório, Data em que o pedido foi incluído, o default é a data base do sistema. |
| Dt. Comunica | Data de Comunicação com o sistema parceiro. | Não editável, data em que foi realizada a comunicação do pedido com o sistema parceiro. |
| Status | Status do pedido. | Status do momento do pedido: 0 - Pendente de Envio, 1 - Envio Realizado, 2 - Erro de Envio, 3 - Envio Cancelado. |
| Tent. Envio | Tentativas de Envio do pedido. | Tentativas em que o pedido foi realizado, caso atinja a quantidade máxima da Integração, sem sucesso, automaticamente o pedido será Cancelado. |
| Json Envio | JSON enviado para o sistema parceiro. | Não editável, JSON que o Protheus enviou para o sistema parceiro da Integração. |
| Json Receb. | JSON recebido do sistema parceiro. | Não editável, JSON em que o Protheus recebeu do sistema parceiro da Integração. |