# Agregar un SKU al turno actual (https://docs.pulsarml.com/es/v1/api-reference/realtime/post-realtime-machine_id-sku)

Asocia un SKU al turno que la máquina está corriendo en el momento de la llamada.

Pensado para terminales y escáneres de planta: sin buscar el turno ni calcular registros de producción. El SKU se indica como `skuId` o como `sku` (su nombre), y la orden de trabajo como `simpleWorkOrderId` o `simpleWorkOrderName`.

Escribe en el turno en curso y se ve en el tablero de Pulsar de inmediato.

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

Base URLs:
- `https://draco.prod.pulsarml.com` — Producción
- `https://draco.dev.pulsarml.com` — Desarrollo (sandbox)

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

### Path parameters

- `machine_id` (integer, required) — El ID de la máquina.

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

Type: object (`AddSkuToCurrentShiftRequestV1`)

- `simpleWorkOrderId` (string, optional, nullable, e.g. `"123"`) — El ID de la orden de trabajo simple a la que se agrega el SKU.
- `simpleWorkOrderName` (string, optional, nullable, e.g. `"WO-001"`) — El nombre de la orden de trabajo simple a la que se agrega el SKU.
- `skuId` (string, optional, nullable, e.g. `"456"`) — El ID del SKU que se agrega al turno actual de la máquina.
- `sku` (string, optional, nullable, e.g. `"sku 1"`) — El nombre del SKU que se agrega al turno actual de la máquina.
- `quantity` (number, optional, nullable, e.g. `1000`) — La cantidad producida del SKU.
- `start` (string (date-time), optional, nullable, e.g. `"2024-01-01T08:00:00"`) — La hora de inicio de la producción del SKU dentro del turno actual.
- `end` (string (date-time), optional, nullable, e.g. `"2024-01-01T16:00:00"`) — La hora de fin de la producción del SKU dentro del turno actual.
- `custom` (object (any keys), optional, nullable) — Valores de campos personalizados, indexados por ID de campo.

### Responses

#### 204 — Respuesta correcta

#### 422 — Error de validación

Type: object (`HTTPValidationError`)

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

### 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"
    }
  }'
```