Odoo Allegro コネクタ: ポーランド マーケットプレイスの統合

このガイドでは、Allegro API 統合、オファー管理、注文自動化、Smart! について説明します。プログラムの履行、ポーランドの VAT コンプライアンス、および Allegro での販売に関する財務調整の詳細。

重要なポイント

• Allegro REST API は OAuth 2.0 を使用します。 apps.allegro.pl での登録
• オファー (Allegro のリスト用語) には、Allegro のカテゴリー システムからの構造化された製品データが含まれています
• 注文のインポートには、Allegro 注文 ID、購入者の詳細、配送設定が含まれます
• アレグロ スマート!プログラムには迅速な発送が必要です (Smart! バッジの場合は最大 1 営業日)
• ポーランドの VAT (標準 23%) は必須です。書籍（5%）、食品（5-8%）の割引率
• VAT レポート用に Allegro Billing をエクスポートし、Odoo に自動的にインポートします
• Allegro の価格政策: 市場によって監視された競争力のある価格設定
• チェコ共和国とスロバキア共和国の市場は Allegro Lokalnie 経由で利用可能

---

Allegro マーケットプレイスの概要

アレグロがポーランドを支配する理由:

Allegro は単なるマーケットプレイスではなく、ポーランドの主要な小売発見プラットフォームです。消費者は、ほとんどの製品カテゴリについて、Google ではなく Allegro で製品検索を開始します。

ポーランドでのアレグロ対アマゾン:

アマゾンは2021年にポーランドに参入したが、アレグロを排除していない。ポーランドの消費者は Allegro の購入者保護を信頼しています、Smart!配送プログラムと地元の販売者のエコシステム。ポーランドでは、ほとんどのカテゴリーにおいて、アレグロは 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. allegro.pl で OAuth ポップアップが開きます
3. ログインしてコネクタを認証します
4. アクセストークンとリフレッシュトークンが自動保存される
5. トークンは 12 時間後に期限切れになります。更新トークンの有効期限は 30 日間です (コネクタによって自動更新されます)

サンドボックス環境:

Allegro は、テスト用に完全なサンドボックスを allegro.pl.allegrosandbox.pl で提供しています。

• allegrolokalnie.pl/developer/sandbox でテスト販売者を登録します
• サンドボックス API: https://api.allegro.pl.allegrosandbox.pl
• 実際のオファーと模擬注文を実際に使用する前にテストします。

---

コネクタの構成

インストール後、Sales → Allegro または Inventory → 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.対象となるオファーの発送時間を「同日」または「翌日」に設定します
2. Smart! 対応の配信方法を構成する
3. コネクタは、適格なオファーを Smart! で自動的にマークします。バッジ

頭いい！運用への影響:

スマートで！有効:

• 締め切り時間 (例: 14:00) より前に行われた注文は、同日発送する必要があります。
• 締め切り後のご注文は翌営業日に発送されます
• コネクタは、締め切り時間と発注時間に基づいて発送日の計算を適用します。
• 発送が遅れるとスマートにトリガーされます。ペナルティ（違反を繰り返した場合はバッジを剥奪）

---

注文管理

注文のインポートと処理:

1. 購入者が Allegro で購入を完了する
2. コネクタは、Allegro Orders API を 15 分ごとにポーリングします。
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 にアップロードされます

---

ポーランドの VAT コンプライアンス

ポーランドの VAT 税率:

Allegro VAT 請求書の要件:

ポーランドでは、売り手は企業の買い手に VAT 請求書 (偽造 VAT) を発行する必要があります。コネクタは以下を処理します。

1. 購入者が NIP (ポーランド税番号) を提供したときの検出 — ビジネス購入者
2. 売り手と買い手のNIP、請求書番号、税金の内訳を記載したVAT請求書の生成
3. Odoo の会計モジュールに請求書を転記する
4. 購入者が請求書を利用できるようにする (Odoo ポータルまたは電子メール経由)

JPK_V7M レポート:

ポーランドでは月次 JPK_V7M VAT レポートが必要です。 Odoo のポーランド会計ローカリゼーションは、転記された請求書と購入請求書からこのレポートを生成します。コネクタにより、Allegro の販売が JPK を含めるために正しくタグ付けされるようになります。

