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

# Einrichtung und Berechtigungen

Seller- und Service-Partner-Einrichtung sowie Berechtigungen für den OTTO Market Connector.

Öffnen Sie über die Suche **OTTO Market Einrichtung**. Die Seite legt beim ersten Öffnen einen Datensatz an, falls noch keiner existiert.

### Sandbox und Produktion

| Umgebung   | API-Basis-URL                     |
| ---------- | --------------------------------- |
| Sandbox    | `https://sandbox.api.otto.market` |
| Produktion | `https://api.otto.market`         |

Das Feld **Umgebung** setzt die **API-Basis-URL** und verwirft den gespeicherten Access Token. Die Vorbelegung eines neuen Datensatzes ist **Sandbox**.

Wechseln Sie erst auf **Produktion**, wenn Zuordnungen, ein Verbindungstest und die Abläufe, die Sie nutzen wollen, in der Sandbox geprüft sind. Sandbox und Produktion sind getrennte API-Zugänge. Daten, die Sie in der Sandbox laden, stammen nicht aus dem Produktivmarktplatz.

{% hint style="warning" %}
Eine erfolgreiche Sandbox-Verbindung gilt nicht für die Produktion. Tragen Sie für die Produktion die dort freigegebenen Zugangsdaten ein und führen Sie **Verbindung testen** erneut aus.
{% endhint %}

### Authentifizierung

Im Feld **Authentifizierung** wählen Sie einen von zwei Modi.

{% tabs %}
{% tab title="Seller (eigener API-Zugang)" %}
Der Modus **Seller (eigener API-Zugang)** holt das Access Token mit Ihrer **Client ID** und Ihrem **Client Secret**.

Pflichtfelder:

* **Client ID**
* **Client Secret**

**App ID** und **Installation ID** sind in diesem Modus nicht editierbar und werden nicht verwendet.
{% endtab %}

{% tab title="Service Partner" %}
Der Modus **Service Partner** ist die Vorbelegung. Die App holt zuerst ein Entwickler-Token und danach ein Installationstoken für die angebundene Installation.

Pflichtfelder:

* **Client ID**
* **Client Secret**
* **App ID**
* **Installation ID**

**App ID** und **Installation ID** lassen sich nur in diesem Modus bearbeiten. Beide Werte müssen zur Installation gehören, die OTTO Market für diesen Seller freigegeben hat.
{% endtab %}
{% endtabs %}

**OAuth Scopes** ist ein leerzeichengetrennter Text. Leeren Sie das Feld nicht, wenn Sie nicht bewusst weniger Rechte anfordern wollen. Fehlende Scopes aus der [Voraussetzungen](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/voraussetzungen.md) werden beim Öffnen der Einrichtung ergänzt. Jede Änderung an Umgebung, Authentifizierung, Client ID, Client Secret, App ID oder Installation ID verwirft den gespeicherten Token. Der nächste Aufruf holt ein neues Token.

**Schlüssel zuletzt aktualisiert** zeigt, wann Client ID oder Client Secret zuletzt geändert wurden. **Token gültig bis** ist nur lesbar. Den Token selbst geben Sie nicht ein.

### Verkauf

| Feld                                                                                                                   | Wirkung                                                                                                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Standard Debitor Nr.**                                                                                               | Debitor für importierte Bestellungen. Ist das Feld gefüllt, verwendet jede Bestellung diesen Debitor.                                                                     |
| **Debitor pro Bestellung anlegen**                                                                                     | Wirkt nur, wenn **Standard Debitor Nr.** leer ist. Dann entsteht pro Bestellung ein Debitor.                                                                              |
| **Debitorvorlagencode**                                                                                                | Buchungsgruppen aus der Debitorvorlage für neu angelegte Debitoren.                                                                                                       |
| **Standard Geschäftsbuchungsgruppe**, **Standard MwSt.-Geschäftsbuchungsgruppe**, **Standard Debitorenbuchungsgruppe** | Ersatz, wenn die Vorlage die jeweilige Gruppe nicht setzt.                                                                                                                |
| **Verkaufsauftrag automatisch erstellen**                                                                              | Ist beim neuen Datensatz eingeschaltet. Gilt für neu importierte Bestellungen.                                                                                            |
| **Verkaufsauftrag automatisch freigeben**                                                                              | Gibt den erstellten Verkaufsauftrag frei. Die Vorbelegung ist aus.                                                                                                        |
| **Versandkosten Sachkonto**                                                                                            | Sachkonto mit Direktbuchung. Nur wenn das Feld gefüllt ist und die Bestellung Versandkosten enthält, entsteht eine Verkaufszeile **OTTO Market Versandkosten**.           |
| **Standard-Lagerortcode**                                                                                              | Lagerort auf dem Verkaufsauftrag und Filter für die Bestandsmenge.                                                                                                        |
| **Bestandspuffer**                                                                                                     | Ganze Zahl ab 0. Wird von der gemeldeten Menge abgezogen. Siehe [Bestände und Puffer](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/bestand.md). |
| **Bestellstatus-Filter**                                                                                               | Vorbelegung `PROCESSABLE`. Steuert, welche Bestellungen **Bestellungen importieren** abruft.                                                                              |

### Bilder

**Bild-Basis-URL** ist die öffentliche Adresse, unter der OTTO Market Produktbilder abruft. Ist das Feld beim Öffnen der Einrichtung leer, setzt die App `https://ottomarket.solutioo.io`. **Bild-Upload-Schlüssel** ist maskiert und wird für **Bild hochladen** benötigt. Beide Felder erklären [Produktdaten und Bilder](https://docs.solutioo.de/otto-market-connector/einrichtung-und-ablaufe/produktdaten.md).

### Berechtigungssätze

| Berechtigungssatz             | Technische Kennung | Verwendung                                                                                                                               |
| ----------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **OTTO Market Administrator** | `SOU Otto Admin`   | Zugangsdaten, Verbindungstest, Bestand senden, Aufgabenwarteschlange und alle Connector-Seiten.                                          |
| **OTTO Market Anwender**      | `SOU Otto User`    | Lesen der Einrichtung und des Protokolls. Bearbeiten von Bestellungen, Retouren, Artikelzuordnungen, Preisnachlässen und Retourenlagern. |

Die technische Kennung brauchen Sie, wenn Business Central den Berechtigungssatz unter diesem Namen zuweist.

**OTTO Market Anwender** darf die Einrichtung nicht ändern und darf **Verbindung testen**, **Bestand senden** und die Aufgabenwarteschlange nicht ausführen. Mehrere Aktionen speichern außerdem den Zeitpunkt des letzten Laufs in der Einrichtung. Dafür ist Änderungsrecht an der Einrichtung nötig. Personen, die importieren, senden oder die Einrichtung pflegen, erhalten **OTTO Market Administrator**.

**Job Queue anlegen** schreibt Einträge in die Aufgabenwarteschlange von Business Central. Dafür brauchen Sie zusätzlich die Berechtigung, Aufgabenwarteschlangenposten anzulegen. Diese Tabelle ist in den beiden Berechtigungssätzen nicht enthalten.

Die Installation versucht, HttpClient-Anforderungen für die App zuzulassen. Blockiert die Umgebung die Aufrufe trotzdem, lautet die Meldung: *HTTP-Aufrufe sind blockiert. In der Erweiterungsverwaltung HttpClient-Anforderungen für OTTO Market Connector zulassen.*


---

# 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/einrichtung.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.
