# Adicionar um SKU ao turno atual (https://docs.pulsarml.com/pt/v1/api-reference/realtime/post-realtime-machine_id-sku)

Associa um SKU ao turno em curso na máquina no momento da chamada.

Pensado para terminais e scanners de fábrica: sem procurar o turno nem calcular registos de produção. O SKU é indicado como `skuId` ou como `sku` (o seu nome), e a ordem de trabalho como `simpleWorkOrderId` ou `simpleWorkOrderName`.

Escreve no turno em curso e fica visível no painel do Pulsar de imediato.

## `POST /v1/realtime/{machine_id}/sku`

Base URLs:
- `https://draco.prod.pulsarml.com` — Produção
- `https://draco.dev.pulsarml.com` — Desenvolvimento (sandbox)

Authentication: send your API key in the `x-api-key` header.

### Path parameters

- `machine_id` (integer, required) — O ID da máquina.

### Request body (`application/json`, required)

Type: object (`AddSkuToCurrentShiftRequestV1`)

- `simpleWorkOrderId` (string, optional, nullable, e.g. `"123"`) — O ID da ordem de trabalho simples à qual o SKU é adicionado.
- `simpleWorkOrderName` (string, optional, nullable, e.g. `"WO-001"`) — O nome da ordem de trabalho simples à qual o SKU é adicionado.
- `skuId` (string, optional, nullable, e.g. `"456"`) — O ID do SKU a adicionar ao turno atual da máquina.
- `sku` (string, optional, nullable, e.g. `"sku 1"`) — O nome do SKU a adicionar ao turno atual da máquina.
- `quantity` (number, optional, nullable, e.g. `1000`) — A quantidade produzida do SKU.
- `start` (string (date-time), optional, nullable, e.g. `"2024-01-01T08:00:00"`) — A hora de início da produção do SKU dentro do turno atual.
- `end` (string (date-time), optional, nullable, e.g. `"2024-01-01T16:00:00"`) — A hora de fim da produção do SKU dentro do turno atual.
- `custom` (object (any keys), optional, nullable) — Valores de campos personalizados, indexados pelo ID do campo.

### Responses

#### 204 — Resposta bem-sucedida

#### 422 — Erro de validação

Type: object (`HTTPValidationError`)

- `detail` (array of object, optional)
  - `loc` (array of string | integer, required)
  - `msg` (string, required)
  - `type` (string, required)
  - `input` (any, optional)
  - `ctx` (object, optional)

### Example request

```bash
curl -X POST 'https://draco.prod.pulsarml.com/v1/realtime/<machine_id>/sku' \
  -H 'x-api-key: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "simpleWorkOrderId": "123",
    "simpleWorkOrderName": "WO-001",
    "skuId": "456",
    "sku": "sku 1",
    "quantity": 1000,
    "start": "2024-01-01T08:00:00",
    "end": "2024-01-01T16:00:00",
    "custom": {
      "fieldId": "value"
    }
  }'
```