> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://suporte.pontotel.com.br/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/c/e/8/7/ce87d16ae4000000/2_1u3icba.png =300xauto) --- ### 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. ||| ⚠️ A exceção são as escalas: elas nascem na Pontotel e seguem para o Sankhya como cargas horárias. Você confere os detalhes na seção sobre escalas, mais abaixo. --- ### 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 | Sankhya | Pontotel | Sentido | O que acontece | | ---- | ---- | ---- | ---- | | Empresa | Empregador | Sankhya para Pontotel | Cria, atualiza e inativa empregadores | | Departamento + Cidade de trabalho | Local de trabalho | Sankhya para Pontotel | Cria e atualiza locais | | Funcionário | Empregado | Sankhya para Pontotel | Admissão, atualização, transferência e demissão | | Carga horária | Escala | Pontotel para Sankhya | Escalas criadas na Pontotel viram cargas horárias no Sankhya | | Sindicato | Regra de cálculo e banco de horas | Sankhya para Pontotel | Associa a regra ao empregado | | Ocorrências | Dispensas e afastamentos | Sankhya para Pontotel | Cria, atualiza e exclui | | Férias | Férias | Sankhya para Pontotel (ou Pontotel para Sankhya, com o módulo Gestão de Férias) | Cria, atualiza e exclui. Com o módulo, as solicitações feitas na Pontotel também seguem para o Sankhya | | Usuário | Usuário | Sankhya para Pontotel | Cria usuários com permissão e líder direto | | Feriados | Feriados | Sankhya para Pontotel | Cria e remove feriados | | Verbas e faltas | Apontamentos e faltas | Pontotel para Sankhya | Envia o apurado para fechar a folha | 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. || 💡 Dica: para organizar os locais por gestor, crie no Sankhya departamentos separados para cada gestor, como Vendas Gestor 1 e Vendas Gestor 2. ###### 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. ||| ⚠️ Atenção: se você cancelar no Sankhya uma transferência que já foi integrada, o cadastro fica duplicado na Pontotel. Antes de fazer esse procedimento, fale com o nosso time de Suporte. **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. || 💡 Dica: é possível criar escalas em massa na Pontotel! Consulte o procedimento no artigo: [I05 - Como cadastrar ou atualizar escalas em massa](https://suporte.pontotel.com.br/pt-br/article/i05-como-cadastrar-ou-atualizar-escalas-em-massa-jph81r/) **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. || 💡 Dica: se você trocar a escala do empregado direto na Pontotel, ela volta à escala do Sankhya na próxima atualização do cadastro. Faça a troca sempre pela 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. | Esse fluxo é ativado pelo nosso time de Suporte. Quer solicitar e aprovar férias direto na Pontotel? [Fale com um especialista](https://zcal.co/i/BEMijplm) e conheça o módulo Gestão de Férias. ###### 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. ||| ⚠️ Atenção: evite alterar a classificação de um tipo de ocorrência com a integração em operação. Os registros já integrados continuam como estavam, e edições feitas depois no Sankhya podem gerar duplicidade ou bloquear o lançamento. Se precisar alterar, fale com o nosso time de Suporte. ###### 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 | O que aconteceu | Provável causa | O que fazer | | ---- | ---- | ---- | | Funcionário não apareceu | Dispensado de ponto, ou falta empresa, carga horária, departamento, cidade, CPF ou sindicato | Complete o cadastro no Sankhya | | Funcionário e local não apareceram | Cidade de trabalho com grafia inválida ou vazia | Corrija a cidade no Sankhya | | Funcionário entrou na Escala Padrão | A carga horária do Sankhya não tem escala com o mesmo código na Pontotel | Cadastre a escala na Pontotel com o mesmo código | | Escala não virou carga horária no Sankhya | Falta nome, código ou tipo de escala no cadastro | Complete o cadastro da escala na Pontotel | | Férias ou dispensa não integrou | Sem data final, folha travada ou período sobreposto | Preencha a data, destrave a folha ou ajuste o lançamento | | Demissão não integrou | Há pontos depois da data de demissão | Trate a folha na Pontotel | | Dado voltou ao valor antigo | Foi editado só na Pontotel | Edite no Sankhya | | Cadastro duplicado | Código alterado em um dos sistemas | Mantenha os códigos originais | | Alteração não chegou | Log de Alterações desligado ou base fora do ar | Confira o Log de Alterações e a conexão, ou aguarde a verificação diária | --- ### 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](https://gestao.pontotel.com.br/#/cognito/login) ou pelo [WhatsApp](https://api.whatsapp.com/send/?phone=551131852700).