Como funciona a integração entre Pontotel e Sankhya

A Pontotel faz parte do Grupo Sankhya, e as duas plataformas têm uma integração nativa. Neste artigo, você vai entender o que é essa integração, o que ela faz e o que não faz, quais dados circulam entre os sistemas, o que precisa estar certo no Sankhya para tudo funcionar e como acompanhar o que foi integrado.

O que é a integração

Integração é a conexão automática entre dois sistemas, para que eles troquem informações sem ninguém precisar digitar o mesmo dado duas vezes.
Entre Pontotel e Sankhya, cada plataforma cuida do que faz melhor. O Sankhya guarda o cadastro de pessoas e a estrutura da empresa. A Pontotel controla a jornada e o ponto.
A integração leva os cadastros e os eventos de ausência do Sankhya para a Pontotel. No caminho de volta, a Pontotel envia ao Sankhya as escalas, que viram cargas horárias, e os dados apurados do ponto, para fechar a folha de pagamento.
Na prática, você ganha:

• cadastros iguais nos dois sistemas, sem duplicidade;
• menos erros de digitação e menos retrabalho do DP;
• mudanças no Sankhya refletindo rapidamente na Pontotel;
• dados de ponto prontos para o fechamento da folha.

A regra principal: o Sankhya manda

Nos cadastros, o Sankhya é a fonte da verdade. Isso significa que:

• você cria e edita pessoas, empresas, férias e ocorrências no Sankhya, e a Pontotel acompanha;
• se alguém alterar na Pontotel um campo que vem da integração, a alteração é desfeita na próxima atualização, porque o dado do Sankhya volta a prevalecer;
• admissões e demissões devem ser feitas sempre no Sankhya, porque o cadastro manual na Pontotel pode gerar divergência entre os sistemas;
• os códigos (do empregador, do empregado, do local, da escala) são a ligação entre os dois sistemas. Se um código for alterado em qualquer lado, a referência se perde e o sistema entende que se trata de um cadastro novo.

O que a integração não é

• Não é uma cópia de tudo. Só circulam os dados dos fluxos que foram ativados no seu setup.
• Não apaga cadastros. Empregados, usuários e escalas excluídos em um sistema precisam ser excluídos manualmente no outro. A exclusão automática vale só para férias, dispensas e afastamentos.
• Não cria suas regras. As regras de cálculo e de banco de horas são configuradas na Pontotel, junto com o time de Implantação ou Suporte.
• Não integra quem é dispensado de ponto, nem empresas que não são optantes pelo registro eletrônico.
• Não leva anexos. Atestados e comprovantes anexados no Sankhya continuam disponíveis só lá.
• Não envia os pontos batidos para o Sankhya. Ele recebe o resultado apurado (verbas e faltas).
• Não corrige dados incorretos. Se um cadastro estiver incompleto ou inconsistente no Sankhya, ele não integra, e você precisa corrigi-lo na origem.

Quais dados são integrados

Cada fluxo é ativado conforme a necessidade da sua empresa. Se você não ativar um deles, precisa seguir cadastrando aquele dado manualmente. Os fluxos também se conectam: o empregado só integra se o empregador e o local dele também estiverem cadastrados na Pontotel, manualmente ou pela integração.

Quando os dados chegam

A integração consulta o Sankhya em intervalos curtos e traz apenas o que foi criado ou alterado desde a última consulta com sucesso. Por isso, você não precisa esperar um horário fixo.
Isso funciona porque o Sankhya avisa a Pontotel de cada mudança por meio do Log de Alterações do Gateway, que precisa estar habilitado nas preferências do Pessoal+. Além disso, uma vez por dia a Pontotel faz uma verificação completa, que pega qualquer mudança que a consulta recorrente não percebeu, como alterações feitas direto no banco de dados, por script, ou quando a base estava fora do ar.
As escalas seguem o caminho contrário: pouco depois de você criar ou alterar uma escala na Pontotel, ela é enviada ao Sankhya.

