Odoo Allegro Connector: Polnische Marktplatzintegration

Allegro ist Polens unbestrittener E-Commerce-Marktführer mit über 21 Millionen registrierten Käufern und einer Marktdurchdringung von 80 % bei polnischen Online-Käufern. Jede Marke oder jeder Einzelhändler, der nach Polen verkauft, muss über eine Allegro-Präsenz verfügen – dies ist nicht optional. Für Betriebsteams, die Allegro neben anderen Kanälen in Odoo 19 Enterprise verwalten, automatisiert der ECOSIRE Allegro Connector den gesamten Verkäufer-Workflow.

Dieser Leitfaden behandelt die Allegro-API-Integration, Angebotsverwaltung, Auftragsautomatisierung und Smart! Programmerfüllung, Einhaltung der polnischen Mehrwertsteuer und die Besonderheiten der finanziellen Abstimmung beim Verkauf auf Allegro.

Wichtige Erkenntnisse

– Allegro REST API verwendet OAuth 2.0; Anmeldung unter apps.allegro.pl

• Angebote (Allegros Bezeichnung für Listings) enthalten strukturierte Produktdaten aus dem Kategoriesystem von Allegro
• Der Bestellimport umfasst die Allegro-Bestell-ID, Käuferdetails und Lieferpräferenz
• Allegro Smart! Das Programm erfordert einen schnellen Versand (maximal 1 Werktag für das Smart!-Abzeichen)
• Die polnische Mehrwertsteuer (23 % Standard) ist obligatorisch; ermäßigte Preise für Bücher (5 %), Lebensmittel (5-8 %)
• Allegro Billing-Exporte für den automatischen Import von Mehrwertsteuerberichten in Odoo
• Preispolitik von Allegro: wettbewerbsfähige Preise, die vom Markt überwacht werden
• Märkte in der Tschechischen Republik und der Slowakischen Republik verfügbar über Allegro Lokalnie

---

Allegro Marketplace-Übersicht

Warum Allegro Polen dominiert:

Allegro ist nicht nur ein Marktplatz – es ist Polens wichtigste Entdeckungsplattform für den Einzelhandel. Verbraucher beginnen bei den meisten Produktkategorien mit der Produktsuche auf Allegro und nicht auf Google.

Allegro vs. Amazon in Polen:

Amazon ist 2021 in Polen eingestiegen, hat Allegro jedoch nicht verdrängt. Polnische Verbraucher vertrauen dem Käuferschutz von Allegro, Smart! Lieferprogramm und lokales Verkäufer-Ökosystem. In den meisten Kategorien erzielt Allegro in Polen ein 5- bis 10-mal höheres Verkaufsvolumen als Amazon.pl.

---

Allegro-API-Setup

Schritt 1: Registrieren Sie sich als Allegro-Entwickler

1. Erstellen Sie eine Anwendung unter apps.allegro.pl
2. Wählen Sie den Typ „Webanwendung“ (für serverseitiges OAuth).
3. Geben Sie Ihren Weiterleitungs-URI ein: https://your-odoo.com/allegro/oauth/callback
4. Notieren Sie sich Ihre Client-ID und Ihr Client-Geheimnis

Schritt 2: OAuth 2.0-Autorisierung

Allegro verwendet den Autorisierungscode OAuth-Flow (Authentifizierung auf Benutzerebene):

1. Klicken Sie in den Odoo-Connector-Einstellungen auf Allegro-Konto verbinden
2. Das OAuth-Popup wird auf allegro.pl geöffnet
3. Melden Sie sich an und autorisieren Sie den Connector
4. Zugriffstoken und Aktualisierungstoken werden automatisch gespeichert
5. Token verfallen nach 12 Stunden; Aktualisierungstoken der letzten 30 Tage (automatische Aktualisierung durch Connector)

Sandbox-Umgebung:

Allegro stellt unter allegro.pl.allegrosandbox.pl eine vollständige Sandbox zum Testen bereit:

• Registrieren Sie einen Testverkäufer unter allegrolokalnie.pl/developer/sandbox
• Sandbox-API: https://api.allegro.pl.allegrosandbox.pl
• Testen Sie mit echten Angeboten und Scheinbestellungen, bevor Sie live gehen

---

Connector-Konfiguration

Navigieren Sie nach der Installation zu Verkauf → Allegro oder Inventar → Allegro Marketplace.

Kontokonfiguration:

Konfiguration der Liefereinstellungen:

Allegro nutzt eigene Lieferdienste (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Konfigurieren Sie, welche Leistungen Sie anbieten und welche Bearbeitungszeiten Sie benötigen:

---

Angebotsverwaltung

In Allegro werden Angebote als „Angebote“ bezeichnet. Jedes Angebot verfügt über eine eindeutige Allegro-ID und kann wie folgt aufgeführt werden:

• Jetzt kaufen (Festpreis): entspricht dem „Jetzt kaufen“ anderer Marktplätze
• Auktion: Das Bieten beginnt bei einem festgelegten Preis
• Jetzt kaufen + Auktion: kombiniertes Format

Der Connector verwaltet hauptsächlich Sofortkauf-Angebote (am häufigsten für Geschäftsverkäufer).

Angebote aus Odoo-Produkten erstellen:

1. Öffnen Sie das Produkt → Registerkarte Allegro → Angebot erstellen
2. Angebotsfelder konfigurieren:

• Angebotstitel: bis zu 50 Zeichen (prägnant, schlüsselwortreich)
• Kategorie: Durchsuchen Sie die Taxonomie von Allegro
• Parameter: kategoriespezifische erforderliche Attribute
• Beschreibung: HTML erlaubt, hauptsächlich polnische Sprache
• Bilder: bis zu 8 Bilder, mindestens 600×600 Pixel
• Preis: PLN (inkl. MwSt.)
• Menge: verfügbarer Lagerbestand
• Zustand: Neu, Gebraucht (mit Unterzustand)
• Liefereinstellungen: Welche Versandmethoden angeboten werden, kostenlos/kostenpflichtig
• Zahlung: Allegro Pay, Banküberweisung
• Rückgaben: 14-tägiges Rückgaberecht (gesetzliches Minimum in Polen) oder verlängert

Parameter der Allegro-Kategorie:

Für jede Allegro-Kategorie sind bestimmte erforderliche Parameter erforderlich. Der Connector lädt verfügbare Parameter pro Kategorie herunter und erstellt ein geführtes Konfigurationsformular. Beispiel für „Laptops“:

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

Ordnen Sie Odoo-Produktattribute den Allegro-Parametern in der Parameterzuordnungstabelle des Connectors zu.

---

Allegro Smart! Programm

Allegro Smart! ist ein Abonnementprogramm (ähnlich wie Amazon Prime), das eine kostenlose Lieferung für berechtigte Angebote bietet. Schlau! Artikel werden mit einem auffälligen Abzeichen angezeigt und in den Suchergebnissen höher eingestuft.

Schlau! Teilnahmevoraussetzungen:

• Maximale Versandzeit: 1 Werktag
• Lieferung über einen Smart!-zugelassenen Spediteur (Allegro Courier, InPost, DPD, DHL)
• Mindestpunktzahl für positives Feedback
• Keine aktiven Sanktionen für Ihr Konto

Smart konfigurieren! im Stecker:

1. Aktivieren Sie Smart! in Marktplatz-Einstellungen
2. Stellen Sie bei berechtigten Angeboten die Versandzeit auf „Same Day“ oder „Next Day“ ein
3. Konfigurieren Sie Smart!-fähige Versandmethoden
4. Der Connector markiert berechtigte Angebote automatisch mit Smart! Abzeichen

Schlau! betriebliche Auswirkungen:

Mit Smart! aktiviert:

• Bestellungen, die vor Ihrer Annahmeschlusszeit (z. B. 14:00 Uhr) aufgegeben werden, müssen am selben Tag versandt werden
• Bestellungen, die nach der Annahmefrist für den Versand am nächsten Werktag aufgegeben werden
• Der Connector berechnet das Versanddatum basierend auf der Annahmeschlusszeit und der Auftragserteilungszeit
• Verspäteter Versand löst Smart aus! Strafe (Ausweisverlust bei wiederholten Verstößen)

---

Auftragsverwaltung

Auftragsimport und -abwicklung:

1. Der Käufer schließt den Kauf bei Allegro ab
2. Der Connector fragt alle 15 Minuten die Allegro Orders API ab
3. Die Bestellung wird mit allen erforderlichen Details in Odoo importiert
4. Verkaufsauftrag automatisch erstellt und bestätigt
5. Lieferauftrag im Odoo-Bestand erstellt
6. Das Lager führt die Bestellung über einen für Smart! zugelassenen Spediteur aus
7. Tracking-Nummer in Odoo eingegeben → Connector sendet an Allegro
8. Allegro benachrichtigt den Käufer mit einem Tracking-Link

Auftragsdatenzuordnung:

Allegro InPost Parcel Locker-Abwicklung:

InPost ist in Polen äußerst beliebt (über 13.000 Paketschließfächer im ganzen Land). Für InPost-Bestellungen:

1. Generieren Sie ein InPost-Label über die Label-API-Integration des Connectors
2. Drucken Sie es aus und legen Sie es dem Paket bei
3. Geben Sie das Paket am nächstgelegenen InPost-Paketschließfach oder an der Abholstelle eines Kuriers ab
4. InPost-Tracking wird automatisch auf Allegro hochgeladen

---

Einhaltung der polnischen Mehrwertsteuer

Mehrwertsteuersätze in Polen:

Anforderungen an Allegro-Mehrwertsteuerrechnungen:

In Polen müssen Verkäufer gewerblichen Käufern Rechnungen mit ausgewiesener Mehrwertsteuer ausstellen. Der Connector verarbeitet:

1. Erkennen, wenn ein Käufer eine NIP (polnische Steuernummer) angibt – gewerblicher Käufer
2. Erstellen einer Rechnung mit ausgewiesener Mehrwertsteuer mit NIP des Verkäufers und Käufers, Rechnungsnummer und Steueraufschlüsselung
3. Buchung der Rechnung im Buchhaltungsmodul von Odoo
4. Bereitstellung der Rechnung für den Käufer (per Odoo-Portal oder E-Mail)

JPK_V7M-Berichte:

Polen verlangt monatliche JPK_V7M-Mehrwertsteuerberichte. Die polnische Steuerlokalisierung von Odoo generiert diesen Bericht aus Ihren gebuchten Rechnungen und Einkaufsrechnungen. Der Connector stellt sicher, dass Allegro-Verkäufe für die JPK-Einbindung korrekt gekennzeichnet sind.

OSS (One Stop Shop) für EU-übergreifende Verkäufe:

Wenn Sie ein polnischer Verkäufer sind, der an EU-Käufer außerhalb Polens versendet:

• Verkäufe unter 10.000 € Jahresschwelle: Meldung über polnische Mehrwertsteuer (Standard)
• Verkäufe über dem Schwellenwert: Registrieren Sie sich für EU OSS und melden Sie im Land jedes Käufers
• Der Connector markiert EU-übergreifende Verkäufe mit entsprechenden Steuerpositionen für die OSS-Verfolgung

---

Allegro Finanzen und Versöhnung

Allegro-Bezahlung:

Seit 2021 betreibt Allegro eine eigene Zahlungsplattform (Allegro Pay). Verkäufer erhalten:

• Zahlungen von Allegro Pay, die von Käufern eingezogen werden
• Wöchentliche Überweisung von Allegro (abzüglich Gebühren).

Allegro-Gebührenstruktur:

Abstimmungsworkflow:

1. Laden Sie die Allegro-Rechnungs-CSV-Datei aus der Verkäuferzone → Abrechnung herunter
2. Import über Allegro → Finanzen → Abrechnung importieren
3. Connector erstellt Odoo-Journaleinträge:

• Soll: Allegro-Forderung / Haben: Umsatzerlöse
• Lastschrift: Allegro-Provisionsaufwand / Gutschrift: Allegro zahlbar

4. Wenn die wöchentliche Überweisung bei der Bank eintrifft: Mit dem Allegro Pay-Journal abgleichen
5. Monatsende: Allegro-Verkaufsbericht für die Mehrwertsteuererklärung erstellen

---

Allegro Localnie (Tschechische Republik und Slowakei)

Allegro expandierte im Rahmen der CEE-Expansion (Mittel- und Osteuropa) in die Tschechische Republik und in die Slowakei. Der Connector unterstützt diese zusätzlichen Märkte:

• Allegro.cz: Tschechischer Markt, Währung CZK, tschechische Mehrwertsteuer (21 %)
• Allegro.sk: Slowakischer Markt, EUR-Währung, slowakische Mehrwertsteuer (20 %)

Konfigurieren Sie zusätzliche Marktplätze im Connector mit separaten API-Anmeldeinformationen (für tschechische und slowakische Allegro-Konten ist eine separate Verkäuferregistrierung erforderlich).

---

Häufig gestellte Fragen

Ist es möglich, als ausländisches (nicht polnisches) Unternehmen auf Allegro zu verkaufen?

Ja. Allegro akzeptiert Verkäufer aus EU-Ländern. Nicht-polnische EU-Verkäufer müssen über eine EU-Umsatzsteuernummer verfügen und die polnischen Umsatzsteuerpflichten einhalten (entweder sich für die polnische Umsatzsteuer registrieren oder OSS über dem Schwellenwert nutzen). Für Nicht-EU-Verkäufer gelten zusätzliche Anforderungen, einschließlich eines polnischen Fiskalvertreters. Der Connector verwaltet die Mehrwertsteuer sowohl für in Polen registrierte als auch für ausländische Verkäufer mit entsprechender Steuerpositionskonfiguration.

Wie wirkt sich die Streitbeilegung von Allegro auf meine Odoo-Integration aus?

Der Käuferschutz von Allegro ermöglicht Streitigkeiten innerhalb von 20 Tagen nach dem Kauf. Wenn ein Käufer einen Streit eröffnet, vermittelt Allegro. Der Connector importiert Streitfälle als Odoo-Support-Tickets, verknüpft mit dem jeweiligen Verkaufsauftrag. Das Betriebspersonal antwortet über Odoo. Die Lösung wird über das Allegro-Verkäuferportal bestätigt. Bei gelösten Streitigkeiten (Rückerstattung oder Verkäufer gewinnt) wird der Odoo-Bestellstatus entsprechend aktualisiert.

Was sind die Listungsdauer- und Erneuerungsregeln von Allegro?

„Jetzt kaufen“-Angebote sind unbegrenzt gültig (Äquivalent „Gültig bis storniert“). Auktionsangebote haben eine Laufzeit von 3, 5, 7 oder 10 Tagen. Der Connector verwaltet die Angebotsverlängerung für „Jetzt kaufen“-Angebote automatisch. Wenn ein Angebot aufgrund eines Nullbestands endet, wird es neu gestartet, sobald der Lagerbestand wieder aufgefüllt ist. Die Erneuerung des Angebots für Auktionen erfordert manuelle Maßnahmen oder eine automatische Neueinstellungskonfiguration.

Kann ich das One Fulfillment-Programm von Allegro (ähnlich FBA) über den Connector nutzen?

One Fulfillment ist der Lager- und Fulfillment-Service von Allegro (gestartet im Jahr 2023). Der Connector unterstützt eingehende Sendungen von One Fulfillment, die Bestandsverfolgung am virtuellen „Allegro One Fulfillment“-Standort von Odoo und die automatische Validierung erfüllter Bestellungen. Eine Fulfillment-Registrierung wird direkt in der Verkäuferzone verwaltet; Der Connector übernimmt die operative Integration.

Wie verarbeitet der Connector die Werbekampagnen von Allegro (Super Week, Black Friday)?

Allegro führt große Werbeveranstaltungen durch, bei denen teilnehmende Verkäufer 3- bis 10-fache Traffic-Spitzen verzeichnen. Mit der Werbekampagnenfunktion des Connectors können Sie Preisnachlässe für bestimmte Kampagnen mit Start-/Enddatum vorkonfigurieren. Aktivieren Sie den „Kampagnenmodus“ vor größeren Ereignissen, um die Synchronisierungshäufigkeit auf alle 5 Minuten zu erhöhen und zusätzliche Inventarpuffer zu aktivieren.

---

Nächste Schritte

Die Dominanz von Allegro in Polen macht es zu einem nicht verhandelbaren Vertriebskanal für jede Marke, die auf mitteleuropäische Verbraucher abzielt. Aber operative Exzellenz bei Allegro – Smart! Compliance, Mehrwertsteuergenauigkeit, polnischer Kundenservice – erfordert Systeme, die speziell für den Markt entwickelt wurden.

Holen Sie sich den ECOSIRE Allegro Connector für Odoo 19 →

Zu unserem Implementierungsteam gehören polnische Marktspezialisten mit direkter Allegro-Verkäufererfahrung. Wir konfigurieren Ihren Connector, richten die polnische Mehrwertsteuer korrekt ein und schulen Ihr Betriebsteam in Smart! Fulfillment-Workflows. Kontaktieren Sie uns, um Ihre Allegro-Integration zu starten.