رفتن به محتوای اصلی
آدورا
Seller API · OAuth رسمی Webhook لحظه‌ای

موجودی دیجی‌کالا را با بقیه کانال‌ها یکی کنید

با OAuth رسمی دیجی‌کالا، پنل آدورا variant، موجودی، قیمت، سفارش و Q&A فروشگاه‌تان را sync می‌کند — یک بار به‌روز کنید، همه‌جا همگام بماند.

  • OAuth امن دیجی‌کالا
  • اتصال در ~۵ دقیقه
  • SKU Auto-Link
OAuth اتصال رسمی
موجودی و قیمت
Webhook رویداد لحظه‌ای
DK-* شماره سفارش
دردسر فروشندگان دیجی‌کالا

فروش در دیجی‌کالا دارید، ولی بقیه کانال‌ها جدا افتاده؟

وقتی موجودی سایت، انبار و پنل دیجی‌کالا جدا به‌روز می‌شود، oversell و لغو سفارش نتیجه طبیعی است.

01

موجودی دیجی‌کالا با سایت یکی نیست

یک فروش در سایت موجودی variant دیجی‌کالا را کم نمی‌کند — مشتری سفارش می‌دهد و شما cancel می‌زنید.

02

سفارش DK جدا از بقیه کانال‌ها

باید بین پنل دیجی‌کالا، Excel و wp-admin جابه‌جا شوید تا بفهمید امروز چند سفارش دارید.

03

پرسش مشتریان گم می‌شود

Q&A دیجی‌کالا inbox جدا دارد — پاسخ دیر یا تکراری اعتماد فروشگاه را کم می‌کند.

چرا آدورا؟

دیجی‌کالا + همه کانال‌های دیگر

اتصال OAuth فقط شروع است — هدف یک منبع برای کاتالوگ، موجودی و سفارش است.

یک منبع موجودی

تغییر موجودی در آدورا → seller-stock دیجی‌کالا به‌روز می‌شود. فروش در DK → موجودی بقیه کانال‌ها کم می‌شود.

سفارش DK-{id} در پنل واحد

سفارش‌های دیجی‌کالا کنار WooCommerce و باسلام — یک جریان پردازش.

لینک خودکار با SKU

DigikalaSkuAutoLinker variantهای دیجی‌کالا را با SKU کاتالوگ آدورا match می‌کند.

امکانات اتصال

بعد از OAuth چه کارهایی خودکار می‌شود؟

هر کارت یک مسیر sync واقعی بین Seller API دیجی‌کالا و پنل آدورا را نشان می‌دهد.

↔ دوطرفه

موجودی و قیمت

PATCH seller-stock · batch update

موجودی را در آدورا عوض کنید — variant دیجی‌کالا sync می‌شود. تغییر از DK هم به کاتالوگ مرکزی برمی‌گردد.

DK → Adoura

سفارشات

GET /orders · webhook

سفارش جدید دیجی‌کالا با شماره DK-{id} در پنل آدورا ثبت می‌شود — کنار سایر کانال‌ها.

DK → inbox

پرسش و پاسخ

GET /questions · POST answer

سؤال مشتری در inbox آدورا می‌آید؛ پاسخ از همان پنل به دیجی‌کالا ارسال می‌شود.

Real-time

Webhook

سفارش · وضعیت · Q&A

رویدادهای دیجی‌کالا بلافاصله به آدورا push می‌شوند — بدون polling دستی.

آموزش اتصال

اتصال دیجی‌کالا در ۴ مرحله

بدون کدنویسی — OAuth رسمی Seller API، حدود ۵ دقیقه تا اولین sync.

  • حساب فروشنده دیجی‌کالا
  • API Seller Open API
  • OAuth client_id از دیجی‌کالا
  • آدورا اشتراک فعال
01

در آدورا ثبت‌نام کنید

پنل فروشنده آدورا نقطه مرکزی sync است.

  1. به my.adoura.ir بروید و ثبت‌نام کنید (یا وارد شوید)
  2. کاتالوگ اولیه را import کنید یا دستی محصول بسازید
  3. مطمئن شوید SKU محصولات با variant دیجی‌کالا یکسان است
02

OAuth دیجی‌کالا را بزنید

