Passar para o conteúdo principal

Como integrar a Senior com a Feedz?

Saiba como realizar a integração da sua plataforma Senior com a sua Feedz.

Feedz avatar
Escrito por Feedz
Atualizado há mais de 2 semanas

⚠️ Na plataforma, este recurso é visível somente para pessoas com perfil de Administrador.

A integração entre a Feedz e a Senior funciona como uma leitura e atualização contínua. Isso significa que ela não apenas lê os dados da Senior, mas também permite a criação, atualização e desligamento de colaboradores na Feedz com base nos registros da Senior. Quaisquer alterações realizadas em perfis dentro da Senior serão sincronizadas na Feedz, garantindo consistência nos dados.

As informações sincronizadas na integração são:

  • Nome completo

  • Nome visível (obrigatório)

  • CPF

  • E-mail de trabalho (obrigatório)

  • Data de admissão

  • Departamento (obrigatório)

  • Cargo (obrigatório)

  • Data de nascimento

  • Data de demissão

  • Situação

  • Matrícula (campo adicional)

  • Sexo (campo adicional)

  • Gestor direto

  • Unidade


Pontos de atenção antes de integrar a Senior com a Feedz

Antes de ativar a integração, é fundamental considerar alguns cenários que podem impactar os dados da sua base.

⚠️ Lembre-se: se a sua empresa já possui cadastros criados manualmente ou por importação de planilhas, é preciso ter atenção redobrada para evitar duplicações, perdas de permissões e inconsistências.

1 - Riscos em bases já populadas

Ao ativar a integração pela primeira vez em uma base que já possui dados, existe a possibilidade de duplicação de informações ou até mesmo a perda de permissões atribuídas a unidades e departamentos. Veja como a Feedz trata esse cenário:

Unidades, Departamentos e Cargos:

  • A integração busca registros existentes com o mesmo nome. Caso encontre, vincula o ID de integração;

  • Se não encontrar, cria um novo registro, o que pode gerar duplicidades — especialmente porque os nomes vindos da Senior podem ter sufixos ou formatações diferentes;

  • Se existirem colaboradores com permissões vinculadas a nomes antigos, essas permissões podem ser perdidas.

Colaboradores:

  • A busca segue a ordem: E-mail > CPF;

  • Se encontrar correspondência, o sistema atualiza os dados e vincula o ID de integração;

  • Se não encontrar, cria um novo registro — por isso, é essencial garantir que os cadastros anteriores estejam com e-mail comercial e CPF corretamente preenchidos.

2 - Riscos de desligamento incorretos

  • Alguns ERPs podem enviar desligamentos retroativos (meses depois do ocorrido) ou manter o envio mesmo em casos de readmissão;

  • A Feedz não permite múltiplos contratos por colaborador, isso pode gerar desligamentos e reativações recorrentes e incorretas.

⚠️ Lembre-se: esses desligamentos podem causar impactos irreversíveis, mesmo que o colaborador seja reativado.

  • Perda de token (apenas para administradores);

  • Exclusão de agendas futuras de 1:1;

  • Quebra do vínculo de liderança;

  • Remoção da pessoa das Avaliações de Desempenho;

  • Perda de vínculo com Objetivos.

3 - Bloqueios de cadastros por domínios não permitidos

Se você utiliza a funcionalidade "Domínios de e-mail permitidos", lembre-se de adicionar todos os domínios utilizados pela empresa. Caso contrário, o cadastro de novos colaboradores poderá ser bloqueado.


Passo a passo

O primeiro passo é acessar a sua Feedz e depois clicar em 'Configurações' no menu lateral esquerdo. Em seguida, no menu superior, clique em 'Integrações'. Por fim, será necessário gerar o token, clicando no botão 'Gerar Token'.

O token é pessoal e por usuário/empresa. Esta chave deve ser gerada apenas pelo administrador da empresa, ou seja, pelo cliente. A Feedz não pode criar essa chave.

Desça a página até a seção 'Integração Senior' e preencha os dados da integração com a Senior.

Orientações para preenchimento dos campos:

  1. "Ativar Integração": a integração da Senior só funcionará com esse campo marcado/ativado. Se todas as informações estiverem preenchidas, mas a opção não estiver ativa, a integração não funcionará.

  2. "Ativar Integração de Gestor Direto": essa integração consulta o serviço "Hierarquia Posto" para buscar o líder do colaborador.

  3. "Ativar integração de filiais": essa integração consulta o serviço "integrações", buscando dados na tabela "R030FIL". É necessário uma permissão específica para seu funcionamento. Caso a integração de filiais falhe, dados do colaborador não serão atualizados.

  4. "Subdomínio Senior": deve ser preenchido com a URL completa para acesso à API. Importante: Essa URL precisa ser fornecida pela própria Senior.

  5. "Porta Acesso Senior": porta para acessar a API. Exemplo de porta: HTTP = 8080; HTTPS = 443.

  6. "Usuário Senior": deve ser preenchido com o usuário de acesso a API/Integração. Importante: Essa informação precisa ser fornecida pela própria Senior.

  7. "Senha de Acesso Senior": deve ser preenchido com a senha para acesso a API/Integração. Importante: Essa informação precisa ser fornecida pela própria Senior.

  8. "Número Empresa Senior": deve ser preenchido com o número da empresa que será integrada. Importante: Essa informação precisa ser fornecida pela própria Senior.

  9. "Ano fundação": ano de início da empresa para que, ao realizar a importação, o sistema consiga buscar os dados dos primeiros colaboradores da empresa que ainda estão ativos.

  10. "Departamento na Senior": na Senior, o departamento pode ser configurado como Local (padrão) ou Centro de custo. Caso sua empresa utilize o centro de custo como referência de departamento, essa configuração pode ser ajustada na integração com a Feedz.

  11. "Código do tipo de hierarquia de postos de trabalho": para integrar o Gestor Direto, é necessário preencher este campo. Na Senior ele aparecerá como na imagem a seguir:

  12. "Tipos de colaborador": é possível definir quais perfis de colaboradores serão integrados com a Feedz. As opções são:

    • Tipo 1: Colaborador (CLT)

    • Tipo 2: Terceiro

    • Tipo 3: Parceiro