O que precisa estar pronto no Sankhya

• Ter o Pessoal+ e o Sankhya OM contratados e implementados, com o Sankhya ID habilitado no ambiente.
• Ter um usuário de integração (o nome padrão é INTEGPONTO), com permissão de acesso à tela de Configurações do Gateway e aos cadastros.
• Ter gerado o token do Gateway, associado a esse usuário e ao parceiro Pontotel, e entregue à Pontotel. A tela de Configurações do Gateway permite gerar o token direto pelo sistema nas versões 4.16 ou superiores do Sankhya.
• Ter habilitado o Log de Alterações nas preferências do Pessoal+. O Sankhya recomenda fazer isso em horário de baixa utilização.
• Manter a base do Sankhya online durante as consultas, com o token válido e a URL da base atualizada no Gateway.

Como cada fluxo funciona

Empregadores

• A empresa precisa estar ativa e marcada como optante pelo registro eletrônico de ponto.
• Código, descrição e CPF ou CNPJ são obrigatórios.
• Para não integrar uma empresa (por exemplo, uma só de autônomos), altere a opção de registro eletrônico dela.
• Se a empresa for inativada no Sankhya, o empregador fica inativo na Pontotel.
• Você não precisa integrar todas as empresas. É possível escolher uma ou algumas e deixar as demais de fora: basta informar ao Suporte os códigos das empresas do Sankhya que devem integrar.
• Se a sua empresa usa CEI, CNO ou CAEPF, também é possível integrar esse dado. A ativação é assistida pelo nosso time, para evitar alterações nos empregadores que já existem.

Locais de trabalho

• O local nasce da combinação de Departamento + Cidade de trabalho dos funcionários que controlam ponto.
• A cidade de trabalho precisa estar preenchida e escrita corretamente. Se estiver inconsistente, o local não integra e, por consequência, o empregado também não.
• Os locais criados pela integração ficam associados a todos os empregadores.

Empregados

• O funcionário não pode estar dispensado de ponto.
• Precisa ter, no mínimo: empresa, carga horária (com data de início), departamento, cidade de trabalho, CPF e sindicato.
• O PIS é opcional, mas, se for preenchido, precisa ser válido ou “00000000000”.
• Quando o Nome Social está preenchido no Sankhya, ele vira o nome do empregado na Pontotel, e o nome civil fica guardado em um campo próprio. Se o colaborador não usa nome social, deixe o campo em branco.
• A integração cuida de admissão, atualização, transferência e demissão. Admissões com data futura também integram, e demissões com data futura ficam agendadas.
• Na demissão, o cadastro não pode ter pontos batidos depois da data de demissão.
• Na transferência entre empresas, o cadastro do empregado é atualizado com o novo empregador e o novo código, e o histórico (pontos, férias, dispensas, afastamentos e banco de horas) é mantido. O PIN continua o mesmo.
• Quem tem dois vínculos em empresas diferentes recebe um segundo cadastro, com PIN igual ao CPF seguido de “1”.
• A integração não exclui empregados.

O código do empregado na Pontotel é a junção do código da empresa com o código do funcionário no Sankhya, com zeros à esquerda até completar 4 dígitos. Por exemplo, empresa 1 e funcionário 22 resultam no código 0122. É com esse código que você localiza o empregado na Auditoria de Integrações.

Dia de início da folha
Você define o dia de início da folha ao ligar a integração. Há três formas de configurar:

• usar o dia de apuração cadastrado na empresa, no Sankhya (é o padrão);
• definir um dia fixo, entre 1 e 28, para todos os empregados;
• usar o dia de início da apuração do cadastro de cada funcionário, também entre 1 e 28.

Se a folha do empregado já foi travada, a mudança do dia de início precisa do apoio do nosso time de Suporte.

