> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe.md). # OTTO Market Connector Einrichtung und tägliche Abläufe des solutioo OTTO Market Connectors für Microsoft Dynamics 365 Business Central. Verbinden Sie OTTO Market mit Microsoft Dynamics 365 Business Central. Der Connector unterstützt Sie beim Bestellimport, bei Artikel- und Bestandsdaten, Liefermeldungen und Retouren. Das Marketplace-Angebot ist ein **Kontaktangebot mit individuellem Preis**. Zugang, Einrichtung und Leistungsumfang stimmen Sie mit solutioo ab. ## Voraussetzungen * Microsoft Dynamics 365 Business Central Online ab Version 28.0 in einer deutschen Umgebung. * Ein freigegebener Zugang zur OTTO Market Partner API mit den Berechtigungen für die benötigten Funktionen. * Berechtigungen zur Installation der App und zur Einrichtung der Verbindung. * Abgestimmte Artikelzuordnungen sowie Verkaufs-, Buchungs- und Lagerorteinstellungen. {% hint style="info" %} Die Installation der App erteilt keine OTTO Market API-Berechtigungen. Die Verbindung und die verfügbaren Funktionen hängen von Ihrem freigegebenen API-Zugang ab. Prüfen Sie die Einrichtung zuerst in einer Sandbox. {% endhint %} ## Verbindung einrichten 1. Installieren Sie den **solutioo OTTO Market Connector**. Weisen Sie dem zuständigen Administrator den Berechtigungssatz **OTTO Market Administrator** zu. Seine technische Kennung ist `SOU Otto Admin`. 2. Öffnen Sie über die Business-Central-Suche **OTTO Market Einrichtung**. Wählen Sie **Umgebung** und **Authentifizierung**. Die Umgebung bestimmt die API-Basis-URL. 3. Tragen Sie **Client ID** und **Client Secret** Ihres freigegebenen Zugangs ein. Im Modus **Service Partner** ergänzen Sie **App ID** und **Installation ID**. Die OAuth Scopes müssen zu den genutzten Funktionen und der Freigabe Ihres Zugangs passen. 4. Hinterlegen Sie den Standarddebitor und die passenden Verkaufs- und Lagerorteinstellungen. Wenn Debitoren pro Bestellung angelegt werden sollen, prüfen Sie zusätzlich die Debitorvorlage und Buchungsgruppen. 5. Wählen Sie **Verbindung testen**. Die App prüft den Tokenabruf und liest eine Bestellung. Eine erfolgreiche Verbindung ersetzt keinen vollständigen Test Ihrer Verkaufs-, Versand- und Retourenabläufe. 6. Pflegen Sie die Artikel- und Carrier-Zuordnungen. Aktivieren Sie automatische Jobs erst nach einem erfolgreichen Test mit Sandbox-Daten. {% hint style="warning" %} Client-Secrets, Tokens und Bild-Upload-Schlüssel gehören ausschließlich in die vorgesehene Einrichtung. Entfernen Sie diese Angaben aus Screenshots, Protokollen und Supportanfragen. {% endhint %} ## Artikel und Bestand Öffnen Sie **OTTO Market Artikelzuordnungen** und verbinden Sie jede OTTO Market SKU mit dem passenden Business-Central-Artikel. Kontrollieren Sie Varianten und Lagerorte vor der ersten Bestandsübertragung. Unter **OTTO Market Artikel** sehen Sie Produktinformationen, Merkmale, Medien, Preise und den Marktplatzstatus. **Artikel laden** übernimmt die verfügbaren Produktdaten. Das Übertragen von Produktdaten setzt die entsprechende API-Berechtigung voraus. Für Produktbilder benötigen Sie zusätzlich den eingerichteten Bilddienst. Mit **Bestand senden** übertragen Sie die berechneten Mengen der zugeordneten Artikel. Prüfen Sie den **Standard-Lagerortcode** und den **Bestandspuffer**, damit die gemeldete Verfügbarkeit zu Ihrem Verkaufsprozess passt. ![OTTO Market-Produktdaten in Business Central mit SKU, EAN, Artikelzuordnung und Kategorie. Demodaten.](https://3843777504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZIRq5Om235i0xyZMTcyA%2Fuploads%2FpHcyIz49kYezz5rWlWHu%2F03-otto-market-produktdaten.png?alt=media) ## Bestellungen bearbeiten 1. Wählen Sie in der Einrichtung **Bestellungen importieren**. Der **Bestellstatus-Filter** bestimmt, welche Bestellungen abgerufen werden. 2. Öffnen Sie **OTTO Market Bestellungen** und kontrollieren Sie die importierten Positionen. Ergänzen Sie fehlende Artikelzuordnungen vor dem Erstellen des Verkaufsauftrags. 3. Erstellen Sie den Verkaufsauftrag aus der Bestellung. Je nach Einrichtung geschieht dies automatisch oder über die Aktion in der Bestellung. 4. Prüfen Sie den verknüpften Verkaufsauftrag und bearbeiten Sie ihn im üblichen Business-Central-Ablauf. ![OTTO Market-Bestellungen mit Lieferstatus, Verarbeitungsstatus und verknüpften Verkaufsaufträgen. Demodaten.](https://3843777504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZIRq5Om235i0xyZMTcyA%2Fuploads%2FfwV5DVjKPyHcnznM3AdK%2F01-otto-market-bestellungen.png?alt=media) ![OTTO Market-Bestelldetails mit Status, Verkaufsauftragsnummer und importierten Positionen. Demodaten.](https://3843777504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZIRq5Om235i0xyZMTcyA%2Fuploads%2FF91jSUcWGB0gRv7KL1jh%2F02-otto-market-bestelldetails.png?alt=media) ## Versand melden Nach dem Buchen der Verkaufslieferung können Sie die Lieferung an OTTO Market melden. Prüfen Sie zuvor die Carrier-Zuordnung und die erforderlichen Versanddaten, insbesondere die Sendungsnummer. Die Einrichtung bietet hierfür **Lieferungen melden**. Kontrollieren Sie anschließend die Antwort im **OTTO Market API-Protokoll**. Eine gebuchte Business-Central-Lieferung allein bestätigt noch keine erfolgreich übermittelte Versandmeldung. ## Retouren und Automatik **Retouren importieren** lädt die verfügbaren Retouren. Unter **OTTO Market Retouren** prüfen Sie Bestellung, Artikel und Mengen und führen die vorgesehene Annahme oder Ablehnung aus. Die verfügbaren Aktionen hängen vom Retourenstatus und den API-Berechtigungen ab. Mit **Job Queue anlegen** richten Sie die vorgesehenen Synchronisationsjobs in der Business-Central-Aufgabenwarteschlange ein. Aktivieren Sie nur die benötigten Abläufe, nachdem Verbindung, Zuordnungen und ein vollständiger Testablauf geprüft sind. Kontrollieren Sie regelmäßig die Aufgabenwarteschlange und das API-Protokoll auf Fehler. ## Fehler beheben | Problem | Prüfung | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Verbindungstest schlägt fehl | Umgebung, Authentifizierung, Client ID, Client Secret und Scopes prüfen. Im Service-Partner-Modus müssen App ID und Installation ID zur angebundenen Installation gehören. Details stehen im API-Protokoll. | | Verkaufsauftrag lässt sich nicht erstellen | SKU-Zuordnungen, Standarddebitor beziehungsweise Debitorvorlage sowie Buchungs- und Lagerorteinstellungen prüfen. Die Fehlermeldung der Bestellung lesen und danach erneut ausführen. | | Bestand wird abgelehnt | SKU-Zuordnung, API-Berechtigung, Lagerorteinstellungen und Marktplatzstatus prüfen. Die API-Antwort zeigt den konkreten Grund. | | Versandmeldung wird abgelehnt | Carrier-Zuordnung, Sendungsnummer und Bestellpositionen kontrollieren. Erst nach der Korrektur erneut melden. | | Automatik läuft nicht | Status und Fehlermeldungen der Aufgabenwarteschlange sowie die aktivierten Automatikoptionen in der Einrichtung kontrollieren. | ## Einrichtung und Support solutioo unterstützt Sie bei API-Zugang, Einrichtung und Ihren Abläufen in Business Central. [Kontakt zu solutioo aufnehmen](https://www.solutioo.de/kontakt/) oder [Jonah Schreiber per E-Mail kontaktieren](mailto:jonah.schreiber@solutioo.de). Nennen Sie bei Supportanfragen App-Version, Business-Central-Version, betroffene Aktion, Zeitpunkt und HTTP-Status beziehungsweise Fehlermeldung. Entfernen Sie Zugangsdaten und personenbezogene Daten aus den beigefügten Screenshots und Protokollen. Die Abbildungen zeigen echte Business-Central-Sandbox-Seiten mit Demodaten. Diese Anwendung ist eine eigenständige Integration von solutioo für OTTO Market. Stand: 6. Oktober 2026 · App-Version 1.1.13.0 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.