Odoo Allegro 连接器：波兰市场集成

Allegro 是波兰无可争议的电子商务领导者，拥有超过 2100 万注册买家，在波兰在线购物者中的市场渗透率为 80%。任何向波兰销售产品的品牌或零售商都必须拥有 Allegro 的存在——这不是可选的。对于在 Odoo 19 Enterprise 中管理 Allegro 以及其他渠道的运营团队来说，ECOSIRE Allegro 连接器可以自动化整个卖家工作流程。

本指南涵盖 Allegro API 集成、报价管理、订单自动化、智能！计划履行、波兰增值税合规性以及在 Allegro 上销售的财务对账细节。

要点

• Allegro REST API 使用 OAuth 2.0；在 apps.allegro.pl 注册
• Offers（Allegro 的列表术语）具有来自 Allegro 类别系统的结构化产品数据
• 订单导入包括 Allegro 订单 ID、买家详细信息和交货偏好
• Allegro 智能！计划需要快速发送（Smart! 徽章最多 1 个工作日）
• 波兰增值税（23% 标准）是强制性的；书籍 (5%)、食品 (5-8%) 折扣
• Allegro Billing 导出增值税报告自动导入到 Odoo
• Allegro 的价格政策：由市场监控的有竞争力的定价
• 通过 Allegro Lokalnie 进入捷克共和国和斯洛伐克共和国市场

---

Allegro 市场概述

为什么 Allegro 统治波兰：

Allegro 不仅仅是一个市场，它还是波兰主要的零售发现平台。消费者在 Allegro 上开始搜索大多数产品类别的产品，而不是 Google。

Allegro 与亚马逊在波兰的对比：

亚马逊于 2021 年进入波兰，但并未取代 Allegro。波兰消费者信任 Allegro 的买家保护，Smart！交付计划和本地卖家生态系统。对于大多数品类，Allegro 在波兰的销量是 Amazon.pl 的 5-10 倍。

---

Allegro API 设置

第 1 步：注册成为 Allegro 开发者

1. 在apps.allegro.pl处创建一个应用程序
2. 选择“Web应用程序”类型（用于服务器端OAuth）
3. 输入您的重定向 URI：https://your-odoo.com/allegro/oauth/callback 4.记下您的客户端 ID 和 客户端密钥

步骤2：OAuth 2.0授权

Allegro 使用授权代码 OAuth 流程（用户级身份验证）：

1. 在 Odoo 连接器设置中，单击 连接 Allegro 帐户
2. OAuth 弹出窗口在 allegro.pl 上打开 3.登录并授权连接器 4.自动存储的访问令牌和刷新令牌
3. 代币在12小时后过期；最近 30 天的刷新令牌（由连接器自动刷新）

沙盒环境：

Allegro 在 allegro.pl.allegrosandbox.pl 提供了完整的沙箱用于测试：

• 在 allegrolokalnie.pl/developer/sandbox 注册测试卖家
• 沙箱 API：https://api.allegro.pl.allegrosandbox.pl
• 在上线前测试真实的报价和模拟订单

---

连接器配置

安装后导航至 销售 → Allegro 或 库存 → Allegro Marketplace。

账户配置：

交付偏好配置：

Allegro 使用自己的送货服务（Allegro Courier、InPost、DPD、DHL、Poczta Polska）。配置您提供的服务以及处理时间：

---

优惠管理

在 Allegro 中，列表称为“报价”。每个优惠都有一个唯一的 Allegro ID，可以列为：

• 立即购买（固定价格）：相当于其他市场的立即购买
• 拍卖：以设定价格开始竞价
• 立即购买 + 拍卖：组合格式

该连接器主要管理“立即购买”优惠（对于企业卖家来说最常见）。

从 Odoo 产品创建报价：

1. 打开产品 → Allegro 选项卡 → 创建报价
2. 配置报价字段：

