Eventos

O eventType de cada notificação indica o que aconteceu, e o seu objeto event contém os dados. O envelope que o envolve é o mesmo para todos os eventos.

Paragens de máquina

Quando uma máquina para, o Pulsar regista a paragem. Os eventos de paragem informam-no no momento: MachineStopCreated quando começa e MachineStopEnded quando termina, quer alguém já a tenha classificado ou não. Para saber também a sua causa, subscreva os eventos de classificação abaixo.

Os dois eventos de paragem contêm o mesmo objeto event. Tem os mesmos campos que os eventos de classificação, mas os campos da causa são null enquanto a paragem não estiver classificada:

Tal como nas classificações, uma paragem é identificada pela sua máquina e pelo seu start. Use esse par para associar um MachineStopEnded ao MachineStopCreated que já recebeu, e a um evento de classificação posterior da mesma paragem.

Paragem criada

MachineStopCreated é enviado quando o Pulsar regista uma nova paragem. Os campos da causa são null até alguém a classificar.

{
  "eventId": "2a7c9e14-6b3d-4f81-a5c2-9d0e7f3b1a68",
  "eventTimestamp": "2026-09-25T13:41:52.306Z",
  "eventType": "MachineStopCreated",
  "event": {
    "machine": "Injetora 4",
    "machineExternalName": "INJ-004",
    "start": "2026-09-25T13:41:07.000Z",
    "end": null,
    "operator": "Ana Torres",
    "generalCause": null,
    "specificCause": null,
    "component": null,
    "description": null,
    "isAutomated": null
  }
}

Paragem terminada

MachineStopEnded é enviado quando uma paragem recebe a sua hora de fim. Uma paragem que o Pulsar já regista fechada é enviada como MachineStopCreated e como MachineStopEnded.

{
  "eventId": "e6b13f80-4c2a-4d97-8e5b-1f9a7c3d0b24",
  "eventTimestamp": "2026-09-25T13:59:04.751Z",
  "eventType": "MachineStopEnded",
  "event": {
    "machine": "Injetora 4",
    "machineExternalName": "INJ-004",
    "start": "2026-09-25T13:41:07.000Z",
    "end": "2026-09-25T13:58:30.000Z",
    "operator": "Ana Torres",
    "generalCause": null,
    "specificCause": null,
    "component": null,
    "description": null,
    "isAutomated": null
  }
}

Se a paragem foi classificada antes de o evento ser entregue, os campos da causa contêm essa classificação.

O que esperar

• As mudanças de turno dividem as paragens. Uma paragem ainda aberta quando um turno termina é fechada na mudança de turno, e começa uma nova paragem no turno seguinte. Recebe um MachineStopEnded da primeira e um MachineStopCreated da segunda.
• O início de uma paragem pode mudar. O Pulsar pode ajustar a hora de início de uma paragem depois de a registar. Como uma paragem é identificada pelo seu start, recebe então um MachineStopCreated com o novo início e nada mais sobre o anterior.
• Apenas paragens detetadas. As paragens que alguém adiciona ou divide manualmente no Pulsar ainda não enviam eventos de paragem.

Classificações de paragens de máquina

Quando uma máquina para, o Pulsar regista a paragem. Classificá-la significa registar porque aconteceu: uma causa geral, opcionalmente uma causa mais específica e o componente envolvido, e uma descrição em texto livre. Uma classificação é introduzida por uma pessoa ou aplicada automaticamente por uma regra.

Os três eventos de classificação contêm o mesmo objeto event:

Uma paragem é identificada pela sua máquina e pelo seu start. Use esse par para associar uma atualização ou eliminação a uma paragem que já conhece.

Criada

MachineStopClassificationCreated é enviado quando uma paragem é classificada pela primeira vez.

{
  "eventId": "8d2f6c1e-4b7a-4f0e-9a3c-5e1d7b9f2a64",
  "eventTimestamp": "2026-09-25T14:03:12.482Z",
  "eventType": "MachineStopClassificationCreated",
  "event": {
    "machine": "Injetora 4",
    "machineExternalName": "INJ-004",
    "start": "2026-09-25T13:41:07.000Z",
    "end": "2026-09-25T13:58:30.000Z",
    "operator": "Ana Torres",
    "generalCause": "Falha mecânica",
    "specificCause": "Encravamento no molde",
    "component": "Pino extrator",
    "description": "Peça presa na cavidade 2, libertada manualmente",
    "isAutomated": false
  }
}

Atualizada

MachineStopClassificationUpdated é enviado quando uma classificação existente muda, por exemplo quando alguém corrige a causa. O objeto event contém os valores atuais da classificação.

{
  "eventId": "c41a7e09-2d6b-4f38-9e15-7b0c3a9d4f22",
  "eventTimestamp": "2026-09-25T14:20:45.117Z",
  "eventType": "MachineStopClassificationUpdated",
  "event": {
    "machine": "Injetora 4",
    "machineExternalName": "INJ-004",
    "start": "2026-09-25T13:41:07.000Z",
    "end": "2026-09-25T13:58:30.000Z",
    "operator": "Ana Torres",
    "generalCause": "Falha mecânica",
    "specificCause": "Falha do extrator",
    "component": "Pino extrator",
    "description": "Pino extrator dobrado, substituído",
    "isAutomated": false
  }
}

Eliminada

MachineStopClassificationDeleted é enviado quando uma classificação é removida e a paragem fica sem classificação. As causas, o componente, a descrição e isAutomated descrevem a classificação tal como estava antes de ser eliminada. A máquina, as horas da paragem e o operador vêm dos registos atuais do Pulsar.

{
  "eventId": "5e93b0d7-8a14-4c6f-b2e8-1d7f0a3c9b56",
  "eventTimestamp": "2026-09-25T15:02:09.804Z",
  "eventType": "MachineStopClassificationDeleted",
  "event": {
    "machine": "Injetora 4",
    "machineExternalName": "INJ-004",
    "start": "2026-09-25T13:41:07.000Z",
    "end": "2026-09-25T13:58:30.000Z",
    "operator": "Ana Torres",
    "generalCause": "Falha mecânica",
    "specificCause": "Falha do extrator",
    "component": "Pino extrator",
    "description": "Pino extrator dobrado, substituído",
    "isAutomated": false
  }
}

Os dados do evento são lidos no momento da entrega

Nos eventos de paragem e nos eventos de classificação criada e atualizada, o Pulsar lê a paragem ou a classificação quando prepara a notificação pela primeira vez, não no instante da alteração. Se uma classificação mudar duas vezes seguidas, ambos os eventos podem conter os valores mais recentes, e um MachineStopCreated entregue com atraso pode já incluir end. Trate cada evento como "esta paragem está agora assim", não como o registo de uma edição em particular.

Se uma paragem já não existir quando o Pulsar prepara o seu evento de paragem, por exemplo porque o seu início mudou, o evento não é enviado.

Uma nova tentativa ou um reenvio volta a enviar exatamente o mesmo corpo que a primeira tentativa, por isso nunca inclui alterações posteriores.