Odoo Allegro Connector: Polish Marketplace Integration

Integrate Odoo 19 with Allegro, Poland's dominant eCommerce marketplace. Automate listings, orders, inventory, Smart! program management, and PLN financial reconciliation.

E
ECOSIRE Research and Development Team
|19 Mart 20269 dk okuma2.1k Kelime|

Odoo Allegro Bağlayıcısı: Polonya Pazaryeri Entegrasyonu

Allegro, 21 milyondan fazla kayıtlı alıcısı ve Polonyalı çevrimiçi alışveriş yapanlar arasında %80 pazar penetrasyonuyla Polonya'nın tartışmasız e-Ticaret lideridir. Polonya'ya satış yapan herhangi bir marka veya perakendecinin bir Allegro varlığına sahip olması gerekir; bu isteğe bağlı değildir. Odoo 19 Enterprise'daki diğer kanalların yanı sıra Allegro'yu yöneten operasyon ekipleri için ECOSIRE Allegro Connector tüm satıcı iş akışını otomatikleştirir.

Bu kılavuz Allegro API entegrasyonunu, teklif yönetimini, sipariş otomasyonunu, Smart! programın yerine getirilmesi, Polonya'da KDV uyumluluğu ve Allegro'da satışın mali mutabakat ayrıntıları.

