Settings
Open Add-ons > Manage add-ons > OTTO Market Connector > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs and webhooks of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Secrets are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often stock and price are pushed, orders imported and shipments reported. |
| Status of imported orders | O | |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave a secret field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test uses the sandbox credentials and sandbox.api.otto.market (test data only); Live uses the live credentials and api.otto.market. |
| Client ID / Client secret | Credentials of the app you created in OTTO Partner Connect (API-Zugriff), one pair for the sandbox and one for live. The add-on requests a token with grant_type=client_credentials and the scopes products, availability, orders, shipments, returns and shipping-profiles; the token lasts 30 minutes and is renewed automatically. |
| Ship-from city and ZIP code (required) | The address your parcels leave from (country Germany). OTTO requires it on every shipment. |
| Shipping profile ID | Optional. The OTTO shipping profile assigned to every product you list. Empty = the first profile of your account. |
| Return carrier | DHL, GLS or Hermes. OTTO requires a return tracking key for every shipped item; the add-on sends this carrier with the tracking number of the shipment. |
| Condition of accepted returns | A (original packaging) to E (mistake). Sent when you press Approve on a return. |
| Product safety contact (GPSR) | Optional name, address, e-mail and phone of the manufacturer / product safety contact, sent with every product. |
OTTO has no webhooks in its public API, so there is no webhook secret or URL: orders and returns are pulled by the cron job.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_otto_market.cronhttps://your-store.example/index.php?dispatch=kv_otto_market.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own account.