Mauve-API

Einleitung

Die Mauve API (oder auch Mauve Admin API) bietet eine umfassende REST Schnittstelle zum verschlüsselten Austausch von Daten zwischen dem Mauve System3 und anderen Programmen.

Die API sollte verwendet werden, um Integrationen mit Systemen von Drittanbietern zu erstellen. Sie kann für Aufgaben verwendet werden, wie z.B.

• Synchronisation
• Automatisierung
• Integration

Sie wird durch Backend-Anmeldeinformationen geschützt, die nicht mit Endkunden geteilt werden dürfen.

Adressen

Die Basis-URL der Mauve API ist https://api.mauve.de/

Die Dokumentation der Endpunkt befindet sich unter https://api.mauve.de/swagger-ui

Testzugang

Mit den folgenden API Zugangsdaten können Sie die Mauve API testen. Als dahinterliegende System ist die Demo Version von Mauve System3 mit der Kunden-Nr. 0000000-K (https://demo.mauve.de)

Benutzername: demo
Passwort: demo

Info: Die Daten der Demo Version werden nächtlich zurückgesetzt. Bitte übertragen Sie keine sensiblen Daten!

Zugangsdaten

Um Zugangsdaten für ein spezielle Kundensystem zu erhalten schicken Sie bitte eine E-Mail an support@mauve.de mit dem Hinweis auf welche Kunden-Nr. Sie Zugriff benötigen und auf welche Bereiche der API.

Hinweis: Verwenden Sie bei Api-Calls einen Base64-Token (Beispiel: base64_encode("0000000-K_example" . ":" . "password") ) zur Autorisierung aus Benutzername:Passwort. Login per Benutzername und Passwort ist nur über die Swagger-UI möglich

Struktur

Die Mauve API ist in fünf Bereiche unterteilt:

• Artikel (englisch "Products") - Dieser Bereich stellt den lesenden Zugriff auf die Daten den Artikelstamms bereit und ermöglicht das Lesen und Schreiben von Artikelpreisen und -beständen
• Warengruppen (englisch "Categories") - Dieser Bereich ermöglicht den lesenden Zugriff auf den Warengruppenbaum, einzelne Warengruppen und die Artikel in einer Warengruppe
• Belege (englisch "Documents") - Dieser Bereich bietet den lesenden Zugriff auf die Informationen eines Belegs (dabei kann es sich um Vorbestellungen, Rechnungen, Lieferantenbestellungen usw. handeln)
• Aufträge (englisch "Orders") - Dieser Bereich ermöglicht es einen Kundenauftrag aus einem externen System an das Mauve System3 zu übergeben (dieser wird nach Prüfungen zu einem Beleg und ist danach über den Documents Endpunkt erreichbar)
• Portale (englisch "Portal") - Dieser Bereich stellt lesenden und schreibenden Zugriff auf die Preise, Bestände und Kundenaufträge in einem Mauve System3 Portalsystem bereit