---
title: Produkte und Materialien
description: "Hier erfahren Sie, wie Sie mit der Skyplanner-API Produkte und Materialien erstellen und diese mit Ihren Aufträgen verknüpfen können. Wir zeigen Ihnen auch, wie Sie Standardprozessschritte für Ihre Produkte erstellen und wie Sie Auftragspositionen unter Verwendung dieser Vorgaben erstellen. ####…"
url: "https://skyplanner.ai/de/docs/produkte-und-materialien/"
updated: "2025-10-07"
category: Integrationen
tags:
  - API
  - Integration
---

# Produkte und Materialien

Hier erfahren Sie, wie Sie mit der Skyplanner-API Produkte und Materialien erstellen und diese mit Ihren Aufträgen verknüpfen können. Wir zeigen Ihnen auch, wie Sie Standardprozessschritte für Ihre Produkte erstellen und wie Sie Auftragspositionen unter Verwendung dieser Vorgaben erstellen.

#### Ein Produkt/Material erstellen

Das Erstellen und Aktualisieren von Produkten und Materialien erfolgt über denselben API-Endpunkt: /Produkte. Der Typ des Produkts wird durch das **Attribut type** festgelegt: 'Produkt' oder 'Material'

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Abb. 1.** Ein Produkt erstellen

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Abb. 2.** Ein Material erstellen

Stellen Sie bei der Erstellung von Produkten und Materialien sicher, dass Sie den Wert **is_active** auf true setzen, wenn Sie möchten, dass das Produkt/Material in der Produktliste als aktiv angezeigt wird. Beachten Sie auch, dass Sie die verfügbare Lagermenge mit dem Attribut **free_amount** festlegen können.

#### Erstellen von Standard-Prozessschritten für ein Produkt

Bevor Sie Standard-Prozessschritte für ein Produkt hinzufügen können, müssen Sie über die entsprechenden Workstages verfügen. Workstages können entweder über die Skyplanner-Benutzeroberfläche oder den Endpunkt /workstages erstellt werden.

Das Hinzufügen von Standard-Prozessschritten erfolgt über den /products/jobs/{productId}-Endpunkt.

Wenn Sie also zum Beispiel dem Produkt mit der ID 22220 einen Standardschritt hinzufügen möchten, würden Sie eine POST-Anfrage wie folgt stellen:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Abb. 3.** Hinzufügen eines Standard-Prozessschritts

Einige bemerkenswerte Bereiche:

- auftrag_nummer
  - Dies ist eine Indexnummer, die Skyplanner mitteilt, in welcher Reihenfolge die Prozessschritte ausgeführt werden sollen
  - Zum Beispiel: Der erste Schritt erhält den Wert 1, der zweite Schritt erhält den Wert 3, der dritte Schritt erhält den Wert 3 und so weiter...
- Workstations
  - Dies ist eine Liste von Arbeitsstationen, für die dieser Prozessschritt geplant werden kann
  - Geben Sie hier die IDs der Arbeitsstationen als kommagetrennte Liste an, etwa so: "61,62,63"
- zeit_variation
  - Mögliche Werte: time_per_pcs, pcs_per_time, fixed_time
- Dauer, Einstellungszeit, Einstellungszeit
  - Geben Sie diese Werte in *Sekunden* an

#### Aktualisieren eines Standard-Prozessschritts

Wenn Sie einen Standardprozessschritt aktualisieren, müssen Sie das Attribut **order_number** verwenden, um anzugeben, welcher Schritt aktualisiert werden soll.

Der erste Prozessschritt**(Bestellnummer 1**) in diesem Produkt wird zum Beispiel mit einer PUT-Anfrage wie dieser durchgeführt:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Abb. 4.** Aktualisieren eines Standard-Prozessschritts

#### Löschen von Standard-Prozessschritten

Das Löschen von Standard-Prozessschritten erfolgt ebenfalls mit Hilfe der **order_number-Werte**.

Die Bestellnummern werden in einem Array wie diesem angegeben:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Abb. 5.** Löschen von Standard-Prozessschritten

##### Hinzufügen eines Materials/Unterprodukts zu einem Produkt

Um ein Material oder Unterprodukt anzuhängen, müssen wir den Endpunkt /sub-products verwenden.

Der Prozess ist ziemlich einfach: Wir geben die ID des Materials oder Unterprodukts in das Attribut **production_planning_product_id** ein und die ID des Produkts, dem das Material/Unterprodukt zugeordnet werden soll, in das Attribut **production_planning_product_parent_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Abb. 6.** Anbringen eines Materials an einem Produkt

##### Hinzufügen eines Materials zu einer Auftragsposition

Sie können Materialien auch direkt an eine Auftragsposition anhängen, indem Sie den Endpunkt /row-materials verwenden. Auf diese Weise können Sie zusätzliche Materialien hinzufügen oder eine völlig andere Liste von Materialien in einer Auftragsposition verwenden als die Standardmaterialien, die den Produkten zugeordnet sind. Beachten Sie, dass Sie für eine Auftragsposition für jedes Material nur eine Zeile-Material-Entität haben können. Sie können also nicht zwei Entitäten mit der gleichen **production_planning_product_id**zur gleichen **phaser_order_row_id** anlegen.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Abb. 7.** Hinzufügen eines Materials zu einer Auftragsposition

#### Aktualisieren des Lagerbestands

Sie können den Produkt- oder Materialbestand aktualisieren, indem Sie eine PUT-Anfrage mit dem Attribut **free_amount** senden.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Abb. 8.** Aktualisieren des Lagerbestands