This system creates a complete bidirectional synchronization between Odoo ERP and multiple marketplaces (eBay, Amazon, Shopify, etc.) through AdlerDo. Products flow from Odoo to marketplaces, stock updates are synchronized, and orders flow back to Odoo automatically.

System Architecture

Odoo ERP (Master Data Source) → AdlerDo (Integration Hub) → Marketplaces (eBay, Amazon, Shopify, etc.)

Complete Integration Cycle

• Products from Odoo: All products are fetched from Odoo ERP and saved in AdlerDo database. This includes product details, SKUs, descriptions, prices, and specifications.
• Stock Updates to Marketplaces: Stock quantities are fetched from Odoo and automatically uploaded to all connected marketplaces (eBay, Amazon, Shopify, etc.) to keep inventory synchronized.
• Orders from Marketplaces: Customer orders are captured from all marketplaces and saved in AdlerDo, then automatically sent to Odoo for fulfillment and processing.
• Products Sent to Odoo: Product updates and new products from AdlerDo are sent back to Odoo, completing the full synchronization cycle.

Four Main Synchronization Steps

Step 1: Products from Odoo to AdlerDo

What it does: The system fetches all products from your Odoo ERP system and saves them in AdlerDo's database. This creates a synchronized product catalog that can be distributed to multiple marketplaces.

What Information Gets Transferred?

1. Product Information

• Product name & title
• Product description
• SKU (Stock Keeping Unit)
• Barcode / EAN
• Product category

2. Pricing & Cost

• Sale price
• Cost price
• List price
• Currency
• Tax information

3. Product Details

• Product images
• Product variants
• Weight & dimensions
• Attributes & specifications
• Product type

Step 2: Stock Updates to Marketplaces

What it does: The system fetches current stock quantities from Odoo and automatically updates all connected marketplaces (eBay, Amazon, Shopify, etc.) to keep inventory synchronized in real-time.

What Information Gets Transferred?

1. Stock Information

• Available quantity
• Reserved stock
• Product SKU mapping
• Stock location
• Warehouse information

2. Marketplace Updates

• eBay inventory updates
• Amazon FBA/FBM stock
• Shopify inventory levels
• Other marketplace stock
• Multi-location support

3. Smart Features

• Safety stock buffer
• Prevent overselling
• Real-time synchronization
• Automatic calculations
• Low stock alerts

Step 3: Orders from Marketplaces to Odoo

What it does: The system captures all customer orders from connected marketplaces, stores them in AdlerDo, and automatically creates corresponding sales orders in Odoo for fulfillment.

What Information Gets Transferred?

1. Order Information

• Order number & ID
• Order date & time
• Order items & quantities
• Product SKUs
• Order total amount

2. Customer Details

• Customer name
• Email address
• Phone number
• Shipping address
• Billing address

3. Additional Data

• Payment method
• Shipping method
• Order notes
• Marketplace source
• Tracking information

Step 4: Products Sent to Odoo

What it does: Product updates, new products, and product information stored in AdlerDo are sent back to Odoo to keep the master database synchronized and complete the integration cycle.

What Information Gets Transferred?

1. Product Updates

• Updated product details
• Price modifications
• Description changes
• Attribute updates
• Image updates

2. New Products

• Create new products in Odoo
• Product variants
• Product categories
• Initial stock levels
• Pricing information

3. Sync Features

• Duplicate prevention
• Conflict resolution
• Data validation
• Error handling
• Audit logging

Complete Cycle Summary

This complete synchronization cycle ensures seamless data flow in all directions. Products flow from Odoo to marketplaces, stock is continuously synchronized, orders flow back to Odoo, and product updates complete the cycle. Everything happens automatically, creating a unified ecosystem across all your sales channels!

Why This Complete Cycle Matters

1. Full Automation Complete bidirectional sync eliminates all manual data entry

2. Single Source of Truth Odoo remains the master database for all product information

3. Real-time Sync All changes propagate instantly across all platforms

4. Scale Easily Add more marketplaces without additional complexity

AdlerDo

Download here

System Requirements

• RAM: 4GB or higher
• CPU: 2 vCPUs or more
• Storage: 40GB SSD or more

Step 1: ASP.NET Core 8.0

Link download

https://builds.dotnet.microsoft.com/dotnet/aspnetcore/Runtime/8.0.22/aspnetcore-runtime8.0.22-win-x64.exe

Project Structure / Application Files

• Backend Module – named: marketplace_api
• frontend Module – named: coresystem_wbf

Step 2: Install AdlerDo

• First install Marketplace Setup Api

Check the box to agree to the licenses, then click Install. Then wait for the installation to complete.

• After installation is complete, press finish.

It is essential to ensure, after installation, that the service is running in the background.

Step 3: Open the AdlerDo app

• Installation is complete. You can now enter your username and password.

Documentation for Marketplace Integration Setup

Accounts Integration (Connect and manage your marketplace and ERP accounts for seamless multi-channel selling)

AdlerDo Integration:

• Connect Marketplace accounts (Kaufland, Shopify, PrestaShop, JTL, etc.)
• Automatically synchronize products, inventory, and orders
• Provide centralized management for all sales channels from one place
• Save time and reduce manual errors

Integration Steps

Step 1: Access the Accounts Page

• From the left sidebar menu, click on " Accounts ."
• The " Accounts Integration " page will open.

Step 2: Select the Account Type / Marketplace

From the " Select " dropdown menu, choose the platform you want to integrate from the available marketplaces.

Step 3: Entering Credentials

You will need to enter the following information (it may vary slightly depending on the platform)

Step 4: Add a New Account

• On the Accounts Integration page, click the " Add New Account " button (the green button at the top right of the page).
• A popup window or a new page will appear for entering the account details.

Delete Account

This function lets you disconnect your Marketplace account.

After logging into your account, the Adlerdo page will appear.

What is the product management?

This interface is your control center for managing your product catalog and inventory within the Adlerdo system. It allows you to add, edit, import, and export products, then send them directly to the online marketplaces connected to your account.

1- Search Bar

Search for a specific product using its name, SKU, or any other information.

2- Marketplace and Account Selection Section

• Select Marketplace: Dropdown menu to select the online marketplace you want to work on (such as Amazon, Shopify, eBay, etc.).
• Select Account: Dropdown menu to choose the account linked to this marketplace (useful if you have multiple accounts on the same marketplace).
• Send to Marketplace button: After selecting the marketplace and account, click this button to send the selected products to the chosen marketplace.

3- Main Action Buttons

• Add: To manually add a new product
• Edit: To edit the details of selected products (at least one product must be selected).
• Dynamic Import Product: To dynamically import products from an external source (e.g., Excel file or API).
• Dynamic Import Variant: To dynamically import product variants (such as size, color, etc.).
• Export: To export the current product list to a file (Excel or CSV) for external use or backup

4- Product Table Columns Description

• Name: Product name (e.g., "Desk Combination", "headcall")
• SKU: Unique product identifier (Stock Keeping Unit) — required for synchronization
• Price: Product price (automatically updated on marketplaces when edited).
• GTIN / MPN / ASIN / UPC: Global product classification codes (important for marketplaces like Amazon and eBay).
• TaricCoc: European customs code (if applicable — important for international shipping).
• OriginCountry: Country of origin — required by some marketplaces
• Variants: Green button for each product to view or manage its variants (e.g., colors, sizes…).
• Gallery: Green button to view or add product images (typically for display on the marketplace).

The system provides powerful Dynamic Import and Export tools that allow you to manage your product data with maximum flexibility. These features support importing and exporting product information to and from any marketplace with ease.

Dynamic Import Product

The Dynamic Import Product feature allows you to upload product data from any file format or structure, without requiring a predefined template.

