本系统通过 AdlerDo 在 Odoo ERP 与多个市场平台（eBay、Amazon、Shopify 等）之间建立完整的双向同步。产品从 Odoo 流向各市场平台，库存更新保持同步，订单则自动回流至 Odoo。

系统架构

Odoo ERP（主数据源）→ AdlerDo（集成枢纽）→ 市场平台（eBay、Amazon、Shopify 等）

完整集成周期

• 来自 Odoo 的产品： 所有产品都从 Odoo ERP 获取并保存到 AdlerDo 数据库中。这包括产品详情、SKU、描述、价格和规格。
• 向市场平台推送库存更新： 库存数量从 Odoo 获取，并自动上传到所有已连接的市场平台（eBay、Amazon、Shopify 等），以保持库存同步。
• 来自市场平台的订单： 从所有市场平台捕获客户订单并保存到 AdlerDo 中，然后自动发送到 Odoo 进行履约和处理。
• 发送到 Odoo 的产品： 来自 AdlerDo 的产品更新和新产品会回传到 Odoo，从而完成整个同步周期。

四个主要同步步骤

步骤 1：产品从 Odoo 到 AdlerDo

功能说明： 系统会从您的 Odoo ERP 系统中获取所有产品，并将其保存到 AdlerDo 的数据库中。这将创建一个可分发到多个市场平台的同步产品目录。

哪些信息会被传输？

1. 产品信息

• 产品名称与标题
• 产品描述
• SKU（库存量单位）
• 条形码 / EAN
• 产品类别

2. 定价与成本

• 销售价格
• 成本价格
• 标价
• 货币
• 税务信息

3. 产品详情

• 产品图片
• 产品变体
• 重量与尺寸
• 属性与规格
• 产品类型

步骤 2：向市场平台推送库存更新

功能说明： 系统会从 Odoo 获取当前库存数量，并自动更新所有已连接的市场平台（eBay、Amazon、Shopify 等），以实时保持库存同步。

哪些信息会被传输？

1. 库存信息

• 可用数量
• 预留库存
• 产品 SKU 映射
• 库存位置
• 仓库信息

2. 市场平台更新

• eBay 库存更新
• Amazon FBA/FBM 库存
• Shopify 库存水平
• 其他市场平台库存
• 多地点支持

3. 智能功能

• 安全库存缓冲
• 防止超卖
• 实时同步
• 自动计算
• 低库存提醒

步骤 3：订单从市场平台到 Odoo

功能说明： 系统会捕获来自已连接市场平台的所有客户订单，将其存储在 AdlerDo 中，并自动在 Odoo 中创建相应的销售订单以供履约。

哪些信息会被传输？

1. 订单信息

• 订单编号与 ID
• 订单日期与时间
• 订单商品与数量
• 产品 SKU
• 订单总金额

2. 客户详情

• 客户姓名
• 电子邮件地址
• 电话号码
• 收货地址
• 账单地址

3. 附加数据

• 付款方式
• 配送方式
• 订单备注
• 市场平台来源
• 物流跟踪信息

步骤 4：发送到 Odoo 的产品

功能说明： 存储在 AdlerDo 中的产品更新、新产品和产品信息会回传到 Odoo，以保持主数据库同步并完成整个集成周期。

哪些信息会被传输？

1. 产品更新

• 更新的产品详情
• 价格修改
• 描述更改
• 属性更新
• 图片更新

2. 新产品

• 在 Odoo 中创建新产品
• 产品变体
• 产品类别
• 初始库存水平
• 定价信息

3. 同步功能

• 防止重复
• 冲突解决
• 数据验证
• 错误处理
• 审计日志

完整周期总结

这一完整的同步周期确保数据在各个方向上无缝流动。产品从 Odoo 流向市场平台，库存持续同步，订单回流至 Odoo，产品更新则完成整个周期。一切都自动进行，在您所有的销售渠道中构建出一个统一的生态系统！

为什么这一完整周期至关重要

1. 全面自动化 完整的双向同步消除了所有手动数据录入

2. 单一可信数据源 Odoo 始终是所有产品信息的主数据库

3. 实时同步 所有更改会即时传播到所有平台

4. 轻松扩展 无需增加额外复杂度即可接入更多市场平台

AdlerDo

在此下载

系统要求

• 内存： 4GB 或更高
• CPU： 2 个 vCPU 或更多
• 存储： 40GB SSD 或更多

步骤 1：ASP.NET Core 8.0

下载链接

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

项目结构 / 应用程序文件

• 后端模块 – 名称：marketplace_api
• 前端模块 – 名称：coresystem_wbf

步骤 2：安装 AdlerDo

• 首先安装 Marketplace Setup Api

勾选复选框以同意许可协议，然后点击"安装"。随后等待安装完成。

• 安装完成后，点击"完成"。

安装完成后，务必确保该服务在后台运行。

步骤 3：打开 AdlerDo 应用

• 安装已完成。您现在可以输入用户名和密码。

市场平台集成设置文档

账户集成（连接并管理您的市场平台和 ERP 账户，实现无缝的多渠道销售）

AdlerDo 集成：

• 连接市场平台账户（Kaufland、Shopify、PrestaShop、JTL 等）
• 自动同步产品、库存和订单
• 在一个位置对所有销售渠道进行集中管理
• 节省时间并减少人工错误

集成步骤

步骤 1：进入账户页面

• 从左侧边栏菜单中，点击" Accounts "。
• " 账户集成 "页面将会打开。

步骤 2：选择账户类型 / 市场平台

从" Select "下拉菜单中，从可用的市场平台中选择您要集成的平台。

步骤 3：输入凭据

您需要输入以下信息（可能会因平台不同而略有差异）

步骤 4：添加新账户

• 在 账户集成 页面上，点击" Add New Account "按钮（页面右上角的绿色按钮）。
• 将会出现一个弹出窗口或新页面，用于输入账户详细信息。

删除账户

此功能可让您断开与市场平台账户的连接。

登录您的账户后，将出现 Adlerdo 页面。

什么是产品管理？

此界面是您在 Adlerdo 系统中管理产品目录和库存的控制中心。它允许您添加、编辑、导入和导出产品，然后将它们直接发送到与您账户连接的在线市场平台。

1- 搜索栏

使用产品名称、SKU 或任何其他信息搜索特定产品。

2- 市场平台和账户选择区

• 选择市场平台： 下拉菜单，用于选择您要操作的在线市场平台（例如 Amazon、Shopify、eBay 等）。
• 选择账户： 下拉菜单，用于选择与该市场平台关联的账户（如果您在同一市场平台上有多个账户，此功能会很有用）。
• 发送到市场平台按钮： 选择市场平台和账户后，点击此按钮将所选产品发送到所选市场平台。

3- 主要操作按钮

• 添加： 手动添加新产品
• 编辑： 编辑所选产品的详细信息（至少必须选择一个产品）。
• 动态导入产品： 从外部来源（例如 Excel 文件或 API）动态导入产品。
• 动态导入变体： 动态导入产品变体（例如尺寸、颜色等）。
• 导出： 将当前产品列表导出为文件（Excel 或 CSV），以供外部使用或备份

4- 产品表列说明

• 名称： 产品名称（例如 "Desk Combination"、"headcall"）
• SKU： 唯一的产品标识符（库存量单位）——同步所必需
• 价格： 产品价格（编辑时会自动在市场平台上更新）。
• GTIN / MPN / ASIN / UPC： 全球产品分类代码（对于 Amazon 和 eBay 等市场平台很重要）。
• TaricCoc： 欧洲海关代码（如适用——对国际运输很重要）。
• OriginCountry： 原产国——某些市场平台要求提供
• 变体： 每个产品都有一个绿色按钮，用于查看或管理其变体（例如颜色、尺寸……）。
• 图库： 绿色按钮，用于查看或添加产品图片（通常用于在市场平台上展示）。

本系统提供功能强大的动态导入和导出工具，让您能够以最大的灵活性管理产品数据。这些功能支持轻松地在任何市场平台之间导入和导出产品信息。

动态导入产品

动态导入产品功能允许您从任何文件格式或结构上传产品数据，无需预先定义的模板。

主要功能

• 支持任何表格布局或列顺序（Excel、CSV 等）。
• 自动检测并将您的列映射到系统字段。
• 允许在几秒钟内导入大型产品目录。
• 适用于从供应商或外部系统同步数据。

如何使用动态导入产品

步骤 1 — 打开导入页面

前往：

产品 → 导入 → 动态导入产品

步骤 2 — 上传您的文件

• 点击 导入 Excel 填充
• 选择您的文件（Excel / CSV / 任何格式）

系统支持任何列结构——无需重新排列任何内容。

步骤 3 — 自动列映射

上传后：

• 系统将自动检测列名
• 它会将每一列映射到正确的字段（名称、SKU、价格、GTIN 等）

如果系统无法确定某一列，它会要求您手动选择正确的字段。

步骤 4 — 检查并确认

检查映射预览：

• 确保各列正确匹配
• 如有需要进行调整

然后点击 确认。