• 优惠标题：最多 50 个字符（简洁、关键字丰富）
• 类别：浏览 Allegro 的分类法
• 参数：特定于类别的必需属性
• 描述：允许 HTML，主要是波兰语
• 图像：最多 8 张图像，最小 600×600 像素
• 价格：PLN（包含增值税）
• 数量：可用库存
• 状况：全新、二手（带子条件）
• 送货设置：提供哪些送货方式，免费/付费
• 付款：Allegro Pay、银行转账
• 退货：14 天退货权（波兰的法定最低期限）或延长

Allegro类别参数：

每个 Allegro 类别都有特定的所需参数。连接器下载每个类别的可用参数并创建指导配置表单。 “笔记本电脑”示例：

Required Parameters:
- Processor Brand (Intel, AMD)
- Processor Model (Core i7-13700H, etc.)
- RAM (GB)
- Storage (GB)
- Screen Size (inches)
- Operating System
- Graphics Card

Optional Parameters:
- Battery Life (hours)
- Weight (kg)
- Bluetooth version
- USB ports count

将 Odoo 产品属性映射到连接器参数映射表中的 Allegro 参数。

---

快板智能！节目

快板智能！是一项订阅计划（类似于 Amazon Prime），为符合条件的优惠提供免费送货服务。聪明的！项目会显示醒目的徽章并在搜索结果中排名更高。

聪明的！资格要求：

• 最长派送时间：1 个工作日
• 通过符合 Smart! 资格的承运商（Allegro Courier、InPost、DPD、DHL）送货
• 最低积极反馈分数
• 您的帐户没有受到主动制裁

配置智能！在连接器中：

1.启用智能！在市场设置中 2. 将符合条件的优惠的发货时间设置为“当天”或“次日” 3. 配置符合 Smart! 条件的交付方式 4. 连接器自动使用 Smart! 标记符合条件的优惠！徽章

聪明的！运营影响：

与智能！启用：

• 在截止时间（例如 14:00）之前下的订单必须当天发货
• 下一个工作日截止发货后下的订单
• 连接器根据截止时间和下单时间应用发货日期计算
• 迟到触发智能！处罚（因重复违规而被吊销徽章）

---

订单管理

订单导入及处理：

1.买家在Allegro上完成购买 2. 连接器每 15 分钟轮询一次 Allegro Orders API 3. 订单连同所有必需的详细信息导入到 Odoo 4. 销售订单自动创建并确认 5. Odoo 库存中创建的交货订单 6. 仓库使用符合 Smart! 资格的承运商履行订单 7. 在 Odoo 中输入追踪号码 → 连接器发送至 Allegro 8. Allegro 通过跟踪链接通知买家

订单数据映射：

Allegro InPost 包裹储物柜履行：

InPost 在波兰非常受欢迎（全国有 13,000 多个包裹储物柜）。对于 InPost 订单： 1.通过连接器的标签API集成生成InPost标签 2. 打印并附在包装上 3. 将包裹投递至最近的 InPost 包裹储物柜或快递取件点 4. InPost跟踪自动上传到Allegro

---

波兰增值税合规性

波兰的增值税税率：

Allegro 增值税发票要求：

在波兰，卖家必须向企业买家开具增值税发票（faktury VAT）。连接器手柄：

1. 检测买家何时提供 NIP（波兰税号）——企业买家
2. 生成包含卖方和买方 NIP、发票号码、税项明细的增值税发票
3. 在 Odoo 的会计模块中过帐发票
4. 向买家提供发票（通过 Odoo 门户或电子邮件）

JPK_V7M 报告：

波兰需要每月 JPK_V7M 增值税报告。 Odoo 的波兰财务本地化根据您的过帐发票和采购发票生成此报告。该连接器可确保 Allegro 销售正确标记为包含 JPK。

用于跨欧盟销售的 OSS（一站式商店）：

如果您是向波兰境外的欧盟买家发货的波兰卖家：

• 年销售额低于 10,000 欧元：通过波兰增值税报告（标准）
• 销售额超过阈值：注册 EU OSS 并在每个买家所在国家/地区进行报告
• 连接器使用适当的财政状况标记跨欧盟销售，以进行 OSS 跟踪

