Pular para o conteúdo
SkyPlanner
  • Características
    • Características
    • Soluções
    • Integrações
  • Serviços
    • Serviços de assistência ao embarque
    • Integrações
    • Serviços de personalização
  • Preços
  • Vídeos
  • Empresa
    • About us
    • Contato
    • Torne-se um parceiro SkyPlanner
  • Docs
  • Comece gratuitamente!
  • Português
    • English
    • Suomi
    • Čeština
    • Dansk
    • Deutsch
    • Español
    • Eesti
    • Français
    • Italiano
    • Latviešu
    • Lietuvių
    • Magyar
    • Nederlands
    • Polski
    • Português
    • Slovenčina
    • Slovenščina
    • Svenska
    • Türkçe
    • Indonesia
    • 日本語
    • العربية
    • Ελληνικά
    • 한국어
    • Norsk bokmål
    • Română
    • Українська

Guias de vídeo

4
  • Adiciona uma nota rápida a um passo do processo de produção
  • O que é e como utilizar a funcionalidade Bulldozer
  • Vídeo de introdução ao Fast Track
  • Introdução ao GANTT Timelime do SkyPlanner

Começar a trabalhar

4
  • O que é uma estação de trabalho?
  • Como criar um novo Material
  • Introdução ao GANTT Timelime do SkyPlanner
  • Como criar um novo produto

Ferramentas

3
  • Como adicionar Manutenção a uma Ferramenta
  • Como podes informar que uma ferramenta está avariada?
  • Como adicionar ferramentas

Integrações

7
  • Horários das etapas do processo programado e estações de trabalho
  • Registos de tempo
  • Produtos e materiais
  • Criar uma encomenda
  • Noções básicas de integração
  • Tutorial de integração

Linha de tempo de Gantt

26
  • Como cancelar o agendamento de todos os meus trabalhos na minha linha de tempo do GANTT
  • Função de pesquisa na GANTT Timeline
  • Desprograma um item de ordem do Cronograma GANTT
  • Detalhes do trabalho na linha do tempo GANTT
  • Estações de trabalho na linha do tempo GANTT
  • Como ver uma lista de uma fila de estações de trabalho específica
  • Desprograma um item de ordem do Cronograma GANTT
  • Hora atual na linha do tempo do GANTT
  • Empregos na linha do tempo do GANTT
  • Capacidade azul na cronologia da GANTT
  • Capacidade vermelha na cronologia da GANTT
  • Capacidade na linha do tempo da GANTT
  • Adiciona uma nota rápida a um passo do processo de produção
  • Como criar um grupo de estações de trabalho na linha do tempo do GANTT
  • Como ocultar estações de trabalho na linha de tempo do GANTT
  • Como mostrar todas as estações de trabalho na linha de tempo do GANTT
  • Como excluir um grupo de estações de trabalho na linha do tempo do GANTT
  • Considera os materiais
  • Permite a transferência de trabalhos para outros postos de trabalho mais adequados
  • Dependências da fase de trabalho
  • Bloqueio de Tempo em Execução
  • O que é e como utilizar a funcionalidade Bulldozer
  • Aumenta e diminui o zoom
  • Introdução ao GANTT Timelime do SkyPlanner

Utilizadores

3

Turnos por defeito

3
  • Como eliminar um Turno predefinido
  • Como editar um Deslocamento por defeito
  • Como adicionar um Turno predefinido

Regras globais

5
  • Prioridades dinâmicas
  • Considera os materiais
  • Permite a transferência de trabalhos para outros postos de trabalho mais adequados
  • Dependências da fase de trabalho
  • Bloqueio de Tempo em Execução

Etapas do processo

5
  • Como eliminar uma etapa do processo
  • Como editar uma etapa do processo
  • Grau de conclusão da etapa do processo (grau mínimo de fabrico)
  • Como adicionar uma nova etapa de processo
  • Tempos de montagem e desmontagem

Clientes

2
  • Como editar um cliente
  • Como adicionar um novo cliente

Estações de trabalho

13
  • Como adicionar um grupo de funcionários a uma estação de trabalho
  • Como adicionar um novo turno a uma estação de trabalho
  • O que é uma estação de trabalho?
  • Vídeo de introdução às estações de trabalho
  • Como atribuir a Manutenção Preventiva a todos os postos de trabalho
  • Como remover a manutenção de uma estação de trabalho
  • Como atribuir a manutenção a uma estação de trabalho
  • Como eliminar uma estação de trabalho
  • Introdução ao modo de registo rápido
  • Como adicionar uma nova estação de trabalho
  • Como editar uma estação de trabalho
  • O que é uma exceção de estação de trabalho?

Programação de turnos

5
  • Como alterar a Pessoa atribuída a um Turno num determinado dia
  • Programação de turnos
  • Como adicionar horas extraordinárias
  • Como remover as horas extraordinárias
  • Vídeo de introdução à programação de turnos

