¶ Credencial Facial - Sincronização via API
A sincronização de credenciais faciais permite que o Softpark busque automaticamente as fotos faciais disponíveis no portal Softcase e envie essas informações para os leitores faciais configurados no estacionamento.
Em resumo: o cliente cadastra a credencial no ERP, o Softpark busca a facial pela API e, quando a imagem existe, ela fica disponível para envio ao leitor Control iD.
¶ 
O que este recurso faz
- Busca automaticamente a imagem facial vinculada à credencial.
- Salva ou atualiza a imagem no Softpark quando a API retorna uma facial.
- Mantém as imagens já cadastradas quando a API não retorna uma nova imagem.
- Envia as credenciais e fotos disponíveis para os leitores faciais Control iD.
- Registra o resultado da sincronização para facilitar a conferência.
¶ 
Como o Softpark encontra a facial
O Softpark procura a facial usando o número da credencial.
Para este fluxo, o CPF do cliente deve ser cadastrado no ERP como a credencial do cliente. Esse número será usado pelo Softpark para consultar a API de faciais.
Exemplo simples:
- O cliente possui CPF cadastrado como credencial no ERP.
- O Softpark lê essa credencial.
- O Softpark consulta a API de faciais.
- Se existir imagem para essa credencial, ela é salva no Softpark.
- No envio ao leitor, a credencial e a foto são enviadas ao equipamento.
¶ 
Configuração necessária
No Softpark, acesse:
Configurações > Gerais > Integrações > API Faciais
Preencha:
- Endereço API Faciais:
https://api.portalsoftcase.com.br/softpark - Usuário: usuário informado pela Softcase
- Senha: senha informada pela Softcase
Depois clique em Salvar.
O Softpark faz a autenticação automaticamente. Não é necessário gerar token manualmente, nem salvar novamente a configuração quando o token expirar.
¶ 
Sincronização automática
Depois que a API Faciais estiver configurada, o Softpark executa a sincronização automaticamente em intervalos periódicos.
Durante essa rotina, o sistema:
- verifica as credenciais ativas;
- consulta a API de faciais;
- baixa a imagem quando ela existir;
- atualiza o cadastro facial quando necessário;
- registra o resultado da operação.
Se a imagem encontrada for igual à que já está salva, o sistema não faz uma nova atualização desnecessária.
¶ 
Sincronizar manualmente quando precisar
Se precisar sincronizar na hora, por exemplo após cadastrar uma nova credencial no ERP ou corrigir uma imagem facial, use o botão de sincronização facial no cadastro do condutor.
Para enviar as informações aos leitores, acesse:
Configurações > Facial > Atualizar leitores facial/TAG
Essa opção envia para os leitores as credenciais e as fotos que já estão disponíveis no Softpark, conforme as configurações habilitadas.
¶ 
O que acontece com faciais já cadastradas
A sincronização via API não apaga imagens faciais já cadastradas no Softpark.
Se a API não retornar imagem para uma credencial, o Softpark registra a situação como Sem imagem, mas mantém qualquer imagem que já esteja salva no cadastro.
Isso significa que:
- faciais cadastradas manualmente continuam disponíveis;
- imagens antigas não são removidas automaticamente;
- a imagem só é incluída ou atualizada quando a API retorna uma facial para aquela credencial.
¶ 
O que conferir antes de sincronizar
Antes de testar ou liberar o uso, confira:
- a credencial está ativa no Softpark;
- o CPF foi cadastrado como número da credencial no ERP;
- a imagem facial existe no portal Softcase;
- a URL, usuário e senha da API Faciais foram salvos no Softpark;
- o leitor Control iD está cadastrado e comunicando corretamente.
¶ 
Resultado da sincronização
Ao final da sincronização, o Softpark pode mostrar alguns status:
| Status | O que significa |
|---|---|
| Atualizada | A imagem foi encontrada na API e salva no Softpark. |
| Inalterada | A imagem encontrada é a mesma que já estava salva. |
| Sem imagem | A API não retornou imagem para a credencial. A imagem antiga, se existir, é mantida. |
| Erro API | Houve falha de comunicação, autenticação ou consulta na API. |
¶ 
Observações importantes
- A busca da facial é feita pelo número da credencial.
- Para este fluxo, o CPF deve ser cadastrado como credencial no ERP.
- A integração com os leitores Control iD continua usando o fluxo padrão do Softpark.
- O cadastro manual de faciais continua disponível para casos em que a imagem não venha pela API.
- A sincronização salva ou atualiza imagens, mas não limpa faciais existentes.