⚠️ Importante: as instruções abaixo mostram como configurar a integração entre o Feedz e o ERP TOTVS. Para dúvidas ou problemas técnicos com o ERP, entre em contato com o suporte do ERP, abrindo um ticket na linha de produto correspondente.
➡️ A integração está disponível a partir das versões 12.1.2307.13, 12.1.2311.7 ou 12.1.2403.2.
Passo a passo:
1. Solicitar ambiente de Homologação
Recomendamos como boa prática que, na Feedz, a integração seja testada em um ambiente de teste. Para isso, é necessário solicitar esse ambiente para a pessoa da Feedz que é responsável pelas tratativas da sua empresa (Analista de Customer Success ou Analista de Onboarding). Feita a solicitação, o ambiente será entregue em alguns dias.
Caso a sua empresa deseje um ambiente de homologação também no TOTVS Datasul, será necessário conversar com o Gerente de Contas da TOTVS Datasul para entender a viabilidade.
⚠️ Esta etapa deve ser realizada pelo RH em parceria com a Feedz.
2. Acesso ao Token de integrações da Feedz (obrigatório para todos os sistemas)
A maioria da configuração é feita no Datasul. Na Feedz, você realizará dois passos obrigatórios: gerar uma chave que será usada pelo Datasul para autenticação na Feedz e selecionar o sistema que utilizará, ao enviar os dados de integração para o serviço do ETL.
O Token deve ser gerado por um usuário Administrador da empresa na Feedz. A chave é obtida em: Configurações > Integrações > Chave Integração (API 2.0).
Caso o campo esteja vazio, clique em 'Gerar Token'.
Assim que gerar o token, desça a tela e ative o campo 'Ativar Integração ERP' e selecione o sistema. Você terá à disposição três sistemas: Protheus, RM e Datasul.
Caso queira, você poderá também selecionar com qual status os novos colaboradores serão integrados na Feedz. Basta selecionar no campo abaixo:
Uma nova possibilidade é replicar os cargos. Na Feedz, é possível ter duas nomenclaturas para cargos, uma para o RH e lideranças e outra pública que chamamos "Cargo visível". Esta informação de cargo visível não é enviada pelos ERPs.
Clientes que não precisam desta diferenciação podem replicar o "Nome do cargo" para "Cargo visível".
Por fim, adicione o domínio da empresa que será utilizado para a criação dos endereços de e-mail fake dos novos colaboradores.
⚠️ Lembre-se: se essa ação não for feita, os cadastros serão bloqueados. Para isso, confira este artigo: "Como configurar os domínios permitidos para logar na Feedz?"
Isso é necessário para o cadastro na Feedz quando nem todos os usuários têm um e-mail próprio e esta informação é obrigatória.
Ao preencher um domínio, ele é usado para atribuir um e-mail com base no CPF do colaborador.
Por exemplo, se o CPF é "123.456.789-01" e o domínio é "minhaempresa.com.br", o e-mail será: [email protected].
3. Configuração do ambiente Datasul
As próximas etapas devem ser realizadas diretamente na ferramenta Datasul.
Para poder realizar a integração com sucesso, junto do seu time de TI. Para isso, execute as orientações deste artigo.
Algumas nomenclaturas no Datasul são diferentes das apresentadas na Feedz. Para garantir uma melhor compreensão, veja a tabela abaixo com as correspondências entre os termos nos dois sistemas.
Feedz | Datasul |
Empresa | Empresa |
Unidade | Estabelecimento |
Departamento | Unidade de Lotação |
Matrícula | Matrícula |
Líder direto | Gestor direto |
Pontos de atenção e riscos na integração:
A integração pode gerar duplicações, perda de permissionamentos e desligamentos incorretos. Para evitar esses problemas, fique atento às regras abaixo:
🛑 Risco de duplicação e perda de permissionamentos:
Unidades, Departamentos e Cargos: Se o nome já existir, vinculamos o ID de integração. Caso contrário, um novo registro é criado. Como a nomenclatura varia entre sistemas, duplicações são prováveis, podendo impactar permissionamentos vinculados.
Colaboradores: A busca ocorre na seguinte ordem: E-mail > CPF. Se encontrado, o ID de integração será vinculado e os dados atualizados. Se não, um novo cadastro será criado. Colaboradores sem e-mail comercial ou CPF preenchido podem ser duplicados.
🔄 Risco de desligamentos incorretos:
Alguns ERPs enviam desligamentos retroativos por meses, o que pode gerar readmissões erradas.
Na Feedz, cada pessoa pode ter apenas um contrato. Se mais de um cargo for enviado, pode haver desligamentos indevidos.
Impactos irreversíveis de desligamentos:
Perda de token (admin)
Remoção de agendas 1:1 e da agenda integrada
Exclusão de relações de liderança
Exclusão da Avaliação de Desempenho
Impacto nos objetivos
🚫 Bloqueios por domínios não permitidos:
Se a empresa utilizar "Domínios de e-mail permitidos", todos os domínios devem ser cadastrados para evitar bloqueio de novos cadastros.