Odoo Etsy コネクタ: ハンドメイドコマースの統合

ECOSIRE Odoo Etsy コネクタは、Etsy ショップと Odoo を橋渡しし、商品情報、注文、在庫、顧客データを同期します。このガイドでは、Etsy API 認証情報の設定から製造注文管理、Etsy 販売者レポートまでの完全な統合について説明します。

重要なポイント

• コネクタは OAuth 2.0 認証を備えた Etsy API v3 を使用します
• リストは両方向で同期します: Odoo で作成、Etsy に公開
• 注文のインポートには、購入者の詳細、アイテムのカスタマイズに関するメモ、ギフト包装フラグが含まれます
• Odoo での在庫変更から 5 分以内に在庫が Etsy にプッシュされます
• 製造オーダー (MRP) 統合により、受注生産のハンドメイド商品を追跡します
• Etsy の手数料と支払い処理手数料は Odoo の請求書と自動的に照合されます
• 複数のショップをサポート: 1 つの Odoo インスタンスから複数の Etsy ストアを管理
• Etsy のリスティングの更新 (リスティングごとに 20 セントの自動更新) は Odoo のコストで追跡されます

---

Etsy セラーに Odoo の統合が必要な理由

Etsy に組み込まれたショップ マネージャーは基本的な注文追跡を処理しますが、成長するハンドメイド ビジネスに必要な深さが欠けています。

Odoo は、月収 10,000 ドル以上の販売者、またはハンドメイドと材料全体で 50 以上のアクティブな SKU を管理している販売者にとって、ビジネスに合わせて拡張する運用機能を提供します。

---

Etsy API セットアップ

ステップ 1: Etsy 開発者アカウントを作成する

1. developers.etsy.com に移動し、Etsy 販売者アカウントでサインインします。
2. [マイ アプリ] の下の [アプリの作成] をクリックします。
3. アプリに名前を付け（例：「Odoo Integration」）、その目的を説明します
4. Etsy API 利用規約に同意する
5. Etsy があなたの申請を審査します (通常 1 ～ 3 営業日)

ステップ 2: OAuth スコープを構成する

アプリには次の OAuth 2.0 スコープが必要です。

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

ステップ 3: API 認証情報を生成する

承認後:

• API キー (キー文字列): アプリケーション識別子
• 共有シークレット: OAuth PKCE フローに使用されます
• リダイレクト URI: https://your-odoo.com/etsy/oauth/callback

ステップ 4: OAuth 認証を完了する

Odoo のコネクタ構成から:

1. Etsy ショップに接続 をクリックします
2. Etsy OAuth ポップアップでコネクタを認証します。
3. コネクタはアクセス トークンとリフレッシュ トークンを受信して保存します。

Etsy の OAuth トークンは、一定の期限で期限切れになりません (Amazon の 18 か月のリフレッシュ トークンとは異なります)。取り消すまでは有効です。

---

コネクタのインストールと構成

ECOSIRE マーケットプレイスからインストール:

ECOSIRE 製品 で入手できます。購入後:

1. アプリ経由で Etsy コネクタ モジュールをアップロードしてインストールします
2. 在庫 → Etsy または 販売 → Etsy ショップ に移動します

ショップ構成:

Etsy ショップ セクションのマッピング:

Etsy では、リストをショップ セクション (カテゴリに相当) に分類します。 Etsy セクションを Odoo 製品カテゴリにマッピングします。

---

リスティング管理

Odoo 製品から Etsy リスティングを作成する:

1. 商品フォームを開く → Etsy タブ → 出品の作成
2. リスト固有のフィールドを構成します。

• タイトル: 最大 140 文字、Etsy SEO 向けのキーワードが豊富
• 説明: 素材、寸法、お手入れ方法を含む完全な説明
• タグ: 最大 13 個のタグ。Etsy の検索アルゴリズムに重要です
• カテゴリ: Etsy の分類ツリーを参照します。
• 誰が作ったか: 私が作りました、私のショップのメンバー、他の誰かが作りました
• 製造時期: オーダーメイド、2020 ～ 2025 年、2010 ～ 2019 年など。
• タイプ: 物理アイテム、デジタルダウンロード
• 価格: 表示価格 (Odoo の表示価格とは異なる場合があります)
• 数量: リスト可能な在庫
• マテリアル: 最大 13 個のマテリアルタグ
• 写真: 最大 10 枚の写真 (最初の画像がメインの出品画像になります)

