- Versões
- Visão Geral
- Exemplo de utilização
- Fluxo
01. VERSÕES
02. VISÃO GERAL
Oferecer integração nativa entre o sistema de RH TOTVS Datasul e a Plataforma de Gestão de Desempenho Empresarial da Feedz by TOTVS. Isso garantirá sincronização para processos como avaliação de desempenho e PDI, agilizando as operações e promovendo maior integração entre eles.
03. EXEMPLO DE UTILIZAÇÃO
Os dados contratuais e movimentações dos funcionários armazenados no ERP poderão ser carregados e integrados à plataforma Feedz de forma online.
Os dados abrangidos na integração incluem:
- Estabelecimento;
- Empresa
- Matricula do funcionário;
- Cargo;
- Unidade de Lotação;
- Gestor direto e Colaborador;
- Nome Social/Nome;
- CPF;
- E-mail;
- Data de admissão;
- Data de nascimento;
- Data de demissão;
- Tipo/Motivo de demissão.
04. FLUXO
Importante
Se ocorrer o erro 'Secure Socket Layer (SSL) - Erro 54: unable to get local issuer certificate: for 4032bcee.0' durante o envio de um processo, será necessário parametrizar o certificado
Ao acessar o programa Integração TOTVS Feedz - FP7800 no menu, você tem a opção de realizar integrações mais específicas, utilizando filtros conforme necessário. Isso pode ser feito aplicando seleção, parâmetros e impressão, conforme demonstrado na tela abaixo:
Importante
Segue abaixo alguns pontos importantes para integração do ERP Datasul TOTVS com a Plataforma Feedz.
- E-mail: cadastrado na pessoa física - FP1440, é informação única por funcionário.
- Nome Social: caso o nome social esteja informado campo Nome Social, no botão complemento do eSocial, no FP1440, a Feedz assume essa informação.
- Múltiplos Vínculos: na plataforma Feedz, é permitido apenas um registro por pessoa. Portanto, ao integrar vários funcionários com o mesmo código de pessoa ou e-mail, a Feedz sobrescreverá e adotará o último cadastro integrado para o mesmo código de pessoa ou e-mail. Na Folha de Pagamento, a ordem de envio é baseada na data de admissão para o mesmo código de pessoa. Se a data de admissão for igual, a prioridade será determinada pela ordem no banco de dados.
- Cargo, Unidade de Lotação e Estabelecimento: essas informações sempre serão enviadas baseada na seleção do funcionário, ou seja essas informações só serão enviadas caso haja funcionários vinculadas a ela. Para consultar essas informações da Feedz, é preciso consultar os detalhes do funcionário.
- Obs: O produto segue uma ordem de envio sendo Unidade de Lotação, Cargo, Estabelecimento, Pessoa, Líder imediato. Caso utilize a seleção de funcionário para envio é importante que a pessoa do líder imediato seja enviado antes que o Liderado.
- Para o sistema identificar o cliente precisa utilizar a Visão Decentralizada com um dos tipos de acesso abaixo:
- Funcionário Transferido: Para funcionário com transferência no período. Não são enviadas as informações de desligamento da empresa origem, é somente atualizados as informações do funcionário com os dados atuais.
- Geração do Lote de Envio : O envio é realizado por geração de lotes de 100 registros.
- Obs: Caso ocorra erro em algum registro do lote, este registro fica com erro, e os demais registro do lote serão processados. Caso seja gerado a consulta sem a marcação do campo "Imprimir Entidades" o lote em questão será apresentado com erro. Se marcado o campo "Imprimir Entidade" será demostrado o detalhamento do Lote com os registros processados e com erro.
- Pasta Seleção:
Nesta tela o usuário informa a faixa de seleção para a consulta e ou sincronização.
- Pasta Parâmetros:
Nesta tela o usuário informa os parâmetros para processar a consulta e ou sincronização.
-
- Ambiente:
- Produção/Sandbox: Indica qual ambiente as informações estão sendo integradas.
Chave de Integração: A chave é gerada para plataforma da Feedz. A utilização é pelo usuário, uma vez informado, não precisa ser informar novamente.
Importante
Configuração Feedz para para geração do Token
- Na tela Feedz, ir em Configurações / Integrações;
- No campo Chave de Integração (API 2.0);
- Clicar em Gerar Token;
- No campo Ativar Integração ERP;
- Em Sistema selecionar Datasul;
- No campo Chave de Integração (API 2.0), copiar a chave gerada e colocar na tela de parâmetro do FP7800.
- Ação:
- Criar Processos: Indica que irá integrar as informações com base na pasta de seleção. É utilizado somente para a integração do funcionário.
Consultar Processos: Indica que irá fazer a consulta dos dados que tiveram o processo criado em "Criar Processos". Esse campo informado irá habilitar o campo de seleção em Consultar Processos/Data Inicio, inicial e final.
Importante
Na tela Seleção pode ser informado o horário de inicio e término do envio, desta forma o sistema é mais assertivo nos dados filtrados.
- Relatórios:
- Imprimir Entidades: Indica que na geração do arquivo .CSV, será gerado as informações dos registros processados e dos que tiveram erro durante a consulta do processamento.
- Ambiente:
- Pasta Impressão:
Nesta tela o usuário informa os parâmetros para impressão em desktop ou em RPW.
Informações Técnicas
Para analisar do log, incluímos o localizador "PM_Feedz", isso facilitará a analise das informações, quais e por onde a integração passou pelos programas.
- Necessário ativar o ativar ClientLog
Importante
ATENÇÃO: Para evitar impacto na performance, recomenda-se que o agendamento seja programado para, no máximo, duas vezes ao dia.
| Tipo Informação | Regra |
|---|---|
| Cargos / Nível (Feedz - Cargos) | FP0720 - Manutenção de Cargo |
| Unidade de Lotação (Feedz - Departamento) | FP0780 - Manutenção de Unidade de Lotação |
| Estabelecimentos (Feedz - Unidades) | FP0560 - Manutenção Estabelecimentos |
| Funcionários (Feedz - Pessoas) | FP1500 - Funcionários / FP1510 - Funcionários Contratos Especiais |
| Pessoa Física (Feedz - Pessoas) | FP1440 - Manutenção Pessoa Física |
| Campo - Tipo de Desligamento (Feedz - dismissalType) | FP0060 - Manutenção Situação Irá gravar o campo conforme regra abaixo:
|
Lista de erros de validação e seus códigos
Alguns erros podem acontecer durante o processamento do lote enviado ou durante a validação dos itens do lote enviado, sendo eles:
Código |
Mensagem |
Detalhes |
4998 |
Id do processo não encontrado |
Significa que o processId informado na requisição de consulta de lotes está incorreto. |
4999 |
Ocorreu um erro inesperado! |
Representa erros genéricos ou inesperados que podem acontecer no servidor ou que podem ser gerados por algum aspecto incorreto não previsto do lote enviado. |
5000 |
Token inválido ou expirado! / Bearer token não informado. |
Isso indica que o token não foi informado na requisição ou informado não é válido. É necessário conferir se o token informado é igual à chave API na plataforma Feedz. Em caso afirmativo, é necessário gerar outra chave. |
5000 |
Body vazio |
Significa que foi enviada uma requisição para gravar um lote, mas sem nenhum dado. |
5001 |
O total de itens enviados no corpo da requisição excede o limite de 100 registros. Todos os registros foram ignorados no processamento. |
Ocorre ao enviar um lote com mais de 100 registros. |
5003 |
A pessoa NPE (IntegrationId = IDN) está referenciando um gestor que não existe. Essa pessoa não será importada. |
Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um gestor que ainda não foi cadastrado. |
5004 |
A pessoa NPE (IntegrationId = IDN) está referenciando ela mesmo como chefe. Essa pessoa não será importada. |
Esse erro ocorre ao tentar cadastrar um colaborador, vinculando ela mesma como gestora (integrationId = managerIntegrationId). |
5005 |
A pessoa NPE (IntegrationId = IDN) está referenciando um departamento que não existe. Essa pessoa não será importada. |
Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um departamento que ainda não foi cadastrado. |
5006 |
A pessoa NPE (IntegrationId = IDN) está referenciando uma unidade que não existe. Essa pessoa não será importada. |
Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a uma unidade que ainda não foi cadastrada. |
5008 |
A pessoa NPE (IntegrationId = IDN) está referenciando um cargo que não existe. Essa pessoa não será importada. |
Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um cargo que ainda não foi cadastrado. |
5009 |
O ID de integração (IntegrationId) é obrigatório e não foi informado para a Pessoa NPE. Essa pessoa não será importada. |
Ocorre ao enviar uma pessoa e não informar se id de integração. |
5011 |
O nome (Name) é obrigatório e não foi informado para a Pessoa (IntegrationId = IDN). Essa pessoa não será importada. |
Ocorre ao enviar uma pessoa e não informar seu nome. |
512 |
O e-mail (Email) é obrigatório e não foi informado para a Pessoa 'NPE' (IntegrationId = IDN). Essa pessoa não será importada. |
Ocorre ao enviar uma pessoa e não informar seu e-mail. |
5013 |
A pessoa 'NPE' (IntegrationId = IDN) possui o mesmo e-mail de outra pessoa da lista de pessoas enviadas ou da base. Essa pessoa não será importada. |
Essa validação existe para evitar cadastrar pessoas duplicadas na base. Assim não é possível cadastrar dois e-mails iguais para integrationIds diferentes e vice versa. |
5014 |
A pessoa 'NPE' (IntegrationId = IDN) deve ter o nome digitado somente com caracteres com nome, sobrenome e apenas 1(um) espaço entre eles. |
Esse erro ocorre ao informar um nome inválido. |
5015 |
A pessoa 'NPE' (IntegrationId = IDN) não pode ter o apelido igual ao nome. |
Ocorre quando o name é igual ao socialName. |
5016 |
O email fornecido 'EML' para a pessoa 'NPE' (IntegrationId = IDN) não está em um formato válido. |
Ocorre ao enviar uma pessoa com o e-mail em formato inválido. |
5017 |
O registro com o nome 'NRA' não foi salvo durante o processamento porque o campo 'IntegrationId' não foi informado." |
Ocorre ao enviar qualquer registro auxiliar e não informar o integrationId. |
5018 |
O registro com o código 'IDN' não foi salvo durante o processamento porque o campo 'Name' não foi informado. |
Ocorre ao enviar qualquer registro auxiliar e não informar o nome. |
5030 |
Quando informado a data de demissão deve ser também informado o motivo (dismissalType). |
Ocorre ao enviar data de demissão e não informar o motivo. |
5031 |
Deve ser informado o motivo da demissão (dismissalType) apenas quando for informado a data de demissão. |
Ocorre ao enviar motivo da demissão e não informar a data de demissão. |
5032 |
A data de admissão não pode ser maior que a data de demissão. |
Ocorre ao enviar uma data de admissão posterior à data de demissão. |
5048 |
O ID de integração do líder (managerIntegrationId = MII) informado para a pessoa (personIntegrationId = IDN) não existe. |
Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse líder cadastrado previamente na plataforma. |
5049 |
O ID de integração da pessoa (personIntegrationId = IDN) informada não existe. |
Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse colaborador cadastrado previamente na plataforma. |
5050 |
Uma pessoa (personIntegrationId = IDN) não pode ser líder de sí próprio |
Ocorre ao tentar vincular uma pessoa a ela mesma como líder (personIntegrationId = managerIntegrationId) através da rota persons-bind. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas