Quelle: https://spooly.eu/docs/home-assistant/actions

# Aktionen

Alle 9 Aktionen brauchen das Recht zu ändern. Fehlt es, kommt eine Meldung, und Home Assistant bietet die erneute Anmeldung an. Nach jeder Aktion ruft die Integration sofort neu ab.

Die Spule wählst du über ihr Gerät, Slot und Wartungsaufgabe über ihren Sensor. Im Aktionen-Editor wählst du aus einer Liste, in YAML steht die ID des Geräts. [Beispiele](https://spooly.eu/docs/home-assistant/examples)

## `spooly.set_weight`

In der Oberfläche: Gewicht setzen

Setzt das Restgewicht. Gib genau eines der beiden Gewichte an.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste. |
| `grams` | Zahl, optional | Filament ohne Spule, 0 bis 20.000 g |
| `gross_grams` | Zahl, optional | Spule auf der Waage, 0 bis 40.000 g. Braucht eine bekannte Tara. |

YAML:

```
action: spooly.set_weight
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  gross_grams: 742
```

## `spooly.refill`

In der Oberfläche: Nachfüllen

Addiert Gramm zum Restgewicht.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste. |
| `grams` | Zahl | 1 bis 20.000 g |

YAML:

```
action: spooly.refill
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  grams: 250
```

## `spooly.assign_slot`

In der Oberfläche: Slot zuordnen

Legt eine Spule in einen Slot. Geht nur mit aktivem Slot-Autopilot.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste. |
| `slot` | Entität | Der Sensor des Slots |
| `confirm_color` | Ja/Nein, optional | Auch zuordnen, wenn der Drucker eine andere Farbe meldet. Standard aus. |

YAML:

```
action: spooly.assign_slot
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  slot: sensor.x1_carbon_von_tobi_1_2
  confirm_color: false
```

## `spooly.clear_slot`

In der Oberfläche: Slot leeren

Nimmt die Spule aus einem Slot, sie bleibt in Spooly. Geht nur mit aktivem Slot-Autopilot.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `slot` | Entität | Der Sensor des Slots |

YAML:

```
action: spooly.clear_slot
data:
  slot: sensor.x1_carbon_von_tobi_1_2
```

## `spooly.move`

In der Oberfläche: Umlagern

Legt eine Spule in einen Lagerort, auf Wunsch auf einen Platz. Ohne Platz liegt sie im Ort ohne Platz.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste. |
| `location` | Text | Name des Lagerorts mit Pfad, wie ihn `GET /locations` liefert, oder seine Kennung. Für einen Platz hängst du ihn an wie in Spooly: „Werkstatt · Trockenbox · Platz 1“. So kannst du auch das Attribut `location` einer Spule übernehmen. Heißen zwei Lagerorte gleich, nimm die Kennung aus `location_id`, auch mit „· Platz 1“ dahinter. |

YAML:

```
action: spooly.move
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
  location: "Schrank 01 · Fach vorne"
```

## `spooly.archive`

In der Oberfläche: Archivieren

Archiviert eine Spule. Sie verlässt den aktiven Bestand und wird nicht gelöscht.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der Spule. Im Aktionen-Editor wählst du sie aus einer Liste. |

YAML:

```
action: spooly.archive
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
```

## `spooly.restore`

In der Oberfläche: Zurückholen

Holt eine archivierte Spule zurück in den aktiven Bestand. Das geht nur, solange das Gerät der Spule in Home Assistant noch existiert. Hast du es nach dem Archivieren gelöscht (wie die [Datenaktualisierung](https://spooly.eu/docs/home-assistant/data-updates#home-assistant-data-updates-neu) empfiehlt), holst du die Spule in der App zurück.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `device_id` | Gerät | Das Gerät der archivierten Spule |

YAML:

```
action: spooly.restore
data:
  device_id: 9f2c4e7a1b3d5f60718293a4b5c6d7e8
```

## `spooly.complete_maintenance`

In der Oberfläche: Wartung erledigt

Meldet eine Wartungsaufgabe als erledigt.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `task` | Entität | Der Sensor der Aufgabe |
| `action` | Auswahl, optional | `replace` getauscht, `clean` gereinigt oder `check` geprüft. Ohne Angabe nimmt Spooly die übliche Tätigkeit der Aufgabe. |
| `notes` | Text, optional | Freitext, Spooly speichert ihn beim Eintrag |

YAML:

```
action: spooly.complete_maintenance
data:
  task: sensor.x1_carbon_von_tobi_nozzle_0_4_mm
  action: replace
  notes: Neue Düse 0,4 mm
```

## `spooly.snooze_maintenance`

In der Oberfläche: Wartung zurückstellen

Stellt eine Wartungsaufgabe zurück.

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `task` | Entität | Der Sensor der Aufgabe |
| `days` | Auswahl | 7, 14 oder 30 |
| `reason` | Text, optional | Freitext, Spooly speichert ihn |

YAML:

```
action: spooly.snooze_maintenance
data:
  task: sensor.x1_carbon_von_tobi_nozzle_0_4_mm
  days: 14
  reason: Teil ist bestellt
```