Connecting Otto.de
Connect Germany's #2 marketplace with OAuth2 client credentials and auto-subscribed webhooks.
About Otto.de
Before you start
- An approved Otto Partner Connect seller account at partner.otto.de
- API credentials from Partner Connect → API access: Client ID and Client Secret
- Scopes
quote,orders, andproductsenabled on your API client — ShipWave requires all three to function - German VAT (USt-ID) and Verpackungsgesetz (LUCID) registration on file with Otto
Connecting your account
- Go to Admin → Marketplace → Channels and click New Channel.
- Select Otto.de as the platform.
- Choose the Shopify store to use as the product source.
- Name the channel (e.g. “Otto DE”).
- Click Create Channel.
- Paste your Otto Client ID and Client Secret.
- Click Save Credentials. ShipWave performs an OAuth2 client_credentials exchange against
api.otto.market/v1/tokenand verifies all three scopes are present. - ShipWave automatically subscribes the channel to two webhooks:
order-status-changedandreturn-announced. You will see them confirmed in the Otto Partner Connect webhook settings.
How orders flow in
/v4/orders/{orderNumber}, and imports the order. Otto has a strict 2-business-day ship SLA from order receipt: ship later than that and your seller score drops, with repeated misses risking suspension. ShipWave shows a countdown timer on every Otto order so you do not lose track.Listings and inventory sync
POST /v3/products. Products match Otto’s catalog by EAN when possible; otherwise full attributes are required. Otto categories are very granular — fashion items require size charts, materials, and care instructions. Inventory and price updates use PATCH /v2/products/{productReference}. Listings go through Otto’s editorial review (usually 24-72 hours) before going live. See Listing statuses for the workflow.German descriptions and 19% VAT
Carrier mapping
- DHL — most common, standard for Otto orders
- DPD — for larger parcels
- Hermes — consumer-direct delivery, popular for furniture
- GLS — B2B and faster express
- UPS, DHL Express — international and expedited
Common issues
quote, orders, or products. Edit the client in Partner Connect and add the missing scope, then reconnect.“Webhook signature invalid” – your webhook signing secret was rotated in Otto’s portal. Reconnect the channel to re-subscribe.
“Product rejected in editorial review” – common causes: English-only content, missing size chart for apparel, missing material composition, low-resolution images. Otto provides a specific rejection reason; fix and resubmit.
“Order overdue” alert – the 2-business-day SLA fired. Ship immediately and add tracking; Otto excludes weekends and German public holidays from the count.
FAQs
More in ShipWave Channels
- ShipWave Channels overview
Sell on Amazon, eBay, Etsy, Walmart, and TikTok Shop from one dashboard.
- Getting started with ShipWave Channels
A quick-start guide to connecting your first marketplace and pushing your first listing.
- Connecting Amazon Seller Central
Complete guide to connecting your Amazon seller account via SP-API.
- Connecting eBay
Connect your eBay seller account to list products and manage orders.
- Connecting Walmart Marketplace
Connect your Walmart Seller Center account using API credentials.
- Connecting Etsy
Connect your Etsy shop to list handmade and vintage items.
- Connecting TikTok Shop
Connect your TikTok Shop to sell products directly through TikTok.
- Managing multiple channels
Best practices for managing multiple marketplace channels from one dashboard.
- Reconnecting and troubleshooting connections
How to fix connection issues and reconnect expired or failed marketplace channels.
- Creating marketplace listings
How to create individual listings for products on your marketplace channels.
- Bulk listing operations
Create, update, and manage listings in bulk for efficient catalog management.
- Understanding listing statuses
What each listing status means and how to handle status changes.
- Pushing and syncing listings
How to push listings to marketplaces and keep them in sync.
- Listing validation by platform
Platform-specific listing requirements and how to pass validation.
- Creating listing templates
Build reusable templates with variables for dynamic listing content.
- Mapping categories to marketplaces
How to map Shopify product types to marketplace category taxonomies.
- Required category attributes
Understanding and filling in marketplace-required attributes for each category.
- Setting up pricing rules
Control how Shopify prices translate to each marketplace with markup rules, rounding, and formulas.
- Advanced pricing formulas
Create custom pricing formulas for complex pricing scenarios.
- How inventory sync works
Understanding real-time and periodic inventory synchronization across channels.
- Inventory buffers and floors
Configure safety stock settings to prevent overselling on marketplaces.
- Preventing overselling
How ShipWave prevents overselling across multiple marketplace channels.
- Importing marketplace orders
How marketplace orders are automatically imported into ShipWave and Shopify.
- Fulfilling marketplace orders
How to fulfill marketplace orders through ShipWave and sync tracking back.
- Tracking sync to marketplaces
How tracking numbers are automatically pushed to marketplace platforms.
- Understanding sync logs
How to read and interpret sync logs for troubleshooting and monitoring.
- Troubleshooting sync issues
Common sync problems and how to fix them.
- Reusable marketplace listing templates
Define a title, description, and bullets once with variables for the parts that change, then bulk-apply across hundreds of listings per channel.
- Connecting Mirakl-powered marketplaces
Use one ShipWave adapter to sell on Tesco UK, B&Q, Argos, Walmart.fr, Fnac, and dozens of other Mirakl operators.
- Connecting Allegro
Connect Poland's #1 marketplace and reach ~200M monthly visitors via OAuth2.
- Connecting Bol.com
Connect the #1 marketplace in the Netherlands and Belgium via OAuth2 client credentials.
- Connecting Cdiscount
Connect France's #2 marketplace using your seller username and password.
- Connecting Kaufland Global Marketplace
Sell on 14 European storefronts (DE, AT, SK, CZ, PL, HR, RO, BG, EE, HU, LV, LT, SI, MK) from one ShipWave account.