Histórico da Página
...
- Visão Geral
- Exemplo de utilização
- Tela XXXIntegrações
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela XXXIntegrações
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
...
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 |
2. CLASSES
2.1 Classe PLPtuStpPCad
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.
2.2 Classe PLPtuJsPCad
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 com os seguintes dados:
...
conforme exemplo abaixo:
...
Exemplo:
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{ "message":"Criar Beneficiario", "listaBeneficiarios":[ { "dadosUnimed":{ "codUnimed":"0001" }, "dadosContratante":{ "cpfCnpj":"1872239000017999999999999999", "nomeContratante":"EMPRESA VINICIUSJURIDICA TEIXEIRATESTE" }, "dadosPessoa":{ "nome":"JANAINABENEFICIARIO DE JESUSTESTE", "nomeSocial":"BENEFICIARIO SOCIAL TESTE", "genero":"F", "generoSocial":"F", "dtNascimento":"1992061420100101", "cpf":"3943758486999999999999", "cns":"244198253440018999999999999999" }, "dadosBeneficiario":{ "cdCarteiraTitular":"00011008000005016", "dependencia":"00", "dataInclusao":"2021051720230101" }, "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":[ ], "listaCarencias":[ { "tpCoberturacdMunic":"" 3548500, "DtFimCarenciacdUF":"20220512" 11 }, { "tpCobertura":"" ], "DtFimCarencia":"20220512" },"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).
3. DICIONÁRIO DE DADOS
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 | @E 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 |
Atualização do Arquivo BA1(Cadastro dos Beneficiários):
Card documentos | ||||
---|---|---|---|---|
|
03. TELA
...
INTEGRAÇÕES
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. |
04. TELA
...
INTEGRAÇÕES
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. |
...
05. TABELAS UTILIZADAS
- BA1 (Cadastro dos Beneficiários)
- BTS (Cadastro de Vidas)
- BA3 (Cadastro das Famílias)
- BG9 (Cadastro de Grupos Empresas)
- BQC (Cadastro de Subcontrato)
- SA1 (Cadastro de Clientes)
...