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’
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:
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:
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:
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.
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.
Aktualisieren des Lagerbestands #
Sie können den Produkt- oder Materialbestand aktualisieren, indem Sie eine PUT-Anfrage mit dem Attribut free_amount senden.