Ir para o conteúdo principal
Administrator Guide
Última atualização: 2025-03-14
Conceito: importar eventos de marcação de ponto

Conceito: importar eventos de marcação de ponto

Você pode importar dados de um sistema de coleta de horas de terceiros para o Workday Time Tracking usando os serviços Web
Put Time Clock Events
ou
Import Time Clock Events
. Estes serviços Web importam dados brutos de marcação de ponto como eventos de marcação de ponto, os quais o Workday faz a correspondência para criar blocos de horas e executar cálculos. Os trabalhadores podem editar os blocos de horas antes de enviá-los.

Importar lotes grandes de eventos de marcação de ponto

Se você usa
Put Time Clock Events
para importar mais de 1.000 transações de marcação de ponto, a integração pode demorar um tempo significativo para ser concluída e pode atrasar outros processos do Workday. Nesse caso, use o serviço Web
Import Time Clock Events
.
Use o serviço Web
Import Time Clock Events
quando você precisar importar lotes grandes de 1.000 ou mais eventos de marcação de ponto de forma esporádica. Exemplo: a importação de eventos de marcação de ponto para teste de implementação ou o carregamento de um único lote grande após uma integração com um sistema de terceiros falha. O serviço Web
Import Time Clock Events
é executado como um processo em segundo plano, portanto, não atrasa outras tarefas do Workday que estão sendo executadas simultaneamente.
O padrão de serviço Web "Import" permite que você use o Enterprise Interface Builder (EIB) do Workday. Para recuperar erros de processamento após usar
Import Time Clock Events
, você pode utilizar:
  • O serviço Web
    Get Import Process Messages
  • O relatório
    Eventos de marcação de ponto não processados

Importar lotes pequenos de eventos de marcação de ponto

Use a operação pública de serviço Web
Put Time Clock Events
quando você precisar importar eventos de marcação de ponto de um sistema de terceiros quase em tempo real. O sistema de terceiros deve criar a fila de eventos de marcação de ponto em lotes e iniciar uma chamada para
Put Time Clock Events
. Se o Workday não puder receber um lote, o sistema de terceiros deverá continuar a enfileirar eventos de marcação de ponto até que o Workday esteja disponível.
Quando você usar o serviço Web
Put Time Clock Events
, recomendamos:
  • Enviar eventos de marcação de ponto em sua forma bruta (não correspondentes a blocos de horas ou processados de qualquer outra forma).
  • Enviar lotes a cada 2 a 5 minutos.
  • Enviar os eventos de marcação de ponto na ordem que ocorreram para garantir que o Workday faça a correspondências deles em blocos de horas com a maior precisão possível.
  • Não enviar um lote com mais de 150 transações de marcação de ponto. Se você tem mais de 150 transações de marcação de ponto para enviar, divida-as em lotes menores.

Campos obrigatórios

Os eventos de marcação de ponto importados para o Workday devem incluir estes detalhes:
Campo
Observações
Data/hora do evento de marcação de ponto
Data e hora do evento de marcação de ponto. Se você não especifica um deslocamento de fuso horário, o Workday assume que o deslocamento do UTC é igual a zero.
Clock Event Type Reference
O Workday aceita quatro tipos de evento de marcação de ponto:
Entrada
,
Saída
,
Intervalo
e
Refeição
.
ID do colaborador
ID da posição
Obrigatório se o trabalhador tem vários cargos e o tipo de evento de marcação de ponto é
Entrada
.
Time Clock Event ID
Obrigatório para editar e excluir transações de modo que o Workday possa identificar o evento de marcação de ponto a ser editado ou excluído.
Excluir evento de marcação de ponto
Quando sinalizado, identifica a transação como uma exclusão.
Se você está importando uma exclusão, os únicos campos obrigatórios são:
  • Time Clock Event ID
  • Excluir evento de marcação de ponto
Todos os outros campos são opcionais.

Erros e validações

Os dados aceitos pela operação de serviço Web podem, no entanto, ser inválidos no Controle de horas. O Workday executa um conjunto separado de validações nos dados depois que passam pela operação de serviço Web e sinaliza as transações de marcação de ponto inválidas. O Workday não faz a correspondência de transações de marcação de ponto inválidas com blocos de horas, mas sinaliza os erros até que você corrija a transação. Use a tarefa
Manter eventos de marcação de ponto inválidos
para visualizar, corrigir ou ignorar transações com erro.
Valores inválidos ou ausentes nestes campos fazem com que o evento de marcação de ponto exiba um erro até que seja corrigido:
  • ID do colaborador
  • ID da posição
  • Data/hora do evento de marcação de ponto
  • Clock Event Type Reference
Os campos abaixo são opcionais, mas, se enviados, devem ter valores válidos no Workday. Valores inválidos fazem a transação de marcação de ponto exibir um erro até que seja corrigida. Estes campos se aplicam apenas aos tipos de evento de marcação de ponto
Entrada
. Se o código de entrada de horas está em branco, o Workday aplica o código de entrada de horas por padrão do modelo de entrada de horas do trabalhador.
  • Código de entrada de horas
  • ID do projeto
  • ID da tarefa
  • Taxa de substituição
  • Unidade de negócios
  • Centro de custo
  • Organização personalizada 01 a Organização personalizada 10
  • Worktag personalizada 01
    a
    Worktag personalizada 15
  • Fundo
  • Subvenção
  • Perfil de cargo
  • Local
  • Programa
  • Região

Editar e excluir dados de evento de marcação de ponto

Você pode editar ou excluir eventos de marcação de ponto usando o serviço Web
Put Time Clock Events
. Quando importar uma transação de edição usando o serviço Web, inclua a ID do evento de marcação de ponto no arquivo. Quando você importa transações de edição, o Workday substitui os detalhes existentes no evento de marcação de ponto pelos detalhes da nova transação. Inclua todos os detalhes que quer preservar, além dos campos editados. Quando importar uma transação de exclusão, defina o campo
Delete Time Clock Event
como
Y
(para Sim).
Além de importar edições e exclusões, você pode gerenciar eventos de marcação de ponto diretamente no Workday.
Relatório ou tarefa
Considerações
Tarefa
Manter eventos de marcação de ponto inválidos para trabalhadores
Os gestores e administradores podem editar ou ignorar eventos de marcação de ponto inválidos para os subordinados diretos do gestor.
Relatório
Histórico de marcações de ponto
Você pode editar e excluir qualquer tipo de evento de marcação de ponto.