Formas de registro de ponto e benefícios
Também no momento de ligar a integração, você define como os empregados novos já nascem configurados na Pontotel. Isso inclui as formas de registro de ponto (como foto, voz, reconhecimento facial e registro em qualquer local) e os benefícios, como VR e VT.
A configuração vale para todos os empregados admitidos pela integração. Se alguns precisarem de um ajuste diferente, altere no cadastro do empregado depois da admissão: a integração não desfaz esse ajuste.

Escalas e cargas horárias

Esse fluxo funciona no sentido contrário ao dos outros: você cria a escala na Pontotel, e ela vira carga horária no Sankhya, sem cadastrar duas vezes.
Para criar uma nova escala, siga este passo a passo:

1. Crie a jornada e a escala na Pontotel. Preencha nome, código e tipo de escala (nas configurações avançadas).
2. Confira se a carga horária chegou ao Sankhya. Na Auditoria de Integrações, abra a entidade Carga Horária e filtre pelo código da escala.
3. Associe a carga horária ao funcionário no Sankhya. Informe também a data de início ou de alteração.
4. Aguarde a atualização na Pontotel. A integração de empregados atualiza a escala e a data de início do empregado, conforme o Sankhya.

As regras desse fluxo:

• A escala precisa ter nome, código e tipo de escala, porque o Sankhya usa essas informações para o eSocial. Só esses três dados seguem para o Sankhya. O restante, que diz respeito ao ponto, fica na Pontotel.
• O código da escala e o da carga horária precisam ser iguais. Se a Pontotel não encontrar uma escala com o mesmo código, o empregado é admitido na Escala Padrão, que precisa existir na sua conta.
• Para novas admissões, crie a escala antes de cadastrar o funcionário. Sem carga horária, o funcionário não é integrado.
• Se você já usava cargas horárias no Sankhya, cadastre na Pontotel escalas com os mesmos códigos antes de ativar a integração. Assim, os empregados já entram na escala certa.
• Uma carga horária criada direto no Sankhya não vai para a Pontotel. Para ligar as duas, cadastre a escala na Pontotel com o mesmo código.
• Se você cadastrar na Pontotel uma escala com um código que já existe no Sankhya, ele não cria uma carga horária nova: a escala é vinculada à que já existe. Por isso, use sempre códigos exclusivos.
• A integração não exclui nem inativa escalas. Se você excluir uma carga horária no Sankhya e a escala continuar na Pontotel, a carga horária é criada de novo. Para parar de integrar, exclua a escala na Pontotel.
• Se a data de início da carga horária for anterior ao dia em que a integração admite o empregado, a Pontotel considera o dia da integração, para não gerar faltas indevidas.
• A fase e o dia inicial da escala podem ser ajustados direto na Pontotel. A integração não sobrescreve esses ajustes, desde que o código da escala continue igual ao da carga horária no Sankhya.

Sindicato e banco de horas

• O sindicato do funcionário indica a regra de cálculo dele na Pontotel. O código do sindicato no Sankhya precisa existir na Pontotel.
• Há uma opção específica para também vincular a regra de banco de horas na admissão do empregado, pelo código do sindicato (ou do posto de trabalho, para empresas que usam tomador). Ela não vem ativada por padrão: peça ao Suporte para habilitar.
• Se nenhuma regra com esse código for encontrada, o empregado recebe a regra “regras-padrão”, caso ela exista.
• Essa vinculação acontece apenas na admissão. Alterações posteriores são feitas na Pontotel.

Férias

• A integração só leva férias com data de saída preenchida (folha calculada no Sankhya) e aprovadas.
• Para atualizar, altere no Sankhya. A integração exclui o lançamento anterior e cria o novo. Para excluir, também exclua no Sankhya.
• O período abonado não pode estar com a folha travada na Pontotel, nem ter outro lançamento sobreposto (dispensa, afastamento ou outras férias).
• Você pode escolher se o empregado deve sair do REP-P durante as férias, para não aparecer nos coletores.

Férias solicitadas pela Pontotel