Key Capabilities

• Supports any sheet layout or column order (Excel, CSV, etc.).
• Automatically detects and maps your columns to the system fields.
• Allows importing large product catalogs in seconds.
• Suitable for syncing data from suppliers or external systems.

How to Use Dynamic Import Product

Step 1 — Open the Import Page

Go to:

Products → Import → Dynamic Import Product

Step 2 — Upload Your File

• Click import excel fill
• Select your file (Excel / CSV / any format)

The system supports any column structure—no need to rearrange anything.

Step 3 — Automatic Column Mapping

After uploading:

• The system will automatically detect column names
• It will map each column to the correct field (Name, SKU, Price, GTIN, etc.)

If the system is unsure about a column, it will ask you to select the correct field manually.

Step 4 — Review & Confirm

Check the mapping preview:

• Ensure columns are matched correctly
• Make adjustments if needed

Then click Confirm.

Step 5 — Upload

• Press upload.
• Your products will be created or updated instantly.

Perfect for supplier sheets, custom formats, or marketplace exports.

Download Import Template

When you click the green Download Import Template button → the system instantly downloads a ready-to-use Excel file named Product_Import_Template.xlsx

Where do you want to publish the imported products?

After importing products (whether from an Excel file or via Dynamic Import), this section is responsible for deciding exactly which marketplaces and seller accounts the products will be automatically published to as soon as the import is complete. If no marketplace or account is selected here → the products will be added to your catalog only and will NOT be published to any marketplace.

Step-by-Step Instructions

Step 1

• Action: From the first dropdown "Select Marketplace", choose the desired marketplace.
• Expected Result: The second dropdown "Select Account" updates and shows only accounts linked to that marketplace.

Step 2

• Action: From the second dropdown, choose the specific seller account you want to publish to.

Step 3

• Action: Click the orange button Add to List.
• Expected Result: The marketplace + account appear in the table below.

Step 4

• Action: Repeat steps 1–3 to add more marketplaces/accounts (if you want to publish to multiple places).
• Expected Result: Each new addition = imported products will be automatically published to that account too.

Step 5

• Action: To remove a marketplace/account from the list → click Delete in the table.
• Expected Result: That marketplace/account will no longer receive the imported products.

Step 6

• Action: When finished → click Upload Selected or Import at the bottom.
• Expected Result: Products are imported + instantly published to every marketplace and account listed in the table.

Important Note

If you leave the table empty (no marketplace or account added), the products will only be saved in your system and will not be published to any marketplace until you manually add them later from the individual product page.

Dynamic Import Variant

The Dynamic Import Variant feature allows users to upload variant data for products from any file format or structure—without requiring a predefined template.

This tool is designed to simplify importing variant-rich catalogs.

Key Features

• No fixed template required
• Automatically detects and maps file columns
• Smart system links variants to their parent products
• Supports unlimited variant attributes
• Ideal for suppliers, marketplace exports, or external system

How It Works

First: Upload Your File

1. Navigate to: Products → Import → Dynamic Import Variant
2. Click Upload File select

The system accepts any structure—columns can be in any order.

Second: Automatic Column Detection

Once uploaded:

• The system scans the sheet
• Detects relevant columns (SKU, Parent SKU, Size, Color, Price, etc.)
• Suggests field mappings automatically

If a column is unclear, the system will show a dropdown so you can choose the correct field manually.

Product Attributes Component

This component allows the user to assign attributes to a product by selecting an attribute name and a corresponding value, then adding them to a list.

Component Purpose

1. The Product Attributes section enables the user to: Select an attribute name, Select an attribute value related to that name.
2. Add the selected pair to the attributes list
3. Manage (edit/delete) attribute entries from a table

This ensures every product can have one or more attribute/value pairs that describe its variations.

Download Variants Button

The Download Variants button allows the user to download a ready-made Excel file that contains a template designed for entering the product's variant data.

This template helps the user prepare the data in the correct format before uploading it to the system.

Export button

The Export button allows users to download all products currently displayed in the Product Management screen—or only the selected products—in a clean and structured Excel file.

This file is generated instantly and contains the complete product data exactly as shown in the system's product table.

When the user clicks Export, the system:

Collects either:

• Only the selected products (if the user has checked specific rows).
• Generates an Excel file containing structured product information.
• Downloads the file immediately to the user's device.

Exported File Format

The exported Excel file includes all standard product fields such as:

• Product Name
• SKU
• Price
• GTIN
• MPN
• ASIN
• UPC
• Taric Code
• Origin Country
• Variants (if available)
• Any additional custom attributes displayed in the table

The file uses the same structure and columns as your product list inside the system, ensuring:

• Easy editing
• Easy re-importing using Dynamic Import
• Compatibility with all connected marketplaces

The Add New Product page allows you to easily add and manage products across various marketplaces. By entering essential product details and selecting your marketplace accounts, you can quickly list and update products on multiple platforms from a single location. This feature ensures seamless product uploads, variant management, and real-time synchronization with your marketplace accounts.

1- Click the green + Add button at the top left of the main actions bar

2- A product creation form will open

3- Marketplace Accounts in product creation

Marketplace Accounts

Step 1:

From "Select Marketplace" dropdown, choose the desired marketplace (e.g., Amazon)

Step 2:

The "Select Account" dropdown automatically refreshes and shows only accounts linked to the chosen marketplace

Step 3:

From "Select Account" dropdown, pick the specific seller account you want to use

Step 4:

Both marketplace and account are now selected

Step 5:

Click the orange button Add to List

Step 6:

A new row instantly appears in the "Selected Marketplace Accounts" table

4- Step-by-Step Usage (How Add New Variants and Add Attribute)

Step 1:

Click + New Variant (green button at top)

Step 2:

Fill Variant Name

Step 3:

Enter unique SKU

Step 4:

Set Price and Available Quantity for this variant

Step 5:

Click + Add Attribute → Select Attribute Type

Step 6:

Click Save Product

Category Management Guide

The Category Management section allows you to organize the products in your store by creating, editing, and deleting categories.

Accessing the Category Management Page

From the left sidebar, click on Categories as shown in the image.

You will be directed to the Category Management page, which includes:

1. An Add button to create a new category
2. An Edit button to modify a selected category
3. A Delete button to remove a selected category
4. A table displaying the names of the existing categories

Step 1: Adding a New Category (Add Category)

1. Click the Add button (the green button).
2. A form will appear allowing you to enter the category details:
   Name: the name of the category
3. After entering the information, click Save.
4. The new category will appear immediately in the table.

Step 2: Editing a Category (Edit Category)

From the categories table, select the category you want to edit (by clicking on it).

1. Click the Edit button (the orange button).
2. A form will appear showing the current category details.
3. Make the necessary changes.
4. Click Save to save the edits.

Step 3: Deleting a Category (Delete Category)

From the categories table, select the category you want to delete.

1. Click the Delete button (the red button).
2. A deletion confirmation alert will appear.
3. Click Confirm to complete the process.
4. The category will be removed from the list.

Track and manage customer orders.

The Order Management page allows you to view all customer orders, check payment status, display creation and shipping times, and open the details of each order.

From the sidebar on the left:

Click on Orders to access the Orders page.

Searching for Orders

• Use the search bar at the top of the page to search by order number.
• Type the order number and then click the search button (🔍).
• The system will display only the orders that match the search term.

Refreshing Data

• Click the Refresh button located at the top right of the page.
• This button retrieves the latest order data from the server.

Orders Table

The table displays all orders with the following columns:

1- Order Number