اتصال رسمی Seller API — بدون ذخیره رمز عبور.

  1. منو: سکوهای فروش → دیجی‌کالا
  2. دکمه «اتصال» یا «Connect OAuth»
  3. در seller.digikala.com وارد شوید و دسترسی را تأیید کنید
  4. بعد از callback، وضعیت باید «متصل» شود
04

Sync را فعال کنید

موجودی، سفارش و Q&A از این لحظه خودکار است.

  1. موجودی/قیمت: تغییر در آدورا → push به seller-stock
  2. سفارش: pull خودکار + webhook برای رویداد جدید
  3. لاگ sync را در پنل برای عیب‌یابی ببینید
سوالات متداول

پیش از اتصال، این‌ها پرسیده می‌شود

پاسخ کوتاه — برای جزئیات فنی به مستندات Seller API دیجی‌کالا مراجعه کنید.

اتصال دیجی‌کالا به آدورا چطور کار می‌کند؟

با OAuth رسمی Seller API دیجی‌کالا. شما در پنل آدورا «اتصال» را می‌زنید، در seller.digikala.com تأیید می‌کنید، و access_token امن ذخیره می‌شود — بدون copy/paste رمز.

تفاوت Sales Platform با «ورود محصول از دیجی‌کالا» چیست؟

ورود محصول (Product Import) یک‌بار کاتالوگ عمومی را import می‌کند. Sales Platform اتصال OAuth زنده است — موجودی، قیمت، سفارش و Q&A مداوم sync می‌شوند.

آیا می‌توانم همزمان WooCommerce و دیجی‌کالا وصل کنم؟

بله. این هدف آدورا است — یک کاتالوگ مرکزی که به WooCommerce، دیجی‌کالا، باسلام و کانال‌های دیگر sync می‌شود.

موجودی چطور sync می‌شود؟

از آدورا به دیجی‌کالا با PATCH /variants/{id}/seller-stock (یا batch). تغییر موجودی از DK هم به کاتالوگ مرکزی pull می‌شود تا oversell نشود.

سفارش دیجی‌کالا در آدورا چه شماره‌ای دارد؟

DK-{order_id} — مثلاً DK-928471. جزئیات، اقلام و مشتری مثل سایر سفارش‌های چندکاناله در یک پنل.

Webhook چه رویدادهایی می‌فرستد؟

سفارش جدید، تغییر وضعیت، پرسش مشتری و رویدادهای مرتبط — بسته به تنظیمات ثبت‌شده در Seller API.

آیا به client_id دیجی‌کالا نیاز دارم؟

OAuth از طرف آدورا مدیریت می‌شود. شما فقط با حساب فروشنده دیجی‌کالا login و approve می‌کنید. برای sandbox توسعه‌دهندگان، client جدا در env سرور تنظیم می‌شود.

عیب‌یابی

مشکلات رایج

اگر OAuth قطع شد یا sync درست کار نکرد، این موارد را اول بررسی کنید.

OAuth اتصال OAuth قطع شد یا «Unauthorized» token refresh

در پنل آدورا دوباره «اتصال» را بزنید. اگر refresh_token منقضی شده، OAuth کامل را repeat کنید. مطمئن شوید حساب فروشنده دیجی‌کالا فعال است.

لینک محصول variant دیجی‌کالا لینک نشده SKU match

SKU در آدورا باید با remote_sku دیجی‌کالا یکسان باشد. Auto-Linker را اجرا کنید یا از پنل product_links دستی وصل کنید.

موجودی موجودی در دیجی‌کالا به‌روز نمی‌شود seller-stock

بررسی کنید capability inventory_sync فعال است، variant لینک شده، و لاگ sync خطا ندارد. API rate limit دیجی‌کالا را هم چک کنید.

سفارش سفارش جدید در آدورا نیامد webhook + pull

Webhook ثبت شده باشد (DigikalaWebhookRegistrar). دستی pull orders را از پنل بزنید. لاگ sync را برای خطای API بررسی کنید.

دیجی‌کالا را به آدورا وصل کنید

ثبت‌نام کنید، OAuth را بزنید، و همان کاتالوگ را در سایت و باسلام هم بفروشید.