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
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
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
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.