步骤 5 — 上传

• 按 上传。
• 您的产品将被即时创建或更新。

非常适合供应商表格、自定义格式或市场平台导出文件。

下载导入模板

当您点击绿色的"下载导入模板"按钮时 → 系统会立即下载一个名为 Product_Import_Template.xlsx 的现成 Excel 文件

您想将导入的产品发布到哪里？

导入产品后（无论是从 Excel 文件还是通过动态导入），此区域负责精确决定产品在导入完成后将自动发布到哪些市场平台和卖家账户。如果此处未选择任何市场平台或账户 → 产品将仅添加到您的目录中，而不会发布到任何市场平台。

分步说明

步骤 1

• 操作： 从第一个下拉菜单"选择市场平台"中，选择所需的市场平台。
• 预期结果： 第二个下拉菜单"选择账户"会更新，仅显示与该市场平台关联的账户。

步骤 2

• 操作： 从第二个下拉菜单中，选择您要发布到的特定卖家账户。

步骤 3

• 操作： 点击橙色按钮 添加到列表。
• 预期结果： 该市场平台 + 账户会出现在下方的表格中。

步骤 4

• 操作： 重复步骤 1–3 以添加更多市场平台/账户（如果您想发布到多个位置）。
• 预期结果： 每次新增 = 导入的产品也将自动发布到该账户。

步骤 5

• 操作： 要从列表中移除某个市场平台/账户 → 点击表格中的 删除。
• 预期结果： 该市场平台/账户将不再接收导入的产品。

步骤 6

• 操作： 完成后 → 点击底部的 上传所选 或 导入。
• 预期结果： 产品被导入 + 即时发布到表格中列出的每个市场平台和账户。

重要提示

如果您将表格留空（未添加任何市场平台或账户），产品将仅保存在您的系统中，不会发布到任何市场平台，直到您稍后从单个产品页面手动添加它们。

动态导入变体

动态导入变体功能允许用户从任何文件格式或结构上传产品的变体数据——无需预先定义的模板。

此工具旨在简化包含大量变体的目录的导入。

主要功能

• 无需固定模板
• 自动检测并映射文件列
• 智能系统将变体链接到其父产品
• 支持无限变体属性
• 非常适合供应商、市场平台导出文件或外部系统

工作原理

第一步：上传您的文件

1. 导航至：产品 → 导入 → 动态导入变体
2. 点击 上传文件选择

系统接受任何结构——列可以按任意顺序排列。

第二步：自动列检测

上传后：

• 系统扫描表格
• 检测相关列（SKU、父 SKU、尺寸、颜色、价格等）
• 自动建议字段映射

如果某列不明确，系统会显示一个下拉菜单，以便您手动选择正确的字段。

产品属性组件

此组件允许用户通过选择属性名称和相应的值，然后将它们添加到列表中，从而为产品分配属性。

组件用途

1. 产品属性区允许用户：选择属性名称、选择与该名称相关的属性值。
2. 将所选配对添加到 属性列表
3. 从表格中管理 （编辑/删除） 属性条目

这确保每个产品都可以拥有一个或多个描述其变化的属性/值配对。

下载变体按钮

下载变体按钮允许用户下载一个现成的 Excel 文件，其中包含一个专为输入产品变体数据而设计的模板。

此模板帮助用户在将数据上传到系统之前，以正确的格式准备数据。

导出按钮

导出 按钮允许用户将当前显示在 产品管理 界面中的所有产品——或仅所选产品——下载为一个整洁且结构化的 Excel 文件。

此文件即时生成，包含与系统产品表中所示完全一致的完整产品数据。

当用户点击 导出 时，系统会：

收集以下之一：

• 仅所选产品（如果用户勾选了特定行）。
• 生成包含结构化产品信息的 Excel 文件。
• 立即将文件下载到用户的设备。

导出文件格式

导出的 Excel 文件包含所有标准产品字段，例如：

• 产品名称
• SKU
• 价格
• GTIN
• MPN
• ASIN
• UPC
• Taric 代码
• 原产国
• 变体（如有）
• 表格中显示的任何其他自定义属性

该文件使用与系统内产品列表相同的结构和列，从而确保：

• 便于编辑
• 便于使用动态导入重新导入
• 与所有已连接的市场平台兼容

添加新产品页面让您能够轻松地在各个市场平台上添加和管理产品。通过输入基本的产品详情并选择您的市场平台账户，您可以从一个位置快速在多个平台上刊登和更新产品。此功能确保无缝的产品上传、变体管理以及与您市场平台账户的实时同步。

1- 点击主操作栏左上角的绿色 + 添加 按钮

2- 将打开一个产品创建表单

3- 产品创建中的市场平台账户

市场平台账户

步骤 1：

从"选择市场平台"下拉菜单中，选择所需的市场平台（例如 Amazon）

步骤 2：

"选择账户"下拉菜单会自动刷新，仅显示与所选市场平台关联的账户

步骤 3：

从"选择账户"下拉菜单中，选择您要使用的特定卖家账户

步骤 4：

现在市场平台和账户均已选定

步骤 5：

点击橙色按钮 添加到列表

步骤 6：

一个新行会立即出现在"已选市场平台账户"表格中

4- 分步使用说明（如何添加新变体和添加属性）

步骤 1：

点击 + 新变体（顶部的绿色按钮）

步骤 2：

填写变体名称

步骤 3：

输入唯一的 SKU

步骤 4：

为该变体设置价格和可用数量

步骤 5：

点击 + 添加属性 → 选择属性类型

步骤 6：

点击 保存产品

类别管理指南

类别管理部分允许您通过创建、编辑和删除类别来组织商店中的产品。

进入类别管理页面

从左侧边栏中，如图所示点击 Categories。

您将被引导至类别管理页面，其中包括：

1. 用于创建新类别的"添加"按钮
2. 用于修改所选类别的"编辑"按钮
3. 用于删除所选类别的"删除"按钮
4. 显示现有类别名称的表格

步骤 1：添加新类别（Add Category）

1. 点击 添加 按钮（绿色按钮）。
2. 将出现一个表单，让您输入类别详情：
   名称：类别的名称
3. 输入信息后，点击 保存。
4. 新类别会立即出现在表格中。

步骤 2：编辑类别（Edit Category）

从类别表格中，选择您要编辑的类别（点击它即可）。

1. 点击 编辑 按钮（橙色按钮）。
2. 将出现一个表单，显示当前的类别详情。
3. 进行必要的更改。
4. 点击 保存 以保存编辑。

步骤 3：删除类别（Delete Category）

从类别表格中，选择您要删除的类别。

1. 点击 删除 按钮（红色按钮）。
2. 将出现一个删除确认提示。
3. 点击 确认 以完成该操作。
4. 该类别将从列表中移除。

跟踪和管理客户订单。

订单管理页面允许您查看所有客户订单、检查付款状态、显示创建时间和发货时间，并打开每个订单的详情。

从左侧边栏：

点击 Orders 进入订单页面。

搜索订单

• 使用页面顶部的搜索栏按订单号进行搜索。
• 输入订单号，然后点击搜索按钮（🔍）。
• 系统将仅显示与搜索词匹配的订单。

刷新数据

• 点击页面右上角的 刷新 按钮。
• 此按钮会从服务器检索最新的订单数据。

订单表

该表格显示所有订单，包含以下列：

1- 订单号

显示唯一的订单号（例如 #1057）。

2- 状态

显示订单的状态（例如 已付款）。

3- 付款方式

指示客户所使用的付款方式（例如 信用卡）。

4- 创建时间

显示订单创建的日期和时间。

5- 发货时间

显示订单的发货时间（如有）。

6- 订单详情

每一行都包含一个"详情"按钮。点击它可以查看订单的完整详情。

客户管理

客户管理部分让您能够以有条理且简便的方式管理客户信息和客户关系。

从左侧边栏中，如图中红色箭头所示点击 Customers。

您将被引导至 客户管理 页面，其中包括：

• 一个 搜索框，用于按姓名或编号查找客户
• 添加、编辑 和 删除 按钮，用于管理客户信息
• 一个表格，显示当前客户的姓名和编号，以及一个用于查看每位客户地址的按钮

步骤 1：添加新客户（Add Customer）

1. 点击"添加"按钮（绿色按钮）。
2. 将出现一个窗口或表单，用于输入客户的详细信息：
   • 客户姓名： 客户的姓名
   • 客户编号： 客户的编号
   • 系统要求的其他信息（例如地址、电子邮件、电话……）
3. 输入详细信息后，点击"保存"以添加该客户。
4. 新客户将出现在客户表格中。

步骤 2：编辑客户信息（Edit Customer）

1. 从客户表格中选择您要编辑其信息的客户（点击其姓名即可）。
2. 点击 编辑 按钮（橙色按钮）。
3. 将出现一个窗口，显示该客户的信息。
4. 进行必要的更改。
5. 点击 保存 以保存编辑。

步骤 3：删除客户（Delete Customer）

1. 从表格中选择您要删除的客户。
2. 点击 删除 按钮（红色按钮）。
3. 将出现一个删除确认窗口。
4. 点击 确认 以完成删除。
5. 该客户将从列表中移除。

