Die Moss API gibt deinem Unternehmen direkten, programmatischen Zugriff auf deine Daten in Moss. Sie wird in der Regel von IT-Teams, Datenteams oder Implementierungspartnern genutzt, um Moss mit anderen Systemen zu verbinden, Workflows zu automatisieren und individuelles Reporting aufzubauen.
In diesem Artikel erfährst du:
Welche Daten sind verfügbar?
Die API bietet Zugriff auf zentrale Daten, mit denen Finanzteams täglich arbeiten. Dazu gehören Transaktionsdaten, buchhalterische Referenzdaten sowie Organisationsdaten in Moss.
Das vollständige Datenmodell von Moss findest du hier in der API-Dokumentation.
Daten | Beschreibung |
Ausgaben | Alle Kartentransaktionen, Rechnungen und Erstattungen, einschließlich Einzelnachweise, Beträge, USt, Status, Buchhaltungsdimensionen und Exportverlauf |
Kreditoren | Kreditorennamen, Banking-Details, standardmäßige Buchhaltungseinstellungen und Adressen. Du kannst über die API auch Kreditoren erstellen und aktualisieren. |
Kontenpläne | Die Schlüssel und Namen deiner Sachkonten, wie sie in Moss festgelegt wurden. |
Steuersätze | Alle Steuerschlüssel, Steuersätze und Länderzuweisungen. |
Kostenstellen und Dimensionen | Deine Kostenstellen, Kostenträger und alle benutzerdefinierten Buchhaltungsdimensionen mit den entsprechenden Werten. |
Teams und Abteilungen | Deine Organisationsstruktur, wie sie in Moss festgelegt wurde. |
Nutzer | Namen, E-Mail-Adressen und Rollen der Mitarbeiter |
Banktransaktionen | Geldbewegungen in deinen Moss-Wallets, einschließlich Saldobewegungen |
Dateien | Suche nach Dateien (Belege, Rechnungen), die an Ausgaben angehängt sind und lade sie herunter. |
Was kannst du mit der Moss API machen?
Kunden nutzen die Moss API, um Workflows und Reporting umzusetzen, die über Standardexporte hinausgehen.
Zu den typischen Anwendungsfällen gehören:
Reporting und Einblicke
Integrationen für das Projekt- und Job-Management
Integrationen für die Buchhaltungssoftware
Dokumentenabruf und -archivierung
Individuelles Finanzreporting und Kostenanalyse
Ersetze manuelle CSV-Exporte durch Live-Dashboards, die deine Daten aus Moss mit anderen Unternehmensdaten kombinieren.
Ziehe Ausgabendaten in Google BigQuery, Looker Studio oder Metabase und ermögliche jedem Kostenstellenverantwortlichen einen Self-Service-P&L-Drill-down – ganz ohne Warten auf Monatsberichte
Verbinde Moss mit deinem Projektmanagement-Tool, um die Profitabilität auf Projektebene zu verfolgen, indem du Ausgaben den entsprechenden Projekt-Kostenstellen zuordnest
Kombiniere Ausgabendaten mit Material- und Ressourcendaten, um Live-Ansichten von Cashflow, GuV pro Abteilung sowie den Abgleich von Bestellungen, Rechnungen und Zahlungen zu erstellen
Wie oft kann ich API-Daten abrufen?
Die API von Moss unterstützt einen nahezu Echtzeit-Zugriff. Deine Integration kann aktualisierte Daten so häufig abrufen, wie es innerhalb der definierten Rate Limits erforderlich ist. Viele Unternehmen entscheiden sich dennoch für eine regelmäßige Synchronisation nach Zeitplan, häufig täglich, abhängig von ihren individuellen Anforderungen.
Wichtige Endpunkte
Daten | Endpunkt | Beschreibung |
Ausgaben | | Kartentransaktionen, Rechnungen und Erstattungen mit vollständigen Buchhaltungsdaten (Beträge, Sachkonten, Steuersätze, Dimensionen, Status) |
Kontenpläne |
| Kostenpläne – die Sachkonten, auf die Ausgaben gebucht werden |
Kostenstellen und Dimensionen |
| Buchhaltungsdimensionen (Kostenstellen, Kostenträger, benutzerdefinierte Dimensionen) |
Kostenstellen und Dimensionen |
| Werte innerhalb einer Dimension (z. B. individuelle Kostenstellen oder Projektcodes) |
Teams |
| Teams – hilfreich, um Ausgaben nach Team zu gruppieren |
Abteilungen |
| Abteilungen – hilfreich für die Aggregation auf höherer Ebene |
Kreditoren |
| Stammdaten der Kreditoren – hilfreich für Analysen der Ausgaben nach Kreditor |
Nutzer |
| Nutzer – hilfreich für die Zuweisung von Ausgaben zu Einzelpersonen |
Alle Anwendungsfälle findest du hier in der API-Dokumentation.
Integrationen für das Projekt- und Job-Management
Dienstleistungsunternehmen, z. B. Agenturen, Beratungen oder Bauunternehmen, müssen Ausgaben häufig Kundenprojekten oder Aufträgen zuordnen. Über die API kannst du Projektstrukturen mit Moss synchronisieren und angereicherte Ausgabendaten für nachgelagertes Reporting abrufen.
Beispiele:
Erstelle über die API ein entsprechendes Dimensionselement in Moss, wenn in deinem Projektmanagement-Tool ein neues Projekt erstellt wird. So bleiben Projektlisten ohne manuelle Dateneingabe synchronisiert.
Rufe Ausgaben ab, die mit Projektcodes versehen sind, und lade sie in dein Data Warehouse, um Gewinn-und-Verlust-Ansichten pro Projekt zu erstellen.
Rufe Projekt- oder Kundencodes aus Ausgaben in Moss ab und erstelle präzise Kundenrechnungen auf Basis der tatsächlich angefallenen Kosten.
Wichtige Endpunkte
Daten | Endpunkt | Beschreibung |
Kostenstellen und Dimensionen |
| Erstelle einen neuen Dimensionswert (z. B. einen Projektcode) |
Kostenstellen und Dimensionen |
| Aktualisiere oder deaktiviere einen Posten einer Dimension |
Ausgaben |
| Rufe Ausgaben einschließlich ihrer Dimensionswerte ab, um zu bestimmen, zu welchem Projekt die jeweilige Ausgabe gehört |
Kostenstellen und Dimensionen |
| Führe verfügbare Dimensionen auf, um das entsprechende Projekt zu identifizieren |
Kostenstellen und Dimensionen |
| Führe alle Werte innerhalb einer bestimmten Dimension auf |
Alle Anwendungsfälle findest du hier in der API-Dokumentation.
Integrationen der Buchhaltungssoftware
Wenn dein ERP- oder Buchhaltungssystem nicht nativ von Moss unterstützt wird, kannst du über die API eine individuelle Datensynchronisierung aufbauen.
Beispiele:
Rufe genehmigte Ausgaben aus Moss ab und wandle sie in Journalbuchungen in deinem ERP um. Jede Ausgabe enthält das Sachkonto, den Steuersatz, Dimensionen und den Kreditor, die für eine vollständige Buchung erforderlich sind.
Übertrage Kreditorenlisten und Dimensionselemente aus deinem ERP nach Moss, damit die Ausgabenkontierung mit deinem Buchhaltungssystem konsistent bleibt.
Pflege Kreditorendaten systemübergreifend. Wenn ein Kreditor in Moss oder in deinem ERP erstellt oder aktualisiert wird, wird die Änderung an das jeweils andere System übertragen.
Wichtige Endpunkte
Daten | Endpunkt | Beschreibung |
Ausgaben |
| Ausgaben mit vollständigen Buchungsdetails zur Erstellung von Journal-Einträgen |
Ausgaben |
| Zuordnung zum Hauptbuch |
Steuersätze |
| Steuer- und USt-Sätze zur richtigen steuerlichen Behandlung |
Kreditoren |
| Kreditorendaten einschließlich Adressen und Zahlungsbedingungen |
Dateien |
| Suche nach Dateien (Belegen, Rechnungen), die an Ausgaben angehängt sind |
Dateien |
| Dateiinhalt herunterladen |
Kostenstellen und Dimensionen |
| Zuordnung von Positionen in Dimensionen in Moss (Kostenstellen, Projekte, usw.) |
Kreditoren |
| Erstelle einen neuen Kreditor |
Kreditoren |
| Aktualisiere einen bestehenden Kreditor |
Kostenstellen und Dimensionen |
| Erstelle eine neue Dimension |
Kostenstellen und Dimensionen |
| Erstelle eine neue Dimension (Kostenstelle, Projekt, usw.) |
Alle Anwendungsfälle findest du hier in der API-Dokumentation.
Dokumentenabruf und Archivierung
Rufe Belege, Rechnungen und andere an Ausgaben angehängte Dokumente für Archivierung, Compliance oder automatisierte Verarbeitung ab.
Beispiele:
Ziehe Belege und Rechnungen aus Moss in ein Dokumentenmanagementsystem, einschließlich vollständiger Metadaten, die jedes Dokument mit der zugehörigen Quelltransaktion verknüpfen.
Rufe Dokumentenstichproben für externe Prüfer programmgesteuert ab und ersetze so die manuelle Zusammenstellung.
Übergib Rechnungs-PDFs an ein LLM, um Daten zu extrahieren, Compliance-Prüfungen durchzuführen oder Duplikate zu erkennen.
Wichtige Endpunkte
Daten | Endpunkt | Beschreibung |
Dateien |
| Suche nach Dateien, die an Ausgaben angehängt sind |
Dateien |
| Lade Dateiinhalte herunter (PDF, Bilder) |
Ausgaben |
| Ausgabendaten einschließlich Referenzen für jeden Posten |
Alle Anwendungsfälle findest du hier in der API-Dokumentation.
So legst du los
Die API wird in der Regel von deinem IT- oder Datenteam verwendet. Der Einstieg umfasst in der Regel vier Schritte.
1. Definiere, was du brauchst
Lege zuerst fest, welche Systeme Daten aus Moss erhalten sollen und welche Daten diese Systeme benötigen. Das hilft dir dabei, zu entscheiden, welche Art von Integration du aufbauen möchtest und welche Endpunkte dein Team dafür verwenden muss.
2. Binde dein IT-Team oder deinen Integrationspartner ein
Teile deine Anforderungen mit deinem IT-Team, Datenteam oder Implementierungspartner. Sie sollten außerdem die Dokumentation zur Moss API prüfen, da sie alle Informationen enthält, die für die Einrichtung der Anbindung benötigt werden.
Wenn kein IT-Team oder Integrationspartner verfügbar ist, gibt es andere Möglichkeiten, Daten von Moss zu exportieren. Hier erfährst du mehr über diese Methoden.
3. API-Zugangsdaten anfordern
Dein Moss-Admin kann in den Einstellungen von Moss API-Zugangsdaten erstellen. Diese Zugangsdaten nutzt dein IT-Team, um die Verbindung einzurichten.
So erstellst du API-Keys:
Melde dich als Admin in deinem Moss-Konto an.
Navigiere zu „Einstellungen“ → „Unternehmenseinstellungen“ → „API-Keys“.
Klicke auf „API-Key generieren“.
Bestätige den Vorgang mit der mobilen Moss-App.
Speichere sowohl die Key ID (kid_) als auch den Secret Key (sk_) sicher.
Wichtig: Speichere Zugangsdaten sicher und gib sie niemals in clientseitigem Code preis.
Weitere Informationen zum Abrufen und Verwenden von Zugangs-Tokens findest du in unserer API-Dokumentation.
4. Testen und live gehen
Dein IT-Team baut und testet die Integration und stellt sie anschließend für den Live-Betrieb bereit.
Sicherheit und Zugriffskontrolle
Die Moss API ist darauf ausgelegt, deinem Unternehmen einen sicheren und kontrollierten Zugriff auf deine Daten in Moss zu ermöglichen.
Wichtige Sicherheitsmaßnahmen sind:
Nur authentifizierter Zugriff: Jede API-Verbindung erfordert sichere Zugangsdaten, die eindeutig deinem Unternehmen zugeordnet sind
Separate API-Zugangsdaten: API-Verbindungen nutzen eigene Zugangsdaten, getrennt von den Login-Daten deiner Mitarbeitenden. Es werden keine Passwörter geteilt.
Rate Limits: Die API begrenzt die Anzahl der Anfragen, um Missbrauch zu verhindern und eine stabile Performance sicherzustellen
Nachvollziehbare Aktivitäten: API-Aktivitäten werden protokolliert und sind jederzeit rückverfolgbar
Werden die Daten mit Dritten geteilt?
Nein. Über die API erhältst du ausschließlich Zugriff auf die Daten deiner eigenen Organisation und nur für Anwendungen, die du mit deinen Zugangsdaten ausdrücklich autorisiert hast. Moss gibt deine Daten über die API nicht an Dritte weiter.