Wir entwickeln ständig neue Integrationen, damit Sie ein Ökosystem von Business-Tools aufbauen und Routineprozesse vollständig automatisieren können. Mit diesem Ziel vor Augen haben wir mehrere Verbesserungen an der öffentlichen API vorgenommen, sodass Sie die RO App selbstständig in Dienste von Drittanbietern integrieren können. Heute freuen wir uns, Ihnen sowohl brandneue API-Methoden als auch Aktualisierungen bestehender Methoden vorstellen zu können.
Leads
Die Methode zum Abrufen einer Liste von Leads unterstützt nun die folgenden Abfrageparameter:
modified_at – Filtern Sie nach dem Datum, an dem die Leads aktualisiert wurden.
closed_at – Filtern Sie nach dem Datum, an dem die Leads abgeschlossen wurden.
Darüber hinaus enthält die Antwort nun alle Details zu jedem Lead:
created_at – das Datum, an dem der Lead erstellt wurde.
modified_at – das Datum, an dem die Lead-Daten aktualisiert wurden.
closed_at – das Datum, an dem der Lead abgeschlossen wurde.
rel_obj – das mit dem Lead verbundene Objekt (Auftrag, Verkauf).
Aufträge (Arbeitsaufträge / Tickets / Jobs)
Auftrag erstellen
Die Methode zum Erstellen von Aufträgen unterstützt nun den optionalen Parameter asset_id.
Bestellungen erhalten
Die Methode zum Abrufen einer Liste von Bestellungen gibt nun ein uom-Objekt (Maßeinheit) für Produkte und Dienstleistungen zurück, das Folgendes enthält:
id – die ID der Maßeinheit.
title – der Kurzname.
description – der vollständige Name.
Neue Methode: Bestellung nach ID abrufen
Mit dieser Methode können Sie Daten für einen bestimmten Auftrag anhand seiner ID abrufen.
Die Methode zum Abrufen einer Liste der Verkäufe unterstützt nun den Abfrageparameter created_at, mit dem Sie nach dem Datum der Verkaufserstellung filtern können. Außerdem gibt sie ein uom-Objekt für Produkte und Dienstleistungen mit Details wie id, title und description zurück.
Neue Methode: Zahlung erstellen
Mit dieser Methode können Sie die Erstellung von Zahlungen in RO App automatisieren, wenn Zahlungen in anderen Diensten getätigt werden.
Neue Methode: Cashflow-Posten abrufen
Wenn Sie Cashflow-Positionen verwenden, können Sie deren Liste nun mit dieser Methode abrufen.
Bargeldtransaktionen durchführen
Die Methode zum Abrufen von Bargeldtransaktionen umfasst nun den Parameter cashflow_item (Name und Typ des Cashflow-Postens: Einnahmen oder Ausgaben). Zusätzlich gibt sie client_id (die Kunden-ID, sofern in der Zahlung angegeben) und related_document (das mit der Zahlung verknüpfte Dokument, z. B. eine Bestellung, ein Verkauf oder eine Rückerstattung) zurück.
Die Methode zum Abrufen einer Liste von Unternehmensrechnungen umfasst nun die Parameter code (Produktcode) und article (Produkt-SKU).
Wenn Sie mit Assets (wie Geräten, Fahrzeugen usw.) in anderen Systemen arbeiten, haben wir zu diesem Zweck eine Reihe neuer öffentlicher API-Methoden vorbereitet.
Assets abrufen
Verwenden Sie diese Methode, um eine Liste der Assets in Ihrem Konto zusammen mit allen Details abzurufen, darunter ID, Seriennummer/VIN/IMEI, Gruppendaten, Marke, Modell, Eigentümer und mehr.
Asset anhand der ID abrufen
Verwenden Sie diese Methode, um Daten für ein bestimmtes Asset anhand seiner ID abzurufen.
Benutzerdefinierte Felder für Assets abrufen
Mit dieser Methode können Sie eine Liste der benutzerdefinierten Felder für Assets auf der Seite „Einstellungen > Formular-Editor > Assets“ abrufen.
Asset erstellen
Verwenden Sie diese Methode, um neue Assets in Ihrem Konto zu erstellen. Stellen Sie sicher, dass alle erforderlichen Felder (wie auf der Seite „Einstellungen > Formular-Editor > Assets“ gekennzeichnet) ausgefüllt sind.
Asset aktualisieren
Mit dieser Methode können Sie Asset-Details wie Seriennummer, Eigentümer, Gruppe, Marke, Modell und andere Felder aktualisieren.
Asset verschieben
Verwenden Sie diese Methode, um Assets in andere Lager zu übertragen.
Werte aus dem Asset-Verzeichnis abrufen
Diese Methode ruft alle Elemente aus dem hierarchischen Verzeichnis „Gruppe-Marke-Modell-Modifikation“ für Assets zusammen mit ihren IDs ab.
Wir haben neue Methoden hinzugefügt und bestehende Methoden für die Zusammenarbeit mit Kunden verbessert, darunter auch die Behebung von Problemen mit benutzerdefinierten Feldern.
Neue Methode: Client anhand der ID abrufen
Mit dieser Methode können Sie alle verfügbaren Daten für einen bestimmten Client anhand seiner ID abrufen.
Neue Methode: Kunden zusammenführen
Verwenden Sie diese Methode, um doppelte Kunden zusammenzuführen, indem Sie alle doppelten IDs und die ID des Kunden angeben, zu dem sie konsolidiert werden sollen.
Client erstellen und Client aktualisieren
Diese Methoden unterstützen nun die Abfrageparameter first_name und last_name, sodass Sie Clients genauer erstellen und aktualisieren können.
Kunden abrufen
Diese Methode unterstützt nun den Parameter ids[], mit dem Sie Daten für bestimmte Kunden anhand ihrer IDs abrufen können.
Wir haben vier völlig neue Methoden für die Arbeit mit dem Produktkatalog Ihres Unternehmens vorbereitet.
Produkte abrufen
Verwenden Sie diese Methode, um eine Liste der Produkte Ihres Unternehmens von der Seite „Mein Unternehmen > Produkte“ abzurufen.
Produkt anhand der ID abrufen
Verwenden Sie diese Methode, um Details zu einem bestimmten Produkt anhand seiner ID abzurufen.
Produkt erstellen
Mit dieser Methode können Sie Ihrem Katalog neue Produkte hinzufügen. Beachten Sie, dass dabei keine Produktbestände festgelegt werden – es wird lediglich das Produktprofil auf der Seite „Mein Unternehmen > Produkte” erstellt.
Produkt aktualisieren
Verwenden Sie diese Methode, um Produktdetails wie Kategorie, Name, Beschreibung, Preise und mehr zu aktualisieren.
Auch für Dienstleistungen führen wir vier neue Methoden ein.
Dienstleistungskategorien abrufen
Mit dieser Methode können Sie eine Liste der Dienstleistungskategorien Ihres Unternehmens mit deren Namen und IDs abrufen, die dann zum Erstellen oder Aktualisieren von Dienstleistungen verwendet werden kann.
Dienstleistungen abrufen
Verwenden Sie diese Methode, um eine Liste der Dienstleistungen abzurufen, einschließlich ihrer Kategorien, Maßeinheiten, Garantieangaben, Preise und mehr.
Dienst erstellen
Mit dieser Methode können Sie neue Dienste in Ihrem Konto erstellen.
Aktualisierungsdienst
Verwenden Sie diese Methode, um Details zu den Dienstleistungen Ihres Unternehmens zu aktualisieren, z. B. Namen, Preise, Kategorien, Maßeinheiten und mehr.
Bevorstehende Verbesserungen an der öffentlichen API RO App
Wir arbeiten bereits an neuen API-Methoden, mit denen Sie Kostenvoranschläge verwalten, Dienstleistungen und Produkte mit oder ohne Lagerabzug zu Bestellungen hinzufügen und Integrationen mit Online-Shops und Marktplätzen einrichten können.
In Kürze können Sie die API auch zum Erstellen, Bearbeiten, Schließen und Abrufen von Aufgaben verwenden.
Wenn Sie Fragen, Anregungen oder Kommentare zur öffentlichen API RO App haben, wenden Sie sich bitte per Chat an unser Support-Team.