日志条目管理模块允许系统管理员通过查看详细的日志条目来监控系统活动并排查问题。

进入系统日志页面

您可以从侧边栏进入系统日志页面：

侧边栏 → Log Entries

（在图中以红框突出显示）

日志条目表

该表格显示所有系统日志条目，包含以下列：

• 日志消息：

  • 所记录事件的文本或类型（例如 Product Variants）。
  • 表示与该日志条目相关的活动类型或项目。

• 时间戳：

  • 事件被记录的日期和时间。
  • 显示确切的时间（例如 11/19/2025 1:10:40 PM）。

• 操作名称：

  • 在系统上执行的操作类型（例如 Modified 表示某项内容已被编辑）。

• 用户：

  • 执行该操作的用户或管理员的姓名。

用户选项卡用于管理系统用户，包括添加新用户、编辑现有用户的信息或删除用户。

进入用户选项卡

要开始管理用户，请从侧边栏中选择 Users。这将打开用户页面，其中列出了所有系统用户。

页面顶部有三个用于管理用户数据的按钮：

添加新用户

点击页面顶部的 添加用户 按钮。将打开一个窗口，其中包含需要填写的字段，包括：

• 显示名称
• 用户名
• 电子邮件
• 电话号码
• 密码

填写完这些字段后，点击 保存 将新用户添加到系统中。

编辑现有用户

从表格中选择您要编辑的用户，然后点击 编辑用户。更新必要的信息，然后点击 保存更改 以应用更新。

删除用户

要删除某个用户，请从表格中选择该用户，然后点击 删除用户。确认删除以永久移除该账户。

管理用户的提示

• 在保存更改前，务必仔细核对用户信息。
• 为所有账户使用强健、安全的密码。
• 定期检查并移除不活跃或不必要的用户，以保持系统整洁。

此页面专用于管理客户订单的发货、跟踪其状态、确定配送公司，以及查看与每次发货相关的日期。

步骤 1：进入发货页面

从左侧边栏向下滚动，直到找到" Shipping "。

点击它，发货管理 页面将会打开，如图所示。

发货状态 – 分步使用方法

首先：发货状态在系统中出现的位置

发货状态出现在 发货管理 页面的以下位置：

从左侧菜单中：

• 向下滚动直到找到 Shipping
• 点击它

发货管理页面将会打开。

在页面顶部，您会找到一个名为 Filters 的区域。

在筛选器内，有一个名为 Shipping Status 的下拉菜单

当您点击该下拉菜单时，将出现以下状态：

• 待处理 – 点击此项可查看仍在准备中的发货。
• 已完成 – 点击此项可查看已送达或已完成的发货。
• 已取消 – 点击此项可查看已取消的发货。

步骤 2：点击筛选按钮

选择状态后，点击绿色的 Filter 按钮。

步骤 3：查看结果

下方的表格将更新，仅显示与您所选状态匹配的发货。

配送承运商列表出现的位置

在发货管理页面上，发货表格的上方，您会找到 Filters 区域。

在筛选器内，有一个名为 Shipping Carrier 的下拉菜单。

配送承运商列表的功能

它用于选择您想仅查看其发货的配送公司。

如何使用配送承运商列表

点击 Shipping Carrier 旁边的下拉菜单。

您将看到可用的配送公司列表，例如：

• 全部（显示所有公司）
• DHL Internetmarke
• DB Schenker Land
• DB Schenker Air
• DB Schenker Ocean FCL
• DB Schenker Ocean LCL

选择您想仅查看其发货的配送公司。

按配送承运商筛选发货

选择配送公司后，点击下拉菜单旁边绿色的 Filter 按钮。

发货表格将更新，仅显示使用所选配送公司的发货。

重要提示

• 在下拉菜单中选择 全部 将显示所有配送公司的发货，不进行筛选。
• 此功能可帮助您快速轻松地聚焦于特定公司的发货。

发货信息表

在筛选器下方，您会找到一个包含发货信息的表格，其中包括以下列：

列	功能
Order ID	发货的订单号
Shipping ID	发货自身的编号
Scheduled Date	发货的计划日期
Carrier Name	配送公司的名称
Status	发货状态
Odoo Delivery URL	该发货在 Odoo 中的跟踪链接
Action Details	发货动态的详情
Actions	用于对发货执行操作的按钮（取决于系统）

此界面允许您在系统内管理和链接不同的配送公司账户，例如 DHL 和 DB Schenker。通过它，您可以添加新账户、编辑账户、删除账户，或为与账户关联的配送钱包余额充值。

1. 进入承运商账户页面

从左侧边栏：

选择 Carrier Accounts（在图中以红色突出显示）。

随后您将在 Connected Accounts 下看到可用承运商的列表。

2. 可用的配送承运商

在此示例中，出现了以下承运商：

• DHL Internetmarke（以红色突出显示）
• DB Schenker

当您点击任一承运商时，将显示其管理设置。

3. DHL 账户管理页面

选择 DHL Internetmarke 时，将出现 DHL 账户管理页面，其中包括：

• 添加账户（绿色） – 向系统添加新的 DHL 账户
• 编辑账户（黄色） – 编辑现有账户
• 删除（红色） – 从系统中删除账户
• 为账户钱包充值（橙色） – 为 DHL 账户钱包余额充值

4. 账户表

按钮下方会出现一个表格，其中包含已注册的 DHL 账户。

可用的列：

• 用户名： DHL 账户的用户名
• 创建发货清单： 指示是否可为该账户创建发货清单
• DPI： 所需的运输标签分辨率
• 凭单版式： 运输标签/单据的版式

目前，该表格为空，因为尚未添加任何账户。

工作流程概览

➤ 添加新账户：

当您在 DHL 账户管理界面中点击"添加账户"按钮时，会出现一个新窗口，允许您输入新的 DHL 账户信息以及与打印和运输相关的设置。

关键字段说明

• 电子邮件和密码： 账户的基本登录凭据。必须准确输入，以确保系统能够连接到 DHL 账户。
• 创建发货清单： 指定将创建多少个发货清单，在有多次发货时很有用。
• DPI： 决定标签质量和清晰度的打印分辨率。
• 凭单版式： 将要打印的运输标签的设计或模板。
• 页面格式、宽度、高度、页面类型、方向： 用于控制打印页面尺寸和布局的详细设置。
• X 间距、Y 间距： 页面上标签之间的间距。
• X 数量、Y 数量： 水平和垂直方向上的标签数量。
• 上边距、左边距： 设置页面的上边距和左边距，以控制打印位置。

使用方法

1. 通过点击 添加账户 按钮打开 添加新 DHL 账户 窗口。
2. 填写基本字段（电子邮件 和 密码）。
3. 根据您的需要调整打印设置（DPI、凭单版式、页面尺寸、边距等）。
4. 点击 保存 或 确认（图中未显示该按钮，但通常位于表单底部）以保存新账户。
5. 保存后，新账户将出现在主窗口的 DHL 账户列表中。

➤ 编辑账户：

1. 从表格中选择账户
2. 点击 编辑账户
3. 修改所需信息
4. 点击 保存

➤ 删除账户：

1. 从表格中选择账户
2. 点击 删除

➤ 为账户余额充值：

1. 点击 为账户钱包充值
2. 输入充值金额
3. 确认交易

创建 DHL 账户的步骤（即提供 电子邮件 + 密码 的账户）

步骤 1 — 访问 DHL 官方网站

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

步骤 2 — 点击 注册 / 注册账户

您会找到一个类似这样的按钮：

• Register
• Create Account
• 或 Business Login → Register

步骤 3 — 选择账户类型

DHL 提供两种类型的账户：

1. 个人账户（不适合 API 集成）
2. 商业账户（系统集成所必需）

您应选择：商业账户

步骤 4 — 输入所需信息

系统将要求您提供：

• 电子邮件
• 创建密码
• 公司信息
• 手机号码
• 您的地址

步骤 5 — 激活账户

DHL 将向您发送一封电子邮件以确认您的账户。

步骤 6 — 使用新账户登录

激活后，您即可登录 DHL 门户。

DB Schenker 系统提供物流运输服务，允许用户添加和管理 DB Schenker 运输账户，以便更好地开展运输业务。

访问运输账户板块

在左侧菜单中，点击 Carrier Accounts（承运商账户）。系统将打开 **Carrier Accounts Integration（承运商账户集成）**页面。

访问 DB Schenker 账户

在已连接的账户中搜索 DB Schenker。点击它以打开账户管理页面。

添加账户功能

**"Add Account（添加账户）"**功能允许您添加新的 DB Schenker 账户，从而高效地管理您的运输业务。

添加新账户的步骤

• 访问账户管理页面： 从侧边菜单中选择 Carrier Accounts（承运商账户）。
• 点击添加账户： 在 DB Schenker 账户管理页面顶部，点击绿色的 **Add Account（添加账户）**按钮。

