CONTEÚDO
- Visão Geral
- Parâmetros
- Campos
- Pontos de Integração
- Parâmetros
- Campos
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
...
02. Pontos de Integração
Criação de contrato de serviço
Cadastros integrados: Clientes, Locais de atendimento, postos e area de supervisão
Ao gerar orçamento de serviço, se existir o campo TFF->TFF_FINDME e a integração estiver ativa (MV_FINDME == 1), ao realizar a geração do contrato (TECA850) o sistema verificará se o cliente do orçamento já existe na base da findme. Caso não exista, esse cliente será incluído na base de dados da findme. Após a inclusão do cliente, o protheus fará a inclusão dos postos (TFF) onde o campo TFF->TFF_FINDME estiver com o valor numérico == 1
Cadastros de atendentes
Cadastros integrados: usuários
Acessando a rotina Teca021 (cadastro de atendentes), caso a integração esteja ativa, será exibida opção no menu (outras ações -> findMe)
Geração de agendas
Cadastros integrados: usuários
Ao gerar agendas, utilizando a rotina da Mesa Operacional, o sistema verificará se o atendente que está sendo alocado já possui um usuário na plataforma findme. Caso negativo, o usuário será criado, com os acessos necessários para o posto alocado.
Cadastro de atendente
Cadastros integrados: usuários
Ao editar o cadastro de algum atendente, caso o parâmetro MV_FINDME == 2 (ligado), é possível utilizar a opção outras ações->Int. findme para criar o usuário na plataforma findme para o atendente em questão, respeitando os seguintes requisitos: os campos email e telefone devem estar preenchidos e esse atendente deve ser um funcionário (campo AA1_CDFUNC preenchido)
, 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
Image Added
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âmetro | Tipo de dados | Tamanho | Descrição |
|---|
| MV_GSXFM01 | Caractere | 30 | Url da api de integração. Valor obtido com a plataforma findme |
| MV_GSXFM02 | Caractere | 30 | Usuário utilizado na plataforma findMe |
| MV_GSXFM03 | Caractere | 30 | Senha utilizada na plataforma findme |
| MV_FINDME | Numérico | 1 | 2 = Integração ligada 1 = Integração desligada |
| MV_FINTIME | Caractere | 30 | 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_FDROLE | Caractere | 30 | Regra de acesso padrão para os cadastros findme.
Exemplo:
coordinator |
| MV_FDPSW | Caractere | 30 | Senha padrão inicial para os usuários gerados na plataforma findme |
....
| . |
| MV_DEFREG | Caractere | 30 | 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.
| Tabela | Tipo de dados | Nome do Campo | Tamanho | Descrição |
|---|
| TFL | Date | TFL_DTFIND | 8 | Exibe a data do último envio de materiais como checklist para a findme. |
| TFF | Caractere combobox | TFF_FINDME | 2 | Informa se o posto será integrado:
1 = Sim
2 = Não |
| TFS | Caractere | TFS_FINDME | 1 | 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 |
| TFT | Caractere | TFT_FINDME | 1 | 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
...
| Informacao | Use esse box para destacar informações relevantes e/ou de destaque. |
|---|
| Titulo | IMPORTANTE! |
|---|
|
|---|
| default | true |
|---|
| id | 1 |
|---|
| label | Visão Geral |
|---|
| title | Visão Geral da integração |
|---|
| | draw.io Diagram |
|---|
| border | true |
|---|
| |
|---|
| diagramName | IntegracaoFindme |
|---|
| simpleViewer | false |
|---|
| width | |
|---|
| links | auto |
|---|
| tbstyle | top |
|---|
| lbox | true |
|---|
| diagramWidth | 591 |
|---|
| revision | 12 |
|---|
|
|
| Card |
|---|
| id | 2 |
|---|
| label | Cadastros básicos |
|---|
| title | Integração de cadastros |
|---|
| | Deck of Cards |
|---|
| | Card |
|---|
| id | 1 |
|---|
| label | Usuários |
|---|
| title | Usuários |
|---|
| 01. RequisitosPara 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 AtendentesPara 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
 Image Added
Na plataforma FindMe, teremos o usuário criado
 Image Added 03. Integração via Mesa OperacionalPara 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.
 Image Added Visão do cadastro de usuários, na paltaforma FindMe - Usuário integrado com posto vinculado |
| Card |
|---|
| id | 2 |
|---|
| label | Cliente |
|---|
| title | Cliente FindMe |
|---|
| 01. RequisitosO 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 contratosOs 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  Image Added
Após salvar o orçamento e gerar o contrato, o cliente, local, posto e região deverão ser exibidos na plataforma findme.  Image Added
|
|
|
| Card |
|---|
| id | 3 |
|---|
| label | Local |
|---|
| title | Local de atendimento |
|---|
| 01. RequisitosO 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 contratosOs 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 Image Added
Visão do locais integrados, no painel da plataforma FindMe  Image Added
|
| Card |
|---|
| id | 5 |
|---|
| label | Posto |
|---|
| title | Posto de trabalho |
|---|
| 01. RequisitosO 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 contratosOs 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 Image Added Visão dos postos integrados, no painel da FindMe  Image Added
|
| Card |
|---|
| id | 7 |
|---|
| label | Região |
|---|
| title | Região |
|---|
| 01. RequisitosO 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 contratosOs 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 Image Added Visão das regiões, na plataforma FindMe  Image Added
|
| Card |
|---|
| label | Integração de CheckList |
|---|
| 01. RequisitosO 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 materiaisO 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  Image Added
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 materiaisEm 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  Image Added
|
| Card |
|---|
| 01. RequisitosA 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 Added 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 Added
Em seguida clique na opção Integração FindMe e aguarde o processamento. |
|
05. Referência
...
