Mit der MarkOne API können Sie Ihr MarkOne-Konto sicher mit anderer Software verbinden, sodass Daten automatisch zwischen MarkOne und den Tools fließen, die Ihr Unternehmen bereits nutzt – ganz ohne manuelles Exportieren, Kopieren oder erneutes Eintippen.

Dieser Artikel gibt einen nicht-technischen Überblick darüber, was möglich ist. Wenn Sie (oder Ihr Entwickler) die vollständigen technischen Details benötigen, besuchen Sie unsere **[Entwicklerdokumentation](https://markone-docs.codemagic.app/)**.

---

## Was ist eine API?

Stellen Sie sich die API als eine sichere Tür zu Ihren MarkOne-Daten vor. Anstatt dass sich eine Person anmeldet und sich durch die Oberfläche klickt, kann eine andere Software MarkOne nach Informationen fragen (z. B. „gib mir die Verkäufe von gestern“) oder Informationen an MarkOne senden (z. B. „erstelle diese Bestellung“) – automatisch und in Echtzeit.

Genau das ermöglicht Integrationen: automatisierte Buchhaltung, individuelle Dashboards, Online-Shops, Treue-Apps und vieles mehr.

---

Die API bietet programmatischen Zugriff auf Ihre wichtigsten Geschäftsdaten. Aktuell können Sie mit folgenden Daten arbeiten:

- **Belege (Receipts)** – Rufen Sie Verkaufsbelege für einen beliebigen Zeitraum ab, z. B. für Buchhaltung oder Analysen.

- **Bestellungen (Orders)** – Erstellen, abrufen und aktualisieren Sie Kundenbestellungen automatisch.

- **Filialen (Shops)** – Rufen Sie Informationen zu Ihren Filialen und Standorten ab.

- **Artikel (Articles)** – Greifen Sie auf Ihren Produkt-/Artikelkatalog zu, inklusive Verfügbarkeit pro Filiale und Datum.

- **Rezepte (Recipes)** – Rufen Sie Rezeptinformationen ab.

- **Zutaten (Ingredients)** – Rufen Sie Informationen zu Zutaten ab.

Weitere Datentypen werden im Zuge der Weiterentwicklung der Plattform hinzugefügt.

---

Hier einige Beispiele dafür, was Unternehmen mit der API umsetzen:

- **Automatisierte Buchhaltung** – Übertragen Sie Verkaufs- und Belegdaten direkt in Ihre Buchhaltungs- oder ERP-Software und sparen Sie sich manuelle Exporte.

- **Individuelle Dashboards & Reporting** – Speisen Sie aktuelle Verkaufszahlen in Ihre eigenen Analyse-Tools oder BI-Dashboards ein.

- **Online-Bestellungen & Webshops** – Lassen Sie eine externe Website oder App Bestellungen direkt in MarkOne anlegen.

- **Katalog-Synchronisation** – Halten Sie Produkt-, Rezept- und Zutateninformationen über mehrere Systeme hinweg synchron.

- **Drittanbieter-Integrationen** – Verbinden Sie MarkOne mit Treueprogrammen, Lieferplattformen oder anderen spezialisierten Tools.

---

1. Ein **Systemadministrator** erstellt im Bereich **Marketplace** Ihres Kontos einen sicheren **API-Schlüssel**.

2. Dieser Schlüssel wird der Software oder dem Entwickler übergeben, die bzw. der die Verbindung herstellen soll.

3. Die verbundene Software kann anschließend in Ihrem Auftrag sicher auf Ihre MarkOne-Daten zugreifen und diese lesen oder schreiben.

Sie behalten die Kontrolle: Ein API-Schlüssel kann jederzeit durch Löschen im **Marketplace** widerrufen werden.

> **Sicherheitstipp:** API-Schlüssel gewähren vollen Zugriff auf Ihre Daten. Geben Sie sie nur an vertrauenswürdige Partner weiter und veröffentlichen Sie sie niemals öffentlich.

---

Die API richtet sich an **Entwickler** – entweder Ihr internes technisches Team oder einen externen Partner, der MarkOne mit einem anderen System integriert. Falls Sie selbst nicht technisch versiert sind, leiten Sie dieses Dokument einfach an die Person weiter, die Ihre Integration umsetzt.

---

Alle technischen Details – Authentifizierung, Endpunkte, Anfrageformate und Beispiele – finden Sie in unserer Entwicklerdokumentation:

👉 **[MarkOne Entwicklerdokumentation](https://markone-docs.codemagic.app/)**

Bei Fragen oder wenn Sie Unterstützung benötigen, wenden Sie sich einfach an unser Support-Team – wir helfen Ihnen gerne weiter.