CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Tela Integrações
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela Integrações
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
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).
02. EXEMPLO DE UTILIZAÇÃO
1. CADASTRO DA INTEGRAÇÃO
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 conforme exemplo abaixo:
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 |
A alteração de dicionário referente a essa implementação estará disponível no próximo pacote de Expedição Contínua do módulo SIGAPLS.IMPORTANTE
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)