Produtos

2
  • Subprodutos
  • Como criar um novo produto

Encomendas

6
  • Como editar um item de encomenda
  • Como criar um novo item de encomenda
  • Como filtrar uma encomenda
  • Como arquivar uma encomenda
  • Como editar uma encomenda
  • Como criar uma nova encomenda

Registo do pessoal

7

Programação do pessoal

1

Línguas

1

Armazém

1
  • Como criar um novo Material

Apoia

1
  • Como selecionar o teu idioma no SkyPlanner

Pessoal e utilizadores

2
  • Processar um empregado no cadastro de pessoal
  • Eliminar um empregado do registo de pessoal
Ver categorias
  • Home
  • Docs
  • Integrações
  • Registos de tempo

Registos de tempo

Sami
Atualizado em março 10, 2025

4 min read

Estrutura de dados do Skyplanner #

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ô. Tudo isso será discutido mais tarde.

Se integraste os dados das tuas encomendas/ordens de trabalho/trabalhos na Skyplanner, é muito provável que tenhas utilizado pelo menos estes pontos de extremidade da API:

  • encomendas phaser
  • ordenar linhas
  • phaser-jobs

Efetivamente, os dados inseridos nestes pontos finais são representados na IU do Skyplanner da seguinte forma:

Fig. 1. Encomenda (phaser-orders)
Fig. 2. Itens de pedido (linhas de pedido do phaser (vermelho)), etapas do processo (trabalhos do phaser (verde))

Depois de inserires as tuas encomendas no Skyplanner, deves exportá-las (isto pode ser feito através da interface do utilizador ou do ponto de extremidade /phaser-orders/export-endpoint) para o módulo de planeamento da produção:

Fig. 3. Exportar através da interface do utilizador
Fig. 4. Ordem exportada no plano de produção

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és do endpoint /phaser-orders, tens de exportar os dados novamente para os atualizar no Planeamento da Produção. Isto também significa que, para aceder às ordens que vês na janela do Planeamento da Produção, tens de usar diferentes API-endpoints!

Os pontos finais “alterados” são os seguintes:

  • /phaser-orders → /orders
  • /phaser-Order-rows → /Order-rows
  • /phaser-jobs → /jobs

É importante saber isto, porque ao usar o ponto de extremidade /timelogs para registar os teus eventos de produção, etc. , tens de usar as entidades relacionadas encontradas nos pontos de extremidade do Planeamento da Produção!

Por exemplo, precisas do production_planning_job_id (para reiterar: production_planning_jobs são as entidades acedidas a partir do ponto de extremidade /jobs) para POSTar um novo timelog:

Fig. 5. Pedido POST do registo de tempo

Podes encontrar o production_planning_job_id de que precisas a partir do ponto final /phaser-jobs:

Fig. 6. Pedido GET do trabalho do Phaser (a vermelho está phaser_job_id, NÃO O UTILIZES EM TIMELOGS)

Ou a partir do ponto final /job:

Fig. 7. Pedido /job GET

Criar registos de tempo utilizando a API REST #

Faz registos de tempo para o Skyplanner através da API e utiliza as mesmas regras e sistemas que estão na IU. Por isso, pode ser benéfico familiarizares-te com o funcionamento do sistema na IU antes de o tentares utilizar através da API.

Noções básicas sobre o registo de tempo #

O Skyplanner tem quatro tipos de eventos de registo de tempo:

  • shift_begin
  • interrompido
  • continua
  • shift_end

O evento Shift_begin é enviado quando a tarefa é iniciada pela primeira vez. Nunca envies mais do que um evento shift_begin para cada trabalho!

Pausa – evento que pausa a tarefa.

O evento continuado retoma uma tarefa em pausa.

Shift_end termina o trabalho. Nunca envies mais do que um evento shift_end para cada trabalho!

Dados necessários para os registos de tempo:

  • id_pessoa
    • Pode ser encontrado no ponto de extremidade /people
    • Não é o mesmo que user_id!
  • planned_workstation_id
    • O posto de trabalho onde o trabalho está a ser feito
    • Pode ser encontrado no /workstations-endpoint
  • data_horário
    • O momento em que o evento é realizado
    • Formata: 2024-01-01 10:30:11

Para especificar que timelog da Skyplanner está ligado ao timelog de qualquer sistema externo que estejas a utilizar, podes utilizar o campo external_id . Podes então, por exemplo, fazer pedidos GET utilizando este id para encontrar um timelog específico do Skyplanner.

Fig. 8. External_id nos registos de tempo

Começar um trabalho #

Podes iniciar tarefas enviando um pedido POST como este para a API:

Fig. 9. Deslocação_início do registo de tempo

Ao definir os dados POST para os registos de tempo, define workshift_id como 0 e timelog_finalized como true

