Sincronização Foundation
Atenção:
A funcionalidade de Sincronização Foundation encontra-se em fase de PILOTO. Nesta etapa, o acesso será disponibilizado somente para alguns clientes e o funcionamento poderá apresentar limitações, comportamentos inesperados ou indisponibilidades ocasionais.
Sumário
1. Conceito
A funcionalidade permite que as pessoas cadastradas no Foundation sejam automaticamente criadas e/ou atualizadas como contatos na Agenda de Contatos do SIGN. A sincronização ocorre nos dois sentidos, ou seja, da Pessoa foundation para Agenda de Contatos e da Agenda de Contatos para o cadastro Pessoa foundation.
- Foundation → Agenda de Contatos: ao cadastrar, editar, ativar ou inativar uma pessoa no Foundation, o contato correspondente é criado ou atualizado.
- Agenda de Contatos → Foundation: ao criar um novo contato na Agenda de Contatos, o sistema tentará cadastrá-lo no Foundation. Se já existir uma Pessoa com o mesmo CPF, nenhuma ação adicional é realizada. Só irá iniciar esse processo após o parâmetro Sincroniza Pessoas com Agenda contatos estiver verdadeiro. Ou seja, se já tiver cadastro de contatos na Agenda ao ativar o parâmetro Sincronização não irá replicar no Foundation (Carga Inicial).
Importante:
Caso exista uma pessoa chamada Antonio Silva cadastrada na Agenda de Contatos com o CPF 123.456.789-10 e, no Foundation, uma pessoa também chamada Antonio Silva, porém cadastrada com o documento de identidade 1015022747, o sistema passa a interpretá-las como pessoas distintas. Como consequência, são criados dois contatos na Agenda ou dois cadastros de pessoa no Foundation.
Por isso, antes de realizar novos cadastros em ambas as telas, é importante que o usuário siga um processo de validação prévia, consultando e comparando os documentos informados, para evitar duplicidade de registros.
Observação:
A sincronização de contatos de Pessoa realiza exclusivamente a sincronização de contatos da Jurisdição Brasil.
Isso significa que não serão buscados contatos da Jurisdição Colômbia, mesmo que ela esteja habilitada de forma isolada ou em conjunto com a Jurisdição Brasil.
Glossário
| Termo | Definição |
|---|---|
| Pessoa do Foundation | Módulo da plataforma Senior responsável pelo cadastro e Gestão de Pessoas (colaboradores, clientes, fornecedores, etc.). Mais informações aqui. |
| Agenda de Contatos | Módulo da plataforma Senior onde são gerenciados os Contatos utilizados pelo SIGN. |
| Parâmetro Sincroniza pessoas com Agend contatos | Propriedade de configuração que habilita a integração entre Foundation e Agenda de Contatos (Ativar sincronização). Disponível por tenant para o Admin. |
| Sincronização | Processo de replicar dados de Pessoa (Foundation) para Contato (Agenda de Contatos), mantendo as bases consistentes. |
| Carga Inicial | Processo executado para replicação inicial dos dados, ao ativar o parâmetro que habilita a sincronização entre as Pessoas do Foundation com a Agenda de Contatos. |
| Sincronizado | Status que indica que a Pessoa foi processada com sucesso e o Contato correspondente foi criado ou atualizado. |
| Não sincronizado | Status que indica que a tentativa de sincronização falhou, portanto, nenhum contato foi atualizado ou criado na agenda. O motivo pode ser consultado via botão Ver Detalhes. |
2. Pré-Requisitos
A propriedade Ativar sincronização deve estar habilitada no tenant:
- Tecnologia → Configuração → Por Tenant → Domínios e Serviços → Flow → Contact → Aba Sistema.
- Localizar a propriedade Sincroniza pessoas com Agenda contatos.
- Alterar o valor para Verdadeiro.
Após habilitar, o sistema executa automaticamente a Carga inicial: percorre todas as pessoas do Foundation e tenta criá-las e/ou atualizá-las na Agenda de Contatos.
3. Como Funciona
3.1 Carga Inicial
Ao ativar o parâmetro Sincroniza pessoas com Agenda contatos, o sistema busca todas as Pessoas do Foundation e, para cada uma:
| # | Regra |
|---|---|
| 1 | Verificar se já existe um Contato na Agenda de Contatos com o mesmo CPF informado pelo Foundation. |
| 2 | Se não existir Contato: criar um novo cadastro na Agenda de Contatos somente quando o Foundation fornece todos os campos obrigatórios definidos pelo cadastro de Contato. |
| 3 | Se já existir Contato: atualizar os dados do cadastro existente com as informações recebidas do Foundation somente quando os campos obrigatórios exigidos pelo Contato estiverem preenchidos. |
| 4 | O resultado da operação deve ser registrado na aba Sincronização Pessoas com status Sincronizado ou Não sincronizado. |
Importante:
A Agenda de Contatos é responsável pelas regras de cadastro e atualização. O Foundation atua apenas como origem das informações. Assim, a criação ou atualização do Contato ocorrerá apenas quando os dados enviados atenderem aos campos obrigatórios definidos pela Agenda de Contatos.
Contatos já existentes na Agenda de Contatos no momento da ativação não são enviados para o Foundation. A carga inicial ocorre exclusivamente no sentido Foundation → Agenda de Contatos.
3.2 Sincronização Contínua (Foundation → Agenda de Contatos)
Com Sincroniza pessoas com Agenda contatos igual a verdadeiro, qualquer evento no Foundation Pessoa envia automaticamente uma atualização dos dados, para sincronização das bases:
| Evento no Foundation | O que acontece na Agenda de Contatos |
|---|---|
| Cadastrar nova Pessoa | Verifica se já existe Contato com o mesmo CPF. Se não existir, cria um novo Contato. Se já existir, atualiza o Contato existente. |
| Editar Pessoa | Atualiza o Contato correspondente ao CPF informado. |
| Inativar Pessoa | Inativa o contato correspondente |
| Ativar Pessoa | Ativa o contato correspondente |
Com esse parâmetro habilitado, os eventos realizados no Foundation Pessoa passam a enviar automaticamente solicitações de sincronização para a Agenda de Contatos.
A Agenda de Contatos será responsável por validar as regras de negócio e decidir se o contato será criado, atualizado, ativado ou inativado.
Importante:
Operações de criação e atualização somente serão executadas quando os dados enviados atenderem aos campos obrigatórios definidos pelo cadastro de Contato.
3.3 Fluxo Inverso (Agenda de Contatos → Foundation)
Quando um novo Contato é criado na Agenda de Contatos, o sistema envia automaticamente os dados para criação da respectiva Pessoa no Foundation. O Foundation será responsável por validar a existência prévia do cadastro e decidir se a criação será efetivamente realizada. O sistema não apresentará em tela o status de sincronização desse registro.
Observação:
O fluxo inverso é executado apenas para criação de novos contatos, após sincronização ser ativada. Alterações posteriores (edição de contatos) realizadas na Agenda de Contatos não são propagadas para o Foundation.
| Evento na Agenda de Contatos | O que acontece no Foundation |
|---|---|
| Cadastrar novo Contato | Verifica se já existe uma Pessoa com o mesmo CPF. Se não existir, cria uma nova Pessoa no Foundation. |
| Editar Contato | Nenhuma ação. Alterações realizadas na Agenda de Contatos não são sincronizadas com o Foundation. |
| Inativar Contato | Nenhuma ação. Alterações de status não são propagadas para o Foundation. |
| Ativar Contato | Nenhuma ação. Alterações de status não são propagadas para o Foundation. |
4. Campos Sincronizados
Campos compartilhados entre Foundation e Agenda de Contatos utilizados na sincronização:
| Campo | Observação |
|---|---|
| CPF | Identificador único — usado para deduplicação entre as bases. |
| Nome | Nome completo da Pessoa. |
| Situação / Status | Ativo ou Inativo. Refletido na Agenda ao ativar ou inativar a Pessoa no Foundation. |
| Data de Nascimento | Data de nascimento da Pessoa. |
| Telefone | Se não iniciar com +55, o prefixo é adicionado automaticamente. |
| Se o campo principal estiver vazio, o e-mail para envio de documentos é utilizado. |
5. Campos Obrigatórios para Sincronização
Para que uma Pessoa seja sincronizada com sucesso, os seguintes campos precisam estar preenchidos:
| Campo | Detalhe |
|---|---|
| CPF | Obrigatório. Também é a chave de deduplicação. |
| Nome | Obrigatório. |
| Data de Nascimento | Obrigatório. |
| Telefone ou E-mail | Ao menos um dos dois deve estar preenchido. |
Observação:
Se algum campo obrigatório estiver ausente, a sincronização não é realizada e o registro é salvo com status Não sincronizado, com a respectiva mensagem de erro.
6. Aba Sincronização Pessoas
Acessível dentro da Agenda de Contatos, exibe o histórico de todas as tentativas de sincronização.
| Coluna | Descrição |
|---|---|
| Data / Hora | Data e hora em que a tentativa foi realizada. |
| Contato | Nome da Pessoa relacionada à tentativa de sincronização. |
| Status | Sincronizado ou Não sincronizado. |
| Informações | Visível apenas quando Não sincronizado. Contém o botão Ver Detalhes com o motivo da falha. |
Ao clicar em Ver Detalhes, um modal exibe o motivo pelo qual a sincronização não foi concluída. Alguns exemplos:
- CPF ausente;
- Data de nascimento ausente;
- Ausência simultânea de Telefone e E-mail;
- Formato inválido;
- Entre outras inconsistências.
Os registros são exibidos do mais recente para o mais antigo, com suporte a paginação e filtros por coluna.
Observações Importantes
- A Carga Inicial flui apenas de Foundation para a Agenda. Contatos que existiam na Agenda antes da ativação do parâmetro Sincroniza pessoas com Agenda contatos não são enviados para o Foundation.
- Edições feitas diretamente na Agenda não são replicadas para o Foundation. Apenas a criação de um novo contato dispara o fluxo inverso.
- Se o Foundation já possuir uma Pessoa com o mesmo CPF do contato recém-criado na Agenda, nenhuma duplicação será criado e nenhuma mensagem de erro é exibida.
- Certifique-se de que as Pessoas no Foundation possuem CPF, Nome, Data de nascimento e ao menos Telefone ou E-mail preenchidos antes de ativar a PDL.
English
Español
