Setup inicial de integração Sankhya <> Pontotel

Módulo: Admin (Gestão Pontotel)
Caminho de Acesso: Menu Principal > Admin > Integração > Módulo de Integração

Sumário

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

Descrição e Usabilidade

1. Descrição da Funcionalidade

O Módulo de Integração permite ao cliente realizar o setup inicial dos fluxos de integração entre Sankhya e Pontotel, de forma autônoma e centralizada.

O usuário insere credenciais e configurações básicas, valida as informações e acompanha o status das integrações em ondas evolutivas (setup, parametrizações, pré-visualizações e ativações).

Atualmente, estão disponíveis fluxos de integração de cadastros que enviam e recebem dados entre Sankhya e Pontotel. Eles abrangem:

Empregadores;
Empregados;
Usuários;
Locais de trabalho;
Escalas e jornadas;
Apontamentos e Faltas;
Ocorrências e Afastamentos;
Férias.

As integrações permitem que os dados entre Sankhya e Pontotel sejam refletidos de forma mais rápida e eficiente, trazendo benefícios como:

sincronização imediata - não é preciso esperar o agendamento a cada 12 horas;
maior desempenho - são processados apenas os dados alterados desde a última sincronização bem-sucedida, acelerando o fluxo.

2. Pré-requisitos

Permissões necessárias
- Acesso ao menu Admin > Integração (RH, TI ou Implantação).
- Permissão para editar configurações do account do cliente.
Parâmetros essenciais
- Usuário Sankhya SK, Senha SK, Token SK.
- CPF do responsável pela integração.
- Domínio corporativo de e-mail (opcional).
- URL base Sankhya (informativa).
Configurações relacionadas
- Token válido e URL atualizada no Gateway.
- Processo de criação de tenants na LinkAPI (temporário)

3. Jornada de Uso

1. O usuário acessa Menu Principal > Admin > Integração > Módulo de Integração.

2. Preenche o formulário com:

Usuário Sankhya (SK)
Senha Sankhya (SK)
Token Sankhya (SK)
CPF do responsável pela integração
Domínio corporativo
URL base Sankhya (opcional)

3. Consulta os informativos ("i") ao lado dos campos para instruções.

4. Envia o formulário.

5. O sistema valida as credenciais via Gateway.

Quando válido, cria um card no Trello e inicia a criação do tenant (LinkAPI).
Se inválido, o usuário recebe um feedback de erro e instruções para correção.

6. O usuário acompanha as notificações e status via Trello.

7. Nas ondas seguintes, realiza as parametrizações e valida as pré-visualizações antes de ativar cada fluxo.

4. Pontos de Atenção

O fluxo inicial é liberado primeiro para Implantação (SC), depois para clientes.
O usuário de integração é gerado com padrão (ex.: integcliente@pontotel.com.br).
Validação falha: deve revisar usuário/senha/token e configuração do gateway.
A criação do tenant LinkAPI é feita manualmente pelo QA até a internalização.
A Implantação (SC) precisa de visibilidade das tentativas para apoiar clientes.

5. Dicas de Usabilidade

Ter credenciais Sankhya e CPF do responsável em mãos antes de abrir o formulário.
Usar o ícone ("i") para instruções rápidas de onde buscar os dados.
Garantir liberação dos IPs do serviço no firewall antes de testar.
Salvar prints de erros para facilitar diagnósticos.
Acompanhar o card no Trello para status da validação.

6. Casos de Uso

✅ Exemplo real:

RH preenche credenciais corretas e CPF; sistema valida e cria o tenant; cliente recebe confirmação e parametriza regras.

❌ Erro comum:

TI informa token incorreto; validação falha e mensagem orienta correção do token.

FAQ – Dúvidas Frequentes

Quem deve preencher o formulário de integração?

RH (com apoio do TI) deve preencher as informações iniciais. TI precisa garantir gateway e token.
O que faço se a validação das credenciais falhar?

Verifique usuário, senha e token. Peça ao TI para confirmar gateway e liberar acesso de rede. Em caso de dúvida, abra chamado com implantação/SC.
O que acontece depois que envio o formulário com sucesso?

O sistema valida as credenciais, cria card para validação e inicia criação do tenant (temporário); nas ondas seguintes, você parametriza e valida pré-visualizações.
Posso fazer todo o setup sozinho?

Sim, o módulo foi criado para dar autonomia. Alguns passos (gateway, token, liberações de rede) requerem suporte do TI.
E a LinkAPI?

A criação de tenants na LinkAPI é tratada manualmente pelo QA até internalização do processo.

Pesquisa