Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Parâmetros
  3. Campos
  4. Pontos de Integração

01. Visão Geral

Esse documento tem o objetivo explicar a integração entre o módulo Prestadores de Serviço Terceirização e a plataforma Findme. A abrangência da integração, até o momento da publicação deste documento, é o envio dos cadastros básicos, na nomenclatura da Findme: regiões, locais de atendimento, postos de atendimento, clientes, usuários e checklist de materiais. As movimentações de atendentes também são contempladas pela integração, ou seja, quando um atendente sofre alteração em seu posto de trabalho, no protheus, essa alteração é refletida na plataforma FindMe. 

A integração pode ser facilmente configurada utilizando o painel da integração. Para utilizar o painel da integração, é necessário realizar a inclusão do programa intFindMe no menu do módulo, em Atualizações → Integrações → FindMe

Imagem 1 - Painel de integração FindMe



02. Parâmetros 

Para o correto funcionamento da integração, é necessário a criação de alguns parâmetros, bem como a definição de seus valores. 

Nome do parâmetroTipo de dadosTamanhoDescrição
MV_GSXFM01Caractere30Url da api de integração. Valor obtido com a plataforma findme
MV_GSXFM02Caractere30Usuário utilizado na plataforma findMe
MV_GSXFM03Caractere30Senha utilizada na plataforma findme
MV_FINDMENumérico1

2 = Integração ligada

1 = Integração desligada

MV_FINTIMECaractere30

Timezone padrão, para casos onde Estado e/ ou município não são informados no local de atendimento.

Ex.: America/Sao_Paulo

MV_FDROLECaractere30Regra de acesso padrão para os cadastros findme.
Exemplo:
coordinator
MV_FDPSWCaractere30Senha padrão inicial para os usuários gerados na plataforma findme.
MV_DEFREGCaractere30

Região padrão para a integração FindMe.

A região padrão é substituída, no momento da integração, pelo código da area de supervisão do cadastro de local de atendimento.

03. Campos

Os campos abaixo são essenciais para o funcionamento correto da integração. 

TabelaTipo de dadosNome do CampoTamanhoDescrição
TFLDateTFL_DTFIND8Exibe a data do último envio de materiais como checklist para a findme. 
TFFCaractere comboboxTFF_FINDME2Informa se o posto será integrado:
1 = Sim
2 = Não 
TFSCaractereTFS_FINDME1

Sinaliza se o item de apontamento de material de implantação foi integrado com integrado com o checklist da findme
1 = Não
2 = Sim

TFTCaractereTFT_FINDME1

Sinaliza se o item de apontamento de material de consumo foi integrado com integrado com o checklist da findme
1 = Não
2 = Sim