Önemli Çıkarımlar

  • Allegro REST API, OAuth 2.0'ı kullanır; apps.allegro.pl adresinden kayıt
  • Teklifler (Allegro'nun listeleme terimi), Allegro'nun kategori sisteminden yapılandırılmış ürün verilerine sahiptir
  • Siparişin içe aktarılması Allegro Sipariş Kimliğini, alıcı ayrıntılarını ve teslimat tercihini içerir
  • Allegro Akıllı! program hızlı gönderim gerektirir (Smart! rozeti için maksimum 1 iş günü)
  • Polonya KDV'si (%23 standart) zorunludur; Kitaplar (%5), yiyecekler (%5-8) için indirimli oranlar
  • KDV raporlamasının otomatik olarak Odoo'ya aktarılması için Allegro Faturalandırma aktarımları
  • Allegro'nun fiyat politikası: pazar tarafından izlenen rekabetçi fiyatlandırma
  • Çek Cumhuriyeti ve Slovak Cumhuriyeti pazarlarına Allegro Lokalnie aracılığıyla ulaşılabilir

Allegro Pazaryerine Genel Bakış

Allegro neden Polonya'ya hakim:

MetrikDeğer
Aylık benzersiz alıcılar21 milyon+
Polonya e-Ticaretinde pazar payı~%80
Aktif satıcılar100.000+
Yıllık GMV~15 milyar PLN
Akıllı! aboneler4 milyondan fazla

Allegro sadece bir pazar yeri değil, aynı zamanda Polonya'nın birincil perakende keşif platformudur. Tüketiciler çoğu ürün kategorisi için ürün aramalarını Google'da değil Allegro'da başlatıyor.

Allegro, Polonya'da Amazon'a karşı:

Amazon 2021'de Polonya'ya girdi ancak Allegro'yu yerinden edemedi. Polonyalı tüketiciler Allegro'nun alıcı koruması Smart'a güveniyor! teslimat programı ve yerel satıcı ekosistemi. Çoğu kategoride Allegro, Polonya'daki Amazon.pl'den 5-10 kat daha fazla satış hacmi elde ediyor.


Allegro API Kurulumu

1. Adım: Allegro geliştiricisi olarak kaydolun

  1. apps.allegro.pl adresinde bir uygulama oluşturun
  2. "Web Uygulaması" türünü seçin (sunucu tarafı OAuth için)
  3. Yönlendirme URI'nizi girin: https://your-odoo.com/allegro/oauth/callback
  4. Müşteri Kimliğinizi ve Müşteri Sırrınızı not edin

2. Adım: OAuth 2.0 yetkilendirmesi

Allegro, yetkilendirme kodu OAuth akışını (kullanıcı düzeyinde kimlik doğrulama) kullanır:

  1. Odoo bağlayıcı ayarlarında Allegro Hesabını Bağla'ya tıklayın
  2. allegro.pl'de OAuth açılır penceresi açılır
  3. Oturum açın ve bağlayıcıyı yetkilendirin
  4. Otomatik olarak depolanan jetona erişin ve jetonu yenileyin
  5. Jetonların geçerliliği 12 saat sonra sona erer; yenileme jetonları 30 gün sürer (bağlayıcı tarafından otomatik olarak yenilenir)

Korumalı alan ortamı:

Allegro, test için allegro.pl.allegrosandbox.pl adresinde tam bir sanal alan sağlar:

  • allegrolokalnie.pl/developer/sandbox adresinden bir test satıcısı kaydedin
  • Korumalı alan API'si: https://api.allegro.pl.allegrosandbox.pl
  • Yayına geçmeden önce gerçek görünümlü teklifler ve sahte siparişlerle test edin

Bağlayıcı Yapılandırması

Kurulumdan sonra Satış → Allegro veya Envanter → Allegro Pazaryeri'ne gidin.

Hesap yapılandırması:

AlanAçıklama
Satıcı AdıAllegro hesabı girişi
Müşteri Kimliğiapps.allegro.pl'den
Müşteri Sırrıapps.allegro.pl'den
Erişim JetonuOtomatik olarak dolduruldu
Jetonu YenileOtomatik olarak dolduruldu
Allegro ÇevreÜretim / Sandbox
Varsayılan DepoPolonya'da sipariş karşılama deposu
Para BirimiPLN (Polonya Zlotisi)
KDV NumarasıNIP (Polonya vergi numarası)
Varsayılan Ödeme GünlüğüAllegro Ödeme günlüğü
Teslimat Tercihleri ​​Aşağıya bakın
Akıllı! UygunEvet/Hayır (Allegro Smart'a kayıtlıysanız!)

Teslimat tercihleri yapılandırması:

Allegro kendi teslimat hizmetlerini kullanıyor (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Hangi hizmetleri sunduğunuzu ve işlem sürelerinizi yapılandırın:

Teslimat HizmetiTipik Toplu TaşımaAkıllı! Uygun
Allegro KuryeErtesi günEvet
Gönderi İçi Paket Dolabı1-2 günEvet
DPD1-2 günEvet
DHL1-2 günEvet
Poczta Polska2-5 günHayır

Teklif Yönetimi

Allegro'da listelemelere "teklifler" denir. Her teklifin benzersiz bir Allegro kimliği vardır ve şu şekilde listelenebilir:

  • Hemen Satın Al (sabit fiyat): diğer pazar yerlerindeki Hemen Al'a eşdeğerdir
  • Açık artırma: teklif verme belirli bir fiyattan başlar
  • Hemen Satın Al + Açık Artırma: birleşik format

Bağlayıcı öncelikle Şimdi Satın Al tekliflerini yönetir (en yaygın olanı ticari satıcılar için).

Odoo ürünlerinden teklif oluşturma:

  1. Ürünü açın → Allegro sekmesi → Teklif Oluştur
  2. Teklif alanlarını yapılandırın:
  • Teklif Başlığı: en fazla 50 karakter (özlü, anahtar kelime açısından zengin)
  • Kategori: Allegro'nun sınıflandırmasına göz atın
  • Parametreler: kategoriye özgü gerekli özellikler
  • Açıklama: HTML'ye izin verilir, birincil dil Lehçedir
  • Resimler: en fazla 8 resim, minimum 600×600 piksel
  • Fiyat: PLN (KDV dahil)
  • Miktar: mevcut stok
  • Durum: Yeni, Kullanılmış (alt koşullu)
  • Teslimat Ayarları: sunulan teslimat yöntemleri, ücretsiz/ücretli
  • Ödeme: Allegro Pay, banka havalesi
  • İade: 14 günlük iade hakkı (Polonya'da yasal minimum) veya uzatılmış

Allegro kategorisi parametreleri:

Her Allegro kategorisinin belirli gerekli parametreleri vardır. Bağlayıcı, kategori başına mevcut parametreleri indirir ve yönlendirmeli bir yapılandırma formu oluşturur. "Dizüstü bilgisayarlar" için örnek:

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 ürün özelliklerini konektörün parametre eşleme tablosundaki Allegro parametreleriyle eşleyin.


Allegro Akıllı! programı

Allegro Akıllı! uygun tekliflerde ücretsiz teslimat sunan bir abonelik programıdır (Amazon Prime'a benzer). Akıllı! öğeler belirgin bir rozet gösterir ve arama sonuçlarında daha üst sıralarda yer alır.

Akıllı! uygunluk koşulları:

  • Maksimum gönderim süresi: 1 iş günü
  • Smart!'a uygun taşıyıcı (Allegro Courier, InPost, DPD, DHL) aracılığıyla teslimat
  • Minimum olumlu geribildirim puanı
  • Hesabınızda aktif yaptırım yok

Smart'ı Yapılandırma! konnektörde:

  1. Smart'ı etkinleştirin! pazar yeri ayarlarında
  2. Uygun tekliflerde gönderim süresini "Aynı Gün" veya "Ertesi Gün" olarak ayarlayın
  3. Smart!'a uygun dağıtım yöntemlerini yapılandırın
  4. Bağlayıcı, Smart! ile uygun teklifleri otomatik olarak işaretler! rozet

Akıllı! operasyonel etki:

Akıllı ile! etkin:

  • Son sipariş saatinizden (örn. 14:00) önce verilen siparişler aynı gün kargoya verilmelidir
  • Kesimden sonra verilen siparişler bir sonraki iş günü kargoya verilir
  • Bağlayıcı, son tarih ve sipariş verme zamanına göre sevk tarihi hesaplamasını uygular
  • Geç gönderim Smart'ı tetikler! ceza (tekrarlanan ihlaller nedeniyle rozet kaybı)

Sipariş Yönetimi

Siparişin içe aktarılması ve işlenmesi:

  1. Alıcı, satın alma işlemini Allegro'da tamamlar
  2. Bağlayıcı her 15 dakikada bir Allegro Siparişler API'sini yoklar
  3. Gerekli tüm ayrıntılarla birlikte Odoo'ya aktarılan sipariş
  4. Satış siparişi otomatik olarak oluşturulur ve onaylanır
  5. Odoo envanterinde oluşturulan teslimat siparişi
  6. Depo, siparişi Smart!'a uygun taşıyıcıyı kullanarak yerine getirir
  7. Odoo'ya girilen takip numarası → konektör Allegro'ya gönderilir
  8. Allegro alıcıyı takip bağlantısıyla bilgilendirir

Sipariş verileri eşleme:

Allegro SahasıOdoo Alanı
Sipariş KimliğiReferans ("ALG-" önekiyle)
Alıcı AdıMüşteri adı
Teslimat AdresiTeslimat adresi
Teklif KimliğiBağlantılı ürün
MiktarHat miktarı
Birim Fiyatı (brüt)Vergi dahil fiyat
Teslimat MaliyetiNakliye ücreti hattı
Ödeme YöntemiÖdeme türü
Teslimat YöntemiTaşıyıcı

Allegro InPost Paket Dolabının yerine getirilmesi:

InPost, Polonya'da son derece popülerdir (ülke çapında 13.000'den fazla paket dolabı). InPost siparişleri için:

  1. Bağlayıcının etiket API entegrasyonu aracılığıyla InPost etiketi oluşturun
  2. Yazdırın ve pakete ekleyin
  3. Paketi en yakın InPost paket dolabına veya kurye teslim alma noktasına bırakın
  4. InPost takibi otomatik olarak Allegro'ya yüklendi

Polonya'da KDV Uyumluluğu

Polonya'daki KDV oranları:

KategoriOranı
Standart ürünler%23
İndirimli (yiyecek, kitap, çocuk eşyaları)%5 veya %8
Sıfır oran (ihracat)%0
Muaf (tıbbi hizmetler, eğitim)Muaf

Allegro KDV fatura gereksinimleri:

Polonya'da satıcıların ticari alıcılara KDV faturaları (faktury KDV) düzenlemesi gerekir. Konektör şunları yönetir:

  1. Bir alıcının NIP (Polonya vergi numarası) sağladığını tespit etme - ticari alıcı
  2. Satıcı ve alıcı NIP'si, fatura numarası, vergi dökümü ile KDV faturasının oluşturulması
  3. Faturayı Odoo'nun muhasebe modülüne göndermek
  4. Faturanın alıcıya sunulması (Odoo portalı veya e-posta yoluyla)

JPK_V7M raporlaması:

Polonya aylık JPK_V7M KDV raporu talep etmektedir. Odoo'nun Polonya mali yerelleştirmesi bu raporu, gönderilen faturalarınızdan ve satın alma faturalarınızdan oluşturur. Bağlayıcı, Allegro satışlarının JPK'nın dahil edilmesi için doğru şekilde etiketlenmesini sağlar.

AB çapında satışlar için OSS (Tek Noktadan Hizmet):

Polonya dışındaki AB alıcılarına gönderim yapan Polonyalı bir satıcıysanız:

  • Yıllık 10.000 € eşiğinin altındaki satışlar: Polonya KDV'si aracılığıyla raporlama (standart)
  • Eşiğin üzerindeki satışlar: AB OSS'ye kaydolun ve her alıcının ülkesinde rapor verin
  • Bağlayıcı, AB arası satışları OSS takibi için uygun mali pozisyonlarla işaretler

Allegro Finans ve Uzlaşma

Allegro Ödemesi:

Allegro, 2021'den beri kendi ödeme platformunu (Allegro Pay) işletiyor. Satıcılar şunları alır:

  • Allegro Pay'den alıcılardan tahsil edilen ödemeler
  • Haftalık Allegro'dan havale (eksi ücretler)

Allegro ücret yapısı:

Ücret TürüOranı
Başarı Ücreti (komisyon)%4-10 (kategoriye bağlı)
Teklif Promosyonuİsteğe bağlı (tıklama başına ödeme)
Akıllı! TeslimatAllegro tarafından anlaşılan taşıyıcı ücreti
Allegro Ödeme işlemeBaşarı ücretine dahil

Mutabakat iş akışı:

  1. Satıcı Bölgesinden Allegro faturalandırma CSV dosyasını indirin → Faturalandırma
  2. Allegro → Finans → Faturalandırmayı İthalat yoluyla içe aktarın
  3. Bağlayıcı Odoo günlük girişleri oluşturur:
  • Borç: Allegro Alacak / Alacak: Satış Geliri
  • Borç: Allegro Komisyon Giderleri / Alacak: Allegro Ödenecek
  1. Haftalık transfer bankaya ulaştığında: Allegro Pay dergisiyle mutabakat sağlayın
  2. Ay sonu: KDV beyannamesi için Allegro satış raporu oluşturun

Allegro Localnie (Çek Cumhuriyeti ve Slovakya)

Allegro, CEE (Orta ve Doğu Avrupa) genişlemesinin bir parçası olarak Çek Cumhuriyeti ve Slovakya'ya genişledi. Konektör şu ek pazarları destekler:

  • Allegro.cz: Çek pazarı, CZK para birimi, Çek KDV'si (%21)
  • Allegro.sk: Slovak pazarı, Euro para birimi, Slovak KDV'si (%20)

Bağlayıcıda ayrı API kimlik bilgileriyle ek pazaryerleri yapılandırın (Çek ve Slovak Allegro hesapları ayrı satıcı kaydı gerektirir).


Sıkça Sorulan Sorular

Yabancı (Polonya dışı) bir şirket olarak Allegro'da satış yapmak mümkün mü?

Evet. Allegro AB ülkelerinden satıcıları kabul ediyor. Polonyalı olmayan AB satıcılarının bir AB KDV numarasına sahip olmaları ve Polonya KDV yükümlülüklerine uymaları gerekir (Polonya KDV'sine kaydolmalı veya eşiğin üzerinde OSS kullanmalıdır). AB dışı satıcılar, Polonyalı bir mali temsilci dahil olmak üzere ek gereksinimlerle karşı karşıyadır. Bağlayıcı, uygun mali konum yapılandırmasına sahip hem Polonya'da kayıtlı hem de yabancı satıcılar için KDV'yi yönetir.

Allegro'nun anlaşmazlık çözümü Odoo entegrasyonumu nasıl etkiler?

Allegro'nun alıcı koruması, satın alma tarihinden itibaren 20 gün içinde anlaşmazlıklara izin verir. Bir alıcı anlaşmazlığı açarsa Allegro arabuluculuk yapar. Bağlayıcı, anlaşmazlık durumlarını ilgili satış siparişine bağlı Odoo destek biletleri olarak içe aktarır. Operasyon personeli Odoo aracılığıyla yanıt veriyor; çözüm Allegro satıcı portalı aracılığıyla onaylanır. Çözülmüş anlaşmazlıklar (geri ödeme veya satıcı kazanır), Odoo sipariş durumunu buna göre günceller.

Allegro'nun listeleme süresi ve yenileme kuralları nelerdir?

Şimdi Satın Al teklifleri süresiz olarak geçerli olabilir (İptal Edilene Kadar Geçerli eşdeğeri). Açık artırma teklifleri 3, 5, 7 veya 10 gün süreyle geçerlidir. Bağlayıcı, Şimdi Satın Al teklifleri için teklif yenilemeyi otomatik olarak yönetir; bir teklif stokun sıfır olması nedeniyle sona ererse envanter yenilendiğinde yeniden başlar. Açık artırmalar için teklifin yenilenmesi, manuel işlem veya otomatik yeniden listeleme yapılandırması gerektirir.

Allegro'nun One Fulfillment programını (FBA'ya benzer) bağlayıcı aracılığıyla kullanabilir miyim?

One Fulfillment, Allegro'nun depolama ve sipariş karşılama hizmetidir (2023'te başlatılmıştır). Bağlayıcı, One Fulfillment gelen gönderilerini, Odoo'nun sanal "Allegro One Fulfillment" konumunda envanter takibini ve yerine getirilen siparişlerin otomatik olarak doğrulanmasını destekler. Bir Sipariş Karşılaması kaydı doğrudan Satıcı Bölgesinde yönetilir; bağlayıcı operasyonel entegrasyonu yönetir.

Bağlayıcı, Allegro'nun tanıtım kampanyalarını (Süper Hafta, Kara Cuma) nasıl ele alıyor?

Allegro, katılımcı satıcıların trafikte 3 ila 10 kat artış gördüğü büyük promosyon etkinlikleri yürütüyor. Bağlayıcının promosyon kampanyası özelliği, başlangıç/bitiş tarihlerine sahip belirli kampanyalar için fiyat indirimlerini önceden yapılandırmanıza olanak tanır. Senkronizasyon sıklığını her 5 dakikada bir artırmak ve ekstra envanter arabelleklerini etkinleştirmek için büyük olaylardan önce "Kampanya Modu"nu etkinleştirin.


Sonraki Adımlar

Allegro'nun Polonya'daki hakimiyeti, onu Orta Avrupalı ​​tüketicileri hedefleyen herhangi bir marka için pazarlık konusu edilemez bir satış kanalı haline getiriyor. Ancak Allegro'da operasyonel mükemmellik — Akıllı! uyumluluk, KDV doğruluğu, Polonya müşteri hizmetleri — pazar için özel olarak tasarlanmış sistemler gerektirir.

Odoo 19 için ECOSIRE Allegro Konektörünü edinin →

Uygulama ekibimiz, doğrudan Allegro satıcı deneyimine sahip Polonyalı pazar uzmanlarından oluşmaktadır. Bağlayıcınızı yapılandıracağız, Polonya KDV'sini doğru şekilde ayarlayacağız ve operasyon ekibinizi Smart konusunda eğiteceğiz! yerine getirme iş akışları. Allegro entegrasyonunuzu başlatmak için bizimle iletişime geçin.

E

Yazan

ECOSIRE Research and Development Team

ECOSIRE'da kurumsal düzeyde dijital ürünler geliştiriyor. Odoo entegrasyonları, e-ticaret otomasyonu ve yapay zeka destekli iş çözümleri hakkında içgörüler paylaşıyor.

WhatsApp'ta Sohbet Et