For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Authentifizierung

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

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.

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.

OAuth Scopes ist ein leerzeichengetrennter Text. Leeren Sie das Feld nicht, wenn Sie nicht bewusst weniger Rechte anfordern wollen. Fehlende Scopes aus der Voraussetzungen 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.

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.

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.