Se a sua empresa usa o módulo Gestão de Férias, também é possível seguir o caminho contrário: o colaborador solicita as férias na Pontotel, o pedido passa pela aprovação que você configurou e segue para o Sankhya como uma requisição de férias.
Nesse formato, vale conhecer algumas regras:

• O Sankhya continua sendo a fonte do período aquisitivo e do saldo. A Pontotel passa a seguir a regra dele, que libera 30 dias de saldo no início do período, e não o acúmulo mensal padrão da Pontotel.
• Depois da aprovação na Pontotel, o RH ainda faz a aprovação final da requisição no Sankhya.
• Edições, exclusões e recusas não são sincronizadas entre os sistemas. Qualquer ajuste feito depois do envio precisa ser repetido nos dois lugares.
• Se o RH recusar a requisição no Sankhya, ela não é enviada de novo. Registre as férias manualmente no Sankhya.
• Evite adicionar saldo manualmente no Sankhya: os aumentos não chegam à Pontotel e podem bloquear novas solicitações.

Dispensas e afastamentos

• No Sankhya, dispensas e afastamentos fazem parte de uma única entidade, chamada 'Ocorrências'. Na Pontotel, você escolhe como cada tipo de ocorrência será integrado: como dispensa, como afastamento ou não integrável.
• Ocorrências do Sankhya viram dispensa ou afastamento na folha do empregado, conforme o tipo escolhido.
• Dispensas precisam de data final. Afastamentos podem ficar sem data final, abonando por tempo indeterminado.
• Para dispensas, você pode definir se descontam DSR, se contam como horas trabalhadas e se descontam das horas da jornada. Para afastamentos, se o empregado sai do REP-P no período.
• Compensações, faltas, “trabalhado” e reintegração não são integrados, e devem ser tratados na folha ou no banco de horas da Pontotel.
• Na primeira execução, entram ocorrências iniciadas nos últimos 30 dias.

Usuários

• Quando o usuário está associado a um empregado, o empregado precisa ter CPF.
• Também é possível criar o usuário sem empregado relacionado, o que atende gestores que não registram ponto. Peça ao Suporte para ativar essa opção.
• A permissão vem do cadastro do Sankhya: RH para quem pertence ao DP, Supervisor para quem tem liderados e Funcionário para quem bate ponto. Quem não se encaixa em nenhum caso não é integrado.
• O e-mail do funcionário no Sankhya passa a ser o e-mail do usuário na Pontotel.
• O líder direto também é integrado, e a integração atualiza essa informação quando ela muda no Sankhya.
• A senha inicial é o CPF, e pode ser alterada no site Gestão.
• Para mais segurança, ao ligar a integração é possível ativar a autenticação em dois fatores (MFA) e exigir a troca de senha no primeiro acesso.
• Se você usa permissões personalizadas, peça ao Suporte para desativar a atualização automática de permissões.
• A integração não exclui usuários.

Feriados

• Com a integração ativada, o Sankhya passa a ser a fonte dos feriados. Feriados que existem só na Pontotel são removidos, e os que existem só no Sankhya são criados.
• Entram os feriados marcados para uso no ponto. O campo “Obrigatório” do Sankhya define se o feriado terá folga na Pontotel.
• País, estado e cidade precisam estar preenchidos conforme o tipo do feriado (municipal exige os três, estadual exige país e estado).
• A atualização acontece uma vez ao dia.

Do ponto para a folha: verbas e faltas

O cálculo das verbas é feito na Pontotel, conforme as regras da sua empresa. Para levá-las ao Sankhya, você tem duas opções:

• Arquivo E02: você gera o arquivo na Pontotel e o importa no Sankhya. Veja o artigo Entenda sobre o arquivo E02.
• Envio direto (beta): no mesmo local, você seleciona “integrar verbas e faltas” e os dados vão para o Sankhya sem exportar e importar arquivos.

Nas duas opções, é necessário ter a parametrização das verbas (E02) feita.

Antes de enviar:

• confira os apontamentos gerando o arquivo e trave a folha, para congelar os valores;
• na primeira vez, envie apenas um local de trabalho, valide no Sankhya e depois libere os demais;
• no Sankhya, os valores só são gravados se o período estiver aberto e o funcionário não tiver folha calculada;
• só entram as faltas que existem na folha da Pontotel e ainda não existem no Sankhya. Se o seu cálculo no Sankhya já considera as faltas para descontos de DSR e férias, evite ter a mesma verba parametrizada na Pontotel, para não descontar duas vezes.

Como acompanhar o que foi integrado

• Auditoria de Integrações: usuários com perfil de RH e a permissão liberada no perfil consultam os registros dos últimos 90 dias. Há uma tela para cada fluxo, com filtros por identificador, período, etapa e status (sucesso, rejeitado ou erro). Quando há rejeição, a tela mostra o erro e uma orientação em “O que fazer”.
• Como localizar um registro: para empregados, use o código da Pontotel (empresa mais funcionário). Para escalas, que aparecem na entidade Carga Horária, use o código da escala.
• Verbas e faltas: o acompanhamento é pelo ícone de sino (Notificações), como nos relatórios. O arquivo final traz o que foi integrado e as falhas. Na tela de acompanhamento (beta), você analisa as falhas e usa reexecutar nos itens selecionados.
• Configuração da integração: o ajuste das opções de cada fluxo é feito pelo nosso time de Suporte.

Passo a passo para ativar a integração

1. Solicite a ativação. Fale com o Suporte da Pontotel ou com o Time de Implantação.
2. Preencha o formulário. Um analista apresentará o cronograma e pedirá as informações iniciais pelo formulário de ativação.
3. Corrija a base. Com as bases conectadas, geramos uma planilha de análise. Você ajusta no Sankhya as inconsistências encontradas.
4. Valide em homologação. Nossa equipe técnica testa a integração e depois você faz a sua validação em um ambiente de testes.
5. Ative. Os códigos e as verbas são confirmados com você.
6. Valide o fechamento. Você confere as verbas e as faltas, e o processo é encerrado.

Erros mais comuns e como evitar

Perguntas frequentes

1. Posso escolher quais dados integrar?

Sim, cada fluxo é ativado separadamente, e você também pode escolher quais empresas integram. Lembre-se de que o empregado depende do empregador e do local.

2. Excluí um empregado no Sankhya. Ele sai da Pontotel?

Não. Empregados, usuários e escalas excluídos precisam ser excluídos manualmente no outro sistema. Para férias, dispensas e afastamentos, a exclusão no Sankhya é refletida.

3. Os pontos batidos vão para o Sankhya?

Não. O Sankhya recebe as verbas e as faltas apuradas, não as batidas.

4. Os anexos dos atestados vão junto?

Não. Eles seguem disponíveis no Sankhya.

5. Já cadastrei férias direto na Pontotel. Isso é um problema?

Se elas depois forem lançadas no Sankhya, alterações ou exclusões feitas lá não refletirão no lançamento criado na Pontotel. Prefira lançar sempre no Sankhya, ou use o módulo Gestão de Férias com a integração, que envia as férias aprovadas para o Sankhya.

6. Criei uma escala nova na Pontotel. O que faço no Sankhya?

Aguarde ela aparecer como carga horária (você confere na Auditoria de Integrações, na entidade Carga Horária). Depois, associe a carga horária ao funcionário no Sankhya, com a data de início. A Pontotel atualiza o cadastro do empregado em seguida.

7. Criei uma carga horária direto no Sankhya. Ela aparece na Pontotel como escala?

Não. Cadastre a escala na Pontotel com o mesmo código da carga horária. Sem isso, os empregados são admitidos na Escala Padrão.

Caso ainda tenha dúvidas ou precise de auxílio, entre em contato com o nosso time de Suporte pelo chat integrado ao site Pontotel Gestão ou pelo WhatsApp.

Atualizado em: 14/10/2026