Wir erweitern die Möglichkeiten der öffentlichen API v2 in RO App weiter. Über die API können Sie jetzt Aufgaben der Mitarbeiter verwalten, Mindest- und Höchstbestände für Produkte in Lagerhäusern festlegen und Rechnungen genauer mit Aufträgen verknüpfen. So können Sie Daten mit anderen Systemen synchronisieren, ohne sie manuell einzugeben. Außerdem gibt es neue Webhooks für Aufgaben.
Aufgaben über die API
Die öffentliche API v2 bietet jetzt Endpunkte für die Arbeit mit Aufgaben. Sie unterstützen Status und Priorität von Aufgaben, sodass die Daten in der API mit dem übereinstimmen, was Sie in RO App sehen.
Jetzt können Sie:
eine Liste von Aufgaben oder eine einzelne Aufgabe abrufen – mit Titel, Beschreibung, Status, Priorität, Autor, Bearbeitern, Fälligkeitsdatum und verknüpftem Datensatz;
Aufgaben erstellen, bearbeiten und löschen;
den Status einer Aufgabe ändern und Kommentare hinzufügen;
eine Liste der Aufgabenstatus abrufen.
Sie können Aufgaben nach Status, Priorität, Autor, Bearbeitern, Erstellungsdatum und Fälligkeitsdatum filtern. Außerdem gibt es separate Filter für überfällige Aufgaben und Aufgaben ohne Bearbeiter. Die Liste lässt sich nach Erstellungsdatum, Änderungsdatum, Fälligkeitsdatum oder Priorität sortieren.
Bitte beachten Sie: Eine neue Aufgabe wird immer mit dem Anfangsstatus erstellt, den Sie mit einer separaten Anfrage ändern können. Über die API können Sie nur einen Status festlegen, der für die Rolle des Mitarbeiters verfügbar ist – genau wie in der Webversion. Eine Statusänderung über die API wird in der Aufgabe genauso erfasst wie eine manuelle Änderung.
Außerdem haben wir neue Webhooks für Aufgaben hinzugefügt – für Status- und Prioritätsänderungen. So erfahren andere Systeme sofort davon, ohne regelmäßige API-Anfragen. Um sie zu verbinden, wählen Sie beim Einrichten des Webhooks die Ereignisse "Status geändert" und "Priorität geändert" im Block "Aufgaben".
Weitere Informationen finden Sie in der Dokumentation der Endpunkte für Aufgaben.
Mindest- und Höchstbestände von Produkten
Mindest- und Höchstbestände von Produkten lassen sich jetzt über die API festlegen – für jedes Lagerhaus separat. Sie können:
Mindest- und Höchstbestände eines Produkts in allen Lagerhäusern oder in einem bestimmten Lagerhaus abrufen;
sie für ein Lagerhaus festlegen und ändern;
sie für ein Lagerhaus entfernen, wenn sie nicht mehr benötigt werden.
Produkte, deren Bestand unter dem Mindestbestand liegt, erscheinen auf der Seite "Produkte zum Nachbestellen". Wenn Sie Einkäufe in einem anderen System planen, können Sie diese Einstellungen automatisch von dort übertragen, statt die Produktkarten manuell auszufüllen.
Weitere Informationen finden Sie in der Dokumentation der Endpunkte für Mindest- und Höchstbestände.
Rechnungen und Aufträge
Wir haben auch die Endpunkte für die Arbeit mit Rechnungen verbessert, damit Sie Rechnungen einfacher mit Aufträgen verknüpfen können. Jetzt:
enthalten Rechnungspositionen die ID des Auftrags, aus dem sie hinzugefügt wurden;
können Sie die Rechnungsliste nach Auftrag filtern – Sie erhalten alle Rechnungen, die mindestens eine Position aus diesem Auftrag enthalten;
können Sie mit einem neuen Endpunkt einer Rechnung Positionen aus Aufträgen hinzufügen.
Weitere Informationen finden Sie in der Dokumentation des Endpunkts zum Hinzufügen von Auftragspositionen zu einer Rechnung.
Wie die neuen Endpunkte Ihrem Unternehmen helfen
Damit können Sie zum Beispiel:
Aufgaben mit Task-Trackern und Kalendern der Mitarbeiter synchronisieren;
Aufgaben automatisch anhand von Ereignissen in anderen Systemen erstellen – zum Beispiel eine Erinnerung, einen Kunden zurückzurufen;
eigene Berichte über die Erledigung und Überfälligkeit von Aufgaben erstellen;
Mindest- und Höchstbestände für viele Produkte und Lagerhäuser gleichzeitig aktualisieren – zum Beispiel vor der Saison;
Positionen aus Aufträgen automatisch in Rechnung stellen und prüfen, ob dem Kunden bereits alles in Rechnung gestellt wurde.
Zugriff auf die Endpunkte
Ein API-Schlüssel gehört einem bestimmten Mitarbeiter in RO App und hat dieselben Zugriffsrechte wie dieser. Um zum Beispiel über die API mit Aufgaben zu arbeiten, benötigt der Mitarbeiter die entsprechenden Rechte in seiner Rolle: zum Anzeigen, Erstellen, Bearbeiten oder Löschen von Aufgaben.
Wenn Sie Fragen, Anregungen oder Kommentare zur öffentlichen API und zu den Webhooks von RO App haben, kontaktieren Sie uns über den Support-Chat.