TOTVS Clock In

Atalhos

Árvore de páginas

01. Visão Geral 

Esta documentação tem como objetivo orientar referente ao cenário onde há a tentativa de alterar a foto de um colaborador que possui integração com o ERP (Protheus, RM ou Datasul), a nova foto não aparece no aplicativo, ou o sistema reverte automaticamente para a foto anterior após algum tempo.

02. Causa Raiz

Existem dois fatores principais que causam este comportamento:

  • Origem do Dado (Prioridade de Integração): Imagens que nascem no ERP chegam no Data Model Imagem do Clock In com o identificador "Image Sequence = 0". Isso indica ao Clock In que a "fonte da verdade" é o ERP. Qualquer alteração manual feita diretamente no Backoffice do Clock In será descartada no próximo processamento das imagens quando o registro for atualizado por nova sincronização/alteração, pois o novo dado originado do ERP irá sobrepor o dado anterior.




  • Duplicidade de Binário (Base64): Se a mesma imagem (arquivo idêntico) foi usada incorretamente para outro usuário anteriormente, o sistema pode manter um cache atrelado ao código binário (Base64) daquela imagem. Ao reenviar o mesmo arquivo, o sistema reutiliza o vínculo antigo incorreto. (Acompanhar a issue IDEIA-870 referente ao tratamento de update de imagens com mesmo hash Base64, entrega prevista para final de março de 2026).



IMAGEM (BASE64)

Sobre o Base64 da Imagem: Imagine que o sistema lê a foto não como uma imagem, mas como um texto gigante de códigos (chamado Base64). Se você subir a mesma foto, o texto é idêntico e o sistema "acha" que já tem aquilo salvo e usa a memória antiga (que está com problema). Ao alterar um simples detalhe (brilho ou um pixel), você altera completamente esse código de texto. Isso obriga o sistema a ler como um arquivo inédito, gerando um novo código e ignorando o erro anterior.


03. Como Resolver

 Para corrigir, é necessário seguir a regra de ouro: Se a imagem foi originada do ERP, a correção deve ser feita na origem (ERP: RM, Protheus, DataSul, etc) e o arquivo de imagem deve ser inédito.

Passo a Passo:

  1. Acesse o ERP: Não faça a alteração pelo Backoffice da Carol/Clock In. Vá diretamente ao cadastro do funcionário no seu ERP.
  2. Exclua a Imagem: Remova a foto atual dos colaboradores afetados.
  3. Vincule uma Nova Foto ou Gere uma Nova Versão da Foto:
    1. Abra a foto correta em um editor de imagem;
    2. Realize uma pequena alteração (salvar com outro nome, alterar levemente o tamanho ou qualidade);
    3. Isso gera um novo código Base64, impedindo que o sistema reutilize o cache da imagem anterior.
  4. Faça o Upload: Suba esta nova versão editada no ERP;
  5. Aguarde a sincronização e processamento do Clock In.