← Back to EcomCentral
OTTO MARKET

OTTO Market Setup Guide

Connect your OTTO Market seller account to EcomCentral using the OTTO Partner Connect API.

Prerequisites

ℹ️ OTTO Market uses OAuth2 client_credentials grant — no user login flow is required. EcomCentral obtains a short-lived access token automatically per request using your client credentials.

Getting Your API Credentials

  1. Log in to OTTO Partner Connect at partner.otto.market
  2. Navigate to Einstellungen → API-Zugänge (Settings → API access)
  3. Click Neuen Zugang erstellen (Create new access) or select an existing one
  4. Copy your Client ID — it usually looks like a UUID
  5. Click Geheimnis anzeigen (Show secret) to reveal your Client Secret
  6. In EcomCentral, go to Connections → Add Connection, select Otto Market, and paste both values
  7. Click ⚡ Test on the connection card to verify authentication works
⚠️ Store your Client Secret securely. EcomCentral encrypts it with AES-256 before storing in the database. You will not be able to retrieve it from OTTO Partner Connect again after closing the dialog.

Credentials Reference

KeyRequiredDescriptionExample
client_id Required OAuth2 client identifier from OTTO Partner Connect a1b2c3d4-e5f6-…
client_secret Required OAuth2 client secret (treated as a password — never share it) s3cr3t…
✅ Only two credentials needed — the simplest setup of all marketplace integrations. No access token or refresh token is required; EcomCentral handles the OAuth2 flow transparently.

Position Item Fulfillment Statuses

Each line item (position item) in an OTTO order has its own fulfillment status.

ANNOUNCED
Order received — not yet processable
PROCESSABLE
Ready to be picked and shipped
SENT
Shipped — tracking info was submitted
RETURNED
Item returned by the customer
CANCELLED_BY_PARTNER
Cancelled by the merchant
CANCELLED_BY_OTTO
Cancelled by OTTO or buyer

Cancellation Reasons

When cancelling a position item you must supply one of the following reasons:

NOT_AVAILABLE

Out of stock / cannot fulfil

CUSTOMER_WISH

Customer requested cancellation

QUALITY_ISSUE

Product quality problem

WRONG_ITEM

Wrong item picked

ITEM_DISCONTINUED

Product no longer available

OTHER

Any other reason

Supported Features

FeatureSupportedNotes
View orders list✅Paginated with fulfillment status filter
View order details✅Delivery address, position items, prices
Send tracking / create shipment✅Carrier + tracking number → SENT
Cancel position item✅Per-item, with reason code selection
View products✅Via adapter products list (paginated)
View stock quantities✅Via /quantities endpoint
Update stock quantity✅Single SKU → immediate updateQuantity
Sandbox environment✅Set environment = sandbox on the connection
Test connection✅Via standard adapter Test button

Sandbox / Testing Environment

OTTO provides a sandbox environment at sandbox.api.otto.market. To use it:

  1. Create a separate connection in EcomCentral and set Environment = sandbox
  2. Use sandbox credentials (issued separately by OTTO via Partner Connect sandbox portal)
  3. Sandbox orders and products are test data — no real orders are affected
ℹ️ The production and sandbox APIs use different base URLs and different credentials. Do not mix production client secrets with the sandbox environment.

Troubleshooting

✕ 401 Unauthorized

The client_id or client_secret is incorrect, or the credentials have been revoked. Re-generate credentials in OTTO Partner Connect and update the connection.

✕ 403 Forbidden

Your API client does not have the required scope for this operation. Contact your OTTO partner manager to enable additional API scopes.

✕ 404 on order_detail

The salesOrderId does not exist in your seller account. Confirm you are using the correct environment (production vs sandbox).

✕ Empty products or stock list

Products must be published in OTTO Market before they appear via the API. Stock quantities via /quantities only appear after at least one stock update has been made.