Correções de Reconciliação de Folha de Ponto para Upload

A funcionalidade de Upload de Correções de Reconciliação de Timesheet permite que usuários autorizados importem tempo registrado em outros sistemas de registro de tempo. Nenhum processo de aprovação é necessário, pois os recursos não estão enviando timesheets no Fluid.

Ela permitirá postar e corrigir valores reais de correção em meses fechados ou semanas de timesheet bloqueadas sem criar estornos.

Você precisa de ambas as seguintes funções para acessar a Reconciliação de Timesheet:

• Administrador Financeiro

• Administrador de Timesheet

Além disso, seu ambiente Fluid deve ter os seguintes sinalizadores de recurso habilitados

• Correções de Timesheet e

• Correção de Reconciliação de Timesheet.

Usando o 'Download de Reconciliação de Timesheet', baixe um arquivo Excel pré-formatado com os cabeçalhos de coluna corretos e quaisquer entradas de correção existentes já preenchidas. Usar o download como ponto de partida evita incompatibilidades de cabeçalho que fariam o upload falhar.

Você pode fazer upload de suas correções em qualquer um dos seguintes formatos:

• Excel (.xlsx)

• CSV (.csv)

Ambos os formatos são validados da mesma forma e produzem os mesmos resultados, então você pode escolher o que for mais conveniente para como seus dados são preparados.

Use esta opção se preferir uma experiência guiada dentro do aplicativo e seu arquivo estiver no formato Excel:

1. Vá para Administração Financeira.

2. Vá para a seção 'Upload e Relatórios de Recursos'.

3. Selecione Correções de Reconciliação de Timesheet.

4. Faça upload do seu arquivo .xlsx.

Use esta opção se quiser fazer upload programaticamente ou como parte de um processo automatizado; seu arquivo pode estar no formato .xlsx ou .csv:

POST /api/v3/bulkdata/import/{TimesheetReconcileCorrection}

• Envie um arquivo .xlsx, ou

• Envie um arquivo .csv

Ambos são aceitos pelo mesmo endpoint e processados da mesma forma.

O arquivo de upload deve conter as seguintes colunas:

* Consulte as regras de Projeto e Recurso abaixo para as combinações exatas que são aceitas.

Deixe a coluna ID do Registro em branco. O sistema cria uma nova entrada de folha de ponto de correção para a combinação de recurso e data.

• As horas devem ser maiores que zero.

• Múltiplas novas linhas para o mesmo recurso, projeto, data e referência financeira são tratadas como uma entrada agrupada na mesma folha de ponto.

Insira o ID do Registro do arquivo baixado. O sistema localiza esse registro de correção específico e verifica se os outros campos da linha (Data, Recurso, Projeto, Sub Atividade, Tarefa, Ref. Financeira) correspondem ao que está armazenado no banco de dados. Se algum desses campos não corresponder, a linha é ignorada e um erro é registrado.

• Zero horas são aceitas em uma atualização (para definir a entrada como zero).

O sistema aplica as seguintes regras de "pelo menos um" antes de qualquer verificação mais aprofundada. Uma linha é rejeitada imediatamente se essas condições não forem atendidas.

Após a leitura do arquivo, cada linha é validada conforme as seguintes regras. Uma linha para de ser verificada assim que falha — a primeira falha é a que é reportada.

1. ID do Registro

• Deve estar em branco, ser 0 ou um número inteiro positivo.

• Um número negativo faz com que a linha seja ignorada.

2. Data

• Deve ser uma data válida.

• Deve ser posterior à Data de Bloqueio de Capitalização configurada no seu ambiente Fluid. Entradas na data de bloqueio ou anteriores a ela não são permitidas e serão ignoradas.

3. Recurso

• O sistema busca um recurso cuja Ref. do Recurso ou Ref. Externa corresponda à sua entrada (sem distinção entre maiúsculas e minúsculas, espaços iniciais/finais ignorados).

• Nenhuma correspondência encontrada → a linha é ignorada.

• Mais de uma correspondência encontrada (referência ambígua) → a linha é ignorada.

• Correspondência encontrada, mas sem plano de recurso ativo → o recurso deve ter um plano de recurso com capacidade maior que zero que cubra a data da entrada. Se esse plano não existir, a linha é ignorada.

4. Projeto

Existem dois caminhos dependendo do que você inserir:

Caminho A – Usando uma Ref. do Projeto ou Ref. Alternativa do Projeto (entrada de projeto padrão)

• O sistema busca um projeto cuja Ref. do Projeto ou Ref. Alternativa do Projeto corresponda à sua entrada (sem distinção entre maiúsculas e minúsculas).

• Se você fornecer ambas, as duas devem corresponder ao mesmo projeto.

• Nenhuma correspondência encontrada → a linha é ignorada.

• Mais de uma correspondência encontrada → a linha é ignorada.

• Correspondência encontrada → o status e o tipo do projeto também são verificados:

  • Se o status do projeto estiver na lista de excluídos de correções (configurada na Configuração de Folha de Ponto), a linha é ignorada.

  • Se o tipo do projeto não for um tipo de projeto válido, ou estiver na lista de tipos excluídos de correções, a linha é ignorada.

Caminho B – Usando a coluna Projeto (Tarefa Diversa)

• Deixe a Ref. do Projeto e a Ref. Alternativa do Projeto em branco, e insira o nome de uma Tarefa Diversa na coluna Projeto.

• O nome deve corresponder exatamente (sem distinção entre maiúsculas e minúsculas) a uma Tarefa Diversa configurada na Configuração de Folha de Ponto.

• Sub Atividade não pode ser usada com uma Tarefa Diversa.

• Se Sub Atividade estiver preenchida, mas a Ref. do Projeto estiver em branco, a linha é ignorada (Sub Atividade requer uma referência de projeto).

5. Sub Atividade

• Sub Atividade é validada apenas para entradas de projeto padrão (não para Tarefas Diversas).

• O valor deve ser uma sub-atividade válida para o tipo do projeto, conforme configurado no seu ambiente Fluid.

• Se nenhuma sub-atividade estiver definida para o tipo de projeto, o valor é verificado em relação aos tipos de atividade globais definidos nos metadados do sistema.

• Um valor não reconhecido faz com que a linha seja ignorada.

6. Atribuição de Tarefa Flex

Para entradas de projeto padrão, o sistema não verifica nenhuma regra de alocação. No entanto, se uma linha contiver um título de tarefa flex na coluna Tarefa, ele deve corresponder exatamente (sem distinção entre maiúsculas e minúsculas) à tarefa do Flex Board atribuída ao recurso para aquele projeto.

• O recurso Flex 'Flex Boards' ou 'Flex Schedule' deve estar habilitado.

• A coluna Ref. Financeira deve ser deixada em branco ao usar uma Tarefa Flex. Fornecer tanto uma Tarefa quanto uma Ref. Financeira na mesma linha não é válido e fará com que a linha seja ignorada.

• Se existirem múltiplas tarefas flex com o mesmo título para o mesmo projeto, a linha é ignorada.

Se nem uma alocação válida nem uma tarefa flex válida for encontrada, a linha é ignorada.

7. Horas

• Deve ser um número

• Para novas entradas (ID do Registro = 0): deve ser maior que zero. Zero horas em um novo registro não são permitidas.

• Para atualizações (ID do Registro > 0): zero é aceito.

8. Valor Local e Código de Moeda

• Valor Local é opcional. Se deixado em branco, o sistema usa o cálculo padrão da tabela de tarifas.

• Se o Valor Local for fornecido e um Código de Moeda Local também for fornecido, o código de moeda é validado em relação à lista de moedas configuradas no Fluid. Um código não reconhecido faz com que a linha seja ignorada.

• Se o Valor Local estiver em branco, o código de moeda é ignorado e não causa uma falha por si só.

Se a mesma entrada de tempo aparecer mais de uma vez no mesmo arquivo de upload — identificada pela combinação de ID do Registro, Data, Recurso, Projeto, Ref. Financeira, Tarefa e Sub Atividade — o sistema mantém apenas a última ocorrência. As linhas duplicadas anteriores são ignoradas e registradas como duplicatas. Isso significa que, se você intencionalmente quiser corrigir um valor, coloque a linha correta mais abaixo no arquivo.

O sistema lê o arquivo a partir da linha 2 para baixo (a linha 1 é o cabeçalho). A leitura para automaticamente quando encontra uma linha onde tanto a coluna Data quanto a coluna Ref. do Recurso estão em branco. Certifique-se de que não há linhas em branco acidentais no meio dos seus dados, pois tudo abaixo do primeiro par em branco será ignorado.