Displays the unique order number (e.g., #1057).

2- Status

Shows the status of the order (e.g., Paid).

3- Payment Method

Indicates the payment method used by the customer (e.g., Credit Card).

4- Creation Time

Displays the date and time when the order was created.

5- Shipping Time

Shows the order's shipping time (if available).

6- Order Details

Each row contains a Details button. Clicking it allows you to view the full details of the order.

Customer Management

The Customer Management section allows you to manage customer information and relationships in an organized and easy way.

From the left sidebar, click on Customers as indicated by the red arrow in the image.

You will be directed to the Customer Management page, which includes:

• A search box to find customers by name or number
• Add, Edit, and Delete buttons to manage customer information
• A table displaying the current customers with their names and numbers, along with a button to view each customer's address

Step 1: Adding a New Customer (Add Customer)

1. Click the Add button (the green button).
2. A window or form will appear for entering the customer's details:
   • Customer Name: the customer's name
   • Customer Number: the customer's number
   • Other information as required by the system (e.g., address, email, phone…)
3. After entering the details, click Save to add the customer.
4. The new customer will appear in the customer table.

Step 2: Editing Customer Information (Edit Customer)

1. Select the customer whose information you want to edit from the customer table (by clicking on their name).
2. Click the Edit button (the orange button).
3. A window will appear showing the customer's information.
4. Make the necessary changes.
5. Click Save to save the edits.

Step 3: Deleting a Customer (Delete Customer)

1. Select the customer you want to delete from the table.
2. Click the Delete button (the red button).
3. A deletion confirmation window will appear.
4. Click Confirm to complete the deletion.
5. The customer will be removed from the list.

The Log Entry Management module allows system administrators to monitor system activity and troubleshoot issues by reviewing detailed log entries.

Accessing the System Log Page

You can access the system log page from the sidebar:

Sidebar → Log Entries

(Highlighted inside a red box in the image)

Log Entries Table

The table displays all system log entries with the following columns:

• Log Message:

  • The text or type of the logged event (e.g., Product Variants).
  • Represents the type of activity or the item related to the log entry.

• Timestamp:

  • The date and time when the event was logged.
  • Shows the exact timing (e.g., 11/19/2025 1:10:40 PM).

• Action Name:

  • The type of action performed on the system (e.g., Modified indicates something was edited).

• User:

  • The name of the user or admin who performed the action.

The Users tab is used to manage system users by adding new users, editing the information of existing users, or deleting them.

Accessing the Users Tab

To start managing users, select Users from the sidebar. This will open the Users page, where all system users are listed.

There are three buttons at the top of the page for managing user data:

Adding a New User

Click the Add User button at the top of the page. A window will open with fields to fill out, including:

• Display Name
• User Name
• Email
• Phone Number
• Password

After completing the fields, click Save to add the new user to the system.

Editing an Existing User

Select the user you want to edit from the table and click Edit User. Update the necessary information and then click Save Changes to apply the updates.

Deleting a User

To delete a user, select them from the table and click Delete User. Confirm the deletion to permanently remove the account.

Tips for Managing Users

• Always double-check user information before saving changes.
• Use strong, secure passwords for all accounts.
• Regularly review and remove inactive or unnecessary users to keep the system clean.

This page is dedicated to managing customer order shipments, tracking their status, identifying the shipping company, and viewing the dates associated with each shipment.

Step 1: Accessing the Shipments Page

From the left sidebar, scroll down until you find "Shipping."

Click on it, and the Shipments Management page will open, as shown in the image.

Shipping Status – How to Use It Step by Step

First: Where Shipment Statuses Appear in the System

Shipment statuses appear on the Shipments Management page in the following location:

From the left-hand menu:

• Scroll down until you find Shipping
• Click on it

The Shipments Management page will open.

At the top of the page, you will find a section called Filters.

Inside the filters, there is a dropdown menu named: Shipping Status

When you click the dropdown menu, the following statuses will appear:

• Pending – Click this to view shipments that are still being prepared.
• Finished – Click this to view shipments that have been delivered or completed.
• Canceled – Click this to view shipments that have been canceled.

Step 2: Click the Filter Button

After selecting the status, click the green Filter button.

Step 3: View the Results

The table below will update and display only the shipments that match the status you selected.

Where the Shipping Carrier List Appears

From the Shipments Management page, above the shipments table, you will find the Filters section.

Within the filters, there is a dropdown menu titled Shipping Carrier.

Function of the Shipping Carrier List

It is used to select the shipping company for which you want to view shipments only.

How to Use the Shipping Carrier List

Click the dropdown menu next to Shipping Carrier.

You will see a list of available shipping companies, such as:

• All (to display all companies)
• DHL Internetmarke
• DB Schenker Land
• DB Schenker Air
• DB Schenker Ocean FCL
• DB Schenker Ocean LCL

Select the shipping company whose shipments you want to view only.

Filtering Shipments by Shipping Carrier

After selecting a shipping company, click the green Filter button next to the dropdown menus.

The shipments table will update to show only shipments using the selected shipping company.

Important Notes

• Selecting All in the dropdown displays shipments from all shipping companies without filtering.
• This feature helps you focus on a specific company's shipments quickly and easily.

Shipment Information Table

Below the filters, you will find a table containing shipment information, which includes the following columns:

This interface allows you to manage and link different shipping company accounts within the system, such as DHL and DB Schenker. Through it, you can add new accounts, edit them, delete them, or recharge the shipping wallet balance associated with the account.

1. Accessing the Carrier Accounts Page

From the left sidebar:

Select Carrier Accounts (highlighted in red in the image).

You will then see a list of available carriers under Connected Accounts.

2. Available Shipping Carriers

In the example, the following appear:

• DHL Internetmarke (highlighted in red)
• DB Schenker

When you click on any carrier, its management settings will be displayed.

3. DHL Account Management Page

When selecting DHL Internetmarke, the DHL account management page appears, which includes:

• Add Account (Green) – Add a new DHL account to the system
• Edit Account (Yellow) – Edit an existing account
• Delete (Red) – Delete an account from the system
• Charge Account Wallet (Orange) – Recharge the DHL account wallet balance

4. Accounts Table

Below the buttons, a table appears containing the registered DHL accounts.

Available columns:

• Username: The username of the DHL account
• Create Shipping List: Indicates whether a shipping list can be created for this account
• DPI: The required shipping label resolution
• Voucher Layout: The layout of the shipping label/policy

Currently, the table is empty because no account has been added yet.

Workflow Overview

➤ To add a new account:

When you click the Add Account button in the DHL account management interface, a new window appears allowing you to enter the new DHL account information along with settings related to printing and shipping.

Description of Key Fields

• Email and Password: The basic login credentials for the account. They must be entered accurately to ensure the system can connect to the DHL account.
• Create Shipping List: Specifies how many shipping lists will be created, useful when there are multiple shipments.
• DPI: Print resolution that determines the quality and clarity of the labels.
• Voucher Layout: The design or template of the shipping label that will be printed.
• Page Format, Width, Height, Page Type, Orientation: Detailed settings to control the size and layout of the print page.
• Space X, Space Y: The spacing between labels on the page.
• Count X, Count Y: The number of labels horizontally and vertically.
• Margin Top, Margin Left: Sets the top and left margins of the page to control the print position.

How to Use

1. Open the Add New DHL Account window by clicking the Add Account button.
2. Fill in the basic fields (Email and Password).
3. Adjust the printing settings according to your needs (DPI, Voucher Layout, page size, margins, etc.).
4. Click Save or Confirm (button not shown in the image but usually located at the bottom of the form) to save the new account.
5. After saving, the new account will appear in the DHL accounts list in the main window.

➤ To edit an account:

1. Select the account from the table
2. Click Edit Account
3. Modify the required information
4. Click Save

➤ To delete an account:

1. Select the account from the table
2. Click Delete

➤ To recharge the account balance:

1. Click Charge Account Wallet
2. Enter the recharge amount
3. Confirm the transaction

Steps to Create a DHL Account (the account that provides Email + Password)

Step 1 — Access the official DHL website

https://express-resources.dhl.com/mena-eng-sme-account-request.html

Step 2 — Click on Sign Up / Register

You will find a button such as:

• Register
• Create Account
• Or Business Login → Register

Step 3 — Choose the Account Type

DHL offers two types of accounts:

1. Personal Account (not suitable for API integration)
2. Business Account (required for system integration)

You should select: Business Account

Step 4 — Enter the Required Information

You will be asked to provide:

• Email
• Create a Password
• Company Information
• Mobile Number
• Your Address

Step 5 — Activate the Account

DHL will send you an email to confirm your account.

Step 6 — Log in with the New Account

After activation, you can log in to the DHL portal.

The DB Schenker system provides shipping services, allowing users to add and manage DB Schenker shipping accounts to facilitate their shipping operations.

Accessing the Shipping Accounts Section

From the left-side menu, click Carrier Accounts. This opens the Carrier Accounts Integration page.

Accessing the DB Schenker Account

Search for DB Schenker among the connected accounts. Click it to open the account management page.

Add Account Feature

The "Add Account" feature allows you to add a new DB Schenker account to manage your shipping operations efficiently.

Steps to Add a New Account

• Access the Account Management Page: From the side menu, select Carrier Accounts.
• Click Add Account: At the top of the DB Schenker Account Management page, click the green Add Account button.

• Fill in Account Information:
  • Access Key: Required field provided by DB Schenker
  • Measurement Type: Metric or Imperial
  • Unit of Measurement: Kilograms, Meters, Cubic Meters, Pieces

Adding a Shipping Method

Click Add Method and select a shipping method:

• Sea Freight
• Air Freight
• Land Freight

Click Save Changes to confirm, or Cancel to abort.

Edit Account

Once added, click the orange Edit Account button next to the DB Schenker account to update details.

Delete Account

Click Delete Account and confirm to permanently remove the account and all associated data.

Where Accounts Appear

Accounts are shown in the DB Schenker account management table, displaying:

• Account ID
• Access Key
• Measurement Type
• Measure Unit
• Methods Count
• Actions

Currently, the table is empty because no accounts have been added yet.

Seamless connection between your marketplace, AdlerDo, and Odoo

Welcome to Your Marketplace Integration

This system automatically connects your marketplace store with Odoo ERP through AdlerDo. Products, orders, and inventory are synchronized automatically, saving you time and reducing errors.

System Architecture

Marketplace: Your Online Store → AdlerDo: Integration Platform → Odoo: ERP System

Three Main Features

1-Product Synchronization

Marketplace → AdlerDo → Odoo

What it does: When you create or update a product in your marketplace, the system automatically creates or updates the same product in Odoo with all its details like name, description, price, SKU, images, and variants.

How It Works

Marketplace Product → AdlerDo → Odoo Product

What Information Gets Transferred?

Basic Information

• Product name & title
• Product description
• SKU (Stock Keeping Unit)
• Barcode / UPC
• Product type & category

Pricing & Financial

• Sale price
• Compare at price
• Cost per item
• Tax information
• Currency

Product Details

• Product images
• Product variants (size, color, etc.)
• Weight & dimensions
• Tags & collections
• Vendor information

Process Steps

1. Create or update product in your marketplace
2. AdlerDo captures and stores product data
3. Product created in Odoo automatically

2- Order Synchronization

Marketplace → AdlerDo → Odoo

What it does: When a customer places an order on your marketplace store, the system automatically creates the same order in Odoo with all customer details, ordered items, shipping address, and payment information.

How It Works

Marketplace Order → AdlerDo → Odoo Order

What Information Gets Transferred?

Customer Information

• Customer name
• Email address
• Phone number
• Customer ID
• Customer notes

Order details

• Order number
• Order items & quantities
• Product SKUs
• Order total amount
• Order date & time

Process Steps

1. Customer places order on your marketplace
2. AdlerDo captures and processes order
3. Order created in Odoo automatically

3- Inventory Update

Odoo → AdlerDo → Marketplace

What it does: When your inventory changes in Odoo (from sales, purchases, or adjustments), the system automatically updates the stock quantities on your marketplace products.

How It Works

Odoo Stock → AdlerDo → Marketplace Product

What Information Gets Transferred?

Stock Information

• Available quantity
• Reserved stock
• Product SKU
• Stock location
• Warehouse tracking

Inventory Updates

• Update quantity on your marketplace
• Show as "In Stock"
• Show as "Out of Stock"
• Track inventory status
• Multi-location support

Smart Features

• Safety stock buffer
• Prevent overselling
• Real-time updates
• Automatic calculations
• Low stock alerts

Process Steps

1. Stock changes in Odoo
2. AdlerDo saves and calculates new quantity
3. Marketplace inventory updated automatically

Summary

These three features work together to create a complete automation system. Your products and stock flow from your marketplace to Odoo, your orders flow from your marketplace to Odoo, and your inventory updates flow from Odoo back to your marketplace. Everything happens automatically without any manual work!

Why This Helps You

• Save Time: No more manual data entry or copying information between systems
• Reduce Errors: Automatic sync means no human errors or mistakes
• Real-time Data: Always have accurate, up-to-date information across all platforms
• Grow Faster: Handle more orders and products without extra work

Marketplace Integration System powered by AdlerDo

Automatic synchronization between marketplace and Odoo

© 2024 AdlerDo Integration Platform

AdlerDoo and Odoo Test Environment

This guide shows you how to connect your Amazon Seller Central account. Customer-specific information such as server URLs, usernames, email addresses, or company names has been intentionally hidden in the screenshots.

Important: Always use the login details that were sent to you separately and securely. Please do not send passwords or 2FA codes by regular email.

Part A – Connecting Amazon in AdlerDoo

Requirements

• Remote Desktop access to the provided virtual machine
• AdlerDoo username and password
• Amazon Seller Central login details
• Access to Amazon two-factor authentication / OTP, if required

Step 1: Search for Remote Desktop Connection

Open Windows Search and search for "Remote Desktop Connection". Then start the app.

Step 2: Open Remote Desktop and enter access details

In the "Computer" field, enter the VM URL that was sent to you separately. Then enter the username. After that, click "Connect".

Step 3: Enter the password

Enter the password for the virtual machine and confirm with "OK". The virtual machine will then open.

Step 4: Open the AdlerDoo program

On the desktop of the virtual machine, click the AdlerDoo program shortcut. Please do not open the browser here; open the AdlerDoo application.

Step 5: Log in to AdlerDoo

Log in using the AdlerDoo access details that were sent to you separately.

Step 6: Open Apps Management

After logging in, open the "Integrations" section from the menu on the left, then open "Apps Management".

Step 7: Create an Amazon account

In the "Management Amazon Account" section, click "Create Amazon Account".

Step 8: Log in to Amazon Seller Central

The browser will open the Amazon login page. Enter the Amazon Seller Central login details and confirm the two-factor authentication if required.

Step 9: Grant permissions

Follow Amazon's instructions and grant the requested permissions. After successful authorization, you will be redirected or receive a success message.

Step 10: Check the connection

Afterwards, check in AdlerDoo whether the Amazon account is shown as connected. If the connection is not displayed, refresh the view or inform support.

Part B – Connecting Amazon in the Odoo Test Environment

This section describes how to connect Amazon directly in the Odoo test environment. The Odoo test environment is usually already open in the browser inside the virtual machine.

Step 1: Open the Odoo test environment

Open the browser inside the virtual machine. The Odoo test environment should already be open. If not, use the Odoo test URL that was provided to you separately.

Step 2: Open Sales

In Odoo, click the "Sales" module.

Step 3: Open Configuration and Accounts

In Sales, open the "Configuration" menu at the top and select "Accounts" under "Amazon".

Step 4: Create a new Amazon account

Click "New" to create a new Amazon account in Odoo.

Step 5: Select the Amazon marketplace

In the "Home Marketplace" field, select the correct Amazon marketplace, for example "Amazon.de" for Germany.

Step 6: Start the connection

Click "Connect" or "Continue" to start the connection with Amazon.

Step 7: Log in to Amazon and allow permissions

Log in with the Amazon Seller Central account and confirm the requested permissions. If Amazon asks for an OTP or 2FA code, enter it.

Step 8: Check success

After authorization, you will return to Odoo. Check whether the Amazon account has been created and whether the connection status is correct.

Notes in Case of Problems

• If Amazon asks for an OTP code, the code must be provided by the account owner.
• If the Amazon login fails, please first check the username, password, and 2FA.
• If the connection is not visible after granting permission, refresh the page and check again.
• Always use the correct marketplace, for example Amazon.de for Germany.
• Access details should only be shared through a secure channel.

Step-by-step guide using Remote Desktop and AdlerDoo Apps Management

This guide explains how to connect an eBay seller account with AdlerDoo. All screenshots are anonymized and do not show customer-specific access data.

Before you start

• Use only the virtual machine and AdlerDoo login details provided via the secure access link.
• Have access to the eBay seller account that should be connected.
• Do not share the access data with third parties.
• If an error appears, take a screenshot and send it to us by email.

Step 1 – Open Remote Desktop Connection

On your Windows computer, open the Start menu, search for Remote Desktop Connection, and open the app.

Step 2 – Enter the virtual machine details

Click Show Options if needed. Enter the remote computer address and username from the secure access link, then click Connect.

Step 3 – Enter the virtual machine password

Enter the password from the secure access link and confirm with OK. Please make sure you use the correct credentials for the virtual machine.

Step 4 – Open AdlerDoo on the virtual machine

After the remote desktop session opens, start AdlerDoo on the virtual machine.

Step 5 – Sign in to AdlerDoo

Log in to AdlerDoo with the username and password provided via the secure access link.

Step 6 – Open Apps Management

In AdlerDoo, go to Integrations and then open Apps Management from the left menu.

Step 7 – Create the eBay connection

Scroll to Management eBay Account and click Create eBay Account.

Step 8 – Sign in to eBay and approve the connection

Sign in with the eBay seller account that should be connected. Follow the eBay authorization steps until the connection is completed and you are redirected back to AdlerDoo.

Overview

This documentation describes how to register and configure a Shopify Public App in the Shopify Dev Dashboard and integrate it into AdlerDo V6.1 for OAuth installation. The process produces a Client ID and Client Secret that AdlerDo uses to authenticate against any Shopify store installing the app.

Architecture context

AdlerDo exposes /api/shopify/install as the OAuth entry point. The Dev Dashboard app redirects every install request to this endpoint, which performs the OAuth code exchange, persists the access token in the tenant database, and registers required webhooks via Hangfire background jobs.

Prerequisites

Before starting, ensure:

• Access to the TecSee GmbH Shopify Organization with permission to manage apps
• AdlerDo middleware deployed and reachable over HTTPS at the public host configured for the target environment
• The endpoints /api/shopify/install and /api/shopify/callback are reachable and return valid responses
• A development store is available for end-to-end testing before promoting credentials to production
• The list of OAuth scopes required by AdlerDo has been finalized and stored in configuration

Step 1 — Open the App Development Page

Sign in to the Shopify Organization and navigate to Settings → Apps and sales channels → App development. Click the "Build apps in Dev Dashboard" button.

Important: Do NOT use the "Create an app" button under the Legacy custom apps panel. Legacy custom apps will stop working for new merchants on January 1, 2026.

Step 2 — Create a New App in the Dev Dashboard

The Dev Dashboard opens at dev.shopify.com/dashboard/{organizationId}/apps. Click the "Create app" button in the upper-right corner of the Apps list.

Step 3 — Choose a Creation Path and Set the App Name

Two creation paths are offered:

• Start with Shopify CLI — scaffolds a Node/Remix project locally. AdlerDo does not need this path.
• Start from Dev Dashboard — registers app metadata directly in the dashboard and immediately produces a Client ID and Secret. Use this path for AdlerDo.

Enter the app name (for example: AdlerDo) and click Create.

Naming convention

Use a stable, customer-facing name shown on the install consent screen. For TecSee, prefix per environment if needed: AdlerDo (Production), AdlerDo Staging, AdlerDo Dev.

Step 4 — Configure URLs, Webhooks Version and Scopes

After creation, the app opens on the Versions tab with a new draft version. This is where the install URL, webhooks API version, and scopes are defined.

6.1 App URL

Set App URL to the public AdlerDo install endpoint:

https://whlvm133440.wawihost.de/api/shopify/install

This URL is what Shopify redirects to when a merchant installs the app. AdlerDo's ShopifyInstallController reads the shop and hmac query parameters, validates the HMAC, and redirects to Shopify's OAuth grant page.

6.2 Embed app in Shopify admin

Leave the "Embed app in Shopify admin" checkbox enabled. AdlerDo serves an embedded admin UI inside the Shopify admin frame using App Bridge.

6.3 Preferences URL

Optional. Leave empty unless the app exposes a separate settings page outside the embedded experience.

6.4 Webhooks API version

Pin the webhooks API version explicitly. The example shows 2026-04, which is the version AdlerDo currently consumes. Bumping this value requires reviewing every webhook payload mapping.

6.5 Access scopes

Click "Select scopes" and tick the scopes AdlerDo requires. Keep the list to the minimum AdlerDo actually uses — merchants see the full list on the install consent screen.

The exact same list must also be persisted in AdlerDo configuration (appsettings.Shopify.json → Shopify:Scopes) because the install controller passes it as the scope query parameter. A mismatch will force re-installs.

Optional vs. required scopes

Optional scopes can be requested at runtime after install. AdlerDo treats all listed scopes as required during the initial install, so leave the Optional scopes block empty.

6.6 Redirect URLs

Add the OAuth redirect URL — the public URL of the AdlerDo OAuth callback:

https://whlvm133440.wawihost.de/api/shopify/callback

Add one redirect URL per environment. Shopify rejects the OAuth callback if the URL provided in the redirect_uri parameter is not on this whitelist.

Step 5 — Release the Version

After saving all fields, click Release at the bottom of the version page.

• Version name — a human-readable label. TecSee convention: alderdoo-{n} where n is the auto-incrementing release number
• Version message — a short changelog (e.g., "added read_locales scope", "bumped webhooks API to 2026-04")

Click Release. The new version becomes Active immediately and replaces the previous Active version for all new installs.

Scope changes after release

Adding a new scope to a released version does NOT automatically grant it on already-installed shops. The shop owner must approve a re-authorization. AdlerDo detects scope drift on each request and triggers a re-install redirect when needed.

Step 6 — Verify the Active Version

Open the Versions tab from the left sidebar. The most recently released version is marked with the green "Active" badge. All previous versions remain visible for audit purposes.

From this view you can click any historical version to inspect its configuration, useful when debugging an install on an older shop.

Step 7 — Retrieve Client ID and Secret

Open the Settings tab from the left sidebar. The Credentials block at the top exposes the Client ID and Secret.

9.1 Client ID

Public identifier. Safe to commit to configuration. Copy it via the clipboard icon and paste into AdlerDo configuration.

9.2 Client Secret

Sensitive. Treat as a credential. The secret is only displayed once when first generated; afterwards only the obscured form is shown. Use the eye icon to reveal it once for copying, then store it via the standard AdlerDo secret-storage path.

In AdlerDo, secrets for marketplace integrations are persisted AES-256 encrypted in the tenant DB through MarketplaceCredentialEncryptor.

9.3 Rotating the Secret

Click Rotate to generate a new secret. The previous secret is invalidated immediately. Coordinate the rotation with a deployment of the new secret to AdlerDo.

9.4 API contact email

Set this to a monitored mailbox (currently dev@tecsee.de). Shopify sends API deprecation notices and security advisories to this address.

Wiring the Credentials into AdlerDo

Once the Client ID and Secret are in hand, add the credentials to AdlerDo configuration.

10.1 Configuration

Add the following block to the environment-specific configuration:

"Shopify": {
  "ClientId": "1d15c8413f636e7cfda6f4402d9ef552",
  "ClientSecret": "<from Settings page>",
  "Scopes": "read_products,write_products,read_orders,write_orders,…",
  "WebhooksApiVersion": "2026-04",
  "InstallRedirectUrl": "https://whlvm133440.wawihost.de/api/shopify/callback"
}

10.2 Install flow

The end-to-end install handshake is:

1. Merchant clicks the install link → Shopify redirects to App URL with shop and hmac query parameters
2. AdlerDo /api/shopify/install validates the HMAC against the Client Secret and redirects to https://{shop}/admin/oauth/authorize with the configured scope list and a generated state nonce
3. Merchant approves the scopes on the Shopify consent screen
4. Shopify redirects to /api/shopify/callback with code, hmac and state parameters
5. AdlerDo validates the HMAC and the state nonce, then POSTs code + Client ID + Client Secret to https://{shop}/admin/oauth/access_token to receive the offline access token
6. The token is stored AES-256 encrypted against the tenant; webhook subscriptions and recurring sync Hangfire jobs are registered
7. AdlerDo redirects the merchant to the embedded admin URL

10.3 Verifying the install

After the handshake:

• Confirm a new ShopifyConnection entity exists in the tenant DB with non-null EncryptedAccessToken and the granted scope list
• Confirm the recurring jobs (SyncShopifyOrdersV2026, SyncShopifyProductsV2026) are registered in Hangfire under the new tenant identifier
• Trigger a test webhook from the Shopify admin and confirm AdlerDo handler processes it without HMAC errors

Appendix A — Common Scopes Used by AdlerDo

Appendix B — Troubleshooting

Install redirect returns 401 / Invalid HMAC

Cause: Client Secret in AdlerDo configuration does not match the secret in Settings, or the secret was rotated without redeploying.

Action: Copy the secret from the Dev Dashboard Settings page and redeploy.

OAuth callback returns 'redirect_uri is not whitelisted'

Cause: The callback URL is not present in the Redirect URLs field of the active version.

Action: Open the active version, add the URL, release a new version, retry the install.

Shop installs but no Hangfire jobs appear

Cause: The OAuth code exchange succeeded but the post-install bootstrap failed (e.g., tenant provisioning).

Action: Inspect AdlerDo logs around the install timestamp; the ShopifyInstallController emits an Information log per stage and an Error log with the offending step.

Webhook deliveries fail with HMAC errors

Cause: AdlerDo computed the webhook HMAC over a parsed payload instead of the raw body.

Action: Confirm the request middleware buffers the raw request body before model binding for /api/shopify/webhooks/* routes.

Merchant reports missing data after a scope addition

Cause: The shop was installed against an older version that did not include the scope.

Action: Trigger a re-install redirect — AdlerDo detects scope drift in ShopifyConnectionMiddleware and redirects to the install endpoint, where the merchant approves the new scope.

Posted 20 February, 2026
Updated 23 February, 2026

Connect Kaufland Global Marketplace API

This guide explains how to connect AdlerDo with the Kaufland Global Marketplace API. Once connected, AdlerDo can synchronize products, inventory, orders, and shipment information between your ERP (such as Odoo) and Kaufland.

Overview

By connecting AdlerDo to Kaufland via the official API, your system becomes capable of:

• Synchronizing product listings from your ERP to Kaufland
• Keeping stock levels up to date across systems
• Importing Kaufland orders automatically
• Sending shipment confirmations and tracking details back to Kaufland

This integration ensures a stable, automated data flow and reduces manual work.

Prerequisites

Before starting, make sure that:

• You have an active Kaufland Seller account
• You have access to the Kaufland Seller Portal
• You are allowed to manage API credentials in the seller account

Steps to Obtain Your Kaufland API Credentials

To connect AdlerDo with Kaufland, you must first obtain your API credentials from the Kaufland Seller Portal.

Step 1: Navigate to the API Settings

Open the following link in your browser:

https://sellerportal.kaufland.de/settings/api

From the left-side menu, navigate to:

Settings → Shop Settings → API

Step 2: View Your Current API Keys

In the Current API key section, you will see:

• Client key (Client ID) — masked for security
• Secret key (Client Secret) — masked for security

These values are hidden and cannot be revealed again for security reasons.

Step 3: Generate New API Keys (If Needed)

If you do not have valid credentials or need a new pair, click:

Generate new API keys

Important: Once new keys are generated:

• The old Client ID and Client Secret immediately become invalid
• Any existing integration using the old keys will stop working
• You must update AdlerDo with the new credentials

Step 4: Save Your New Credentials

After generating new keys:

• Copy the Client ID
• Copy the Client Secret
• Store both values securely

You will not be able to retrieve them again after leaving the page.

Connecting Kaufland to AdlerDo

After obtaining your API credentials, you can connect Kaufland inside AdlerDo.

Step 1: Select Account Type

From the dropdown menu next to Select, choose: Kaufland

Step 2: Enter Account Details

Fill in the following fields:

Account Name

Enter a distinctive name for this connection, such as "My Kaufland Store" or "Kaufland DE Account"

Client ID

Enter the Client ID obtained from your Kaufland account

Client Secret

Enter the Client Secret obtained from your Kaufland account

Step 3: Save and Connect the Account

After filling in all required fields, click the Add New Account button (green).

AdlerDo will attempt to establish a connection with the Kaufland Global Marketplace API using the provided credentials.

Step 4: Verify Connected Accounts

Once the connection is successful:

• Your Kaufland account will appear in the Connected Accounts list on the left side
• The account status confirms that AdlerDo is successfully connected to Kaufland

At this point, your system is ready to synchronize data.

What Happens After the Connection

After connecting Kaufland to AdlerDo:

• Product and stock synchronization can be enabled
• Orders placed on Kaufland are automatically imported into AdlerDo
• Orders are forwarded to your ERP for processing
• Shipment confirmations and tracking numbers can be sent back to Kaufland

All synchronization follows the standard AdlerDo Complete Sync Cycle.

Common Notes & Best Practices

After connecting Kaufland to AdlerDo:

• Always keep SKUs consistent between your ERP and Kaufland
• If synchronization fails, check whether API keys were regenerated
• Use secure storage for API credentials
• Re-connect the account immediately after changing API keys

This guide explains how to connect your PrestaShop store to AdlerDo using the Accounts Integration interface. Once connected, AdlerDo can synchronize products, inventory, orders, and other data between your PrestaShop store and your ERP system.

PrestaShop Integration Overview

By connecting PrestaShop with AdlerDo, you can streamline your e-commerce operations and ensure seamless data flow.

Key benefits include:

• Automatically sync product listings and updates
• Keep inventory levels accurate across systems
• Import PrestaShop orders into AdlerDo and your ERP
• Securely manage multiple PrestaShop accounts from a single interface

This integration ensures reliable and secure data flow with minimal manual intervention.

• Inventory Sync
• Order Import
• Multi-Store Management

Accessing Accounts Integration

The Accounts Integration tab can be accessed from the sidebar menu by selecting Accounts.

Step 1: Select Account Type

At the top of the page, use the dropdown menu Select to choose the type of account to link or manage, e.g.:

• PrestaShop (selected in the example)

Step 2: Account Actions

Add New Account

• Click the green button to add a new PrestaShop account to AdlerDo.

Delete Account

• Click the red button to delete the currently selected account.

⚠️ Deleting an account immediately stops synchronization for that connection.

Step 3: Account Settings

The Account Settings section allows you to create or edit a PrestaShop account connection.

Fields Description:

1. Account Name

Internal name in AdlerDo to distinguish multiple PrestaShop accounts. Example:

"PrestaShop – Main Store"

2. Base URL

The main website URL of your PrestaShop store. Example:

https://yourshopdomain.com

3. Token

API Token used for secure authentication between AdlerDo and PrestaShop

Step 4: Connected Accounts

The Connected Accounts panel is on the left side of the page. From here, you can:

• Select an account to edit its settings
• Delete an account if no longer needed

If no accounts are connected, the list will appear empty.

Step 5: Obtain Base URL and API Token from PrestaShop

Base URL

Public URL of your PrestaShop store. Example:

https://yourshopdomain.com

API Token:

Follow these steps:

1. Log in to the PrestaShop Back Office.
2. From the sidebar, navigate to Advanced Parameters → Webservice (API)
3. If the Webservice feature is not enabled, turn it on by selecting Enable PrestaShop Webservice
4. To create a new API key:
   • Click Add new webservice key or the plus (+) icon
   • A page for creating a new key will appear
   • Click Generate to create a random key (this is the Token)
5. Copy the generated key and store it securely
6. Assign the necessary permissions required by AdlerDo (read/write as needed)
7. Click Save to activate the key

⚠️ Important: Keep your API Token secure. If the token is regenerated, you must update it in AdlerDo immediately.

Connecting PlentyMarkets to AdlerDoo

Connect your PlentyMarkets (or PlentyONE) account to AdlerDoo in four simple steps. Once connected, AdlerDoo automatically syncs your products, categories, attributes, orders, and customer addresses between PlentyMarkets and Odoo.

Before you begin

• An active PlentyMarkets or PlentyONE account with REST API access.
• Your Base URL (for example: https://your-shop.plentymarkets-cloud01.com).
• A username and password for a user with REST API permissions.

Tip: Create a dedicated API user in PlentyMarkets for this integration. It is safer than using your admin account, and you can revoke access at any time without affecting other users.

Connect Plenty in four steps

STEP 1: Open Marketplace Accounts

In the AdlerDoo sidebar, go to Settings → Integrations → Marketplace Accounts.

STEP 2: Select Plenty

From the Select Marketplace dropdown at the top of the page, choose Plenty.

STEP 3: Click "Add New Account"

Click the green Add New Account button in the top-right corner of the page.

STEP 4: Enter your credentials and save

Fill in the four fields below with your PlentyMarkets credentials, then click Save. AdlerDoo will authenticate, store the access and refresh tokens automatically, and your account is connected.

Tip: AdlerDoo refreshes the access token in the background before it expires — you never need to manage tokens manually.

Verify the connection

Once connected, AdlerDoo begins syncing data automatically in the background. Use the screens below to confirm that products, orders, categories, attributes and customers have been pulled from your PlentyMarkets store.

1. Check the sync status

Open Settings → Integrations → Connection Sync. Plenty should appear in the list with a green Running indicator.

2. Browse synced products

Open Main → Products and filter by Plenty to see all products synced from your store, with their SKUs, prices, and identifiers (GTIN, MPN, ASIN, UPC).

3. Inspect product variants

Click Variants on any product row to open the variant detail window. Each variant shows its SKU, barcode, price, quantity and dimensions — everything that came across from PlentyMarkets.

4. Browse synced orders

Open Main → Orders and filter by Plenty to see all orders pulled from PlentyMarkets, including status, payment method, and timing.

5. Inspect order details

Click Details on any order row to open the order detail window with line items, quantities, prices, VAT and totals. Use the Gift and Custom tabs in the top-right of the popup to view gift options and customisation data.

6. Review synced categories

Open Main → Categories to see the full category tree imported from PlentyMarkets — the same hierarchy you use to organise products in your store.

7. Review synced attributes

Open Main → Attributes to view all product attributes (size, colour, material, brand, manufacturer, age group, pattern, gender, and so on) used to describe variations.

8. Review synced customers

Open Main → Customers to see customers pulled from PlentyMarkets. Each entry has a PLENTY-prefixed customer number that links it back to its source. Click View Address on any row to inspect the delivery and billing addresses on file.

What gets synced automatically

After the initial connection, AdlerDoo keeps the following in sync between PlentyMarkets and Odoo — no manual action needed:

• Products — including variations, sales prices, stock levels, and attribute values.
• Categories — the full category tree and hierarchy.
• Attributes — size, colour, material and other variation attributes.
• Orders — created in Odoo as sales orders.
• Customer addresses — linked to the corresponding orders and contacts.

Removing a connected account

To disconnect a Plenty account: select it from the Connected Accounts list on the left, then click the red Delete Account button in the top-right corner.

Need help?

For any issues or questions about the integration, please contact the AdlerDoo support team.

Navigating to the Integration Page

From the sidebar on the left:

Accounts → Sidebar Menu

(Shown inside a red box in the image)

Selecting the Integration System

At the top of the page, there is a dropdown menu: Select

Choose JTL from the list of available systems.

Account Settings (JTL Account Configuration)

After selecting JTL, three important fields will appear that must be filled out

1. Account Name

The name of the account you want to display inside the system.

This helps you easily identify the account in the future.

2. Client ID

The unique identifier for the JTL integration.

You obtain this value from your JTL control panel.

3. Client Secret

The secret key for the account.

It should be kept secure and never shared to ensure safety.

This key is used for authentication and linking both systems together.

Available Operations

A green button at the top right.

It adds a new JTL account after filling in the required information.

Delete Account

A red button at the top right.

It deletes the selected account from the list of linked accounts.

Connected Accounts

This section displays previously linked accounts (if any).

It makes it easy to select an account for review, editing, or deletion.

Steps to Retrieve Integration Data from JTL (Client ID & Client Secret)

1. Log in to the JTL Control Panel

Open your web browser, go to the JTL website, and log in using your account credentials.

2. Access Account Settings or General Settings

In the main control panel, look for an option like Settings or Configuration and click on it.

3. Locate the API, Integrations, or Apps Section

Within the settings page, find the section for external integrations, usually labeled as:

• API Access
• Integrations
• Apps or Developer Apps

4. Create a New App or Generate New API Keys

Click the button to create a new app or generate API credentials.

You may need to provide:

• App name
• Description
• Callback URL (if requested)

5. Obtain Client ID and Client Secret

After creation, you will see:

• Client ID: A unique number or text representing the application.
• Client Secret: The secret key associated with the Client ID.

Copy and store both securely.

6. Enter the Data in Your System's Integration Page

1. Go to the Accounts Integration page in your system.
2. Select JTL from the available systems.
3. Enter the Client ID and Client Secret in the corresponding fields.
4. Enter an Account Name for easy identification.

This section facilitates connecting your system with your MediaMarkt Marketplace account to enable product synchronization, orders, inventory management, and related integration operations.

Location within the System

Access this feature via:

Sidebar → Accounts → Accounts Integration

Then select MediaMarkt from the Select dropdown menu.

Account Settings

On the right side, complete the following fields to add a MediaMarkt account:

Control Buttons

• Add New Account: Green button to save a new MediaMarkt account after entering required details.

• Delete Account: Removes the selected account from your accounts list.

Connected Accounts

The left side displays all previously added MediaMarkt accounts. Select any account for editing or deletion.

General Steps to Obtain Integration Data

1. Log in to the MediaMarkt Seller Dashboard (Mirakl backend)

   • Open your browser and navigate to: https://mediamarktsaturn.mirakl.net/login

2. Sign in using your seller account credentials

   • Enter your username and password

3. Go to Account Settings or My Profile

   • Look for the API section or API Keys

4. Create a new API key or copy an existing one

   • Click Generate API Key if you don't have one
   • Copy an existing key if available

5. Record the Base URL for the MediaMarkt platform

   • The Base URL is typically the Mirakl API endpoint: https://mediamarktsaturn.mirakl.net/api

6. Use the Base URL and API Key (Token) in your system

   • Navigate to Accounts Integration in your system
   • Select MediaMarkt from the dropdown
   • Enter a suitable Account Name
   • Enter the Base URL
   • Enter the API Key (Token) you copied

7. Save the data and activate the integration

   • Click Add New Account to complete setup
   • Your system can now fetch orders, update products, and perform integration tasks

The Accounts Integration feature allows you to connect your Galaxus account with the system, enabling you to manage data, fetch orders, and update information automatically by entering your account integration credentials.

Integration Steps

1. Access the Accounts Integration section: From the sidebar, select Accounts.
2. Select Galaxus from the dropdown: In the Select dropdown menu, choose Galaxus.

Fill in the Account Details

• Account Name: Enter a name for the account to be identified within the system (e.g., My Galaxus Account).
• Client ID: Enter your Galaxus account's client identifier.
• Client Secret: Enter the client secret associated with your Galaxus account.

Save the Account

After entering the details, click the Save or Confirm Add button (depending on the system interface).

• Green button used to add a new account

Delete Account

1. Select an account from the Connected Accounts box.
2. Click the Delete Account button.
3. Confirm the deletion.

Connected Accounts

A box appears on the left displaying all Galaxus accounts that have been previously linked to the system. When you select any account from the list, its details will be displayed in the Account Settings section.

Galaxus API Credentials – How to Obtain Integration Keys

1. Log in to Your Galaxus Account

1. Open the Galaxus website.
2. Log in to the account you want to connect to the system.
3. Go to the API Settings page.

After logging in:

From the main menu, navigate to: Settings → Developer Settings → API Keys / Integrations

2. Create a New API Key

If you don't already have an existing key:

1. Click the button: Create API Key or Generate Credentials
2. A form will appear containing:
   • App Name / Integration Name → Enter an identifier such as:
     • TecSee Integration
     • Store Sync
   • Permissions → Select the permissions your system needs (e.g., Products – Orders – Inventory).
3. Click Save / Generate

Connect Odoo via Accounts Integration

The Accounts Integration page allows you to link AdlerDo with one or more Odoo accounts and manage them through a simple, clear, and secure interface. Once connected, AdlerDo can communicate directly with your Odoo system to synchronize products, inventory, orders, and operational data.

Odoo Integration Overview

Connecting Odoo to AdlerDo centralizes marketplace and shop operations inside Odoo.

Key benefits:

• Centralize marketplace and shop data inside Odoo
• Automate product, stock, and order synchronization
• Manage multiple Odoo instances from one interface
• Reduce manual operations and integration errors

This integration ensures a stable and scalable data flow with minimal manual intervention.

• Data Centralization
• Automated Sync
• Multi-Instance Control

Accessing the Accounts Integration Page

From the left sidebar menu, select Accounts

The Integration Accounts Management screen will appear, showing all account connections and settings.

Selecting the System to Connect

At the top section of the page, you will find a dropdown field labeled:

Select

At the top, use the dropdown field labeled Select to choose a system. Select Odoo to begin setup.

Managing Accounts

Add New Account

• Used to add a new Odoo account.
• After filling in all required fields, click Add New Account to save the connection.
• The account will appear under Connected Accounts on the left.

Delete Account

• Used to delete the currently selected Odoo account.
• Once deleted, synchronization for that account will stop immediately.

⚠️ Deleting an account does not affect data inside Odoo, only the connection.

Account Settings (Odoo)

When adding or editing an account, the following fields appear:

Fields Description

a. URL

Login URL of your Odoo instance. Example:

https://yourcompany.odoo.com

b. Account Name

Internal name to identify the Odoo account. Example:

"Odoo – Main ERP"

c. Database Name

The name of the Odoo database you want to connect to. This is required for authentication and data access.

d. User Name

Username or email of an Odoo user with sufficient permissions

e. Password

The password associated with the selected Odoo user account.

🔒 This information is handled securely and used only for authentication.

Managing Connected Accounts

Connected Accounts

The Connected Accounts section shows all previously added Odoo accounts. From here, you can:

• Select an account to edit its settings
• Delete an account if no longer needed

This makes it easy to manage multiple Odoo databases or environments (e.g., production and staging).

Steps to Fetch Integration Data from Odoo

Obtain the URL

Copy the login URL of your Odoo system. Example:

https://yourcompany.odoo.com

Obtain the Database Name

• Find the database name on the database selection page
• Or request it from your Odoo system administrator

Obtain the User Name

Use the username or email of an Odoo user with API access permissions.

Obtain the Password

Use the password associated with the selected Odoo user account.

Enter and Save the Data

1. Enter all required information on the Accounts Integration page
2. Review the details for accuracy
3. Click Add New Account to save the connection

Once saved, the Odoo account will appear under Connected Accounts and be ready for synchronization.

Best Practices

• Use a dedicated Odoo user for integrations
• Assign only required permissions for security
• Use clear account names for multiple databases
• Update credentials immediately if changed in Odoo

Security & Maintenance Tip: Limiting permissions and using dedicated integration users reduces unauthorized access risk and prevents accidental disruptions.

What is DATEV Integration?

This integration allows you to automatically send invoices from Odoo to your DATEV accounting system. Instead of manually uploading invoices, the system fetches them from Odoo, converts them to DATEV format, and uploads them automatically.

Step 1: Connect Your DATEV Account

Before sending invoices, you need to connect your DATEV account.

1. Call the login endpoint to get your DATEV login link
2. Open the link in your browser
3. Log in with your DATEV credentials
4. After successful login, you will see an "Authentication Successful!" page
5. Your DATEV account is now connected

Step 2: Verify Your Account

Check that your DATEV account is connected.

Sending Invoices to DATEV

Send by Date Range

• Send all invoices within a date range
• Download the invoices as xml or pdf in folder for upload to Datev manually

Checking Invoice Status

View All Invoices (Paginated)

Invoice Status Meanings

Handling Failed Invoices

Failed invoices are automatically retried up to 3 times. If an invoice still fails, manual intervention may be required.

Refreshing Your DATEV Token

Your DATEV access token expires periodically. The system handles this automatically during background processing. To manually refresh:

Important: If token refresh fails with an authentication error, you may need to reconnect your DATEV account by repeating Step 1.

Quick Reference

• Get Invoice XML Preview – Returns a dictionary of invoice ID to Base64-encoded XML.
• Fetch PDFs for Saved Invoices – If invoices were saved with metadata only (no PDF), fetch their PDFs

Background Upload Scenario

The metadata for invoices is saved in the AdlerDo database, then automatically uploads to DATEV in the background.