{"id":61503,"date":"2025-03-06T12:14:16","date_gmt":"2025-03-06T12:14:16","guid":{"rendered":"https:\/\/skyplanner.ai\/docs\/registos-de-tempo\/"},"modified":"2025-10-07T11:13:51","modified_gmt":"2025-10-07T11:13:51","password":"","slug":"registos-de-tempo","status":"publish","type":"docs","link":"https:\/\/skyplanner.ai\/pt-br\/docs\/registos-de-tempo\/","title":{"rendered":"Registos de tempo"},"content":{"rendered":"\n
Estrutura de dados do Skyplanner<\/h4>\n\n
Antes de mergulharmos nos timelogs, precisamos discutir um pouco sobre a estrutura de dados no Skyplanner e como as coisas funcionam por baixo do cap\u00f4. Tudo isso ser\u00e1 discutido mais tarde. <\/p>\n\n
Se integraste os dados das tuas encomendas\/ordens de trabalho\/trabalhos na Skyplanner, \u00e9 muito prov\u00e1vel que tenhas utilizado pelo menos estes pontos de extremidade da API:<\/p>\n\n
\n
encomendas phaser<\/li>\n\n\n\n
ordenar linhas<\/li>\n\n\n\n
phaser-jobs<\/li>\n<\/ul>\n\n
Efetivamente, os dados inseridos nestes pontos finais s\u00e3o representados na IU do Skyplanner da seguinte forma:<\/p>\n
\nFig. 1.<\/strong> Encomenda (phaser-orders)<\/figcaption><\/figure>\n<\/div>\nFig. 2.<\/strong> Itens de pedido (linhas de pedido do phaser (vermelho)), etapas do processo (trabalhos do phaser (verde))<\/figcaption><\/figure>\n\n
Depois de inserires as tuas encomendas no Skyplanner, vais querer export\u00e1-las<\/strong> (isto pode ser feito atrav\u00e9s da interface do utilizador ou do ponto final \/phaser-orders\/export-endpoint) para o m\u00f3dulo de planeamento da produ\u00e7\u00e3o:<\/p>\n\nFig. 3.<\/strong> Exportar atrav\u00e9s da interface do utilizador<\/figcaption><\/figure>\n\nFig. 4.<\/strong> Ordem exportada no plano de produ\u00e7\u00e3o<\/figcaption><\/figure>\n\n
Ao exportar pedidos, o Skyplanner copia efetivamente os dados do pedido de uma tabela de banco de dados para outra. Assim, se alterares algo, por exemplo, atrav\u00e9s do endpoint \/phaser-orders, tens de exportar os dados novamente para os atualizar no Planeamento da Produ\u00e7\u00e3o. Isto tamb\u00e9m significa que, para aceder \u00e0s ordens que v\u00eas na janela do Planeamento da Produ\u00e7\u00e3o, tens de usar diferentes API-endpoints! <\/p>\n\n
Os pontos finais “alterados” s\u00e3o os seguintes:<\/p>\n\n
\u00c9 importante saber isto, porque ao utilizar o ponto de extremidade \/timelogs para registar os teus eventos de produ\u00e7\u00e3o, etc. , tens de utilizar as entidades relacionadas encontradas nos pontos de extremidade do Planeamento da Produ\u00e7\u00e3o!<\/strong><\/p>\n\n
Por exemplo, precisas do production_planning_job_id <\/strong>(para reiterar: production_planning_jobs s\u00e3o as entidades acedidas a partir do ponto de extremidade \/jobs) para POSTar um novo timelog:<\/p>\n\nFig. 5.<\/strong> Pedido POST do registo de tempo<\/figcaption><\/figure>\n\n
Podes encontrar o production_planning_job_id de que precisas a partir do ponto final \/phaser-jobs:<\/p>\n\nFig. 6.<\/strong> Pedido GET do trabalho do Phaser (a vermelho est\u00e1 phaser_job_id, N\u00c3O O UTILIZES EM TIMELOGS<\/strong>)<\/figcaption><\/figure>\n\n
Ou a partir do ponto final \/job:<\/p>\n\nFig. 7.<\/strong> Pedido \/job GET<\/figcaption><\/figure>\n\n
Criar registos de tempo utilizando a API REST<\/h4>\n\n
Faz registos de tempo para o Skyplanner atrav\u00e9s da API e utiliza as mesmas regras e sistemas que est\u00e3o na IU. Por isso, pode ser ben\u00e9fico familiarizares-te com o funcionamento do sistema na IU antes de o tentares utilizar atrav\u00e9s da API. <\/p>\n\n
No\u00e7\u00f5es b\u00e1sicas sobre o registo de tempo<\/h5>\n\n
O Skyplanner tem quatro tipos de eventos de registo de tempo:<\/p>\n\n
\n
shift_begin<\/li>\n\n\n\n
pausado<\/li>\n\n\n\n
continua<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
O evento Shift_begin \u00e9 enviado quando a tarefa \u00e9 iniciada pela primeira vez. Nunca envies mais do que um evento shift_begin para cada trabalho!<\/strong><\/p>\n\n
Pausa – evento que pausa a tarefa.<\/p>\n\n
O evento continuado retoma uma tarefa em pausa.<\/p>\n\n
Shift_end termina o trabalho. Nunca envies mais do que um evento shift_end para cada trabalho!<\/strong><\/p>\n\n
Dados necess\u00e1rios para os registos de tempo:<\/p>\n\n
\n
id_pessoa\n
\n
Pode ser encontrado no ponto de extremidade \/people<\/li>\n\n\n\n
N\u00e3o \u00e9 o mesmo que user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
planned_workstation_id\n
\n
O posto de trabalho onde o trabalho est\u00e1 a ser feito<\/li>\n\n\n\n
Pode ser encontrado no \/workstations-endpoint<\/li>\n<\/ul>\n<\/li>\n\n\n\n
data_hor\u00e1rio\n
\n
O momento em que o evento \u00e9 realizado<\/li>\n\n\n\n
Para especificar que timelog da Skyplanner est\u00e1 ligado ao timelog de qualquer sistema externo que estejas a utilizar, podes utilizar o campo external_id <\/strong>. Podes ent\u00e3o, por exemplo, fazer pedidos GET utilizando este id para encontrar um timelog espec\u00edfico do Skyplanner. <\/p>\n\nFig. 8.<\/strong> External_id em registos de tempo<\/figcaption><\/figure>\n\n
Come\u00e7ar um trabalho<\/h4>\n\n
Podes iniciar tarefas enviando um pedido POST como este para a API:<\/p>\n\nFig. 9.<\/strong> Desloca\u00e7\u00e3o_in\u00edcio do registo de tempo<\/figcaption><\/figure>\n\n
Ao definir os dados POST para os registos de tempo, define workshift_id <\/strong>como 0 e timelog_finalized <\/strong>como true<\/strong><\/p>\n\n
Pausa um trabalho<\/h4>\n\n
Pausa os trabalhos enviando um pedido POST como este:<\/p>\n\nFig. 10.<\/strong> Pausa no registo de tempo<\/figcaption><\/figure>\n\n
Nos registos cronol\u00f3gicos do tipo pausado, podes definir o montante <\/strong>e o faulty_amount<\/strong>. Tem tamb\u00e9m em aten\u00e7\u00e3o o tipo <\/strong>de registo de tempo e date_time<\/strong>. <\/p>\n\n
Continua a trabalhar<\/h4>\n\n
Eis como podes continuar um registo de tempo em pausa:<\/p>\n\nFig. 11.<\/strong> Continua o registo de tempo<\/figcaption><\/figure>\n\n
Nota que se tentares continuar um trabalho que tenha sido terminado por um evento shift_end, receber\u00e1s um erro.<\/p>\n\n
Terminar um emprego<\/h4>\n\n
Eis como terminas um trabalho atrav\u00e9s de um registo de tempo shift_end:<\/p>\n\nFig. 12.<\/strong> Registo do tempo do fim do turno<\/figcaption><\/figure>\n\n
Em shift_end-events podes dar os valores amount <\/strong>e faulty_amount <\/strong>tal como em paused-events. Nota que se tentares fazer um shift_end-events a um trabalho que n\u00e3o est\u00e1 em execu\u00e7\u00e3o, receber\u00e1s um erro. <\/p>\n\n
Atualizar registos de tempo<\/h4>\n\n
Podes atualizar os dados do registo de tempo enviando pedidos PUT para o ponto final \/timelogs-endpoint, da seguinte forma:<\/p>\n\nFig. 13.<\/strong> Editar registos de tempo<\/figcaption><\/figure>\n\n
Nota que tens de ter os dados beginTimelog <\/strong>e endTimelog <\/strong>definidos para fazeres uma atualiza\u00e7\u00e3o. Os registos de tempo no Skyplanner s\u00e3o armazenados da seguinte forma: cada registo de tempo “completo” (registo de tempo que tem um in\u00edcio e um fim (por exemplo, shift_begin\/continued & paused\/shift_end) tem uma entidade separada para o in\u00edcio e o fim. <\/p>\n\n
Estes s\u00e3o emparelhados pelo valor begin_id <\/strong>encontrado no endlog. No exemplo acima, o beginTimelog tem o valor de id 1 e, por conseguinte, o seu endTimelog tem o valor begin_id <\/strong>1. <\/p>\n\n
Tamb\u00e9m tens de fornecer os valores person_id <\/strong>e endTimelog de <\/strong>cada vez que fazes um pedido de atualiza\u00e7\u00e3o, mesmo que n\u00e3o os alteres.<\/p>\n\n
Formas alternativas de fazer registos de tempo<\/h4>\n\n
Aqui est\u00e3o algumas formas alternativas de acederes aos teus trabalhos utilizando a API.<\/p>\n\n
Logfull<\/h5>\n\n
Se quiseres enviar os registos de tempo de in\u00edcio e de fim num \u00fanico pedido, podes utilizar o ponto de extremidade \/timelogs\/log-full<\/strong>, desta forma:<\/p>\n\nFig. 14.<\/strong> Pedido de registo<\/figcaption><\/figure>\n\n
Repara como os montantes s\u00e3o enviados aqui: o primeiro valor “amount” denota o montante defeituoso<\/strong> e o segundo o montante<\/strong>. Este pedido cria as entidades beginlog e endlog num \u00fanico pedido. <\/p>\n\n
Registo r\u00e1pido<\/h5>\n\n
O “Quicklogging” de um trabalho completa-o num \u00fanico pedido, define a quantidade de produtos completada para corresponder ao valor definido no item da encomenda. O registo r\u00e1pido \u00e9 feito utilizando o ponto final \/timelogs\/quick-log<\/strong>: <\/p>\n\nFig. 15.<\/strong> Registo r\u00e1pido<\/figcaption><\/figure>\n\n
Observar que aqui s\u00f3 \u00e9 necess\u00e1rio fornecer production_planning_job_id<\/strong>, planned_workstation_id <\/strong>e person_id<\/strong>. Os valores de tempo e montante s\u00e3o preenchidos automaticamente. Nota tamb\u00e9m que os trabalhos com registo r\u00e1pido s\u00e3o sempre conclu\u00eddos com o evento shift_end, pelo que n\u00e3o \u00e9 poss\u00edvel qualquer outro registo ap\u00f3s o registo r\u00e1pido! <\/p>\n\n
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-25-1024x714.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-26-1024x715.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-27-1024x596.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-28-1024x597.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-29.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-30.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-31.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-32-1024x438.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-33.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-34.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-35.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-36.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-37.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-38.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-39.png\")