EU 間での販売のための OSS (ワンストップショップ):

あなたがポーランド国外の EU 購入者に配送するポーランドの販売者の場合:

• 年間基準額 10,000 ユーロ未満の売上: ポーランドの VAT (標準) を通じて報告
• 閾値を超える売上: EU OSS に登録し、各購入者の国で報告します。
• コネクタは、OSS 追跡に適切な会計位置を備えた EU 間の売上をマークします。

---

Allegro の財務と調整

アレグロ支払い:

2021 年以降、Allegro は独自の決済プラットフォーム (Allegro Pay) を運営しています。販売者は以下を受け取ります:

• 購入者から徴収された Allegro Pay からの支払い
• Allegro からの毎週の送金 (手数料を除く)

Allegro の料金体系:

調整ワークフロー:

1. Seller Zone → Billing から Allegro の請求 CSV をダウンロードします。
2. Allegro → Finance → Import Billing 経由でインポート
3. コネクタは Odoo ジャーナル エントリを作成します。

• 借方: Allegro Receivable / 貸方: 売上収益
• 借方: Allegro 手数料 / 貸方: Allegro Payable

4. 毎週の振込が銀行に到着したら、Allegro Pay 仕訳帳と照合します。
5. 月末: VAT 申告用の Allegro 売上レポートを生成します。

---

Allegro Localnie (チェコ共和国およびスロバキア)

Allegro は、CEE (中央および東ヨーロッパ) 拡大の一環として、チェコ共和国とスロバキアに事業を拡大しました。コネクタは、次の追加市場をサポートします。

• Allegro.cz: チェコ市場、CZK 通貨、チェコ VAT (21%)
• Allegro.sk: スロバキア市場、ユーロ通貨、スロバキア VAT (20%)

別の API 資格情報を使用してコネクタで追加のマーケットプレイスを構成します (チェコおよびスロバキアの Allegro アカウントには別の販売者登録が必要です)。

---

よくある質問

外国 (非ポーランド) 企業として Allegro で販売することは可能ですか?

はい。 Allegro は EU 諸国からの販売者を受け入れます。ポーランド以外の EU 販売者は EU VAT 番号を持ち、ポーランドの VAT 義務を遵守する必要があります (ポーランドの VAT に登録するか、しきい値を超える OSS を使用するかのいずれか)。 EU 以外の販売者には、ポーランドの会計代表者などの追加要件が課されます。このコネクタは、適切な会計上のポジション構成を使用して、ポーランド登録の販売者と外国の販売者の両方の VAT を処理します。

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」ロケーションでの在庫追跡、および処理された注文の自動検証をサポートしています。 1 つのフルフィルメント登録はセラーゾーンで直接管理されます。コネクタは運用上の統合を処理します。

コネクタは Allegro のプロモーション キャンペーン (スーパー ウィーク、ブラック フライデー) をどのように処理しますか?

Allegro は大規模なプロモーション イベントを開催しており、参加している販売者のトラフィックが 3 ～ 10 倍に急増しています。コネクタのプロモーション キャンペーン機能を使用すると、開始日と終了日を指定して特定のキャンペーンの値下げを事前に構成できます。主要なイベントの前に「キャンペーン モード」を有効にして、同期頻度を 5 分ごとに増やし、追加のインベントリ バッファをアクティブにします。

---

次のステップ

ポーランドにおけるアレグロの優位性により、中央ヨーロッパの消費者をターゲットとするあらゆるブランドにとって、アレグロは交渉の余地のない販売チャネルとなっています。しかし、Allegro のオペレーショナル エクセレンスはスマートです。コンプライアンス、VAT の正確性、ポーランドの顧客サービスには、市場専用に構築されたシステムが必要です。

Odoo 19 用 ECOSIRE Allegro コネクタを入手 →

当社の実装チームには、Allegro の販売者としての直接の経験を持つポーランド市場のスペシャリストが含まれています。コネクタを構成し、ポーランドの VAT を正しく設定し、Smart! に関する運用チームをトレーニングします。フルフィルメントのワークフロー。 Allegro の統合を開始するには、お問い合わせください。