CONTEÚDO
- Visão Geral
- Parâmetros
- Campos
- 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â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. |
TFT | Caractere | TFT_FINDME | 1 | Sinaliza se o item de apontamento de material de consumo foi integrado com integrado com o checklist da findme. |
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
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.
Em seguida clique na opção Integração FindMe e aguarde o processamento.