> 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/voraussetzungen.md).

# Voraussetzungen

Voraussetzungen für den OTTO Market Connector in Business Central.

Richten Sie die Verbindung erst ein, wenn Business Central, der OTTO Market API-Zugang und die Stammdaten zusammenpassen. Die Installation der App erteilt keinen API-Zugang.

### Business Central

* Microsoft Dynamics 365 Business Central Online. Die App setzt die Anwendung **28.0** voraus und ist für die Cloud bestimmt.
* Eine Umgebung, in der Sie die App installieren und die Einrichtung öffnen dürfen.
* Die deutsche Oberfläche verwendet die Feldnamen in dieser Dokumentation.

Prüfen Sie die Einrichtung zuerst in einer Sandbox. Die Umgebung **Sandbox** und die Umgebung **Produktion** verwenden unterschiedliche API-Adressen. Details stehen unter [Einrichtung und Berechtigungen](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/einrichtung.md).

### Zugang zu OTTO Market

Sie benötigen einen freigegebenen Zugang zum Partner-Connect-Portal für OTTO Market:

* **Client ID** und **Client Secret**
* im Modus **Service Partner** zusätzlich **App ID** und **Installation ID** der angebundenen Installation
* OAuth Scopes, die zu den Funktionen passen, die Sie nutzen wollen

Die App fordert diese Scopes an, sofern sie in der Einrichtung stehen. Beim ersten Öffnen werden fehlende Scopes ergänzt:

`orders` `shipments` `returns` `availability` `products` `receipts` `returns-warehouse-read` `returns-warehouse-write` `price-reduction`

Ein Scope in dieser Liste bedeutet, dass die App ihn beim Tokenabruf mitgibt. Ob OTTO Market ihn für Ihren Zugang freigibt, entscheidet die Freigabe im Portal. Fehlt ein Scope, schlägt die zugehörige Aktion fehl. Die Meldung steht im [API-Protokoll](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/api-protokoll.md).

### Stammdaten in Business Central

* Ein Debitor für OTTO Market-Bestellungen, oder eine Debitorvorlage, wenn pro Bestellung ein Debitor entstehen soll.
* Geschäftsbuchungsgruppe, MwSt.-Geschäftsbuchungsgruppe und Debitorenbuchungsgruppe, falls neue Debitoren ohne vollständige Vorlage entstehen.
* Ein Lagerartikel mit Produktbuchungsgruppe, MwSt.-Produktbuchungsgruppe, Lagerbuchungsgruppe und Basiseinheit. Diesen Artikel verwendet die App als Vorlage, wenn sie beim Bestellimport einen fehlenden Artikel anlegt.
* Lagerort, dessen Bestand gemeldet werden soll, und ein Bestandspuffer, der zu Ihrem Verkauf passt.
* Ein Sachkonto mit Direktbuchung, wenn Versandkosten als eigene Verkaufszeile entstehen sollen.
* Zusteller, die Sie in den gebuchten Lieferungen verwenden. Die Carrier-Zuordnung bezieht sich auf diese Zusteller.
* Firmendaten mit Ort, PLZ und Land. Die Versandmeldung übernimmt diese Angaben, wenn keine abweichenden Absenderwerte gespeichert sind.

### Berechtigungen

Weisen Sie der Person, die Zugangsdaten pflegt und die Synchronisation startet, den Berechtigungssatz **OTTO Market Administrator** zu. Die tägliche Bearbeitung kann zusätzlich den Berechtigungssatz **OTTO Market Anwender** erhalten. Die technische Zuordnung und die Unterschiede stehen unter [Einrichtung und Berechtigungen](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/einrichtung.md).

{% hint style="warning" %}
Client Secret, Access Token und Bild-Upload-Schlüssel gehören nur in die OTTO Market Einrichtung. Entfernen Sie sie aus Screenshots, Protokollen und Supportanfragen.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/voraussetzungen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