---

Allegro 财务与对账

快板支付：

自2021年起，Allegro运营了自己的支付平台（Allegro Pay）。卖家收到：

• Allegro Pay 向买家收取的付款
• 每周从 Allegro 汇款（扣除费用）

Allegro 费用结构：

对账工作流程：

1. 从卖家专区 → 账单下载 Allegro 账单 CSV
2. 通过 Allegro → 财务 → 进口账单 导入
3. 连接器创建 Odoo 日记条目：

• 借方：Allegro 应收账款/贷方：销售收入
• 借方：Allegro 佣金费用/贷方：Allegro 应付款项

4. 当每周转账到达银行时：根据 Allegro Pay 日记帐进行核对
5. 月末：生成 Allegro 销售报告以进行增值税申报

---

Allegro Localnie（捷克共和国和斯洛伐克）

作为 CEE（中欧和东欧）扩张的一部分，Allegro 扩展到捷克共和国和斯洛伐克。该连接器支持以下其他市场：

• Allegro.cz：捷克市场，捷克克朗货币，捷克增值税 (21%)
• Allegro.sk：斯洛伐克市场，欧元货币，斯洛伐克增值税（20%）

使用单独的 API 凭据在连接器中配置其他市场（捷克和斯洛伐克 Allegro 帐户需要单独的卖家注册）。

---

常见问题

是否可以作为外国（非波兰）公司在 Allegro 上进行销售？

是的。 Allegro 接受来自欧盟国家的卖家。非波兰欧盟卖家必须拥有欧盟增值税号并遵守波兰增值税义务（注册波兰增值税或使用高于阈值的 OSS）。非欧盟卖家面临额外要求，包括波兰财务代表。该连接器可以通过适当的财务状况配置处理波兰注册卖家和外国卖家的增值税。

Allegro 的争议解决如何影响我的 Odoo 集成？

Allegro 的买家保护允许在购买后 20 天内提出争议。如果买家提出争议，Allegro 会进行调解。连接器将争议案例作为 Odoo 支持票证导入，并链接到相关销售订单。运营人员通过 Odoo 做出响应；解决方案通过 Allegro 卖家门户确认。已解决的争议（退款或卖家获胜）会相应更新 Odoo 订单状态。

Allegro 的上币期限和续订规则是怎样的？

“立即购买”优惠可以无限期有效（取消前有效）。拍卖报价持续 3、5、7 或 10 天。连接器会自动管理“立即购买”优惠的优惠续订 - 如果优惠因零库存而结束，则会在补充库存时重新启动。拍卖的报价续订需要手动操作或自动重新列出配置。

我可以通过连接器使用 Allegro 的 One Fulfillment 计划（类似于 FBA）吗？

One Fulfillment 是 Allegro 的仓储和履行服务（于 2023 年推出）。该连接器支持 One Fulfillment 入站发货、Odoo 虚拟“Allegro One Fulfillment”位置中的库存跟踪以及已履行订单的自动验证。一项配送注册直接在卖家专区进行管理；连接器处理操作集成。

连接器如何处理 Allegro 的促销活动（超级周、黑色星期五）？

Allegro 举办大型促销活动，参与的卖家会看到 3-10 倍的流量峰值。连接器的促销活动功能可让您为特定活动预先配置降价，并指定开始/结束日期。在重大活动之前启用“活动模式”，将同步频率增加到每 5 分钟一次，并激活额外的库存缓冲区。

---

后续步骤

Allegro 在波兰的主导地位使其成为任何针对中欧消费者的品牌不可妥协的销售渠道。但 Allegro 的卓越运营 — 智能！合规性、增值税准确性、波兰客户服务——需要专为市场打造的系统。

获取适用于 Odoo 19 的 ECOSIRE Allegro 连接器 →

我们的实施团队包括具有直接 Allegro 卖家经验的波兰市场专家。我们将配置您的连接器，正确设置波兰增值税，并对您的运​​营团队进行 Smart 培训！履行工作流程。联系我们开始您的 Allegro 集成。