Pausa um trabalho #

Pausa os trabalhos enviando um pedido POST como este:

Fig. 10. Pausa o registo de tempo

Nos registos cronológicos do tipo pausado, podes definir o montante e o faulty_amount. Tem também em atenção o tipo de registo de tempo e date_time.

Continua a trabalhar #

Eis como podes continuar um registo de tempo em pausa:

Fig. 11. Continua o registo de tempo

Nota que se tentares continuar um trabalho que tenha sido terminado por um evento shift_end, receberás um erro.

Terminar um emprego #

Eis como terminas um trabalho através de um registo de tempo shift_end:

Fig. 12. Registo do tempo do fim do turno

Em shift_end-events podes dar os valores amount e faulty_amount tal como em paused-events. Nota que se tentares fazer um shift_end-events a um trabalho que não está em execução, receberás um erro.

Atualizar registos de tempo #

Podes atualizar os dados do registo de tempo enviando pedidos PUT para o ponto final /timelogs-endpoint, da seguinte forma:

Fig. 13. Editar registos de tempo

Nota que tens de ter os dados beginTimelog e endTimelog definidos para fazeres uma atualização. Os registos de tempo no Skyplanner são armazenados da seguinte forma: cada registo de tempo “completo” (registo de tempo que tem um início e um fim (por exemplo, shift_begin/continued & paused/shift_end) tem uma entidade separada para o início e o fim.

Estes são emparelhados pelo valor begin_id 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 1.

Também tens de fornecer os valores person_id e endTimelog de cada vez que fazes um pedido de atualização, mesmo que não os alteres.

Formas alternativas de fazer registos de tempo #

Aqui estão algumas formas alternativas de acederes aos teus trabalhos utilizando a API.

Logfull #

Se quiseres enviar os registos de tempo de início e de fim num único pedido, podes utilizar o ponto de extremidade /timelogs/log-full, desta forma:

Fig. 14. Pedido de registo

Repara como os montantes são enviados aqui: o primeiro valor “amount” denota o montante defeituoso e o segundo o montante. Este pedido cria as entidades beginlog e endlog num único pedido.

Registo rápido #

O “Quicklogging” de um trabalho completa-o num único pedido, define a quantidade de produtos completada para corresponder ao valor definido no item da encomenda. O registo rápido é feito utilizando o ponto final /timelogs/quick-log:

Fig. 15. Registo rápido

Observar que aqui só é necessário fornecer production_planning_job_id, planned_workstation_id e person_id. Os valores de tempo e montante são preenchidos automaticamente. Nota também que os trabalhos com registo rápido são sempre concluídos com o evento shift_end, pelo que não é possível qualquer outro registo após o registo rápido!

Atualizado em março 10, 2025
API, Integração
Horários das etapas do processo programado e estações de trabalhoProdutos e materiais
Table of Contents
  • Estrutura de dados do Skyplanner
  • Criar registos de tempo utilizando a API REST
    • Noções básicas sobre o registo de tempo
  • Começar um trabalho
  • Pausa um trabalho
  • Continua a trabalhar
  • Terminar um emprego
  • Atualizar registos de tempo
  • Formas alternativas de fazer registos de tempo
    • Logfull
    • Registo rápido
Compartilhe este artigo :
  • Facebook
  • X
  • LinkedIn
  • Pinterest
Foi útil?
  • Feliz
  • Normal
  • Triste

Vendas de contacto

Jussi Mäntylä
+358 40 700 0002
[email protected]

Produto

Características

Soluções

Torne se um parceiro skyplanner

Privacy policy

Apoio

Teste gratuito

Solicitar uma reunião

Vendas de contacto

Recursos

Videos

Powered by Skycode Oy

Rantakatu 2 G (11° andar)
65100 Vaasa, Finlândia
2204947-0
+358 40 700 0002
skycode.fi


    • Facebook
    • LinkedIn
    2025 © Skycode Oy
    • logo
    • Início
    • Características
      • Características
      • Soluções
      • Integrações
    • Serviços de personalização
      • Serviços de assistência ao embarque
      • Integrações
      • Serviços de personalização
    • Preços
    • Vídeos
    • About us
      • About us
      • Contacto de vendas
      • Torne-se um parceiro SkyPlanner
    • Solicitar uma reunião
    • Comece gratuitamente!
    • Português
      • English
      • Suomi
      • Čeština
      • Dansk
      • Deutsch
      • Español
      • Eesti
      • Français
      • Italiano
      • Latviešu
      • Lietuvių
      • Magyar
      • Nederlands
      • Polski
      • Português
      • Slovenčina
      • Slovenščina
      • Svenska
      • Türkçe
      • Indonesia
      • 日本語
      • العربية
      • Ελληνικά
      • 한국어
      • Norsk bokmål
      • Română
      • Українська