• 填写账户信息：
  • Access Key（访问密钥）： 由 DB Schenker 提供的必填字段
  • Measurement Type（计量类型）： 公制或英制
  • Unit of Measurement（计量单位）： 千克、米、立方米、件

添加运输方式

点击 **Add Method（添加方式）**并选择一种运输方式：

• 海运
• 空运
• 陆运

点击 **Save Changes（保存更改）**以确认，或点击 **Cancel（取消）**以放弃。

编辑账户

添加完成后，点击 DB Schenker 账户旁边橙色的 **Edit Account（编辑账户）**按钮以更新详细信息。

删除账户

点击 **Delete Account（删除账户）**并确认，即可永久删除该账户及其所有关联数据。

账户显示位置

账户显示在 DB Schenker 账户管理表格中，展示以下内容：

• Account ID（账户 ID）
• Access Key（访问密钥）
• Measurement Type（计量类型）
• Measure Unit（计量单位）
• Methods Count（方式数量）
• Actions（操作）

目前该表格为空，因为尚未添加任何账户。

在您的市场平台、AdlerDo 与 Odoo 之间实现无缝连接

欢迎使用市场平台集成

本系统通过 AdlerDo 自动将您的市场平台店铺与 Odoo ERP 连接起来。产品、订单和库存会自动同步，帮您节省时间并减少错误。

系统架构

市场平台：您的在线店铺 → AdlerDo：集成平台 → Odoo：ERP 系统

三大核心功能

1 - 产品同步

市场平台 → AdlerDo → Odoo

功能说明： 当您在市场平台中创建或更新产品时，系统会自动在 Odoo 中创建或更新相同的产品，并包含其全部详细信息，如名称、描述、价格、SKU、图片和变体。

工作原理

市场平台产品 → AdlerDo → Odoo 产品

会传输哪些信息？

基本信息

• 产品名称与标题
• 产品描述
• SKU（库存单位）
• 条形码 / UPC
• 产品类型与类别

定价与财务

• 销售价格
• 对比价格
• 单件成本
• 税务信息
• 货币

产品详情

• 产品图片
• 产品变体（尺寸、颜色等）
• 重量与尺寸
• 标签与系列
• 供应商信息

流程步骤

1. 在您的市场平台中创建或更新产品
2. AdlerDo 捕获并存储产品数据
3. 自动在 Odoo 中创建产品

2 - 订单同步

市场平台 → AdlerDo → Odoo

功能说明： 当客户在您的市场平台店铺下单时，系统会自动在 Odoo 中创建相同的订单，并包含所有客户详情、订购商品、收货地址和付款信息。

工作原理

市场平台订单 → AdlerDo → Odoo 订单

会传输哪些信息？

客户信息

• 客户姓名
• 电子邮件地址
• 电话号码
• 客户 ID
• 客户备注

订单详情

• 订单号
• 订单商品与数量
• 产品 SKU
• 订单总金额
• 下单日期与时间

流程步骤

1. 客户在您的市场平台下单
2. AdlerDo 捕获并处理订单
3. 自动在 Odoo 中创建订单

3 - 库存更新

Odoo → AdlerDo → 市场平台

功能说明： 当您在 Odoo 中的库存发生变化时（因销售、采购或调整），系统会自动更新市场平台产品的库存数量。

工作原理

Odoo 库存 → AdlerDo → 市场平台产品

会传输哪些信息？

库存信息

• 可用数量
• 预留库存
• 产品 SKU
• 库存地点
• 仓库跟踪

库存更新

• 更新您市场平台上的数量
• 显示为"有货"
• 显示为"缺货"
• 跟踪库存状态
• 支持多地点

智能功能

• 安全库存缓冲
• 防止超卖
• 实时更新
• 自动计算
• 低库存提醒

流程步骤

1. Odoo 中库存发生变化
2. AdlerDo 保存并计算新的数量
3. 自动更新市场平台库存

小结

这三项功能协同运作，构成一套完整的自动化系统。您的产品和库存从市场平台流向 Odoo，订单从市场平台流向 Odoo，而库存更新则从 Odoo 反向流回您的市场平台。一切都自动完成，无需任何人工操作！

这对您有何帮助

• 节省时间： 无需再在系统之间手动录入或复制信息
• 减少错误： 自动同步意味着不会出现人为失误或差错
• 实时数据： 在所有平台上始终掌握准确、最新的信息
• 更快增长： 无需额外工作即可处理更多订单和产品

由 AdlerDo 驱动的市场平台集成系统

市场平台与 Odoo 之间的自动同步

© 2024 AdlerDo Integration Platform

AdlerDoo 与 Odoo 测试环境

本指南将向您展示如何连接您的 Amazon Seller Central 账户。截图中已刻意隐去客户特定的信息，例如服务器 URL、用户名、电子邮件地址或公司名称。

重要提示： 请始终使用单独且安全地发送给您的登录凭据。请勿通过普通电子邮件发送密码或 2FA 验证码。

A 部分 —— 在 AdlerDoo 中连接 Amazon

前提条件

• 可通过远程桌面访问所提供的虚拟机
• AdlerDoo 用户名和密码
• Amazon Seller Central 登录凭据
• 如有需要，可访问 Amazon 双重身份验证 / OTP

步骤 1：搜索远程桌面连接

打开 Windows 搜索，搜索"Remote Desktop Connection（远程桌面连接）"。然后启动该应用程序。

步骤 2：打开远程桌面并输入访问信息

在"Computer（计算机）"字段中，输入单独发送给您的虚拟机 URL。然后输入用户名。之后点击"Connect（连接）"。

步骤 3：输入密码

输入虚拟机的密码，并点击"OK（确定）"进行确认。随后虚拟机将会打开。

步骤 4：打开 AdlerDoo 程序

在虚拟机的桌面上，点击 AdlerDoo 程序快捷方式。请勿在此处打开浏览器；请打开 AdlerDoo 应用程序。

步骤 5：登录 AdlerDoo

使用单独发送给您的 AdlerDoo 访问凭据登录。

步骤 6：打开应用管理

登录后，从左侧菜单中打开"Integrations（集成）"板块，然后打开"Apps Management（应用管理）"。

步骤 7：创建 Amazon 账户

在"Management Amazon Account（管理 Amazon 账户）"板块中，点击"Create Amazon Account（创建 Amazon 账户）"。

步骤 8：登录 Amazon Seller Central

浏览器将打开 Amazon 登录页面。输入 Amazon Seller Central 登录凭据，如有需要，请确认双重身份验证。

步骤 9：授予权限

按照 Amazon 的说明操作，并授予所请求的权限。授权成功后，您将被重定向或收到成功消息。

步骤 10：检查连接

之后，在 AdlerDoo 中检查 Amazon 账户是否显示为已连接。如果未显示连接，请刷新视图或通知支持团队。

B 部分 —— 在 Odoo 测试环境中连接 Amazon

本节介绍如何在 Odoo 测试环境中直接连接 Amazon。Odoo 测试环境通常已在虚拟机内的浏览器中打开。

步骤 1：打开 Odoo 测试环境

打开虚拟机内的浏览器。Odoo 测试环境应已打开。如果未打开，请使用单独提供给您的 Odoo 测试 URL。

步骤 2：打开销售模块

在 Odoo 中，点击"Sales（销售）"模块。

步骤 3：打开配置和账户

在销售模块中，打开顶部的"Configuration（配置）"菜单，并在"Amazon"下选择"Accounts（账户）"。

步骤 4：创建新的 Amazon 账户

点击"New（新建）"以在 Odoo 中创建新的 Amazon 账户。

步骤 5：选择 Amazon 市场平台

在"Home Marketplace（主站市场平台）"字段中，选择正确的 Amazon 市场平台，例如德国选择"Amazon.de"。

步骤 6：启动连接

点击"Connect（连接）"或"Continue（继续）"以启动与 Amazon 的连接。

步骤 7：登录 Amazon 并授予权限

使用 Amazon Seller Central 账户登录，并确认所请求的权限。如果 Amazon 要求输入 OTP 或 2FA 验证码，请输入。

步骤 8：检查是否成功

授权后，您将返回 Odoo。请检查 Amazon 账户是否已创建，以及连接状态是否正确。

遇到问题时的注意事项

• 如果 Amazon 要求输入 OTP 验证码，该验证码必须由账户所有者提供。
• 如果 Amazon 登录失败，请首先检查用户名、密码和 2FA。
• 如果授予权限后仍看不到连接，请刷新页面并重新检查。
• 请始终使用正确的市场平台，例如德国使用 Amazon.de。
• 访问凭据应仅通过安全渠道共享。

通过远程桌面和 AdlerDoo 应用管理进行的分步指南

本指南介绍如何将 eBay 卖家账户与 AdlerDoo 连接。所有截图均已匿名处理，不显示客户特定的访问数据。

开始之前

• 仅使用通过安全访问链接提供的虚拟机和 AdlerDoo 登录凭据。
• 确保可以访问需要连接的 eBay 卖家账户。
• 请勿将访问数据分享给第三方。
• 如果出现错误，请截屏并通过电子邮件发送给我们。