Após preencher todos os campos, desça a tela e clique em 'Salvar'.

⚠️ Lembre-se: as informações não serão sincronizadas na Feedz logo após o preenchimento dos dados nas configurações. Os dados da Senior serão enviados para Feedz todos os dias, na madrugada.


Campos integrados

Campo na Feedz

Campo na Senior

Nome completo

nomFun

Nome visível (obrigatório) *

nomFun

CPF

numCpf

E-mail (obrigatório)

emaCom

Data de admissão (obrigatório)

datAdm

Departamento (obrigatório)

nomLoc ou nomCcu

Cargo (obrigatório)

titCar

Data de nascimento

datNas

Data de demissão

datAfa

Situação

desSit

Matrícula **

numCad

Sexo **

tipSex

Unidade **

integracoes.R030FIL.[CODFIL, NOMFIL]

Gestor direto **

hierarquiasPosto.numCad

* Nome visível: a integração considera apenas o nome de registro para novos colaboradores. Se o colaborador tiver nome social, ele precisará ser ajustado manualmente após o cadastro.

** Campos exclusivos da nova integração: alguns campos só estão disponíveis na nova versão da integração. Para saber mais ou solicitar a migração, entre em contato com o analista de CS responsável pela sua empresa.


Regras e validações da integração

Vínculo por Integration ID: na primeira sincronização, a Feedz verifica se já existe um "Integration ID" correspondente (para pessoa, unidade, departamento ou cargo). Caso exista, os dados são atualizados; se não, é criado um novo registro.

Cenários de integração:

  • Base limpa: cenário ideal. Todos os registros são criados com vínculo automático ao ERP.

  • Base já populada: aplicamos regras para evitar duplicação. Ainda assim, pode haver inconsistências se os nomes não estiverem exatamente iguais.

Ordem de identificação de colaboradores:

  1. Integration ID

  2. E-mail

  3. CPF

Informações importante:

  • Unidades, cargos e departamentos com nomes semelhantes mas cadastrados de forma diferente podem ser duplicados;

  • Permissionamentos vinculados a registros antigos podem ser perdidos;

  • Nomes e e-mails devem ser únicos em toda a Feedz;

  • Não permitimos caracteres especiais como `, ', ", =, <, > em nomes;

  • Um mesmo e-mail não pode ser usado por pessoas diferentes, mesmo em empresas distintas;

  • Não é possível vincular colaboradores a gestores desligados.

Sobre nome social:

  • Para novos cadastros, se houver nome social, ele será usado como nome de exibição;

  • Em atualizações, o nome social não é sobrescrito. Caso necessário, deve ser alterado manualmente.

Campo Papel:

  • O campo "Papel" é atualizado automaticamente;

  • Por padrão, todos entram como "Colaborador";

  • Se houver vínculo de liderança, o papel passa a ser "Gestor";

  • Não realizamos downgrade para "Colaborador" caso a pessoa já seja "Gestor" ou "Administrador".

Status Desativado:

  • Dados podem ser atualizados;

  • Não é possível reativar colaboradores desativados via integração;

  • É possível realizar o desligamento normalmente.

Readmissão: é possível readmitir colaboradores que foram desligados, desde que tenham o mesmo CPF, e-mail e matrícula utilizados anteriormente no ERP.

⚠️ Lembre-se: se a matrícula for diferente (mesmo com CPF e e-mail iguais), a integração não será feita.


Erros comuns

  • E-mail obrigatório para cadastro na Feedz: pessoa sem e-mail não serão cadastrados na Feedz. Para corrigir esse erro, preencha o e-mail profissional do colaborador na Senior.

  • Já existe colaborador com este CPF: pode existir um erro de digitação no documento do colaborador, ou o CPF já constar na base de dados Feedz. Revise os documentos do colaborador. Contudo, agora, não é mais obrigatório o uso de CPF para que a integração funcione corretamente.

  • Cargo obrigatório para cadastro na Feedz: pessoas sem cargo não serão cadastrados na Feedz. Para corrigir esse erro, preencha o cargo do colaborador na Senior. Os cargos são importados automaticamente, desde que tenham pelo menos um colaborador associado.

  • Colaborador já foi desligado: essa mensagem significa que o perfil do colaborador desligado na Senior já foi desligado anteriormente pela Feedz.


Documentação complementar (Senior)

Caso necessite de informações complementares, você pode acessar os documentos disponibilizados pela Senior abaixo:

Respondeu à sua pergunta?