پاسخ کوتاه: برای اتصال دیجی‌کالا به ابرک، در پنل فروشندگان توکن API بسازید، در منوی «دیجی‌کالا»، «اتصال‌ها» اتصال تازه بسازید، «آزمون اتصال» و «دریافت تنوع‌ها» را بزنید و وب‌هوک را ثبت کنید. برای اسنپ‌فود، در منوی «اسنپ‌فود»، «اتصال‌ها» کانال و شناسهٔ فروشگاه را بدهید و کالاها را در «نگاشت کالاها» جفت کنید.
این آموزش ادامهٔ آموزش راه‌اندازی هستهٔ بازارگاه است. اگر کد داخلی محصولات را هنوز با کد فروشنده یکی نکرده‌اید، اول آن گام را انجام دهید؛ وگرنه نگاشت خودکار کار نمی‌کند.
پیش از شروع به چه چیزهایی نیاز دارید؟
- فضای کاری ابرک با اپ فروش و انبار و کاربری در گروه «مدیر دیجی‌کالا» یا «مدیر اسنپ‌فود».
- برای دیجی‌کالا: دسترسی به پنل فروشندگان و بخش API حساب کاربری، یا اگر این بخش باز نیست، کوکی نشست پنل.
- برای اسنپ‌فود: شناسهٔ فروشگاه در اسنپ‌فود و حساب فروشندهٔ فعال.
زمان لازم چقدر است؟
اتصال دیجی‌کالا برای فروشگاهی با کدهای مرتب حدود ۳۰ دقیقه طول می‌کشد. اتصال اسنپ‌فود در نسخهٔ فعلی کوتاه‌تر است و بیشتر زمانش صرف نگاشت کالاها می‌شود.
دیجی‌کالا را چطور وصل کنیم؟
- ساخت توکن: در پنل فروشندگان دیجی‌کالا، از منوی حساب کاربری به بخش API بروید و توکن بسازید.
- ساخت اتصال: در ابرک منوی «دیجی‌کالا»، «اتصال‌ها» را باز کنید و دکمهٔ ساخت را بزنید. نام اتصال به‌طور پیش‌فرض «فروشگاه دیجی‌کالا» است.
- وارد کردن کلید: در زبانهٔ «کلید API»، «روش اتصال» را «API رسمی (توکن)» بگذارید و توکن را در «توکن دسترسی» وارد کنید.
- انبار و قیمت: در بخش «انبار و قیمت»، انبار، «واحد قیمت در ابرک» و در صورت نیاز لیست قیمت را برگزینید.
- همگام‌سازی: در بخش «همگام‌سازی»، «موجودی احتیاطی» را تعیین کنید و ارسال قیمت را فعلاً خاموش بگذارید.
- آزمون اتصال: دکمهٔ «آزمون اتصال» را بزنید. اگر وضعیت «متصل» نشد، «آخرین خطا» را بخوانید.
- دریافت تنوع‌ها: دکمهٔ «دریافت تنوع‌ها» را بزنید. شمارنده‌های «تنوع‌ها» و «نگاشت‌نشده» روی فرم پر می‌شوند.
- نگاشت دستی: روی شمارندهٔ «نگاشت‌نشده» بزنید و برای هر تنوع، محصول اودو را برگزینید.
- کف قیمت: در «دیجی‌کالا»، «تنوع‌ها» برای هر تنوعی که قیمتش باید از ابرک برود، «کف قیمت (ریال)» بگذارید. سپس در فرم اتصال ارسال قیمت را روشن کنید.
- ارسال نخست: دکمهٔ «ارسال موجودی و قیمت» را بزنید تا منتظر زمان‌بند ۳۰ دقیقه‌ای نمانید، سپس «دریافت سفارش‌ها» را بزنید.
- وب‌هوک: در زبانهٔ «وب‌هوک»، دکمهٔ «ثبت رویدادها در دیجی‌کالا» را بزنید تا سفارش تازه بی‌درنگ برسد.
اگر دیجی‌کالا به حساب شما توکن API نداده، در گام سوم «پنل فروشندگان (بدون API)» را برگزینید و کوکی نشست را در «کوکی نشست پنل» بگذارید. این روش وب‌هوک ندارد و تا «اجازهٔ نوشتن از راه پنل» را روشن نکنید، فقط می‌خواند.
اسنپ‌فود را چطور وصل کنیم؟
- ساخت اتصال: منوی «اسنپ‌فود»، «اتصال‌ها» را باز کنید و اتصال تازه بسازید. در عنوان، نام فروشگاه را بنویسید.
- کانال و شناسه: در بخش «فروشگاه»، «کانال» را از میان «اسنپ‌فود (رستوران)»، «اسنپ‌مارکت» و «دخل» برگزینید و «شناسهٔ فروشگاه در اسنپ‌فود» را وارد کنید.
- تنظیمات ابرک: در بخش «ابرک»، «تیم فروش سفارش‌ها»، انبار، مشتری پیش‌فرض، لیست قیمت و واحد قیمت را تعیین کنید.
- حساب فروشنده: توکن‌های حساب اسنپ‌فود در فیلدهای محافظت‌شده‌ای نگه داشته می‌شوند که فقط گروه «مدیر اسنپ‌فود» به آن‌ها دسترسی دارد.
- آزمون اتصال: دکمهٔ «آزمون اتصال» را بزنید تا وضعیت «متصل» شود.
- اسنپ‌ساپلای: اگر توکن اسنپ‌ساپلای ثبت شده، دکمهٔ «به‌روزرسانی اسنپ‌ساپلای» را بزنید تا اعتبار و کیف پول در بخش «اسنپ‌ساپلای (فقط خواندن)» دیده شود.
- نگاشت کالاها: در زبانهٔ «نگاشت کالاها» برای هر کالای اسنپ‌فود شناسه، کد کالای فروشنده و عنوان را بنویسید و محصول اودو را برگزینید.
- بازبینی گزارش: منوی «اسنپ‌فود»، «گزارش درخواست‌ها» را باز کنید و ببینید درخواست‌ها با موفقیت برگشته‌اند.
در نسخهٔ فعلی، سفارش‌های اسنپ‌فود وارد اودو نمی‌شوند و موجودی و قیمت هم خودکار ارسال نمی‌شود. نگاشت کامل امروز کار مرحلهٔ بعد را ساده می‌کند.
بعد از اتصال چه چیزی را چک کنیم؟
روز اول، فهرست «تنوع‌ها» را بر پایهٔ «وضعیت ارسال» مرتب کنید. هر تنوعی که «خطا» دارد، دلیلش را در «خطای ارسال» می‌نویسد. روز دوم، چند سفارش دیجی‌کالا را در «فروش» باز کنید و مشتری، مالیات و مبلغ را با پنل دیجی‌کالا مقایسه کنید.
خطاهای رایج کدام‌اند؟
دیجی‌کالا: وضعیت اتصال «خطا» شد
توکن کپی ناقص شده یا منقضی است. توکن تازه بسازید، دوباره وارد کنید و «آزمون اتصال» را بزنید.
دیجی‌کالا: قیمت تنوعی ارسال نمی‌شود
آن تنوع «کف قیمت» ندارد یا قیمت اودو از کف پایین‌تر است. «خطای ارسال» همان تنوع دلیل را می‌گوید.
دیجی‌کالا: موجودی انبار دو بار کم شد
کالا در انبار دیجی‌کالاست و «تأیید خودکار سفارش» روشن است. برای این اتصال خاموشش کنید.
اسنپ‌فود: پیام «نخست با حساب فروشندهٔ اسنپ‌فود وارد شوید»
توکن دسترسی حساب برای این اتصال ثبت نشده است. گام حساب فروشنده را کامل کنید و دوباره آزمون بزنید.
اسنپ‌فود: هیچ درخواستی ثبت نمی‌شود
کلید «اتصال روشن» خاموش است. تا وقتی خاموش باشد، ابرک به اسنپ‌فود درخواستی نمی‌فرستد.
پرسش‌های پرتکرار
بعد از اتصال، سفارش‌های دیجی‌کالا کجا دیده می‌شوند؟
در منوی «دیجی‌کالا»، «سفارش‌ها» و همچنین در «فروش» با فیلتر «سفارش‌های بازارگاه».
هزینهٔ هر کانکتور چقدر است؟
۲۵۰٬۰۰۰ تومان (۲٬۵۰۰٬۰۰۰ ریال) به ازای هر کاربر در ماه. جزئیات در صفحهٔ قیمت است.
تفاوت دو کانکتور را کجا بخوانم؟
در مقالهٔ اتصال دیجی‌کالا و اسنپ‌فود به اودو.