步骤 1 —— 打开远程桌面连接

在您的 Windows 计算机上，打开开始菜单，搜索 Remote Desktop Connection（远程桌面连接），然后打开该应用程序。

步骤 2 —— 输入虚拟机信息

如有需要，点击 Show Options（显示选项）。从安全访问链接中输入远程计算机地址和用户名，然后点击 Connect（连接）。

步骤 3 —— 输入虚拟机密码

从安全访问链接中输入密码，并点击 OK（确定）进行确认。请确保您为虚拟机使用了正确的凭据。

步骤 4 —— 在虚拟机上打开 AdlerDoo

远程桌面会话打开后，在虚拟机上启动 AdlerDoo。

步骤 5 —— 登录 AdlerDoo

使用通过安全访问链接提供的用户名和密码登录 AdlerDoo。

步骤 6 —— 打开应用管理

在 AdlerDoo 中，前往 Integrations（集成），然后从左侧菜单打开 Apps Management（应用管理）。

步骤 7 —— 创建 eBay 连接

滚动至 Management eBay Account（管理 eBay 账户），点击 Create eBay Account（创建 eBay 账户）。

步骤 8 —— 登录 eBay 并批准连接

使用需要连接的 eBay 卖家账户登录。按照 eBay 的授权步骤操作，直至连接完成并被重定向回 AdlerDoo。

概述

本文档介绍如何在 Shopify Dev Dashboard 中注册和配置 Shopify 公共应用（Public App），并将其集成到 AdlerDo V6.1 中以实现 OAuth 安装。该流程会生成一个 Client ID 和 Client Secret，供 AdlerDo 用于对任何安装该应用的 Shopify 店铺进行身份验证。

架构背景

AdlerDo 将 /api/shopify/install 作为 OAuth 入口点公开。Dev Dashboard 应用会将每个安装请求重定向到该端点，由其执行 OAuth 授权码交换、将访问令牌持久化到租户数据库，并通过 Hangfire 后台作业注册所需的 webhook。

前提条件

开始之前，请确保：

• 拥有 TecSee GmbH Shopify 组织的访问权限，并具备管理应用的权限
• AdlerDo 中间件已部署，并可通过 HTTPS 在为目标环境配置的公共主机上访问
• 端点 /api/shopify/install 和 /api/shopify/callback 可访问并返回有效响应
• 在将凭据推向生产环境之前，已有一个可用于端到端测试的开发店铺
• AdlerDo 所需的 OAuth 权限范围（scope）列表已最终确定并存储在配置中

步骤 1 —— 打开应用开发页面

登录 Shopify 组织，导航至 Settings → Apps and sales channels → App development。点击"Build apps in Dev Dashboard"按钮。

重要提示： 请勿使用 Legacy custom apps 面板下的"Create an app"按钮。自 2026 年 1 月 1 日起，旧版自定义应用（Legacy custom apps）将不再对新商家可用。

步骤 2 —— 在 Dev Dashboard 中创建新应用

Dev Dashboard 在 dev.shopify.com/dashboard/{organizationId}/apps 打开。点击 Apps 列表右上角的"Create app"按钮。

步骤 3 —— 选择创建路径并设置应用名称

系统提供两种创建路径：

• Start with Shopify CLI —— 在本地搭建一个 Node/Remix 项目。AdlerDo 无需使用此路径。
• Start from Dev Dashboard —— 直接在仪表板中注册应用元数据，并立即生成 Client ID 和 Secret。AdlerDo 请使用此路径。

输入应用名称（例如：AdlerDo），然后点击 Create（创建）。

命名约定

使用一个稳定的、面向客户的名称，该名称会显示在安装同意屏幕上。对于 TecSee，如有需要，可按环境添加前缀：AdlerDo (Production)、AdlerDo Staging、AdlerDo Dev。

步骤 4 —— 配置 URL、Webhooks 版本和权限范围

创建后，应用会在 Versions 选项卡上打开，并附带一个新的草稿版本。安装 URL、webhooks API 版本和权限范围都在此处定义。

6.1 App URL

将 App URL 设置为公共的 AdlerDo 安装端点：

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

当商家安装应用时，Shopify 会重定向到该 URL。AdlerDo 的 ShopifyInstallController 会读取 shop 和 hmac 查询参数，验证 HMAC，并重定向到 Shopify 的 OAuth 授权页面。

6.2 在 Shopify 后台中嵌入应用

保持"Embed app in Shopify admin"复选框处于启用状态。AdlerDo 使用 App Bridge 在 Shopify 后台框架内提供嵌入式后台 UI。

6.3 Preferences URL

可选。除非应用在嵌入式体验之外公开单独的设置页面，否则请留空。

6.4 Webhooks API 版本

明确固定 webhooks API 版本。示例显示为 2026-04，即 AdlerDo 当前使用的版本。提升此值需要审查每一个 webhook 载荷的映射关系。

6.5 访问权限范围

点击"Select scopes"并勾选 AdlerDo 所需的权限范围。请将列表保持在 AdlerDo 实际使用的最小范围内 —— 商家会在安装同意屏幕上看到完整列表。

完全相同的列表还必须持久化在 AdlerDo 配置中（appsettings.Shopify.json → Shopify:Scopes），因为安装控制器会将其作为 scope 查询参数传递。不匹配将导致被迫重新安装。

可选与必需权限范围

可选权限范围可在安装后于运行时请求。AdlerDo 在初次安装期间将所有列出的权限范围视为必需，因此请将 Optional scopes 区块留空。

6.6 Redirect URLs

添加 OAuth 重定向 URL —— 即 AdlerDo OAuth 回调的公共 URL：

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

每个环境添加一个重定向 URL。如果 redirect_uri 参数中提供的 URL 不在此白名单中，Shopify 将拒绝 OAuth 回调。

步骤 5 —— 发布版本

保存所有字段后，点击版本页面底部的 Release（发布）。

• Version name —— 人类可读的标签。TecSee 约定：alderdoo-{n}，其中 n 为自动递增的发布编号
• Version message —— 简短的变更日志（例如"added read_locales scope"、"bumped webhooks API to 2026-04"）

点击 Release。新版本会立即变为 Active（活动），并在所有新安装中取代之前的 Active 版本。

发布后的权限范围变更

向已发布版本添加新的权限范围，并不会自动为已安装的店铺授予该权限。店铺所有者必须批准重新授权。AdlerDo 会在每次请求时检测权限范围的偏移，并在需要时触发重新安装的重定向。

步骤 6 —— 验证活动版本

从左侧边栏打开 Versions 选项卡。最近发布的版本会标有绿色的"Active"徽章。所有先前的版本仍然可见，以供审计之用。

在此视图中，您可以点击任意历史版本以检查其配置，这在调试旧店铺上的安装时非常有用。

步骤 7 —— 获取 Client ID 和 Secret

从左侧边栏打开 Settings 选项卡。顶部的 Credentials 区块会显示 Client ID 和 Secret。

9.1 Client ID

公开标识符。可安全地提交到配置中。通过剪贴板图标复制它，并粘贴到 AdlerDo 配置中。

9.2 Client Secret

敏感信息。请将其视为凭据。该密钥仅在首次生成时显示一次；之后仅显示遮盖后的形式。使用眼睛图标将其显示一次以便复制，然后通过标准的 AdlerDo 密钥存储路径进行存储。

在 AdlerDo 中，市场平台集成的密钥会通过 MarketplaceCredentialEncryptor 以 AES-256 加密的方式持久化在租户数据库中。

9.3 轮换密钥

点击 Rotate（轮换）以生成新密钥。先前的密钥会立即失效。请将密钥轮换与新密钥向 AdlerDo 的部署协调进行。

9.4 API 联系邮箱

将其设置为一个受监控的邮箱（当前为 dev@tecsee.de）。Shopify 会将 API 弃用通知和安全公告发送到该地址。

将凭据接入 AdlerDo

获得 Client ID 和 Secret 后，将凭据添加到 AdlerDo 配置中。

10.1 配置

将以下区块添加到特定于环境的配置中：

"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 安装流程

端到端的安装握手过程如下：

1. 商家点击安装链接 → Shopify 携带 shop 和 hmac 查询参数重定向到 App URL
2. AdlerDo /api/shopify/install 根据 Client Secret 验证 HMAC，并携带配置的权限范围列表和生成的 state nonce 重定向到 https://{shop}/admin/oauth/authorize
3. 商家在 Shopify 同意屏幕上批准权限范围
4. Shopify 携带 code、hmac 和 state 参数重定向到 /api/shopify/callback
5. AdlerDo 验证 HMAC 和 state nonce，然后将 code + Client ID + Client Secret POST 到 https://{shop}/admin/oauth/access_token，以接收离线访问令牌
6. 该令牌以 AES-256 加密的方式针对该租户存储；同时注册 webhook 订阅和周期性同步的 Hangfire 作业
7. AdlerDo 将商家重定向到嵌入式后台 URL

10.3 验证安装

握手完成后：

