Após o Skyplanner ter agendado os passos do teu processo na linha de tempo, poderás querer obter os dados de início, fim e estação de trabalho para os passos no teu sistema ERP. Isto pode ser feito usando o /jobs-endpoint.
Atualizar as horas programadas #
Se deres ao pedido GET feito ao ponto de extremidade /jobs o parâmetro URL job_parts=true, a tua resposta de retorno incluirá alguns dados adicionais:
Com o parâmetro job_parts=true obténs também as entidades chamadas job parts ligadas ao trabalho.
As partes da tarefa são representadas na IU do Skyplanner pelos “pedaços” em que uma tarefa é dividida:
Cada parte do trabalho tem uma planned_start_time, uma planned_end_time e uma planned_duration. Se quiseres saber quando é que o trabalho está programado para ser iniciado, a tua lógica de integração tem de procurar em cada parte do trabalho e encontrar a planned_start_time com o valor mais antigo. E para a hora de fim do trabalho, terás de procurar a planned_end_time com o valor mais recente.
Nota: não assumas que a primeira parte do trabalho tem a primeira planned_start_time e a última parte tem a última planned_end_time! Nem sempre é esse o caso.
A partir de job_parts podes também encontrar a duração de cada parte no campo planned_duration. Este valor está em segundos.
Atualizar a estação de trabalho #
Nos dados da peça de trabalho (Fig. 1.), podes encontrar o posto de trabalho em que a peça está planeada para ser concluída no valor planned_workstation_id.
Com o valor workstation_id, podes ir buscar a estação de trabalho ao ponto de extremidade /workstations-endpoint:
Se tiver ligado o posto de trabalho correspondente no seu sistema ERP ao posto de trabalho da Skyplanner através do seu ID externo, pode encontrá-lo na resposta. Isto permite-te atualizar a estação de trabalho no teu ERP se a Skyplanner tiver reatribuído a etapa do processo a uma estação de trabalho diferente.
