Connecteur Odoo Allegro : intégration du marché polonais

Allegro est le leader incontesté du commerce électronique en Pologne, avec plus de 21 millions d'acheteurs enregistrés et une pénétration du marché de 80 % parmi les acheteurs en ligne polonais. Toute marque ou détaillant vendant en Pologne doit avoir une présence Allegro – ce n'est pas facultatif. Pour les équipes opérationnelles gérant Allegro aux côtés d'autres canaux dans Odoo 19 Enterprise, le connecteur ECOSIRE Allegro automatise l'ensemble du flux de travail du vendeur.

Ce guide couvre l'intégration de l'API Allegro, la gestion des offres, l'automatisation des commandes, Smart ! l'exécution du programme, la conformité à la TVA polonaise et les spécificités du rapprochement financier de la vente sur Allegro.

Points clés à retenir

• L'API REST Allegro utilise OAuth 2.0 ; inscription sur apps.allegro.pl
• Les offres (terme d'Allegro pour les annonces) contiennent des données de produits structurées provenant du système de catégories d'Allegro.
• L'importation de commandes inclut l'ID de commande Allegro, les détails de l'acheteur et les préférences de livraison
• Allegro Intelligent ! le programme nécessite une expédition rapide (maximum 1 jour ouvrable pour le badge Smart!)
• La TVA polonaise (standard de 23%) est obligatoire ; tarifs réduits pour les livres (5%), la nourriture (5-8%)
• Exportations Allegro Billing pour l'importation automatique des déclarations de TVA vers Odoo
• La politique prix d'Allegro : des prix compétitifs suivis par la place de marché
• Marchés de la République tchèque et de la République slovaque disponibles via Allegro Lokalnie

---

Présentation du marché Allegro

Pourquoi Allegro domine la Pologne :

Allegro n'est pas seulement une place de marché : c'est la principale plateforme de découverte du commerce de détail en Pologne. Les consommateurs lancent des recherches de produits sur Allegro, et non sur Google, pour la plupart des catégories de produits.

Allegro contre Amazon en Pologne :

Amazon est entré en Pologne en 2021 mais n'a pas délogé Allegro. Les consommateurs polonais font confiance à la protection des acheteurs d'Allegro, Smart ! programme de livraison et écosystème de vendeurs locaux. Pour la plupart des catégories, Allegro génère un volume de ventes 5 à 10 fois supérieur à celui d'Amazon.pl en Pologne.

---

Configuration de l'API Allegro

Étape 1 : Inscrivez-vous en tant que développeur Allegro

1. Créez une application à apps.allegro.pl
2. Choisissez le type "Application Web" (pour OAuth côté serveur)
3. Saisissez votre URI de redirection : https://your-odoo.com/allegro/oauth/callback
4. Notez votre ID client et votre Secret client

Étape 2 : autorisation OAuth 2.0

Allegro utilise le flux OAuth du code d'autorisation (authentification au niveau de l'utilisateur) :

1. Dans les paramètres du connecteur Odoo, cliquez sur Connecter le compte Allegro
2. La fenêtre contextuelle OAuth s'ouvre sur allegro.pl
3. Connectez-vous et autorisez le connecteur
4. Jeton d'accès et jeton d'actualisation stockés automatiquement
5. Les jetons expirent après 12 heures ; les jetons d'actualisation durent 30 jours (rafraîchis automatiquement par le connecteur)

Environnement bac à sable :

Allegro fournit un bac à sable complet sur allegro.pl.allegrosandbox.pl pour les tests :

• Enregistrez un vendeur test sur allegrolokalnie.pl/developer/sandbox -API Sandbox : https://api.allegro.pl.allegrosandbox.pl
• Testez avec des offres réelles et des commandes simulées avant de passer en ligne

---

Configuration du connecteur

Accédez à Ventes → Allegro ou Inventaire → Allegro Marketplace après l'installation.

Configuration du compte :

Configuration des préférences de livraison :