• 确认租户数据库中存在一个新的 ShopifyConnection 实体，其 EncryptedAccessToken 非空并包含已授予的权限范围列表
• 确认周期性作业（SyncShopifyOrdersV2026、SyncShopifyProductsV2026）已在 Hangfire 中以新的租户标识符注册
• 从 Shopify 后台触发一个测试 webhook，并确认 AdlerDo 处理程序在没有 HMAC 错误的情况下处理它

附录 A —— AdlerDo 常用权限范围

权限范围	在 AdlerDo 中的用途
read_products, write_products	目录同步：从 Odoo 或 JTL-Wawi 创建/更新产品和变体
read_orders, write_orders	将订单拉取到 AdlerDo，并将订单修改/履约信息推回
read_inventory, write_inventory	按地点同步库存水平
read_locations	解析用于库存和运输的履约地点
read_fulfillments, write_fulfillments	创建履约，并从承运商推送物流追踪号：DHL、GLS、DPD、DB Schenker
read_assigned_fulfillment_orders, write_assigned_fulfillment_orders	当 AdlerDo 作为已注册的履约服务时需要
read_customers, write_customers	客户同步和 B2B 细分
read_shipping	读取承运商和区域配置以进行费率计算
read_app_proxy, write_app_proxy	嵌入式后台代理路由所需
read_analytics	嵌入式后台中的报表仪表板

附录 B —— 故障排除

安装重定向返回 401 / 无效的 HMAC

原因： AdlerDo 配置中的 Client Secret 与 Settings 中的密钥不匹配，或密钥已轮换但未重新部署。

处理措施： 从 Dev Dashboard Settings 页面复制密钥并重新部署。

OAuth 回调返回 'redirect_uri is not whitelisted'

原因： 回调 URL 未出现在活动版本的 Redirect URLs 字段中。

处理措施： 打开活动版本，添加该 URL，发布新版本，然后重试安装。

店铺已安装但未出现 Hangfire 作业

原因： OAuth 授权码交换成功，但安装后的引导流程失败（例如租户配置）。

处理措施： 检查安装时间戳前后的 AdlerDo 日志；ShopifyInstallController 会为每个阶段发出一条 Information 日志，并针对出问题的步骤发出一条 Error 日志。

Webhook 投递因 HMAC 错误而失败

原因： AdlerDo 是基于解析后的载荷（而非原始请求体）计算的 webhook HMAC。