05. Pontos de integração


      01. Requisitos

      Para a integração de usuários, o cadastro do protheus precisa seguir as seguintes regras:

      1) O cadastro de atendentes do protheus, tabela AA1, precisa ter vínculo com o cadastro de funcionários, tabela SRA. Em outras palavras, o atendente precisa tambem ser um funcionário. 

      2) Os campos de email e telefone precisa estar preenchidos, no cadastro do atendente

      02. Integração via Cadastro de Atendentes

      Para integrar um usuário, via cadastro de atendentes:


      1) Acesse a rotina de cadastro de atendentes em Atualizações->Cadastros->Prest.Servicos→Atendentes
      2) Aponte para o cadastro do atendente para o qua deseja criar um usuário na plataforma FindMe
      3) Utilize a opção Alterar ou Visualizar
      4) Acesse o menu Outras ações → Integrar FindMe


      Na plataforma FindMe, teremos o usuário criado

      03. Integração via Mesa Operacional

      Para criar os usuários na plataforma FindMe no momento da geração das agendas, utilizando a mesa operacional do protheus, basta ter o contrato com base em orçamento devidamente configurado para a integração, onde o campo do posto (TFF) está com a opção Integra Findme = Sim. Ao gerar agendas para esse posto, serão criados os usuários para a plataforma, bem como o vínculo desse usuário com o posto integrado.

      Visão do cadastro de usuários, na paltaforma FindMe - Usuário integrado com posto vinculado

      01. Requisitos

      O campo TFF_FINDME precisa estar criado corretamente e o parâmetro MV_FINDME precisa estar criado e com o seu conteúdo igual a 2 (integração ligada)

      02. Integração via criação de contratos

      Os cadastros integrados na geração do contrato são: Cliente, Local, Posto e Região. 

      Ao incluir um orçamento de serviço, a integração se baseia no posto (TFF) para gravar os registros na plataforma findme. Selecione a opção Inte.Findme = 1 na linha do posto

      Após salvar o orçamento e gerar o contrato, o cliente, local, posto e região deverão ser exibidos na plataforma findme. 


      01. Requisitos

      O campo TFF_FINDME precisa estar criado corretamente e o parâmetro MV_FINDME precisa estar criado e com o seu conteúdo igual a 2 (integração ligada)

      02. Integração via criação de contratos

      Os cadastros integrados na geração do contrato são: Cliente, Local, Posto e Região. 

      Ao incluir um orçamento de serviço, a integração se baseia no posto (TFF) para gravar os registros na plataforma findme. Selecione a opção Inte.Findme = 1 na linha do posto


      Visão do locais integrados, no painel da plataforma FindMe


      01. Requisitos

      O campo TFF_FINDME precisa estar criado corretamente e o parâmetro MV_FINDME precisa estar criado e com o seu conteúdo igual a 2 (integração ligada)

      02. Integração via criação de contratos

      Os cadastros integrados na geração do contrato são: Cliente, Local, Posto e Região. 

      Ao incluir um orçamento de serviço, a integração se baseia no posto (TFF) para gravar os registros na plataforma findme. Selecione a opção Inte.Findme = 1 na linha do posto

      Visão dos postos integrados, no painel da FindMe


      01. Requisitos

      O campo TFF_FINDME precisa estar criado corretamente e o parâmetro MV_FINDME precisa estar criado e com o seu conteúdo igual a 2 (integração ligada)
      É necessário ter cadastrado uma area de supervisão, no protheus.
      O local de atendimento precisa ter uma area de supervisão vinculada
      Caso não seja informada uma area de supervisão, será considerado o valor do parâmetro MV_DEFREG
      Em casos onde não é informada a area de supervisão, no local de atendimento, e tambem não é informado o parâmetro MV_DEFREG, o cadastro em questão não será integrado


      02. Integração via criação de contratos

      Os cadastros integrados na geração do contrato são: Cliente, Local, Posto e Região. 

      Ao incluir um orçamento de serviço, a integração se baseia no posto (TFF) para gravar os registros na plataforma findme. Selecione a opção Inte.Findme = 1 na linha do posto

      Visão das regiões, na plataforma FindMe


      01. Requisitos

      O campo TFF_FINDME precisa estar criado corretamente e o parâmetro MV_FINDME precisa estar criado e com o seu conteúdo igual a 2 (integração ligada)
      É necessário ter contrato de prestação de serviço gerado, com base em orçamento de serviço com postos integrados com a FindMe
      É necessário ter materiais de consumo / implantação apontados
      Os campos TFS_FINDME, TFL_DTFIND e TFT_FINDME devem estar devidamente criados no ambiente protheus

      02. Integração via rotina de apontamento de materiais

      O objetivo dessa integração é criar checklist para o posto integrado, com os materiais de implantação e consumo apontados no protheus. Para cada novo apontamento de materiais, o usuáro protheus pode realizar o sincronismo com a findme, utilizando a rotina de apontamento de materiais em Atualizações→Prest Servicos→ Apontamento de Materiais

      Com a integração habilitada, deve ser exibida uma nova coluna na janela, contendo a Data Findme, que representa a última data que foi realizada integração (criação do checklist) dos materiais apontados, para o posto em questão

      Caso a data esteja vazia, significa que ainda não foram enviados dados dos materiais, para a plataforma findme

      Para realizar o envio, acesse Outras Apções → Checklist Findme

      02. Reintegração via rotina de apontamento de materiais

      Em casos onde o checklist foi criado na plataforma Findme, mas foram realizadas alterações no checklist vigente, para atualizar os dados integrados, é necessário clicar na opção Reintegrar, em Outras Ações

      01. Requisitos

      A funcionalidade depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de 08/04/2024 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores à versão 12.1.33.
      É necessário ter incluída a rotina teca766 (Monitor de integração com a findme) no menu do módulo 28. 

      02. Integração em lote, via Monitor de Integração com a Findme (TECA766)

      Abrindo a rotina, preencha os parâmetros para realizar o filtro de registros que serão importados
      image-2024-3-22_16-17-33.png

      Como a integração em lote utiliza como base os contratos de prestação de serviço vigentes, selecione esses contratos na tela (browse) que é exibida, após o preenchimento dos parâmetros.
      image-2024-3-22_16-18-56.png


      Em seguida clique na opção Integração FindMe e aguarde o processamento.