Adicionar defeitos ao turno

Adiciona unidades defeituosas de um SKU a um turno pelo seu ID (o que é devolvido por GET /v1/shifts), mesmo em turnos que já terminaram.

Como os defeitos se somam. Ao contrário dos operadores, os defeitos não têm cronologia nem ordem. Cada chamada adiciona um novo registo de produção de defeitos de quantity unidades do SKU, que cobre o turno completo, e a Qualidade e o OEE do turno contabilizam-no em segundo plano. Uma chamada nunca substitui as anteriores:

  • Enviar quantity: 2 e depois quantity: 3 regista 5 defeitos.
  • Enviar o mesmo pedido duas vezes regista os defeitos duas vezes, por isso repita apenas os pedidos que falharam.
  • Para anular uma chamada, elimine o registo que ela devolveu com DELETE /v1/production-logs/{id}. Para ver o que um turno já tem, liste os seus registos com POST /v1/production-logs/filters.

Os defeitos não são atribuídos a nenhum operador, e podem ser adicionados a turnos passados, incluindo aqueles cuja produção foi revista. O SKU é indicado por id ou por name; um nome desconhecido cria um SKU novo, por isso verifique a ortografia.

Erros:

  • 400: nenhum turno corresponde, o turno ainda não começou, ou o turno não tem produção suficiente desse SKU para comportar os defeitos.
  • 404: sku.id não é um dos seus SKUs.

Parâmetros de caminho

shift_id*Shift Id

O ID do turno.

Corpo do pedido

application/json

Definições de TypeScript

Utilize o tipo request body em TypeScript.

Corpo da resposta

application/json

application/json

Experimente em direto
POST
/v1/shifts/{shift_id}/defects

Este endpoint requer autenticação. Cole um token na secção Autorização, mais abaixo.

curl -X POST "https://example.com/v1/shifts/0/defects" \  -H "Content-Type: application/json" \  -d '{    "sku": {}  }'
{  "id": "5b0f6a52-3c1e-4d5b-9f0e-8a7c6d5e4f3a",  "shiftId": 48213,  "machineId": 12,  "quantity": 3,  "start": "2026-10-12T06:00:00Z",  "end": "2026-10-12T14:00:00Z"}

Adicionar defeitos por hora POST

Adiciona unidades defeituosas de um SKU ao turno que a máquina `machineId` estava a executar em `time`, mesmo em turnos que já terminaram. Use-o quando sabe a máquina e aproximadamente quando os defeitos foram encontrados, mas não o ID do turno. **Como os defeitos se somam.** Ao contrário dos operadores, os defeitos não têm cronologia nem ordem. Cada chamada adiciona um novo registo de produção de defeitos de `quantity` unidades do SKU, que cobre o turno completo, e a Qualidade e o OEE do turno contabilizam-no em segundo plano. Uma chamada nunca substitui as anteriores: * Enviar `quantity: 2` e depois `quantity: 3` regista 5 defeitos. * Enviar o mesmo pedido duas vezes regista os defeitos duas vezes, por isso repita apenas os pedidos que falharam. * Para anular uma chamada, elimine o registo que ela devolveu com `DELETE /v1/production-logs/{id}`. Para ver o que um turno já tem, liste os seus registos com `POST /v1/production-logs/filters`. Os defeitos não são atribuídos a nenhum operador, e podem ser adicionados a turnos passados, incluindo aqueles cuja produção foi revista. O SKU é indicado por `id` ou por `name`; um nome desconhecido cria um SKU novo, por isso verifique a ortografia. Erros: * `400`: nenhum turno corresponde, o turno ainda não começou, ou o turno não tem produção suficiente desse SKU para comportar os defeitos. * `404`: `sku.id` não é um dos seus SKUs.

Listar os sinais de uma máquina GET

Devolve os sinais de sensor em bruto que uma máquina expõe, com o `public_id` necessário para ler as suas amostras. Um sinal é um canal de sensor lido pela máquina, com o nome da grandeza física que transporta (`current`, `count`, `product_count`, `cycle`, `energy`, `temperature`, `pressure`, ...). Uma máquina pode expor vários sinais com o mesmo `name`; o seu `display_name` distingue-os. Os sinais eliminados e os que não têm um tipo não são listados. `description` vem em inglês por predefinição; passe `language=es` para a obter em espanhol. Uma descrição sem tradução no idioma pedido é devolvida em inglês.