处理措施： 确认请求中间件在为 /api/shopify/webhooks/* 路由进行模型绑定之前缓冲了原始请求体。

商家报告在添加权限范围后缺少数据

原因： 该店铺是基于不包含该权限范围的旧版本安装的。

处理措施： 触发重新安装的重定向 —— AdlerDo 会在 ShopifyConnectionMiddleware 中检测权限范围偏移，并重定向到安装端点，商家在此批准新的权限范围。

发布于 2026 年 2 月 20 日
更新于 2026 年 2 月 23 日

连接 Kaufland Global Marketplace API

本指南介绍如何将 AdlerDo 与 Kaufland Global Marketplace API 连接。连接后，AdlerDo 可以在您的 ERP（如 Odoo）与 Kaufland 之间同步产品、库存、订单和物流信息。

概述

通过官方 API 将 AdlerDo 连接到 Kaufland，您的系统将能够：

• 将产品刊登信息从您的 ERP 同步到 Kaufland
• 在各系统间保持库存水平的实时更新
• 自动导入 Kaufland 订单
• 将发货确认和物流追踪详情发送回 Kaufland

此集成可确保数据流稳定、自动化，并减少手动工作。

前提条件

开始之前，请确保：

• 您拥有一个有效的 Kaufland 卖家账户
• 您可以访问 Kaufland 卖家门户
• 您有权在卖家账户中管理 API 凭据

获取 Kaufland API 凭据的步骤

要将 AdlerDo 与 Kaufland 连接，您必须首先从 Kaufland 卖家门户获取您的 API 凭据。

步骤 1：导航至 API 设置

在浏览器中打开以下链接：

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

从左侧菜单，导航至：

Settings → Shop Settings → API

步骤 2：查看您当前的 API 密钥

在 **Current API key（当前 API 密钥）**板块中，您将看到：

• Client key（Client ID）—— 出于安全考虑已遮盖
• Secret key（Client Secret）—— 出于安全考虑已遮盖

出于安全原因，这些值会被隐藏，且无法再次显示。

步骤 3：生成新的 API 密钥（如有需要）

如果您没有有效的凭据或需要一对新的凭据，请点击：

Generate new API keys（生成新的 API 密钥）

重要提示： 一旦生成新密钥：

• 旧的 Client ID 和 Client Secret 会立即失效
• 任何使用旧密钥的现有集成都将停止工作
• 您必须用新凭据更新 AdlerDo

步骤 4：保存您的新凭据

生成新密钥后：

• 复制 Client ID
• 复制 Client Secret
• 将两个值安全地存储起来

离开该页面后，您将无法再次检索它们。

将 Kaufland 连接到 AdlerDo

获取 API 凭据后，您可以在 AdlerDo 内连接 Kaufland。

步骤 1：选择账户类型

从 Select 旁边的下拉菜单中，选择：Kaufland

步骤 2：输入账户详情

填写以下字段：

Account Name（账户名称）

为此连接输入一个具有辨识度的名称，例如 "My Kaufland Store" 或 "Kaufland DE Account"

Client ID

输入从您的 Kaufland 账户获取的 Client ID

Client Secret

输入从您的 Kaufland 账户获取的 Client Secret

步骤 3：保存并连接账户

填写完所有必填字段后，点击 ***Add New Account（添加新账户）***按钮（绿色）。

AdlerDo 将尝试使用所提供的凭据与 Kaufland Global Marketplace API 建立连接。

步骤 4：验证已连接的账户

连接成功后：

• 您的 Kaufland 账户将出现在左侧的 **Connected Accounts（已连接账户）**列表中
• 账户状态会确认 AdlerDo 已成功连接到 Kaufland

此时，您的系统已准备好同步数据。

连接后会发生什么

将 Kaufland 连接到 AdlerDo 后：

• 可以启用产品和库存同步
• 在 Kaufland 上下的订单会自动导入到 AdlerDo
• 订单会转发到您的 ERP 进行处理
• 发货确认和物流追踪号可以发送回 Kaufland

所有同步均遵循标准的 AdlerDo 完整同步周期。

常见说明与最佳实践

将 Kaufland 连接到 AdlerDo 后：

• 始终保持您的 ERP 与 Kaufland 之间 SKU 的一致
• 如果同步失败，请检查 API 密钥是否已重新生成
• 使用安全存储来保管 API 凭据
• 更改 API 密钥后立即重新连接账户

本指南介绍如何使用**账户集成（Accounts Integration）**界面将您的 PrestaShop 店铺连接到 AdlerDo。连接后，AdlerDo 可以在您的 PrestaShop 店铺与您的 ERP 系统之间同步产品、库存、订单和其他数据。

PrestaShop 集成概述

通过将 PrestaShop 与 AdlerDo 连接，您可以简化电商运营并确保数据无缝流转。

主要优势包括：

• 自动同步产品刊登信息及更新
• 在各系统间保持库存水平准确
• 将 PrestaShop 订单导入 AdlerDo 和您的 ERP
• 从单一界面安全地管理多个 PrestaShop 账户

此集成可确保数据流转可靠、安全，且几乎无需人工干预。

• 库存同步
• 订单导入
• 多店铺管理

访问账户集成

可通过侧边栏菜单选择 **Accounts（账户）来访问账户集成（Accounts Integration）**选项卡。

步骤 1：选择账户类型

在页面顶部，使用下拉菜单 Select 选择要关联或管理的账户类型，例如：

• PrestaShop（示例中已选中）

步骤 2：账户操作

添加新账户

• 点击绿色按钮，将新的 PrestaShop 账户添加到 AdlerDo。

删除账户

• 点击红色按钮，删除当前所选账户。

⚠️ 删除账户会立即停止该连接的同步。

步骤 3：账户设置

**Account Settings（账户设置）**板块允许您创建或编辑 PrestaShop 账户连接。

字段说明：

1. Account Name（账户名称）

在 AdlerDo 中用于区分多个 PrestaShop 账户的内部名称。示例：

"PrestaShop – Main Store"

2. Base URL（基础 URL）

您 PrestaShop 店铺的主网站 URL。示例：

https://yourshopdomain.com

3. Token（令牌）

用于 AdlerDo 与 PrestaShop 之间安全身份验证的 API 令牌

步骤 4：已连接的账户

**Connected Accounts（已连接账户）**面板位于页面左侧。在此，您可以：

• 选择一个账户以编辑其设置
• 删除不再需要的账户

如果没有已连接的账户，列表将显示为空。

步骤 5：从 PrestaShop 获取基础 URL 和 API 令牌

基础 URL

您 PrestaShop 店铺的公开 URL。示例：

https://yourshopdomain.com

API 令牌：

请按以下步骤操作：

1. 登录 PrestaShop 后台（Back Office）。
2. 从侧边栏，导航至 Advanced Parameters → Webservice (API)
3. 如果 Webservice 功能未启用，请通过选择 Enable PrestaShop Webservice 将其开启
4. 要创建新的 API 密钥：
   • 点击 Add new webservice key 或 加号 (+) 图标
   • 将出现一个用于创建新密钥的页面
   • 点击 Generate 以创建一个随机密钥（这就是 Token）
5. 复制生成的密钥并将其安全地存储
6. 分配 AdlerDo 所需的必要权限（根据需要设置读/写）
7. 点击 Save 以激活该密钥

⚠️ 重要提示： 请妥善保管您的 API 令牌。如果令牌被重新生成，您必须立即在 AdlerDo 中更新它。

将 PlentyMarkets 连接到 AdlerDoo

只需四个简单步骤，即可将您的 PlentyMarkets（或 PlentyONE）账户连接到 AdlerDoo。连接后，AdlerDoo 会在 PlentyMarkets 与 Odoo 之间自动同步您的产品、类别、属性、订单和客户地址。

开始之前

• 一个具有 REST API 访问权限的有效 PlentyMarkets 或 PlentyONE 账户。
• 您的基础 URL（例如：https://your-shop.plentymarkets-cloud01.com）。
• 一个具有 REST API 权限的用户的用户名和密码。

提示： 为此集成在 PlentyMarkets 中创建一个专用的 API 用户。这比使用您的管理员账户更安全，并且您可以随时撤销访问权限而不影响其他用户。

四步连接 Plenty

步骤 1：打开市场平台账户

在 AdlerDoo 侧边栏中，前往 Settings → Integrations → Marketplace Accounts。

步骤 2：选择 Plenty

从页面顶部的 Select Marketplace 下拉菜单中，选择 Plenty。

步骤 3：点击"Add New Account"

点击页面右上角绿色的 Add New Account 按钮。

步骤 4：输入您的凭据并保存

在下方四个字段中填写您的 PlentyMarkets 凭据，然后点击 Save。AdlerDoo 将进行身份验证，自动存储访问令牌和刷新令牌，随后您的账户即已连接。

字段	应输入内容
Account Name	此账户的任意易记名称，例如：My Plenty Store。
User Name	您具有 REST API 权限的 PlentyMarkets 用户名。
Password	您的 PlentyMarkets 密码。
Base URL	您完整的 PlentyMarkets URL，例如：https://your-shop.plentymarkets-cloud01.com。

提示： AdlerDoo 会在访问令牌过期前于后台自动刷新它 —— 您无需手动管理令牌。

验证连接

连接后，AdlerDoo 会在后台自动开始同步数据。使用下面的界面来确认产品、订单、类别、属性和客户已从您的 PlentyMarkets 店铺拉取过来。

1. 检查同步状态

打开 Settings → Integrations → Connection Sync。Plenty 应出现在列表中，并带有绿色的 Running 指示。

2. 浏览已同步的产品

打开 Main → Products 并按 Plenty 筛选，即可查看从您店铺同步过来的所有产品，包括其 SKU、价格和标识符（GTIN、MPN、ASIN、UPC）。

3. 检查产品变体

在任意产品行上点击 Variants，即可打开变体详情窗口。每个变体都会显示其 SKU、条形码、价格、数量和尺寸 —— 即从 PlentyMarkets 传输过来的全部信息。

4. 浏览已同步的订单

打开 Main → Orders 并按 Plenty 筛选，即可查看从 PlentyMarkets 拉取的所有订单，包括状态、付款方式和时间。

5. 检查订单详情

在任意订单行上点击 Details，即可打开订单详情窗口，其中包含订单行项目、数量、价格、增值税和总额。使用弹窗右上角的 Gift 和 Custom 选项卡可查看礼品选项和定制数据。

6. 查看已同步的类别

打开 Main → Categories，即可查看从 PlentyMarkets 导入的完整类别树 —— 与您在店铺中组织产品所用的层级结构相同。

7. 查看已同步的属性

打开 Main → Attributes，即可查看用于描述变体的所有产品属性（尺寸、颜色、材质、品牌、制造商、年龄组、图案、性别等）。

8. 查看已同步的客户

打开 Main → Customers，即可查看从 PlentyMarkets 拉取的客户。每条记录都有一个带 PLENTY 前缀的客户编号，将其关联回来源。在任意行上点击 View Address 可查看存档的送货地址和账单地址。

哪些内容会自动同步

初次连接后，AdlerDoo 会在 PlentyMarkets 与 Odoo 之间保持以下内容同步 —— 无需任何手动操作：

• 产品 —— 包括变体、销售价格、库存水平和属性值。
• 类别 —— 完整的类别树和层级结构。
• 属性 —— 尺寸、颜色、材质及其他变体属性。
• 订单 —— 在 Odoo 中创建为销售订单。
• 客户地址 —— 关联到相应的订单和联系人。

移除已连接的账户

要断开某个 Plenty 账户的连接：从左侧的 Connected Accounts 列表中选择它，然后点击右上角红色的 Delete Account 按钮。

需要帮助？

如对本集成有任何问题或疑问，请联系 AdlerDoo 支持团队。

导航至集成页面

从左侧的侧边栏：

Accounts → 侧边栏菜单

（在图中以红框标示）

选择集成系统

在页面顶部，有一个下拉菜单：Select

从可用系统列表中选择 JTL。

账户设置（JTL 账户配置）

选择 JTL 后，将出现三个必须填写的重要字段

1. Account Name（账户名称）

您希望在系统内显示的账户名称。

这有助于您日后轻松识别该账户。

2. Client ID

JTL 集成的唯一标识符。

您可从 JTL 控制面板获取此值。

3. Client Secret

账户的密钥。

应妥善保管，切勿分享，以确保安全。

此密钥用于身份验证以及将两个系统关联在一起。

可用操作

右上角有一个绿色按钮。

在填写完所需信息后，它会添加一个新的 JTL 账户。

删除账户

右上角有一个红色按钮。

它会从已关联账户列表中删除所选账户。

已连接的账户

此板块显示先前已关联的账户（如有）。

它便于选择账户以进行查看、编辑或删除。

从 JTL 获取集成数据的步骤（Client ID 和 Client Secret）

1. 登录 JTL 控制面板

打开您的网页浏览器，前往 JTL 网站，并使用您的账户凭据登录。

2. 访问账户设置或常规设置

在主控制面板中，寻找类似 Settings（设置）或 Configuration（配置）的选项并点击它。

3. 找到 API、集成或应用板块

在设置页面内，找到用于外部集成的板块，通常标记为：

• API Access（API 访问）
• Integrations（集成）
• Apps（应用） 或 Developer Apps（开发者应用）

4. 创建新应用或生成新的 API 密钥

点击按钮以创建新应用或生成 API 凭据。

您可能需要提供：

• 应用名称
• 描述
• 回调 URL（如被要求）

5. 获取 Client ID 和 Client Secret

创建后，您将看到：

• Client ID： 代表该应用的唯一数字或文本。
• Client Secret： 与 Client ID 关联的密钥。

复制两者并安全地存储。

6. 在您系统的集成页面中输入数据

1. 前往您系统中的 **Accounts Integration（账户集成）**页面。
2. 从可用系统中选择 JTL。
3. 在相应字段中输入 Client ID 和 Client Secret。
4. 输入一个便于识别的 Account Name（账户名称）。

本板块可帮助您将系统与您的 MediaMarkt Marketplace 账户连接，从而实现产品同步、订单、库存管理及相关集成操作。

在系统中的位置

通过以下路径访问此功能：

侧边栏 → Accounts → Accounts Integration

然后从 Select 下拉菜单中选择 MediaMarkt。

账户设置

在右侧，填写以下字段以添加 MediaMarkt 账户：

字段	说明
Account Name	系统内 MediaMarkt 账户的唯一标识符
Client ID	从 MediaMarkt API 仪表板获取的主标识符
Client Secret	用于账户身份验证的密钥

控制按钮

• Add New Account（添加新账户）： 绿色按钮，在输入所需详情后保存新的 MediaMarkt 账户。

• Delete Account（删除账户）： 从您的账户列表中移除所选账户。

已连接的账户

左侧显示所有先前添加的 MediaMarkt 账户。选择任意账户以进行编辑或删除。

获取集成数据的一般步骤

1. 登录 MediaMarkt 卖家仪表板（Mirakl 后台）

   • 打开浏览器并导航至：https://mediamarktsaturn.mirakl.net/login

2. 使用您的卖家账户凭据登录

   • 输入您的用户名和密码

3. 前往 Account Settings（账户设置）或 My Profile（我的资料）

   • 寻找 API 板块或 API Keys（API 密钥）

4. 创建新的 API 密钥或复制现有密钥

   • 如果您还没有密钥，请点击 Generate API Key（生成 API 密钥）
   • 如有现成密钥，请复制它

5. 记录 MediaMarkt 平台的基础 URL

   • 基础 URL 通常为 Mirakl API 端点：https://mediamarktsaturn.mirakl.net/api

6. 在您的系统中使用基础 URL 和 API 密钥（Token）

   • 导航至您系统中的 Accounts Integration（账户集成）
   • 从下拉菜单中选择 MediaMarkt
   • 输入一个合适的 Account Name（账户名称）
   • 输入 Base URL（基础 URL）
   • 输入您复制的 API Key（Token）

7. 保存数据并激活集成

   • 点击 **Add New Account（添加新账户）**以完成设置
   • 您的系统现在即可获取订单、更新产品并执行集成任务

账户集成（Accounts Integration）功能允许您将 Galaxus 账户与系统连接，从而只需输入您的账户集成凭据，即可自动管理数据、获取订单和更新信息。

集成步骤

1. 访问账户集成板块： 从侧边栏中，选择 Accounts。
2. 从下拉菜单中选择 Galaxus： 在 Select 下拉菜单中，选择 Galaxus。

填写账户详情

• Account Name（账户名称）： 输入用于在系统内识别该账户的名称（例如 My Galaxus Account）。
• Client ID： 输入您 Galaxus 账户的客户端标识符。
• Client Secret： 输入与您 Galaxus 账户关联的客户端密钥。

保存账户

输入详情后，点击 **Save（保存）**或 **Confirm（确认）**添加按钮（取决于系统界面）。

• 绿色按钮用于添加新账户

删除账户

1. 从 **Connected Accounts（已连接账户）**框中选择一个账户。
2. 点击 **Delete Account（删除账户）**按钮。
3. 确认删除。

已连接的账户

左侧会出现一个框，显示所有先前已关联到系统的 Galaxus 账户。当您从列表中选择任意账户时，其详情将显示在 **Account Settings（账户设置）**板块中。

Galaxus API 凭据 —— 如何获取集成密钥

1. 登录您的 Galaxus 账户

1. 打开 Galaxus 网站。
2. 登录您想要连接到系统的账户。
3. 前往 **API Settings（API 设置）**页面。

登录后：

从主菜单，导航至：Settings → Developer Settings → API Keys / Integrations

2. 创建新的 API 密钥

如果您还没有现有密钥：

1. 点击按钮：Create API Key（创建 API 密钥）或 Generate Credentials（生成凭据）
2. 将出现一个表单，包含：
   • App Name / Integration Name（应用名称 / 集成名称） → 输入一个标识符，例如：
     • TecSee Integration
     • Store Sync
   • Permissions（权限） → 选择您系统所需的权限（例如：Products – Orders – Inventory）。
3. 点击 Save / Generate（保存 / 生成）

通过账户集成连接 Odoo

**账户集成（Accounts Integration）**页面允许您将 AdlerDo 与一个或多个 Odoo 账户关联，并通过一个简洁、清晰且安全的界面对其进行管理。连接后，AdlerDo 可以直接与您的 Odoo 系统通信，以同步产品、库存、订单和运营数据。

Odoo 集成概述

将 Odoo 连接到 AdlerDo 可将市场平台和店铺运营集中在 Odoo 内进行。

主要优势：

• 将市场平台和店铺数据集中在 Odoo 内
• 自动化产品、库存和订单同步
• 从单一界面管理多个 Odoo 实例
• 减少手动操作和集成错误

此集成可确保数据流转稳定、可扩展，且几乎无需人工干预。

• 数据集中化
• 自动化同步
• 多实例控制

访问账户集成页面

从左侧边栏菜单中，选择 Accounts（账户）

将出现 **Integration Accounts Management（集成账户管理）**界面，显示所有账户连接和设置。

选择要连接的系统

在页面顶部区域，您会找到一个下拉字段，标记为：

Select

在顶部，使用标记为 Select 的下拉字段来选择一个系统。选择 Odoo 以开始设置。

管理账户

添加新账户

• 用于添加新的 Odoo 账户。
• 填写完所有必填字段后，点击 **Add New Account（添加新账户）**以保存连接。
• 该账户将出现在左侧的 **Connected Accounts（已连接账户）**下方。

删除账户

• 用于删除当前所选的 Odoo 账户。
• 删除后，该账户的同步将立即停止。

⚠️ 删除账户不会影响 Odoo 内的数据，仅影响连接。

账户设置（Odoo）

在添加或编辑账户时，会出现以下字段：

字段说明

a. URL

您 Odoo 实例的登录 URL。示例：

https://yourcompany.odoo.com

b. Account Name（账户名称）

用于识别 Odoo 账户的内部名称。示例：

"Odoo – Main ERP"

c. Database Name（数据库名称）

您想要连接的 Odoo 数据库的名称。身份验证和数据访问都需要此项。

d. User Name（用户名）

具有足够权限的 Odoo 用户的用户名或电子邮件

e. Password（密码）

与所选 Odoo 用户账户关联的密码。

🔒 此信息会被安全处理，仅用于身份验证。

管理已连接的账户

已连接的账户

**Connected Accounts（已连接账户）**板块显示所有先前添加的 Odoo 账户。在此，您可以：

• 选择一个账户以编辑其设置
• 删除不再需要的账户

这使得管理多个 Odoo 数据库或环境（例如生产环境和预发布环境）变得轻松。

从 Odoo 获取集成数据的步骤

获取 URL

复制您 Odoo 系统的登录 URL。示例：

https://yourcompany.odoo.com

获取数据库名称

• 在数据库选择页面上查找数据库名称
• 或向您的 Odoo 系统管理员索取

获取用户名

使用具有 API 访问权限的 Odoo 用户的用户名或电子邮件。

获取密码

使用与所选 Odoo 用户账户关联的密码。

输入并保存数据

1. 在 **Accounts Integration（账户集成）**页面上输入所有必填信息
2. 检查详情是否准确
3. 点击 **Add New Account（添加新账户）**以保存连接

保存后，Odoo 账户将出现在 **Connected Accounts（已连接账户）**下方，并已准备好进行同步。

最佳实践

• 为集成使用专用的 Odoo 用户
• 出于安全考虑，仅分配所需的权限
• 为多个数据库使用清晰的账户名称
• 如果在 Odoo 中更改了凭据，请立即更新

安全与维护提示： 限制权限并使用专用的集成用户可降低未经授权访问的风险，并防止意外中断。

什么是 DATEV 集成？

此集成允许您将发票从 Odoo 自动发送到您的 DATEV 会计系统。系统会从 Odoo 获取发票，将其转换为 DATEV 格式并自动上传，无需手动上传发票。

步骤 1：连接您的 DATEV 账户

在发送发票之前，您需要连接您的 DATEV 账户。

1. 调用登录端点以获取您的 DATEV 登录链接
2. 在浏览器中打开该链接
3. 使用您的 DATEV 凭据登录
4. 成功登录后，您将看到一个"Authentication Successful!（身份验证成功！）"页面
5. 您的 DATEV 账户现已连接

步骤 2：验证您的账户

检查您的 DATEV 账户是否已连接。

将发票发送到 DATEV

按日期范围发送

• 发送某个日期范围内的所有发票
• 将发票作为 xml 或 pdf 下载到文件夹中，以便手动上传到 DATEV

检查发票状态

查看所有发票（分页显示）

发票状态含义

状态	含义
Meta data Saved	发票信息已保存；PDF 尚未获取
Pending	已准备好处理，正在队列中等待
Creating	正在 DATEV 服务器上创建作业
Uploading	正在将发票文件上传到 DATEV
Committing	正在 DATEV 上完成上传的最终提交
Completed	已成功发送到 DATEV
Failed	出现问题（参见错误消息）

处理失败的发票

失败的发票会自动重试最多 3 次。如果某张发票仍然失败，可能需要手动干预。

刷新您的 DATEV 令牌

您的 DATEV 访问令牌会定期过期。系统会在后台处理期间自动处理此问题。如需手动刷新：

重要提示： 如果令牌刷新因身份验证错误而失败，您可能需要通过重复步骤 1 来重新连接您的 DATEV 账户。

快速参考

• Get Invoice XML Preview（获取发票 XML 预览） —— 返回一个从发票 ID 到 Base64 编码 XML 的字典。
• Fetch PDFs for Saved Invoices（为已保存的发票获取 PDF） —— 如果发票仅保存了元数据（无 PDF），则获取其 PDF

操作	端点
连接 DATEV 账户	GET /api/DatevAuth/login-url
查看账户	GET /api/DatevAccount
发送发票（按订单 ID）	POST /api/odoo-datev/fetch-and-queue
发送发票（按日期范围）	POST /api/odoo-datev/fetch-by-date
发送单张发票	POST /api/odoo-datev/fetch-single
查看发票（分页显示）	GET /api/odoo-datev/invoices
检查作业状态	GET /api/datev/invoices/{jobId}/status
查看队列摘要	GET /api/odoo-datev/queue-status
查看统计信息	GET /api/datev/invoices/stats
重试失败的作业	POST /api/datev/invoices/{jobId}/retry
刷新令牌	POST /api/DatevAuth/refresh-token
删除账户	DELETE /api/DatevAccount

后台上传场景

发票的元数据保存在 AdlerDo 数据库中，随后在后台自动上传到 DATEV。