Integração de Locais de Trabalho Sankhya x Pontotel (Departamento + Cidade de Trabalho)

Módulo: Pessoas+ / Integrações
Caminho de Acesso: Menu Principal > Integrações > Cadastro de Locais de Trabalho

Sumário

1. Descrição da Funcionalidade
2. Pré-requisitos
3. Diagrama de Fluxo
4. Jornada de Uso
5. Pontos de Atenção
6. Dicas de Usabilidade
7. Casos de Uso

Descrição e Usabilidade

1. Descrição da Funcionalidade

A integração automatiza o cadastro e atualização dos Locais de Trabalho na Pontotel, a partir da combinação Departamento + Cidade de Trabalho dos funcionários cadastrados na Sankhya.

O processo garante que os locais estejam sempre sincronizados, facilitando a associação correta dos empregados para registro de ponto e eliminando erros manuais.

A integração ocorre automaticamente a cada 12 horas, trazendo agilidade e precisão para a gestão dos locais.

2. Pré-requisitos

Permissões necessárias
- Ter contratado e implementado o Pessoal+ e também o Sankhya Om;
- Ter realizado o setup de integração Sankhya/Pontotel.
Parâmetros essenciais
- Habilitação do recurso Log de Alterações do Gateway (parâmetro LOGTABOPER - Ativar armazenamento de log de modificações em tab = ligado na tela Preferências do Sankhya Om).
- Funcionários devem possuir controle de ponto e associação de Departamento + Cidade de Trabalho correspondentes.
- Não pode existir outro local previamente cadastrado na Pontotel com o mesmo código (CODDEP+CODCIDTRAB) na Sankhya.
- Cadastro das cidades na Sankhya deve estar correto e sem inconsistências.
Configurações relacionadas
- Base Sankhya online e responsiva durante as consultas.
- Token válido e URL atualizada no Gateway.

3. Diagrama de fluxo

4. Jornada de Uso

4.1. Cadastro/Alteração de funcionário na Sankhya

O usuário preenche Departamento e Cidade de Trabalho no cadastro do colaborador.

4.2. Execução automática da integração

A cada 12 horas, o sistema verifica colaboradores elegíveis e sincroniza os Locais de Trabalho na Pontotel.

4.3. Atualização do cadastro de locais na Pontotel

Novos locais são criados ou atualizados conforme as informações do Sankhya Om.

4.4. Associação de empregados

Os colaboradores são vinculados ao local correspondente, garantindo o registro de ponto correto.

4.5. Campos integrados: departamento e cidade de trabalho (Sankhya) → local de trabalho (Pontotel)

Campo Sankhya	Campo Pontotel	Descrição
Tabelas consultadas no Sankhya: TFPFUN, TFPDEP e TSICID
CODDEP + CODCIDTRAB - DESCRDEP - NOMECID	Nome	Concatenação da descrição do código do departamento + código da cidade de trabalho + nome do departamento + cidade de trabalho do empregado.
CODDEP + CODCIDTRAB	Código	Concatenação do CODDEP + CODCIDTRAB.
UFNOMECID	Estado	UFNOMECID da tabela de cidades, associada ao CODCIDTRAB.
NOMECID	Cidade	Identificado na tabela de cidades pelo código da cidade de trabalho atribuída ao funcionário.
-	Sobreaviso	Cria como possui sobreaviso, mas não atualiza esse campo.
-	Empregadores	Associa a todos os empregadores ativos na Pontotel na criação. Na atualização, associar a novos empregadores criados, se houver.
DESCRDEP - NOMECID - UFNOMECID	Endereço AFD	Concatenação da descrição do departamento + cidade de trabalho do empregado + UF da cidade de trabalho.
-	Sincronizar com REPP	Mantém sempre o local sincronizado com o REPP.
-	Aparece no acompanhamento	Mantém o local sempre no acompanhamento.

5. Pontos de Atenção

O código do local (CODDEP+CODCIDTRAB) é o identificador de equivalência entre Sankhya e Pontotel e não deve ser alterado.
Locais não serão integrados se houver inconsistências no cadastro da cidade de trabalho ou se o campo não estiver preenchido no Sankhya Om.
Se o local já existir na Pontotel com o mesmo código, os dados serão atualizados.
A associação do empregado ao local deve ser feita na Sankhya; se o local não for integrado, o cadastro do empregado não será criado/atualizado na Pontotel.
Alterações que não sensibilizem o log de alterações só serão integradas na execução de consistência diária.

6. Dicas de Usabilidade

Utilizar filtros no Sankhya Om para visualizar funcionários com Departamento e Cidade de Trabalho preenchidos.
Manter o cadastro das cidades atualizado e padronizado para evitar falhas na integração.
Verificar periodicamente o status do token e da URL no Gateway para garantir a continuidade da integração.

7. Casos de Uso

✅ Exemplo Real:
Cadastro de funcionário com Departamento "Administrativo" e Cidade de Trabalho "Goiás". Após a execução da integração, o local "Administrativo - Goiás" é criado automaticamente na Pontotel.

❌ Erro Comum:
Funcionário cadastrado sem Cidade de Trabalho preenchida no Sankhya Om.

Resultado: local não integrado e empregado não criado/atualizado na Pontotel.

FAQ – Dúvidas Frequentes

Posso integrar locais de trabalho cadastrados apenas com Departamento?

Não, é obrigatório preencher também a Cidade de Trabalho.
O que acontece se eu alterar o código do local na Pontotel?

A referência de equivalência entre Pontotel e Sankhya será perdida, podendo causar inconsistências.
Locais inativos na Sankhya são excluídos na Pontotel?

Não, apenas o status do local é atualizado para inativo.
Preciso cadastrar manualmente locais de trabalho na Pontotel?

Apenas se a integração não estiver habilitada ou configurada corretamente.

Pesquisa