Allegro utilise ses propres services de livraison (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Configurez les services que vous proposez et vos délais de traitement :

---

Gestion des offres

Dans Allegro, les annonces sont appelées « offres ». Chaque offre possède un identifiant Allegro unique et peut être répertoriée comme :

• Acheter maintenant (prix fixe) : équivalent à l'achat immédiat d'autres places de marché
• Enchères : les enchères commencent à un prix fixe
• Acheter maintenant + Enchères : format combiné

Le connecteur gère principalement les offres Acheter maintenant (les plus courantes pour les vendeurs professionnels).

Création d'offres à partir des produits Odoo :

1. Ouvrez le produit → onglet Allegro → Créer une offre
2. Configurez les champs d'offre :

• Titre de l'offre : jusqu'à 50 caractères (concis, riches en mots clés)
• Catégorie : parcourez la taxonomie d'Allegro
• Paramètres : attributs obligatoires spécifiques à la catégorie
• Description : HTML autorisé, langue polonaise principale
• Images : jusqu'à 8 images, minimum 600×600 pixels
• Prix : PLN (TVA incluse)
• Quantité : stock disponible
• Condition : Neuf, Occasion (avec sous-état)
• Paramètres de livraison : quelles méthodes de livraison sont proposées, gratuites/payantes
• Paiement : Allegro Pay, virement bancaire
• Retours : droit de retour de 14 jours (minimum légal en Pologne) ou prolongé

Paramètres de la catégorie Allegro :

Chaque catégorie Allegro a des paramètres requis spécifiques. Le connecteur télécharge les paramètres disponibles par catégorie et crée un formulaire de configuration guidée. Exemple pour « ordinateurs portables » :

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

Mappez les attributs du produit Odoo aux paramètres Allegro dans le tableau de mappage des paramètres du connecteur.

---

Allegro intelligent ! Programme

Allegro intelligent! est un programme d'abonnement (similaire à Amazon Prime) offrant la livraison gratuite sur les offres éligibles. Intelligent! les éléments affichent un badge bien visible et sont mieux classés dans les résultats de recherche.

Intelligent! conditions d'éligibilité :

• Délai maximum d'expédition : 1 jour ouvrable
• Livraison via un transporteur éligible Smart! (Allegro Courier, InPost, DPD, DHL)
• Score minimum de commentaires positifs
• Aucune sanction active sur votre compte

Configuration intelligente ! dans le connecteur :

1. Activez Smart ! dans les paramètres du marché
2. Définissez l'heure d'expédition sur "Le jour même" ou "Le jour suivant" pour les offres éligibles
3. Configurez les méthodes de livraison éligibles à Smart!
4. Le connecteur marque automatiquement les offres éligibles avec Smart ! insigne

Intelligent! impact opérationnel :

Avec Smart! activé :

• Les commandes passées avant votre heure limite (par exemple, 14h00) doivent être expédiées le jour même
• Les commandes passées après la date limite d'expédition sont expédiées le jour ouvrable suivant
• Le connecteur applique le calcul de la date d'expédition en fonction de l'heure limite et de l'heure de passation des commandes
• Une expédition tardive déclenche Smart ! pénalité (perte du badge en cas de récidive)

---

Gestion des commandes

Importation et traitement des commandes :

1. L'acheteur finalise son achat sur Allegro
2. Le connecteur interroge l'API Allegro Orders toutes les 15 minutes
3. Commande importée sur Odoo avec tous les détails requis
4. Commande créée et confirmée automatiquement
5. Bon de livraison créé dans l'inventaire Odoo
6. L'entrepôt exécute la commande en utilisant un transporteur éligible à Smart!
7. Numéro de suivi saisi dans Odoo → le connecteur envoie à Allegro
8. Allegro informe l'acheteur avec un lien de suivi

Mappage des données de commande :

Réalisation du casier à colis Allegro InPost :

InPost est extrêmement populaire en Pologne (plus de 13 000 consignes à colis dans tout le pays). Pour les commandes InPost :

1. Générez une étiquette InPost via l'intégration de l'API d'étiquette du connecteur
2. Imprimez et joignez au colis
3. Déposez le colis au casier à colis InPost ou au point de retrait par coursier le plus proche
4. Suivi InPost automatiquement téléchargé sur Allegro

---

Conformité à la TVA polonaise

Taux de TVA en Pologne :

Exigences relatives à la facture Allegro avec TVA :

En Pologne, les vendeurs doivent émettre des factures TVA (TVA factice) aux acheteurs professionnels. Le connecteur gère :

1. Détecter le moment où un acheteur fournit un NIP (numéro fiscal polonais) – acheteur professionnel
2. Génération d'une facture TVA avec NIP vendeur et acheteur, numéro de facture, répartition fiscale
3. Publication de la facture dans le module comptable d'Odoo
4. Mise à disposition de la facture pour l'acheteur (via le portail Odoo ou email)

Rapport JPK_V7M :

La Pologne exige des rapports mensuels de TVA JPK_V7M. La localisation fiscale polonaise d'Odoo génère ce rapport à partir de vos factures publiées et factures d'achat. Le connecteur garantit que les ventes Allegro sont correctement étiquetées pour l'inclusion JPK.

OSS (One Stop Shop) pour les ventes transeuropéennes :

Si vous êtes un vendeur polonais expédiant des marchandises à des acheteurs de l'UE en dehors de la Pologne :

• Ventes inférieures au seuil annuel de 10 000 € : déclaration via la TVA polonaise (standard)
• Ventes supérieures au seuil : inscrivez-vous à EU OSS et déclarez dans le pays de chaque acheteur
• Le connecteur marque les ventes à travers l'UE avec des positions fiscales appropriées pour le suivi des OSS

---

Allegro Finance et Réconciliation

Allegro Pay :

Depuis 2021, Allegro exploite sa propre plateforme de paiement (Allegro Pay). Les vendeurs reçoivent :

• Paiements d'Allegro Pay collectés auprès des acheteurs
• Versement hebdomadaire d'Allegro (moins les frais)

Structure tarifaire Allegro :

Flux de travail de rapprochement :

1. Téléchargez le CSV de facturation Allegro depuis la Zone Vendeur → Facturation
2. Importer via Allegro → Finance → Importer la facturation
3. Le connecteur crée des entrées de journal Odoo :

• Débit : Allegro à recevoir / Crédit : Chiffre d'affaires
• Débit : Dépense de commission Allegro / Crédit : Allegro à payer

4. Lorsque le virement hebdomadaire arrive en banque : rapprochez-vous du journal Allegro Pay
5. Fin de mois : générer un rapport de ventes Allegro pour la déclaration de TVA

---

Allegro Localnie (République tchèque et Slovaquie)

Allegro s'est étendu à la République tchèque et à la Slovaquie dans le cadre de l'expansion de la CEE (Europe centrale et orientale). Le connecteur prend en charge ces marchés supplémentaires :

• Allegro.cz : marché tchèque, devise CZK, TVA tchèque (21 %)
• Allegro.sk : marché slovaque, devise EUR, TVA slovaque (20 %)

Configurez des places de marché supplémentaires dans le connecteur avec des informations d'identification API distinctes (les comptes Allegro tchèque et slovaque nécessitent un enregistrement de vendeur distinct).

---

Questions fréquemment posées

Est-il possible de vendre sur Allegro en tant que société étrangère (non polonaise) ?

Oui. Allegro accepte les vendeurs des pays de l'UE. Les vendeurs non polonais de l'UE doivent avoir un numéro de TVA européen et se conformer aux obligations polonaises en matière de TVA (soit s'inscrire à la TVA polonaise, soit utiliser OSS au-dessus du seuil). Les vendeurs hors UE sont confrontés à des exigences supplémentaires, notamment celle d’un représentant fiscal polonais. Le connecteur gère la TVA pour les vendeurs enregistrés en Pologne et étrangers avec une configuration de situation fiscale appropriée.

Comment la résolution des litiges d'Allegro affecte-t-elle mon intégration Odoo ?

La protection des acheteurs d'Allegro autorise les litiges dans les 20 jours suivant l'achat. Si un acheteur ouvre un litige, Allegro intervient comme médiateur. Le connecteur importe les cas litigieux sous forme de tickets d'assistance Odoo, liés à la commande de vente concernée. Le personnel des opérations répond via Odoo ; la résolution est confirmée via le portail vendeur Allegro. Les litiges résolus (remboursement ou victoire du vendeur) mettent à jour le statut de la commande Odoo en conséquence.

Quelles sont la durée de référencement et les règles de renouvellement d'Allegro ?

Les offres d'achat immédiat peuvent être valables indéfiniment (équivalent valable jusqu'à annulation). Les offres d'enchères durent 3, 5, 7 ou 10 jours. Le connecteur gère automatiquement le renouvellement des offres pour les offres Acheter maintenant : si une offre se termine en raison d'un stock nul, elle redémarre lorsque l'inventaire est réapprovisionné. Le renouvellement de l'offre pour les enchères nécessite une action manuelle ou une configuration de remise en vente automatique.

Puis-je utiliser le programme One Fulfilment d'Allegro (similaire à Expédié par Amazon) via le connecteur ?

One Fulfilment est le service d'entreposage et de traitement des commandes d'Allegro (lancé en 2023). Le connecteur prend en charge les expéditions entrantes One Fulfilment, le suivi des stocks dans l'emplacement virtuel « Allegro One Fulfilment » d'Odoo et la validation automatique des commandes exécutées. L’inscription One Fulfilment est gérée directement dans la Zone Vendeur ; le connecteur gère l’intégration opérationnelle.

Comment le connecteur gère-t-il les campagnes promotionnelles d'Allegro (Super Week, Black Friday) ?

Allegro organise des événements promotionnels majeurs au cours desquels les vendeurs participants constatent des pics de trafic multipliés par 3 à 10. La fonctionnalité de campagne promotionnelle du connecteur vous permet de préconfigurer des réductions de prix pour des campagnes spécifiques avec des dates de début/fin. Activez le « Mode campagne » avant les événements majeurs pour augmenter la fréquence de synchronisation à toutes les 5 minutes et activer des tampons d'inventaire supplémentaires.

---

Prochaines étapes

La domination d'Allegro en Pologne en fait un canal de vente non négociable pour toute marque ciblant les consommateurs d'Europe centrale. Mais l'excellence opérationnelle sur Allegro — Smart ! la conformité, l'exactitude de la TVA, le service client polonais – nécessitent des systèmes spécialement conçus pour le marché.

Obtenez le connecteur ECOSIRE Allegro pour Odoo 19 →

Notre équipe de mise en œuvre comprend des spécialistes du marché polonais ayant une expérience directe des vendeurs Allegro. Nous configurerons votre connecteur, configurerons correctement la TVA polonaise et formerons votre équipe opérationnelle sur Smart ! flux de travail d'exécution. Contactez-nous pour démarrer votre intégration Allegro.