3. Etsy に公開 をクリックします

バリエーションリスト (製品バリエーション):

Etsy は「バリエーション」をサポートしています — Odoo はこれらを製品属性にマッピングします。

例: サイズ 5 ～ 10 のゴールド/シルバーで販売されるリングは、12 のバリエーションの組み合わせを含む単一の Etsy リストを作成し、それぞれに独自の価格と在庫追跡が含まれます。

パーソナライズされたカスタムオーダーのリスト:

Etsy はパーソナライズされたアイテムで有名です。コネクタでパーソナライゼーションを構成します。

• リスティングで パーソナライゼーションが必須/オプション を有効にします
• 購入者はチェックアウト時にパーソナライズテキスト (名前、日付、モノグラム) を入力します。
• このテキストは、Odoo 販売注文の顧客メモ フィールドに表示されます。
• 生産チームはアイテムを作成するときにカスタマイズを確認します

---

注文の同期

注文インポートの詳細:

Etsy の注文には、ハンドメイド販売者にとって重要なフィールドが含まれています。

受注生産の注文ルーティング:

Etsy セラーは注文を受けてから商品を作ることがよくあります (MTO)。コネクタを構成します。

1. 製品設定 → 販売タブ → オンデマンド: 「受注生産」
2. Etsy の注文がインポートされると、Odoo は以下を作成します:

• 販売注文（確認済み） ・販売に連動した製造指図（案）
• 製造オーダーには、必要な材料と作業時間が示されています。

3. 生産チームは製造オーダーを処理します。 4.MO完了後、商品入荷→納期確定
4. 発送の詳細が Etsy に返送される

カスタムオーダーの取り扱い:

カスタムコミッションの場合 (Etsy には掲載されていません):

1. Etsy でカスタムオーダーを受け入れる
2. Odoo で、合意された価格で「カスタム製品」の販売注文を手動で作成します
3. 注文メモ内の Etsy の会話へのリンク
4. Etsy で手動またはコネクタのカスタム注文ツール経由で出荷済みとしてマークします

---

インベントリの同期

物理的な製品の場合:

インベントリの同期は、デフォルトでは 5 分ごとに実行されます。 Odoo の株価が変化すると:

1. 再計算された利用可能数量 (手持から引当を差し引いた)
2. Listing Inventory API 経由で Etsy にプッシュされた数量
3. 数量が 0 に達した場合: 出品は完売に設定されます (出品はアクティブのままになります)。
4. 再入荷時: リストは自動的に再アクティブ化されます

受注生産品の場合

MTO 製品は、従来の意味での物理的な在庫を追跡しません。 Etsy の出品数量を生産能力指標として設定します。

• 現在の注文容量を表す固定の「利用可能数量」(例: 5) を設定します。
• 生産キューがいっぱいになるにつれて手動で調整します

デジタルダウンロードの場合:

デジタル製品には無限の在庫があります。コネクタは Etsy の数量を 999 に設定し、在庫の変更を同期しません。デジタル ファイルの配信は、Etsy のネイティブ デジタル ダウンロード システムによって処理されます。コネクタはファイル配信には影響しません。

---

財務調整

Etsy の支払い処理と料金体系には、慎重な会計設定が必要です。

Etsy ペイメントの料金体系 (参考):

• 掲載手数料: 掲載ごとに 0.20 ドル (掲載時に課金され、自動更新では 4 か月ごとに請求されます)
• 取引手数料: 商品価格の6.5% + 送料
• 支払い処理手数料: 3% + 取引ごとに 0.25 ドル (米国)
• オフサイト広告料金: Etsy が商品を宣伝する場合 (登録されている場合) 12 ～ 15%

Odoo での料金調整の設定:

1. 専用の Etsy Payments 仕訳帳を作成します (銀行タイプ)
2. アカウントを作成します。

• Etsy Listing Fees (経費)
• Etsy Transaction Fees (経費)
• Etsy Payment Processing Fees (経費)
• Etsy Payments Receivable (現在の資産)

3. Etsy 支払い明細をインポートします:

• Etsy → 支払い → 月次明細 → CSV のダウンロードに移動します
• コネクタの調整ツールへのインポート
• コネクタは、トランザクション タイプごとにジャーナル エントリを作成します。

月末調整プロセス:

1. Etsy 月額支払い CSV をダウンロード
2. コネクタ経由でインポート: Etsy → 調整 → インポート明細
3. 自動一致エントリを確認する
4. 認識されていないトランザクションを手動で照合する
5. 調整を確認 → Odoo に仕訳を投稿
6. Etsy ペイメントの銀行口座と Odoo 残高を照合する

---

Etsy SEO とパフォーマンス追跡

パフォーマンス同期のリスト:

コネクタは Etsy ショップの統計情報を Odoo にインポートします。

• 1 日あたりのリスティングごとの閲覧数
• お気に入りの数
• コンバージョン率（売上に対する閲覧数）
• 上場による収益

このデータは Odoo の Etsy 分析ダッシュボードに表示されるため、Etsy の統計インターフェースに切り替えることなく、成績上位のリストとパフォーマンスの低いリストを特定できます。

タグとキーワードの追跡:

Etsy の Shop Stats API から統計を取得することで、どの検索語が Etsy トラフィックを促進しているかを追跡します。このデータを次の目的で使用します。

• 類似のリストに追加するコンバージョン率の高いタグを特定する
• 閲覧数は多いがコンバージョンが低いリスティングを見つける (価格設定や写真の問題)
• 製品カテゴリの季節的傾向を特定します

---

よくある質問

コネクタは Etsy マーケットプレイスに加えて Etsy のパターン (カスタム Web サイト) も処理できますか?

いいえ。コネクタは特に Etsy マーケットプレイスと統合されています。 Etsy Pattern (ホスト型ウェブサイトビルダー) は同じ在庫を共有しますが、チェックアウトと支払い処理を別々に使用します。パターンオーダーは個別に管理する必要があります。フル機能の Web サイト統合の場合は、Odoo の Web サイト モジュールまたは Shopify 統合をお勧めします。

コネクタは Etsy の取引準備金 (Etsy 支払い保留) をどのように処理しますか?

Etsy は、リスク管理のために新規販売者の支払いに引当金を設けることがあります。コネクタは、各注文の支払いステータスを追跡します。予約金額は Etsy ペイメント残高に表示されますが、引き出すことはできません。コネクタは、準備金が解放されるまでこれらの請求書を「支払い保留中」としてマークし、資金が銀行に解放されると「支払い済み」に更新します。

1 つの Odoo インスタンスから複数の Etsy ショップ (例: 1 つはジュエリー、もう 1 つはインテリア) を管理できますか?

はい。ショップごとに独立した OAuth 認証情報を使用して、個別の Etsy ショップ設定を作成します。各ショップには独自の注文インポート、在庫割り当て、支払い調整設定があります。製品は、ショップ固有の価格を上書きして複数のショップに掲載できます。

コネクタは Etsy の卸売り/B2B 機能をサポートしていますか?

Etsy にはネイティブの卸売/B2B プログラムがありません。卸売の問い合わせに Etsy を使用するが、実際の取引はオフラインで処理する場合、コネクターはカスタム注文と同じように処理します。合意された価格設定で Odoo 販売注文を手動で作成し、標準プロセスを通じて処理することになります。

コネクタは Etsy の海外販売と VAT/GST 要件をどのように処理しますか?

Etsy は、EU、英国、オーストラリア、および Etsy がマーケットプレイスの仲介者として機能するその他の管轄区域において、売り手に代わって買い手に VAT/GST を徴収し、送金します。コネクターはこれらの注文を税金 0 ドルで輸入します (Etsy が徴収したため)。税金の徴収を担当する市場では、購入者の国に基づいて Odoo で適切な会計ポジションを構成します。

---

次のステップ

ECOSIRE Etsy Connector は、Etsy をスタンドアロンのマーケットプレイスから Odoo 19 Enterprise 内の完全に統合された販売チャネルに変換します。基本的な店舗管理を超えて拡大するハンドメイド ビジネスにとって、この統合は持続可能な成長のための運営バックボーンを提供します。

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

コネクタには、セットアップ ドキュメント、注文履歴データのインポート ツール、Etsy ショップを Odoo と迅速かつ正確に統合するための実装サポートが含まれています。